Você está na página 1de 1986

Dê a sua opinião sobre a experiência de download do PDF.

Comandos do Windows
Artigo • 25/04/2023

Todas as versões compatíveis do Windows e do Windows Server têm um conjunto de


comandos do console do Win32 interno. Esse conjunto de documentação descreve os
Comandos do Windows que podem ser usados para automatizar tarefas usando os
scripts ou ferramentas de script.

Shells de linha de comando


O Windows tem dois shells de linha de comando: o Shell de comando e o PowerShell.
Cada shell é um programa de software que fornece comunicação direta entre você e o
sistema operacional ou o aplicativo, fornecendo um ambiente para automatizar
operações de TI.

O Shell de comando foi o primeiro shell integrado ao Windows para automatizar tarefas
rotineiras, como gerenciamento de conta de usuário ou backups noturnos, com
arquivos em lote (.bat). Com o Host de Script do Windows, execute scripts mais
sofisticados no Shell de comando. Para obter mais informações, consulte cscript ou
wscript. Execute operações com mais eficiência ao usar os scripts do que ao usar a
interface do usuário. Os scripts aceitam todos os comandos disponíveis na linha de
comando.

O PowerShell foi projetado para estender os recursos do Shell de comando para


executar comandos do PowerShell chamados cmdlets. Os cmdlets são semelhantes aos
Comandos do Windows, mas fornecem uma linguagem de script mais extensível. É
possível executar os cmdlets dos Comandos do Windows e do PowerShell no
PowerShell, mas o Shell de comando só pode executar comandos do Windows e não
cmdlets do PowerShell.

Para a automação mais robusta e atualizada do Windows, recomendamos usar o


PowerShell em vez de Comandos do Windows ou o Host de Script do Windows para
automação do Windows.

Uma referência de códigos de saída e erro para os Comandos do Windows pode ser
encontrada nos artigos Depurar códigos de erro do sistema que podem ser úteis para
entender os erros produzidos. Os Comandos do Windows também incluem operadores
de redirecionamento de comando. Para saber mais sobre seu uso, consulte Usar
operadores de redirecionamento de comando.
7 Observação

Você também pode baixar e instalar o PowerShell Core, a versão código aberto do
PowerShell.

Preenchimento automático do arquivo do Shell


de comando e do nome do diretório
É possível configurar o Shell de comando para concluir automaticamente os nomes de
arquivo e diretório em uma sessão de computador ou usuário quando um caractere de
controle especificado é pressionado. Por padrão, esse caractere de controle é
configurado para ser a chave de guia para nomes de arquivo e diretório, embora
possam ser diferentes. Para alterar esse caractere de controle, execute regedit.exe e
navegue até uma das seguintes chaves e entradas do Registro, dependendo se deseja
alterar o valor somente para o usuário atual ou para todos os usuários do computador.

U Cuidado

A edição incorreta do Registro pode causar danos graves ao sistema. Antes de fazer
as seguintes alterações no registro, faça backup de todos os dados importantes do
computador.

registry

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor\CompletionChar
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor\PathCompletionChar

Defina esses valores como o do caractere de controle que queira usar. Consulte códigos
de chave virtual para obter uma lista completa. Para desabilitar um caractere de
conclusão específico no Registro, use o valor para espaço (0x20), pois ele não é um
caractere de controle válido. O tipo de valor dessa entrada do Registro é REG_DWORD e
pode ser especificado por um valor hexadecimal ou decimal.

Você também pode habilitar ou desabilitar a conclusão de nomes de arquivo e diretório


por instância de um Shell de comando executando cmd.exe com o parâmetro e
comutador /F:ON ou /F:OFF . Se a conclusão do nome estiver habilitada com o
parâmetro /F:ON e a opção, os dois caracteres de controle usados serão Ctrl-D para a
conclusão do nome do diretório e Ctrl-F para a conclusão do nome do arquivo. As
configurações especificadas pelo usuário têm precedência sobre as configurações do
computador e as opções de linha de comando têm precedência sobre as configurações
do Registro.

Referência de linha de comando A-Z


Para encontrar informações sobre um comando específico, no menu A-Z a seguir,
selecione a letra com a qual o comando começa e selecione o nome do comando.

A|B|C|D|E|F|G|H|I|J|K|L|M|N|O|P|Q|R|S|T|U|V|W|X|Y|Z

A
active
add
add alias
add volume
append
arp
assign
assoc
at
atmadm
attach-vdisk
attrib
attributes
attributes disk
attributes volume
auditpol
auditpol backup
auditpol clear
auditpol get
auditpol list
auditpol remove
auditpol resourcesacl
auditpol restore
auditpol set
autochk
autoconv
autofmt
automount
B
bcdboot
bcdedit
bdehdcfg
bdehdcfg driveinfo
bdehdcfg newdriveletter
bdehdcfg quiet
bdehdcfg restart
bdehdcfg size
bdehdcfg target
begin backup
begin restore
bitsadmin
bitsadmin addfile
bitsadmin addfileset
bitsadmin addfilewithranges
bitsadmin cache
bitsadmin cache and delete
bitsadmin cache and deleteurl
bitsadmin cache and getexpirationtime
bitsadmin cache and getlimit
bitsadmin cache and help
bitsadmin cache and info
bitsadmin cache and list
bitsadmin cache and setexpirationtime
bitsadmin cache and setlimit
bitsadmin cache and clear
bitsadmin cancel
bitsadmin complete
bitsadmin create
bitsadmin examples
bitsadmin getaclflags
bitsadmin getbytestotal
bitsadmin getbytestransferred
bitsadmin getclientcertificate
bitsadmin getcompletiontime
bitsadmin getcreationtime
bitsadmin getcustomheaders
bitsadmin getdescription
bitsadmin getdisplayname
bitsadmin geterror
bitsadmin geterrorcount
bitsadmin getfilestotal
bitsadmin getfilestransferred
bitsadmin gethelpertokenflags
bitsadmin gethelpertokensid
bitsadmin gethttpmethod
bitsadmin getmaxdownloadtime
bitsadmin getminretrydelay
bitsadmin getmodificationtime
bitsadmin getnoprogresstimeout
bitsadmin getnotifycmdline
bitsadmin getnotifyflags
bitsadmin getnotifyinterface
bitsadmin getowner
bitsadmin getpeercachingflags
bitsadmin getpriority
bitsadmin getproxybypasslist
bitsadmin getproxylist
bitsadmin getproxyusage
bitsadmin getreplydata
bitsadmin getreplyfilename
bitsadmin getreplyprogress
bitsadmin getsecurityflags
bitsadmin getstate
bitsadmin gettemporaryname
bitsadmin gettype
bitsadmin getvalidationstate
bitsadmin help
bitsadmin info
bitsadmin list
bitsadmin listfiles
bitsadmin makecustomheaderswriteonly
bitsadmin monitor
bitsadmin nowrap
bitsadmin peercaching
bitsadmin peercaching e getconfigurationflags
bitsadmin peercaching e help
bitsadmin peercaching e setconfigurationflags
bitsadmin peers
bitsadmin peers e clear
bitsadmin peers e discover
bitsadmin peers e help
bitsadmin peers e list
bitsadmin rawreturn
bitsadmin removeclientcertificate
bitsadmin removecredentials
bitsadmin replaceremoteprefix
bitsadmin reset
bitsadmin resume
bitsadmin setaclflag
bitsadmin setclientcertificatebyid
bitsadmin setclientcertificatebyname
bitsadmin setcredentials
bitsadmin setcustomheaders
bitsadmin setdescription
bitsadmin setdisplayname
bitsadmin sethelpertoken
bitsadmin sethelpertokenflags
bitsadmin sethttpmethod
bitsadmin setmaxdownloadtime
bitsadmin setminretrydelay
bitsadmin setnoprogresstimeout
bitsadmin setnotifycmdline
bitsadmin setnotifyflags
bitsadmin setpeercachingflags
bitsadmin setpriority
bitsadmin setproxysettings
bitsadmin setreplyfilename
bitsadmin setsecurityflags
bitsadmin setvalidationstate
bitsadmin suspend
bitsadmin takeownership
bitsadmin transfer
bitsadmin util
bitsadmin util e enableanalyticchannel
bitsadmin util e getieproxy
bitsadmin util e help
bitsadmin util e repairservice
bitsadmin util e setieproxy
bitsadmin util e version
bitsadmin wrap
bootcfg
bootcfg addsw
bootcfg copy
bootcfg dbg1394
bootcfg debug
bootcfg default
bootcfg delete
bootcfg ems
bootcfg query
bootcfg raw
bootcfg rmsw
bootcfg timeout
break

C
cacls
call
cd
certreq
certutil
change
change logon
change port
change user
chcp
chdir
chglogon
chgport
chgusr
chkdsk
chkntfs
choice
cipher
clean
cleanmgr
clip
cls
cmd
cmdkey
cmstp
color
comp
compact
compact vdisk
convert
convert basic
convert dynamic
convert gpt
convert mbr
copy
create
create partition efi
criar partição estendida
create partition logical
create partition msr
create partition primary
create volume mirror
create volume raid
create volume simple
create volume stripe
cscript

D
date
dcdiag
dcgpofix
defrag
del
delete
delete disk
delete partition
delete shadows
delete volume
detach vdisk
detail
detail disk
detail partition
detail vdisk
detail volume
dfsdiag
dfsdiag testdcs
dfsdiag testdfsconfig
dfsdiag testdfsintegrity
dfsdiag testreferral
dfsdiag testsites
dfsrmig
diantz
dir
diskcomp
diskcopy
diskpart
diskperf
diskraid
diskshadow
dispdiag
dnscmd
doskey
driverquery

E
echo
edit
endlocal
end restore
erase
eventcreate
Evntcmd
exec
exit
expand
expand vdisk
expose
extend
extract
F
fc
filesystems
find
findstr
finger
flattemp
fondue
for
forfiles
format
freedisk
fsutil
fsutil 8dot3name
fsutil behavior
fsutil dirty
fsutil file
fsutil fsinfo
fsutil hardlink
fsutil objectid
fsutil quota
fsutil repair
fsutil reparsepoint
fsutil resource
fsutil sparse
fsutil tiering
fsutil transaction
fsutil usn
fsutil volume
fsutil wim
ftp
ftp append
ftp ascii
ftp bell
ftp binary
ftp bye
ftp cd
ftp close
ftp debug
ftp delete
ftp dir
ftp disconnect
ftp get
ftp glob
ftp hash
ftp lcd
ftp literal
ftp ls
ftp mget
ftp mkdir
ftp mls
ftp mput
ftp open
ftp prompt
ftp put
ftp pwd
ftp quit
ftp quote
ftp recv
ftp remotehelp
ftp rename
ftp rmdir
ftp send
ftp status
ftp trace
ftp type
ftp user
ftp verbose
ftp mdelete
ftp mdir
ftype
fveupdate

G
getmac
gettype
goto
gpfixup
gpresult
gpt
gpupdate
graftabl

H
help
helpctr
hostname

I
icacls
if
import (shadowdisk)
import (diskpart)
inactive
ipconfig
ipxroute
irftp

J
jetpack

K
klist
ksetup
ksetup addenctypeattr
ksetup addhosttorealmmap
ksetup addkdc
ksetup addkpasswd
ksetup addrealmflags
ksetup changepassword
ksetup delenctypeattr
ksetup delhosttorealmmap
ksetup delkdc
ksetup delkpasswd
ksetup delrealmflags
ksetup domain
ksetup dumpstate
ksetup getenctypeattr
ksetup listrealmflags
ksetup mapuser
ksetup removerealm
ksetup server
ksetup setcomputerpassword
ksetup setenctypeattr
ksetup setrealm
ksetup setrealmflags
ktmutil
ktpass

L
label
list
list providers
list shadows
list writers
load metadata
lodctr
logman
logman create
logman create alert
logman create api
logman create cfg
logman create counter
logman create trace
logman delete
logman import e logman export
logman query
logman start e logman stop
logman update
logman update alert
logman update api
logman update cfg
logman update counter
logman update trace
logoff
lpq
lpr

M
macfile
makecab
manage bde
manage bde status
manage bde on
manage bde off
manage bde pause
manage bde resume
manage bde lock
manage bde unlock
manage bde autounlock
manage bde protectors
manage bde tpm
manage bde setidentifier
manage bde forcerecovery
manage bde changepassword
manage bde changepin
manage bde changekey
manage bde keypackage
manage bde upgrade
manage bde wipefreespace
mapadmin
md
merge vdisk
mkdir
mklink
mmc
mode
more
mount
mountvol
move
mqbkup
mqsvc
mqtgsvc
msdt
msg
msiexec
msinfo32
mstsc

N
nbtstat
netcfg
netdom
net print
netsh
netstat
nfsadmin
nfsshare
nfsstat
nlbmgr
nltest
nslookup
nslookup exit Command
nslookup finger Command
nslookup help
nslookup ls
nslookup lserver
nslookup root
nslookup server
nslookup set
nslookup set all
nslookup set class
nslookup set d2
nslookup set debug
nslookup set domain
nslookup set port
nslookup set querytype
nslookup set recurse
nslookup set retry
nslookup set root
nslookup set search
nslookup set srchlist
nslookup set timeout
nslookup set type
nslookup set vc
nslookup view
ntbackup
ntcmdprompt
ntfrsutl

O
offline
offline disk
offline volume
online
online disk
online volume
openfiles

P
pagefileconfig
path
pathping
pause
pbadmin
pentnt
perfmon
ping
pktmon
pnpunattend
pnputil
popd
powershell
powershell ise
print
prncnfg
prndrvr
prnjobs
prnmngr
prnport
prnqctl
prompt
pubprn
pushd
pushprinterconnections
pwlauncher
pwsh

Q
qappsrv
qprocess
consulta
query process
query session
query termserver
query user
quser
qwinsta

R
rd
rdpsign
recover
recover disk group
refsutil
reg
reg add
reg compare
reg copy
reg delete
reg export
reg import
reg load
reg query
reg restore
reg save
reg unload
regini
regsvr32
relog
rem
remove
ren
rename
repadmin
repair
repair bde
replace
rescan
reset
reset session
retain
revert
rexec
risetup
rmdir
robocopy
route ws2008
rpcinfo
rpcping
rsh
rundll32
rundll32 printui
rwinsta

S
san
sc config
sc create
sc delete
sc query
schtasks
scwcmd
scwcmd analyze
scwcmd configure
scwcmd register
scwcmd rollback
scwcmd transform
scwcmd view
secedit
secedit analyze
secedit configure
secedit export
secedit generaterollback
secedit import
secedit validate
select
select disk
select partition
select vdisk
select volume
serverceipoptin
servermanagercmd
serverweroptin
set environmental variables
set shadow copy
set context
set id
setlocal
set metadata
set option
set verbose
setx
sfc
shadow
shift
showmount
shrink
shutdown
simulate restore
sort
start
subcomando set device
subcomando set drivergroup
subcomando set drivergroupfilter
subcomando set driverpackage
subcomando set image
subcomando set imagegroup
subcomando set server
subcomando set transportserver
subcomando set multicasttransmission
subcomando start namespace
subcomando start server
subcomando start transportserver
subcomando stop server
subcomando stop transportserver
subst
sxstrace
sysocmgr
systeminfo

T
takeown
tapicfg
taskkill
tasklist
tcmsetup
telnet
telnet close
telnet display
telnet open
telnet quit
telnet send
telnet set
telnet status
telnet unset
tftp
time
timeout
title
tlntadmn
tpmtool
tpmvscmgr
tracerpt
tracert
tree
tscon
tsdiscon
tsecimp
tskill
tsprof
type
typeperf
tzutil

U
unexpose
uniqueid
unlodctr

V
ver
verifier
verify
vol
vssadmin
vssadmin delete shadows
vssadmin list shadows
vssadmin list writers
vssadmin resize shadowstorage

W
waitfor
wbadmin
wbadmin delete catalog
wbadmin delete systemstatebackup
wbadmin disable backup
wbadmin enable backup
wbadmin get disks
wbadmin get items
wbadmin get status
wbadmin get versions
wbadmin restore catalog
wbadmin start backup
wbadmin start recovery
wbadmin start sysrecovery
wbadmin start systemstatebackup
wbadmin start systemstaterecovery
wbadmin stop job
wdsutil
wecutil
wevtutil
where
whoami
winnt
winnt32
winrs
winsat mem
winsat mfmedia
wmic
writer
wscript

X
xcopy
Chave da sintaxe de linha de comando
Artigo • 09/03/2023

A tabela a seguir descreve a notação usada para indicar a sintaxe da linha de comando.

Notation Descrição

Texto sem colchetes ou Itens que você deve digitar, conforme mostrado.
chaves

<Text inside angle Espaço reservado para o qual você deve fornecer um valor.
brackets>

[Text inside square Itens opcionais.


brackets]

{Text inside braces} Conjunto de itens necessários. É necessário escolher uma.

Barra vertical ( \| ) Separador para itens mutuamente exclusivos. É necessário


escolher uma.

Reticências (…) Itens que podem ser repetidos e usados várias vezes.
Comandos por função de servidor
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Uma função de servidor descreve a função primária do servidor. Os administradores


podem optar por dedicar um servidor inteiro a uma função ou instalar várias funções e
subfunções de servidor em um único computador. Cada função pode incluir
ferramentas de linha de comando adicionais, instaladas como parte da função. Os
tópicos a seguir fornecem uma lista de comandos associados a cada função de servidor.

Referência aos comandos de impressão

Referência aos comandos dos Serviços para Network File System

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)

Referência aos comandos do Backup do Windows Server


Referência da ferramenta de linha de
comando de impressão
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Informações e links para cada uma das ferramentas de linha de comando de impressão
associadas:

Comando Descrição

lpq Exibe o status de uma fila de impressão em um computador com o LPD.

lpr Envia um arquivo para um computador ou dispositivo de


compartilhamento de impressora com o serviço LPD em preparação para
impressão.

Net print Exibe as informações sobre uma fila de impressora especificada, exibe as
informações sobre um trabalho de impressão especificado ou controla
um trabalho de impressão especificado.

print Envia um arquivo de texto para uma impressora.

prncnfg Configura ou exibe as informações de configuração sobre uma


impressora.

prndrvr Adiciona, exclui e lista os drivers de impressora.

prnjobs Pausa, retoma, cancela e lista os trabalhos de impressão.

prnmngr Adiciona, exclui e lista as impressoras ou conexões de impressora, além


de definir e exibir a impressora padrão.

prnport Cria, exclui e lista as portas de impressora TCP/IP padrão, além de exibir e
alterar a configuração da porta.

prnqctl Imprime uma página de teste, pausa ou retoma uma impressora e limpa
uma fila de impressora.

pubprn Publica uma impressora no serviço de diretório do Active Directory.

rundll32 Permite automatizar a instalação e a configuração de impressoras usando


printui.dll,printUIEntry scripts ou o prompt de comando.
Ferramentas de linha de comando dos
Serviços para Sistema de Arquivos de
Rede
Artigo • 12/04/2023

Os Serviços para NFS (Network File System) fornecem uma solução de


compartilhamento de arquivos que permite transferir arquivos entre computadores que
executam sistemas operacionais Windows Server e UNIX usando o protocolo NFS.

Informações e links para cada uma das ferramentas de linha de comando associadas do
NFS:

Comando Descrição

mapadmin Gerencie o Mapeamento de Nomes de Usuário dos Serviços Microsoft para


Sistema de Arquivos de Rede.

mount Monte os compartilhamentos de rede do NFS (Sistema de Arquivos de Rede).

nfsadmin Gerencie o Servidor para NFS e o Cliente para NFS.

nfsshare Controle os compartilhamentos do NFS (Sistema de Arquivos de Rede).

nfsstat Exiba ou redefina as contagens de chamadas feitas ao Servidor para NFS.

rpcinfo Liste os programas nos computadores remotos.

showmount Exiba os diretórios montados.

Links relacionados
Chave da sintaxe de linha de comando
Referência às ferramentas de linha de
comando dos Serviços de Área de
Trabalho Remota (Serviços de Terminal)
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Saiba mais sobre as ferramentas de linha de comando disponíveis dos Serviços de Área
de Trabalho Remota (Serviços de Terminal), com descrições e links para informações
mais detalhadas.

7 Observação

Para descobrir as novidades da última versão, confira Novidades nos Serviços de


Área de Trabalho Remota do Windows Server.

Comando Descrição

change Altera as configurações do servidor Host da Sessão da Área de Trabalho Remota


para entrada, mapeamentos de porta COM e modo de instalação.

change Habilita ou desabilita logons de sessões de cliente em um servidor Host da Sessão


logon da Área de Trabalho Remota ou exibe o status de logon atual.

change Lista ou altera os mapeamentos de porta COM para serem compatíveis com os
port aplicativos MS-DOS.

change Altera o modo de instalação do servidor Host da Sessão da Área de Trabalho


user Remota.

chglogon Habilita ou desabilita logons de sessões de cliente em um servidor Host da Sessão


da Área de Trabalho Remota ou exibe o status de logon atual.

chgport Lista ou altera os mapeamentos de porta COM para serem compatíveis com os
aplicativos MS-DOS.

chgusr Altera o modo de instalação do servidor Host da Sessão da Área de Trabalho


Remota.

flattemp Habilita ou desabilita as pastas temporárias simples.


Comando Descrição

logoff Desconecta um usuário de uma sessão em um servidor Host da Sessão da Área de


Trabalho Remota e exclui a sessão do servidor.

msg Envia uma mensagem a um usuário em um servidor Host da Sessão da Área de


Trabalho Remota.

mstsc Cria conexões com servidores host da Sessão da Área de Trabalho Remota ou outros
computadores remotos.

qappsrv Exibe uma lista de todos os servidores Host da Sessão da Área de Trabalho Remota
na rede.

qprocess Exibe informações sobre processos em execução em um servidor Host da Sessão da


Área de Trabalho Remota.

consulta Exibe informações sobre processos, sessões e servidores Host da Sessão da Área de
Trabalho Remota.

query Exibe informações sobre processos em execução em um servidor Host da Sessão da


process Área de Trabalho Remota.

query Exibe as informações sobre as sessões em um servidor Host da Sessão da Área de


session Trabalho Remota.

query Exibe uma lista de todos os servidores Host da Sessão da Área de Trabalho Remota
termserver na rede.

query user Exibe as informações sobre as sessões de usuário em um servidor Host da Sessão da
Área de Trabalho Remota.

quser Exibe as informações sobre as sessões de usuário em um servidor Host da Sessão da


Área de Trabalho Remota.

qwinsta Exibe as informações sobre as sessões em um servidor Host da Sessão da Área de


Trabalho Remota.

rdpsign Permite que você assine digitalmente um arquivo de Protocolo de Área de Trabalho
Remota (.rdp).

reset Permite redefinir (excluir) uma sessão em um servidor Host da Sessão da Área de
session Trabalho Remota.

rwinsta Permite redefinir (excluir) uma sessão em um servidor Host da Sessão da Área de
Trabalho Remota.

shadow Permite controlar remotamente uma sessão ativa de outro usuário em um servidor
host da Sessão da Área de Trabalho Remota.

tscon Conecta-se a outra sessão em um servidor host da Sessão da Área de Trabalho


Remota.
Comando Descrição

tsdiscon Desconecta uma sessão de um servidor Host da Sessão da Área de Trabalho Remota.

tskill Encerra um processo em execução em uma sessão em um servidor Host da Sessão


da Área de Trabalho Remota.

tsprof Copia as informações de configuração do usuário dos Serviços de Área de Trabalho


Remota de um usuário para outro.

Links relacionados
Chave da sintaxe de linha de comando
Referência aos comandos do Backup do
Windows Server
Artigo • 12/04/2023

Os subcomandos a seguir para o wbadmin fornecem a funcionalidade de backup e


recuperação de um prompt de comando.

Para configurar um agendamento de backup, você deve ser membro do grupo


Administradores. Para realizar todas as outras tarefas com esse comando, você deve ser
membro do grupo Operadores de Backup ou Administradores ou deve ter as
permissões apropriadas.

Você deve executar o wbadmin em um prompt de comando elevado. (Para abrir um


prompt de comandos com privilégios elevados, clique em Iniciar, clique com o botão
direito em Prompt de Comando, em seguida, clique em Executar como administrador.)

Subcomando Descrição

Wbadmin enable Configura e habilita um agendamento de backup diário.


backup

Wbadmin disable Desabilita os backups diários.


backup

Wbadmin start Executa um backup único. Se usado sem parâmetros, usa as configurações
backup do agendamento de backup diário.

Wbadmin stop job Interrompe a operação de backup ou recuperação em execução no


momento.

Wbadmin get Lista os detalhes de backups recuperáveis do computador local ou, se


versions outro local for especificado, de outro computador.

Wbadmin get items Lista os itens incluídos em um backup específico.

Wbadmin start Executa uma recuperação dos volumes, aplicativos, arquivos ou pastas
recovery especificados.

Wbadmin get status Mostra o status da operação de backup ou recuperação em execução no


momento.

Wbadmin get disks Lista os discos que estão online no momento.

Wbadmin start Executa uma recuperação de estado do sistema.


systemstaterecovery
Subcomando Descrição

Wbadmin start Executa um backup de estado do sistema.


systemstatebackup

Wbadmin delete Exclui um ou mais backups de estado do sistema.


systemstatebackup

Wbadmin start Executa uma recuperação do sistema completo (pelo menos todos os
sysrecovery volumes que contêm o estado do sistema operacional). Esse subcomando
só estará disponível se você estiver usando o Ambiente de Recuperação do
Windows.

Wbadmin restore Recupera um catálogo de backup de um local de armazenamento


catalog especificado, caso o catálogo de backup no computador local tenha sido
corrompido.

Wbadmin delete Exclui o catálogo de backup no computador local. Use esse comando
catalog somente se o catálogo de backup neste computador estiver corrompido e
você não tiver backups armazenados em outro local que possa ser usado
para restaurar o catálogo.
ativo
Artigo • 12/04/2023

Em discos básicos, marca a partição com foco como ativa. Somente partições podem ser
marcadas como ativas. Uma partição deve ser selecionado para que essa operação seja
bem-sucedida. Use o comando select partition para selecionar uma partição e deslocar
o foco para ela.

U Cuidado

O DiskPart informa apenas o BIOS (sistema de entrada/saída básico) ou a EFI


(Interface de Firmware Extensível) de que a partição ou o volume é uma partição do
sistema ou volume de sistema válido e pode conter os arquivos de inicialização do
sistema operacional. O DiskPart não verifica o conteúdo da partição. Se você
marcar erroneamente uma partição como ativa e ela não contiver os arquivos de
inicialização do sistema operacional, o computador poderá não iniciar.

Sintaxe

active

Exemplos
Para marcar a partição com foco como a partição ativa, digite:

active

Links relacionados
Chave da sintaxe de linha de comando

Comando select partition


add
Artigo • 11/04/2023

Adiciona volumes ao conjunto de volumes que devem ser copiados por sombra ou
adiciona aliases ao ambiente de alias. Se usado sem subcomandos, add lista os volumes
e aliases atuais.

7 Observação

Os aliases não são adicionados ao ambiente de alias até que a cópia de sombra
seja criada. Os aliases necessários imediatamente devem ser adicionados usando
adicionar alias.

Sintaxe

add
add volume <volume> [provider <providerid>]
add alias <aliasname> <aliasvalue>

Parâmetros

Parâmetro Descrição

volume Adiciona um volume ao Conjunto de Cópias de Sombra, que é o conjunto de


volumes a serem copiados por sombra. Confira adicionar volume para sintaxe e
parâmetros.

alias Adiciona o nome e o valor dados ao ambiente de alias. Confira adicionar alias para
sintaxe e parâmetros.

/? Exibe a ajuda na linha de comando.

Exemplos
Para exibir os volumes adicionados e os aliases que estão atualmente no ambiente,
digite:
add

A saída a seguir mostra que a unidade C foi adicionada ao Conjunto de Cópias de


Sombra:

Volume c: alias System1 GUID \\?\Volume{XXXXXXXX-XXXX-XXXX-XXXX-


XXXXXXXXXXXX}\
1 volume in Shadow Copy Set.
No Diskshadow aliases in the environment.

Links relacionados
Chave da sintaxe de linha de comando
add alias
Artigo • 17/04/2023

Adiciona aliases ao ambiente de alias. Se usado sem parâmetros, o add alias exibe a
ajuda na solicitação de comando. Os aliases são salvos no arquivo de metadados e
serão carregados com o comando load metadata.

Sintaxe

add alias <aliasname> <aliasvalue>

Parâmetros

Parâmetro Descrição

<aliasname> Especifica o nome do alias.

<aliasvalue> Especifica o valor do alias.

`? Exibe a ajuda no prompt de comando.

Exemplos
Para listar todas as sombras, incluindo seus aliases, digite:

list shadows all

O trecho a seguir mostra uma cópia de sombra à qual foi atribuído o alias padrão
VSS_SHADOW_x:

* Shadow Copy ID = {ff47165a-1946-4a0c-b7f4-80f46a309278}


%VSS_SHADOW_1%

Para atribuir um novo alias com o nome System1 a essa cópia de sombra, digite:
add alias System1 %VSS_SHADOW_1%

Como alternativa, você pode atribuir o alias usando a ID da cópia de sombra:

add alias System1 {ff47165a-1946-4a0c-b7f4-80f46a309278}

Links relacionados
Chave da sintaxe de linha de comando

Comando load metadata


add volume
Artigo • 17/04/2023

Adiciona volumes ao Conjunto de Cópias de Sombra, que é o conjunto de volumes dos


quais será feita cópia de sombra. Quando uma cópia de sombra é criada, uma variável
de ambiente vincula o alias à ID de sombra, de modo que o alias possa ser usado para
fins de scripts.

Os volumes são adicionados um de cada vez. Cada vez que um volume é adicionado,
ele é verificado para garantir que o VSS dê suporte à criação de cópia de sombra para
esse volume. Essa verificação pode ser invalidada pelo uso posterior do comando set
context.

Esse comando é necessário para criar cópias de sombra. Se usado sem parâmetros, o
add volume exibirá a ajuda na solicitação de comando.

Sintaxe

add volume <volume> [provider <providerid>]

Parâmetros

Parâmetro Descrição

<volume> Especifica um volume a ser adicionado ao Conjunto de Cópias de Sombra. Pelo


menos um volume é necessário para a criação da cópia de sombra.

[provider \ Especifica a ID do Provedor para um provedor registrado a ser usado para criar a
<providerid>] cópia de sombra. Se provedor não for especificado, o provedor padrão será
usado.

Exemplos
Para exibir a lista atual de provedores registrados, na solicitação diskshadow> , digite:

list providers
A saída a seguir exibe um único provedor, que será usado por padrão:

* ProviderID: {b5946137-7b9f-4925-af80-51abd60b20d5}
Type: [1] VSS_PROV_SYSTEM
Name: Microsoft Software Shadow Copy provider 1.0
Version: 1.0.0.7
CLSID: {65ee1dba-8ff4-4a58-ac1c-3470ee2f376a}
1 provider registered.

Para adicionar a unidade C: ao Conjunto de Cópias de Sombra e atribuir um alias


chamado System1, digite:

add volume c: alias System1

Links relacionados
Chave da sintaxe de linha de comando

Comando set context


acrescentar
Artigo • 10/04/2023

Permite que os programas abram arquivos de dados em diretórios especificados como


se estivessem no diretório atual. Se usado sem parâmetros, acréscimo exibe a lista de
diretórios acrescentados.

7 Observação

Este comando não tem suporte no Windows 10.

Sintaxe

append [[<drive>:]<path>[;...]] [/x[:on|:off]] [/path:[:on|:off] [/e]


append ;

Parâmetros

Parâmetro Descrição

[\ Especifica uma unidade e um diretório a serem acrescentados.


<drive>:]
<path>

/x:on Aplica diretórios acrescentados a pesquisas de arquivos e inicialização de


aplicativos.

/x:off Aplica diretórios acrescentados somente a solicitações para abrir arquivos. A opção
/x:off é a configuração padrão.

/path:on Aplica diretórios acrescentados a solicitações de arquivo que já especificam um


caminho. /path:on é a configuração padrão.

/path:off Desativa o efeito de /path:on.

/e Armazena uma cópia da lista de diretórios acrescentados em uma variável de


ambiente denominada ACRÉSCIMO. /e pode ser usado somente na primeira vez
que você usa acréscimo depois de iniciar o sistema.

; Limpa a lista de diretórios acrescentados.


Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Exemplos
Para limpar a lista de diretórios acrescentados, digite:

append ;

Para armazenar uma cópia do diretório a uma variável de ambiente denominada


acréscimo, digite:

append /e

Links relacionados
Chave da sintaxe de linha de comando
arp
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe e modifica entradas no cache do ARP (Protocolo de Resolução de Endereços). O


cache do ARP contém uma ou mais tabelas que são usadas para armazenar endereços
IP e seus endereços físicos Ethernet ou Anel de Token resolvidos. Há uma tabela
separada para cada adaptador de rede Ethernet ou Anel de Token instalado em seu
computador. Usado sem parâmetros, o arp exibe informações de ajuda.

Sintaxe

arp [/a [<inetaddr>] [/n <ifaceaddr>]] [/g [<inetaddr>] [-n <ifaceaddr>]]


[/d <inetaddr> [<ifaceaddr>]] [/s <inetaddr> <etheraddr> [<ifaceaddr>]]

Parâmetros

Parâmetro Descrição

[/a Exibe tabelas de cache do ARP atuais para todas as interfaces. O parâmetro /n
[<inetaddr>] diferencia maiúsculas de minúsculas. Para exibir a entrada de cache do ARP para
[/n um endereço IP específico, use arp / a com o parâmetro inetaddr, em que
<ifaceaddr>] inetaddr é um endereço IP. Se inetaddr não for especificado, a primeira interface
aplicável será usada. Para exibir a tabela de cache do ARP para uma interface
específica, use o parâmetro /n ifaceaddr em conjunto com o parâmetro /a em
que inetaddr é o endereço IP atribuído à interface.

[/g Idêntico a /a.


[<inetaddr>]
[/n
<ifaceaddr>]

[/d Exclui uma entrada com um endereço IP específico, em que inetaddr é o


<inetaddr> endereço IP. Para excluir uma entrada em uma tabela para uma interface
[<ifaceaddr>] específica, use o parâmetro ifaceaddr em que ifaceaddr é o endereço IP
atribuído à interface. Para excluir todas as entradas, use o caractere curinga
asterisco (*) no lugar de inetaddr.
Parâmetro Descrição

[/s Adiciona uma entrada estática ao cache do ARP que resolve o endereço IP
<inetaddr> inetaddr ao endereço físico etheraddr. Para adicionar uma entrada de cache do
<etheraddr> ARP estático à tabela uma interface específica, use o parâmetro ifaceaddr em
[<ifaceaddr>] que ifaceaddr é um endereço IP atribuído à interface.

/? Exibe a ajuda no prompt de comando.

Comentários
Os endereços IP para inetaddr e ifaceaddr são expressos em notação decimal
pontilhada.

O endereço físico para etheraddr consiste em seis bytes expressos em notação


hexadecimal e separados por hifens (por exemplo, 00-AA-00-4F-2A-9C).

As entradas adicionadas com o parâmetro /s são estáticas e não atingem tempo


limite do cache do ARP. As entradas serão removidas se o protocolo TCP/IP for
interrompido e iniciado. Para criar entradas permanentes de cache do ARP
estático, coloque os comandos arp apropriados em um arquivo em lote e use
Tarefas Agendadas para executar o arquivo em lote na inicialização.

Exemplos
Para exibir as tabelas de cache do ARP para todas as interfaces, digite:

arp /a

Para exibir a tabela de cache do ARP para a interface atribuída ao endereço IP 10.0.0.99,
digite:

arp /a /n 10.0.0.99

Para adicionar uma entrada de cache do ARP estático que resolve o endereço IP
10.0.0.80 ao endereço físico 00-AA-00-4F-2A-9C, digite:
arp /s 10.0.0.80 00-AA-00-4F-2A-9C

Links relacionados
Chave da sintaxe de linha de comando
assign
Artigo • 21/12/2022

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Atribui uma letra de unidade ou ponto de montagem ao volume com foco. Você
também pode usar esse comando para alterar a letra da unidade associada a uma
unidade removível. Se nenhuma letra de unidade ou ponto de montagem for
especificado, a próxima letra de unidade disponível será atribuída. Se a letra da unidade
ou o ponto de montagem já estiver em uso, um erro será gerado.

Um volume deve ser selecionado para que essa operação seja realizada com sucesso.
Use o comando selecionar volume para selecionar um volume e deslocar o foco para
ele.

) Importante

Você não pode atribuir letras de unidade a volumes do sistema, volumes de


inicialização ou volumes que contêm o arquivo de paginação. Além disso, não é
possível atribuir uma letra da unidade a uma partição OEM (fabricante original do
equipamento) ou a qualquer partição GPT (tabela de partição GUID) que não seja
uma partição de dados básica.

Sintaxe

assign [{letter=<d> | mount=<path>}] [noerr]

Parâmetros

Parâmetro Descrição

letter= A letra da unidade que você deseja atribuir ao volume.


<d>
Parâmetro Descrição

mount= O caminho do ponto de montagem que você deseja atribuir ao volume. Para obter
<path> instruções sobre como usar esse comando, consulte atribuir um caminho de pasta
de ponto de montagem a uma unidade.

NOERR Somente para scripts. Quando um erro é encontrado, o DiskPart continua


processando comandos como se o erro não tivesse ocorrido. Sem esse parâmetro,
um erro faz com que o DiskPart saia com um código de erro.

Exemplos
Para atribuir a letra E ao volume em foco, digite:

assign letter=e

Referências adicionais
Chave da sintaxe de linha de comando

Selecionar comando de volume


assoc
Artigo • 10/04/2023

Exibe ou modifica associações da extensão de nome de arquivo. Se usado sem


parâmetros, assoc exibirá uma lista de todas as associações da extensão de nome de
arquivo atual.

7 Observação

Há suporte para esse comando somente no cmd.exe e ele não está disponível no
PowerShell. Você pode usar cmd /c assoc como solução alternativa.

Sintaxe

assoc [<.[ext]>[=[<filetype>]]]

Parâmetros

Parâmetro Descrição

<.ext> Especifica a extensão de nome de arquivo.

<filetype> Especifica o tipo de arquivo a ser associado à extensão de nome de arquivo


especificada.

/? Exibe a ajuda no prompt de comando.

Comentários
Para fazer alterações nas associações, você precisa de privilégios de administrador.

Para remover a associação de tipo de arquivo para uma extensão de nome de


arquivo, adicione um espaço em branco após o sinal de igual pressionando a
BARRA DE ESPAÇO.

Para associar arquivos sem extensão a um tipo de arquivo, use apenas um ponto
(confira os exemplos).
Para exibir os tipos de arquivo atuais que têm cadeias de caracteres de comando
abertas definidas, use o comando ftype.

Para redirecionar a saída de assoc para um arquivo de texto, use o operador de


redirecionamento > .

Exemplos
Para exibir a associação de tipo de arquivo atual para a extensão de nome de arquivo
.txt, digite:

assoc .txt

Para remover a associação de tipo de arquivo para a extensão de nome de arquivo .bak,
digite:

assoc .bak=

7 Observação

Adicione um espaço após o sinal de igual.

Para exibir a saída de assoc uma tela de cada vez, digite:

assoc | more

Para enviar a saída de assoc ao arquivo assoc.txt, digite:

assoc>assoc.txt

Associar .log a arquivos de texto:


assoc .log=txtfile

Associar arquivos sem extensão a arquivos de texto:

assoc .=txtfile

Links relacionados
Chave da sintaxe de linha de comando

comando ftype
at
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Agenda comandos e programas a serem executados em um computador em uma data


e hora determinadas. Você só pode usar o at quando o serviço Agendar estiver em
execução. Usado sem parâmetros, at lista comandos agendados. Você deve ser um
membro do grupo Administradores local para executar este comando.

Sintaxe

at [\computername] [[id] [/delete] | /delete [/yes]]


at [\computername] <time> [/interactive] [/every:date[,...] |
/next:date[,...]] <command>

Parâmetros

Parâmetro Descrição

\ Especifica um computador remoto. Se você omitir esse parâmetro, o comando


<computername\> at agenda os comandos e programas no computador local.

<id> Especifica o número de identificação atribuído a um comando agendado.

/delete Cancela um comando agendado. Caso omita a ID, todos os comandos


agendados no computador serão cancelados.

/sim Responde sim a todas as consultas do sistema ao excluir eventos agendados.

<time> Especifica a hora em que queira executar o comando. tempo é expresso como
Horas:Minutos em notação de 24 horas (ou seja, 00:00 (meia-noite) a 23:59).

Interativo Permite que o comando interaja com a área de trabalho do usuário que está
conectado no momento em que o Comando é executado.

a cada: Executa o comando em cada dia ou dias especificados da semana ou mês (por
exemplo, todas as quintas-feiras ou o terceiro dia de cada mês).
Parâmetro Descrição

<date> Especifica a data em que queira executar o comando. Especifique um ou mais


dias da semana (ou seja, digite M,T,W,Th,F,S,Su) ou um ou mais dias do mês
(ou seja, digite 1 a 31). Separe várias entradas de data com vírgulas. Caso
omita a data, o comando at usará o dia atual do mês.

próximo: Executa o comando na próxima ocorrência do dia (por exemplo, na próxima


quinta-feira).

<command> Especifica o comando do Windows, o programa (ou seja, o arquivo .exe ou


.com) ou o programa em lotes (ou seja, .bat ou arquivo .cmd) o qual queira
executar. Quando o comando exigir um caminho como argumento, use o
caminho absoluto (ou seja, todo o caminho começando com a letra da
unidade). Se o comando estiver em um computador remoto, especifique a
notação UNC (Convenção Universal de Nomenclatura) para o servidor e o
nome do compartilhamento, em vez de uma letra de unidade remota.

/? Exibe a ajuda no prompt de comando.

Comentários
Esse comando não carrega automaticamente cmd.exe antes de executar
comandos. Caso não esteja executando um arquivo executável (.exe), será
necessário carregar explicitamente o cmd.exe no início do comando da seguinte
maneira:

cmd /c dir > c:\test.out

Caso esteja usando esse comando sem opções de linha de comando, as tarefas
agendadas aparecerão em uma tabela formatada de forma semelhante à seguinte:

Status ID Day time Command Line


OK 1 Each F 4:30 PM net send group leads status due
OK 2 Each M 12:00 AM chkstor > check.file
OK 3 Each F 11:59 PM backup2.bat

Se incluir um número de identificação (ID) com esse comando, somente as


informações de uma única entrada aparecerão em um formato semelhante ao
seguinte:
Task ID: 1
Status: OK
Schedule: Each F
Time of Day: 4:30 PM
Command: net send group leads status due

Depois de agendar um comando, especialmente um comando que tenha opções


de linha de comando, verifique se a sintaxe do comando está correta digitando at
sem nenhuma opção de linha de comando. Se as informações na coluna Linha de
Comando estiverem erradas, exclua o comando e digite-o novamente. Se ainda
estiver incorreto, digite novamente o comando usando menos opções de linha de
comando.

Comandos agendados com o at em execução como processos em segundo plano.


A saída não é exibida na tela do computador. Para redirecionar a saída para um
arquivo, use o símbolo > de redirecionamento. Caso redirecione a saída para um
arquivo, precisará usar o símbolo ^ de escape antes do símbolo de
redirecionamento, seja usando o at na linha de comando ou em um arquivo em
lote. Por exemplo, para redirecionar a saída para output.txt, digite:

at 14:45 c:\test.bat ^>c:\output.txt

O diretório atual para o comando em execução é a pasta systemroot.

Caso altere a hora do sistema depois de agendar um comando para ser executado,
sincronize o at no agendador com a hora revisada do sistema digitando at sem
opções de linha de comando.

Os comandos agendados são armazenados no registro. Como resultado, você não


perderá tarefas agendadas se reiniciar o serviço agendamento.

Não use uma unidade redirecionada para trabalhos agendados que acessam a
rede. O serviço Agendar pode não conseguir acessar a unidade redirecionada ou a
unidade redirecionada pode não estar presente se um usuário diferente estiver
conectado no momento em que a tarefa agendada for executada. Em vez disso,
use caminhos UNC para trabalhos agendados. Por exemplo:

at 1:00pm my_backup \\server\share


Não use a seguinte sintaxe, em que x: é uma conexão feita pelo usuário:

at 1:00pm my_backup x:

Caso agende um comando at que usa uma letra da unidade para se conectar a um
diretório compartilhado, inclua um comando at para desconectar a unidade
quando terminar de usar a unidade. Se a unidade não estiver desconectada, a letra
da unidade atribuída não estará disponível no prompt de comando.

Por padrão, as tarefas agendadas usando esse comando serão interrompidas após
72 horas. Modifique o registro para alterar esse valor padrão.

Para modificar o registro

U Cuidado

A edição incorreta do Registro pode causar danos graves ao sistema. Antes de


alterar o Registro, faça backup de todos os dados importantes do
computador.

1. Inicie o editor do Registro (regedit.exe).

2. Localize e selecione na seguinte chave no Registro:


HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Schedule

3. No menu Editar, selecione Adicionar Valor e adicione os seguintes valores de


registro:

Nome do valor. atTaskMaxHours

Tipo de dados. reg_DWOrd

Radix. Decimal

Dados de valor: 0. Um valor de 0 no campo Dados de Valor indica que


não há limite e não é interrompido. Valores de 1 a 99 indicam o número
de horas.

Use a pasta Tarefas Agendadas para exibir ou modificar as configurações de uma


tarefa que foi criada usando este comando. Ao agendar uma tarefa usando esse
comando, a tarefa é listada na pasta Tarefas Agendadas, com um nome como o
seguinte:at3478. No entanto, caso modifique uma tarefa por meio da pasta Tarefas
Agendadas, ela será atualizada para uma tarefa agendada normal. A tarefa não
está mais visível para o comando at e a configuração na conta não se aplica mais a
ela. Insira explicitamente uma conta de usuário e uma senha para a tarefa.

Exemplos
Para exibir uma lista de comandos agendados no servidor de Marketing, digite:

at \\marketing

Para saber mais sobre um comando com o número de identificação 3 no servidor Corp,
digite:

at \\corp 3

Para agendar um comando de compartilhamento de rede a ser executado no servidor


Corp às 8h e redirecionar a listagem para o servidor de Manutenção, no diretório
compartilhado Relatórios e no arquivo Corp.txt, digite:

at \\corp 08:00 cmd /c net share reports=d:\marketing\reports >>


\\maintenance\reports\corp.txt

Para fazer backup do disco rígido do servidor de Marketing em uma unidade de fita à
meia-noite a cada cinco dias, crie um programa em lote chamado Archive.cmd, que
contém os comandos de backup e agende o programa em lote para ser executado,
digite:

at \\marketing 00:00 /every:5,10,15,20,25,30 archive

Para cancelar todos os comandos agendados no servidor atual, desmarque as


informações de agendamento do at da seguinte maneira:

at /delete
Para executar um comando que não seja um arquivo executável (.exe), preceda o
comando com cmd /c para carregar cmd.exe da seguinte maneira:

cmd /c dir > c:\test.out

Links relacionados
Chave da sintaxe de linha de comando

schtasks. Outra ferramenta de agendamento de linha de comando.


atmadm
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Monitora conexões e endereços registrados pelo gerenciador de chamadas atM em


uma rede atM (modo de transferência assíncrona). Você pode usar o atmadm para
exibir as estatísticas das chamadas de entrada e saída em adaptadores atM. Usado sem
parâmetros, o atmadm exibe as estatísticas para monitorar o status de conexões atM
ativas.

Sintaxe

atmadm [/c][/a][/s]

Parâmetros

Parâmetro Descrição

/c Exibe as informações de chamada de todas as conexões atuais com o adaptador de


rede atM instalado neste computador.

/a Exibe o endereço do NSAP (ponto de acesso ao serviço de rede) registrado para


cada adaptador instalado neste computador.

/s Exibe as estatísticas para monitorar o status de conexões atM ativas.

/? Exibe a ajuda no prompt de comando.

Comentários
O comando atmadm /c produz um resultado semelhante ao seguinte:

Windows atM call Manager Statistics


atM Connections on Interface : [009] Olicom atM PCI 155 Adapter
Connection VPI/VCI remote address/
Media Parameters (rates in bytes/sec)
In PMP SVC 0/193 47000580FFE1000000F21A2E180020481A2E180B
Tx:UBR,Peak 0,Avg 0,MaxSdu 1516
Rx:UBR,Peak 16953936,Avg 16953936,MaxSdu 1516
Out P-P SVC 0/192 47000580FFE1000000F21A2E180020481A2E180B
Tx:UBR,Peak 16953936,Avg 16953936,MaxSdu 1516
Rx:UBR,Peak 16953936,Avg 16953936,MaxSdu 1516
In PMP SVC 0/191 47000580FFE1000000F21A2E180020481A2E180B
Tx:UBR,Peak 0,Avg 0,MaxSdu 1516
Rx:UBR,Peak 16953936,Avg 16953936,MaxSdu 1516
Out P-P SVC 0/190 47000580FFE1000000F21A2E180020481A2E180B
Tx:UBR,Peak 16953936,Avg 16953936,MaxSdu 1516
Rx:UBR,Peak 16953936,Avg 16953936,MaxSdu 1516
In P-P SVC 0/475 47000580FFE1000000F21A2E180000C110081501
Tx:UBR,Peak 16953984,Avg 16953984,MaxSdu 9188
Rx:UBR,Peak 16953936,Avg 16953936,MaxSdu 9188
Out PMP SVC 0/194 47000580FFE1000000F21A2E180000C110081501 (0)
Tx:UBR,Peak 16953984,Avg 16953984,MaxSdu 9180
Rx:UBR,Peak 0,Avg 0,MaxSdu 0
Out P-P SVC 0/474 4700918100000000613E5BFE010000C110081500
Tx:UBR,Peak 16953984,Avg 16953984,MaxSdu 9188
Rx:UBR,Peak 16953984,Avg 16953984,MaxSdu 9188
In PMP SVC 0/195 47000580FFE1000000F21A2E180000C110081500
Tx:UBR,Peak 0,Avg 0,MaxSdu 0
Rx:UBR,Peak 16953936,Avg 16953936,MaxSdu 9180

A tabela a seguir contém as descrições de cada elemento na saída de exemplo do


atmadm /c.

Tipo de dados Tela de Exibição Descrição

Informações de Entrada/saída Direção da chamada.


Conexão In é de outro
dispositivo para o
adaptador de rede
atM. Out é do
adaptador de rede
atM para outro
dispositivo.

PMP Chamada ponto a multiponto.

P-P Chamada ponto a ponto.

SVC A conexão está em um circuito virtual comutado.

PVC A conexão está em um circuito virtual


permanente.
Tipo de dados Tela de Exibição Descrição

Informações de VPI/VCI Caminho virtual e


VPI/VCI canal virtual da
chamada de entrada
ou saída.

Parâmetros de 47000580FFE1000000F21A2E180000C110081500 Endereço NSAP do


mídia/endereço dispositivo atM de
remoto chamada (In) ou
(Out).

Tx O parâmetro Tx inclui os três elementos a seguir:


Tipo de taxa de bits padrão ou especificada
(UBR, CBR, VBR ou ABR)
Velocidade de linha padrão ou especificada
Tamanho da SDU (unidade de dados de
serviço) especificada.

Rx O parâmetro Rx inclui os três elementos a


seguir:
Tipo de taxa de bits padrão ou especificada
(UBR, CBR, VBR ou ABR)
Velocidade de linha padrão ou especificada
Tamanho da SDU especificada.

O comando atmadm /a produz um resultado semelhante ao seguinte:

Windows atM call Manager Statistics


atM addresses for Interface : [009] Olicom atM PCI 155 Adapter
47000580FFE1000000F21A2E180000C110081500

O comando atmadm /s produz um resultado semelhante ao seguinte:

Windows atM call Manager Statistics


atM call Manager statistics for Interface : [009] Olicom atM PCI 155
Adapter
Current active calls = 4
Total successful Incoming calls = 1332
Total successful Outgoing calls = 1297
Unsuccessful Incoming calls = 1
Unsuccessful Outgoing calls = 1
calls Closed by remote = 1302
calls Closed Locally = 1323
Signaling and ILMI Packets Sent = 33655
Signaling and ILMI Packets Received = 34989
A tabela a seguir contém as descrições de cada elemento na saída de exemplo do
atmadm /s.

Estatística do Descrição
Gerenciador de
Chamadas

Chamadas ativas Chamadas ativas atualmente no adaptador atM instalado neste


atuais computador.

Total de chamadas Chamadas recebidas com êxito de outros dispositivos nesta rede atM.
recebidas com
êxito

Total de chamadas Chamadas concluídas com êxito para outros dispositivos atM nesta
efetuadas com rede deste computador.
êxito

Total de chamadas Chamadas recebidas que não se conectaram com este computador.
recebidas com
falha

Total de chamadas Chamadas efetuadas que não se conectaram com outro dispositivo na
efetuadas com rede.
falha

Chamadas Chamadas encerradas por um dispositivo remoto na rede.


encerradas
remotamente

Chamadas Chamadas encerradas por este computador.


encerradas
localmente

Sinalização e Número de pacotes ILMI (interface de gerenciamento local integrada)


pacotes ILMI enviados para o comutador ao qual este computador está tentando se
enviados conectar.

Sinalização e Número de pacotes ILMI recebidos da opção atM.


pacotes ILMI
recebidos

Exemplos
Para exibir as informações de chamada de todas as conexões atuais com o adaptador de
rede atM instalado neste computador, digite:
atmadm /c

Para exibir o endereço do NSAP (ponto de acesso ao serviço de rede) registrado para
cada adaptador instalado neste computador, digite:

atmadm /a

Para exibir as estatísticas para monitorar o status de conexões atM ativas, digite:

atmadm /s

Links relacionados
Chave da sintaxe de linha de comando
attach vdisk
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Anexa (às vezes chamado de montagens ou superfícies) um VHD (disco rígido virtual)
para que ele apareça no computador host como uma unidade de disco rígido local. Se o
VHD já tiver uma partição de disco e um volume de sistema de arquivos quando você
anexá-lo, o volume interno do VHD será atribuído a uma letra de unidade

) Importante

Escolha e desanexe um VHD para que essa operação seja bem-sucedida. Use o
comando select vdisk para selecionar um VHD e mudar o foco para ele.

Sintaxe

attach vdisk [readonly] { [sd=<SDDL>] | [usefilesd] } [noerr]

Parâmetros

Parâmetro Descrição

readonly Anexa o VHD como somente leitura. Qualquer operação de gravação retorna um
erro.
Parâmetro Descrição

sd=<SDDL Define o filtro do usuário no VHD. A cadeia de caracteres de filtro deve estar no
string> formato SDDL (Linguagem de Definição de Descritor de Segurança). Por padrão, o
filtro de usuário permite acesso como em um disco físico. As cadeias de caracteres
da SDDL podem ser complexas, mas em sua forma mais simples, um descritor de
segurança que protege o acesso é conhecido como uma DACL (lista de controle de
acesso discricionário). Ele usa a forma: D:<dacl_flags><string_ace1><string_ace2> ...
<string_acen>

Os sinalizadores da DACL comuns são:

A. Permitir o acesso
D. Negar acesso

Os direitos comuns são:

GA. Todo o acesso


GR. Acesso de leitura
GW. Acesso de gravação

As contas de usuário comuns são:

BA. Administradores internos


AU. usuários autenticados
CO. Criador proprietário
WD. Todos

Exemplos:

D:P:(A;;GR;;;AU. Fornece acesso de leitura a todos os usuários autenticados.


D:P:(A;;GA;;;WD. Dá acesso completo a todos.

usefilesd Especifica que o descritor de segurança no arquivo .vhd deve ser usado no VHD. Se
o parâmetro Usefilesd não for especificado, o VHD não terá um descritor de
segurança explícito, a menos que seja especificado com o parâmetro Sd.

noerr Usado somente para scripts. Quando um erro é encontrado, o DiskPart continua a
processar os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro,
um erro faz com que o DiskPart saia com um código de erro.

Exemplos
Para anexar o VHD selecionado como somente leitura, digite:

attach vdisk readonly


Links relacionados
Chave da sintaxe de linha de comando

select vdisk

compact vdisk

detail vdisk

detach vdisk

expand vdisk

merge vdisk

list
attrib
Artigo • 17/04/2023

Exibe, define ou remove atributos atribuídos a arquivos ou diretórios. Se usado sem


parâmetros, attrib exibirá atributos de todos os arquivos no diretório atual.

Sintaxe

attrib [{+|-}r] [{+|-}a] [{+|-}s] [{+|-}h] [{+|-}i] [<drive>:][<path>]


[<filename>] [/s [/d] [/l]]

Parâmetros

Parâmetro Descrição

{+|-}r Define (+) ou limpa (-) o atributo de arquivo Somente leitura.

{+\|-}a Define (+) ou limpa (-) o atributo de arquivo Arquivo morto. Esse conjunto de
atributos marca os arquivos que foram alterados desde a última vez em que foram
submetidos ao backup. Observe que o comando xcopy usa atributos de arquivo
morto.

{+\|-}s Define (+) ou limpa (-) o atributo Arquivo do sistema. Se um arquivo usar esse
conjunto de atributos, você deverá limpar o atributo antes de alterar outros
atributos para o arquivo.

{+\|-}h Define (+) ou limpa (-) o atributo Arquivo oculto. Se um arquivo usar esse
conjunto de atributos, você deverá limpar o atributo antes de alterar outros
atributos para o arquivo.

{+\|-}i Define (+) ou limpa (-) o atributo de arquivo Não indexado por conteúdo.

[<drive>:] Especifica o local e o nome do diretório, arquivo ou grupo de arquivos para os


[<path>] quais você deseja exibir ou alterar atributos.
[<filename>] Você pode usar os caracteres curinga ? e * no parâmetro filename para exibir ou
alterar os atributos de um grupo de arquivos.

/s Aplica attrib e qualquer opção de linha de comando a arquivos correspondentes


no diretório atual e em todos os subdiretórios.

/d Aplica attrib e quaisquer opções de linha de comando a diretórios.


Parâmetro Descrição

/l Aplica attrib e qualquer opção de linha de comando ao Link Simbólico, em vez do


destino do Link Simbólico.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para exibir os atributos de um arquivo chamado News86 localizado no diretório atual,
digite:

attrib news86

Para atribuir o atributo Somente leitura ao arquivo chamado report.txt, digite:

attrib +r report.txt

Para remover o atributo Somente leitura de arquivos no diretório público e seus


subdiretórios em um disco na unidade b:, digite:

attrib -r b:\public\*.* /s

Para definir o atributo Arquivo morto para todos os arquivos na unidade a:e, em
seguida, desmarque o atributo Archive para arquivos com a extensão .bak, digite:

attrib +a a:*.* & attrib -a a:*.bak

Links relacionados
Chave da sintaxe de linha de comando

Comando xcopy
Atributos
Artigo • 12/04/2023

Exibe, define ou limpa os atributos de um disco ou volume.

Sintaxe

attributes disk
attributes volume

Parâmetros

Parâmetro Descrição

attributes disk Exibe, define ou limpa os atributos de um disco.

attributes volume Exibe, define ou limpa os atributos de um volume.

Links relacionados
Chave da sintaxe de linha de comando
attributes disk
Artigo • 12/04/2023

Exibe, define ou limpa os atributos de um disco. Quando esse comando é usado para
exibir os atributos atuais de um disco, o atributo de disco de inicialização denota o
disco usado para iniciar o computador. Para um espelho dinâmico, ele exibe o disco que
contém o plex de inicialização do volume de inicialização.

) Importante

Um disco deve ser selecionado para que o comando attributes disk tenha êxito.
Use o comando select disk para selecionar um disco e mudar o foco para ele.

Sintaxe

attributes disk [{set | clear}] [readonly] [noerr]

Parâmetros

Parâmetro Descrição

set Define o atributo especificado do disco com foco.

clear Limpa o atributo especificado do disco com foco.

readonly Especifica que o disco é somente leitura.

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Exemplos
Para exibir os atributos do disco selecionado, digite:

attributes disk
Para definir o disco selecionado como somente leitura, digite:

attributes disk set readonly

Links relacionados
Chave da sintaxe de linha de comando

comando select disk


attributes volume
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe, define ou limpa os atributos de um volume.

Sintaxe

attributes volume [{set | clear}] [{hidden | readonly | nodefaultdriveletter


| shadowcopy}] [noerr]

Parâmetros

Parâmetro Descrição

set Define o atributo especificado do volume com foco.

clear Limpa o atributo especificado do volume com foco.

readonly Especifica que o volume é somente leitura.

oculto Especifica que o volume está oculto.

nodefaultdriveletter Especifica que o volume não recebe uma letra da unidade por padrão.

shadowcopy Especifica que o volume é um volume de cópia de sombra.

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a


processar os comandos como se o erro não tivesse ocorrido. Sem esse
parâmetro, um erro faz com que o DiskPart saia com um código de erro.

Comentários
Em discos básicos de MBR (registro mestre de inicialização), os parâmetros hidden,
readonly e nodefaultdriveletter se aplicam a todos os volumes no disco.

Em discos básicos de GUID (tabela de partição de GUID) e em discos dinâmicos de


MBR e GPT, os parâmetros hidden, readonly e nodefaultdriveletter se aplicam
apenas ao volume selecionado.

Um volume deve ser selecionado para que o comando de attributes volume tenha
êxito. Use o comando select volume para selecionar um volume e mudar o foco
para ele.

Exemplos
Para exibir os atributos atuais no volume selecionado, digite:

attributes volume

Para definir o volume selecionado como oculto e somente leitura, digite:

attributes volume set hidden readonly

Para remover os atributos oculto e somente leitura no volume selecionado, digite:

attributes volume clear hidden readonly

Links relacionados
Chave da sintaxe de linha de comando

comando select volume


auditpol
Artigo • 12/04/2023

Exibe informações sobre e executa funções para manipular as políticas de auditoria,


incluindo:

Configurar e consultar uma política de auditoria do sistema.

Configurar e consultar uma política de auditoria por usuário.

Definir e consultar opções de auditoria.

Configurar e consultar o descritor de segurança usado para delegar acesso a uma


política de auditoria.

Relatar ou fazer backup de uma política de auditoria para um arquivo de texto CSV
(valor separado por vírgula).

Carregar uma política de auditoria de um arquivo de texto CSV.

Configurar as SACLs de recursos globais.

Sintaxe

auditpol command [<sub-command><options>]

Parâmetros

Subcomando Descrição

/get Exibe a política de auditoria atual. Para obter mais informações, consulte obter a
auditpol para obter sintaxe e opções.

/set Define a política de auditoria. Para obter mais informações, consulte definir a
auditpol para obter sintaxe e opções.

/list Exibe elementos de política selecionáveis. Para obter mais informações, consulte
lista da auditpol para obter sintaxe e opções.

/backup Salva a política de auditoria em um arquivo. Para obter mais informações,


consulte backup da auditpol para obter sintaxe e opções.
Subcomando Descrição

/restaurar Restaura a política de auditoria de um arquivo que foi criado anteriormente


usando auditpol /backup. Para obter mais informações, consulte restaurar a
auditpol para obter sintaxe e opções.

/limpar Limpa a política de auditoria. Para obter mais informações, consulte limpar a
auditpol para obter sintaxe e opções.

/remove Remove todas as configurações de política de auditoria por usuário e desabilita


todas as configurações de política de auditoria do sistema. Para obter mais
informações, consulte remover a auditpol para obter sintaxe e opções.

/resourceSACL Configura as SACLs (listas globais de controle de acesso do sistema de recursos).


Observação: aplica-se somente ao Windows 7 e ao Windows Server 2008 R2.
Para obter mais informações, consulte auditpol resourceSACL.

/? Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
auditpol backup
Artigo • 30/05/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

O comando auditpol backup faz backup das configurações de política de auditoria do


sistema, das configurações de política de auditoria por usuário para todos os usuários e
todas as opções de auditoria para um arquivo de texto CSV.

Para executar operações de backup nas políticas de sistema e por usuário, você precisa
obter permissões de Gravação ou Controle Total para esse objeto definido no descritor
de segurança. Você também poderá executar operações de backup se tiver o direito de
uso para Gerenciar log de auditoria e segurança (SeSecurityPrivilege). No entanto, esse
direito permite o acesso que não é necessário para executar as operações gerais de
backup.

Sintaxe

auditpol /backup /file:<filename>

Parâmetros

Parâmetro Descrição

/file Especifica o nome do arquivo do para o backup.

/? Exibe a ajuda no prompt de comando.

Exemplos
Você pode fazer o backup das seguintes configurações em um arquivo de texto
formatado por CSV:

Configurações de política de auditoria por usuário para todos os usuários


Configurações de política de auditoria do sistema
Todas as opções de auditoria
Para fazer backup dessas configurações em um arquivo chamado auditpolicy.csv, digite
o seguinte comando:

auditpol /backup /file:C:\auditpolicy.csv

7 Observação

Se nenhuma unidade for especificada, o diretório atual será usado.

Links relacionados
Chave da sintaxe de linha de comando

auditpol restore

Comandos auditpol
auditpol clear
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exclui a política de auditoria por usuário para todos os usuários, redefine (desabilita) a
política de auditoria do sistema para todas as subcategorias e define todas as opções de
auditoria como desabilitadas.

Para executar operações de limpeza nas políticas de sistema e por usuário, você precisa
obter permissão de Gravação ou Controle Total para esse objeto definida no descritor
de segurança. Você também poderá executar operações de limpeza se tiver o direito de
usuário para Gerenciar logs de auditoria e segurança (SeSecurityPrivilege). No entanto,
esse direito permite acesso adicional que não é necessário para executar as operações
de limpeza gerais.

Sintaxe

auditpol /clear [/y]

Parâmetros

Parâmetro Descrição

/y Suprime o prompt para confirmar se todas as configurações de política de auditoria


devem ser limpas.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para excluir a política de auditoria por usuário para todos os usuários, redefina
(desabilite) a política de auditoria do sistema para todas as subcategorias e defina todas
as configurações da política de auditoria como desabilitadas, em um prompt de
confirmação, digite:
auditpol /clear

Para excluir a política de auditoria por usuário para todos os usuários, redefina as
configurações da política de auditoria do sistema para todas as subcategorias e defina
todas as configurações de política de auditoria como desabilitadas, sem um prompt de
confirmação, digite:

auditpol /clear /y

7 Observação

O exemplo anterior é útil ao usar um script para executar essa operação.

Links relacionados
Chave da sintaxe de linha de comando

Comandos auditpol
auditpol get
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server, 2019,
Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Recupera a política do sistema, a política por usuário, as opções de auditoria e o objeto


descritor de segurança de auditoria.

Para executar operações de obtenção nas políticas por usuário e de sistema, você deve
ter permissão de Leitura para esse objeto definido no descritor de segurança. Você
também poderá executar operações de obtenção se tiver o direito de uso para
Gerenciar log de auditoria e segurança (SeSecurityPrivilege). No entanto, esse direito
permite acesso adicional que não é necessário para executar as operações de obtenção
gerais.

Sintaxe

auditpol /get
[/user[:<username>|<{sid}>]]
[/category:*|<name>|<{guid}>[,:<name|<{guid}> ]]
[/subcategory:*|<name>|<{guid}>[,:<name|<{guid}> ]]
[/option:<option name>]
[/sd]
[/r]

Parâmetros

Parâmetro Descrição

/user Exibe a entidade de segurança para a qual a política de auditoria por usuário é
consultada. O parâmetro /category ou /subcategory deve ser especificado. O
usuário pode ser especificado como um SID (identificador de segurança) ou
nome. Se nenhuma conta de usuário for especificada, a política de auditoria do
sistema será consultada.

/category Uma ou mais categorias de auditoria especificadas pelo GUID (identificador


global exclusivo) ou pelo nome. Um asterisco (*) pode ser usado para indicar que
todas as categorias de auditoria devem ser consultadas.
Parâmetro Descrição

/subcategoria Uma ou mais subcategorias de auditoria especificadas por GUID ou nome.

/sd Recupera o descritor de segurança usado para delegar acesso à política de


auditoria.

/option Recupera a política existente para as opções CrashOnAuditFail,


FullprivilegeAuditing, AuditBaseObjects ou AuditBasedirectories.

/r Exibe a saída no formato de relatório, CSV (valor separado por vírgula).

/? Exibe a ajuda no prompt de comando.

Comentários
Todas as categorias e subcategorias podem ser especificadas pelo GUID ou pelo nome
entre aspas (“). Os usuários podem ser especificados por SID ou nome.

Exemplos
Para recuperar a política de auditoria por usuário para a conta Convidado e exibir a
saída para as categorias Sistema, Acompanhamento detalhado e Acesso a Objetos,
digite:

auditpol /get /user:{S-1-5-21-1443922412-3030960370-963420232-51}


/category:System,detailed Tracking,Object Access

7 Observação

Esse comando é útil em dois cenários. 1) Ao monitorar uma conta de usuário


específica para atividades suspeitas, você pode usar o comando /get para
recuperar os resultados em categorias específicas usando uma política de inclusão
para habilitar a auditoria adicional. 2) Se as configurações de auditoria em uma
conta estiverem registrando vários eventos, mas supérfluos, você poderá usar o
comando /get para filtrar eventos desnecessários para essa conta com uma
política de exclusão. Para obter uma lista de todas as categorias, use o comando
auditpol /list /category .
Para recuperar a política de auditoria por usuário para uma categoria e uma
subcategoria específica, que relata as configurações inclusivas e exclusivas dessa
subcategoria na categoria Sistema da conta Convidado, digite:

auditpol /get /user:guest /category:System /subcategory:{0ccee921a-69ae-


11d9-bed3-505054503030}

Para exibir a saída no formato de relatório e incluir o nome do computador, o destino


da política, a subcategoria, o GUID da subcategoria, as configurações de inclusão e as
configurações de exclusão, digite:

auditpol /get /user:guest /category:detailed Tracking /r

Para recuperar a política para a categoria e as subcategorias do Sistema, que relata as


configurações de política de categoria e subcategoria para a política de auditoria do
sistema, digite:

auditpol /get /category:System /subcategory:{0ccee921a-69ae-11d9-bed3-


505054503030}

Para recuperar a política para a categoria e as subcategorias de Acompanhamento


detalhado no formato de relatório e incluir o nome do computador, o destino da
política, a subcategoria, o GUID da subcategoria, as configurações de inclusão e as
configurações de exclusão, digite:

auditpol /get /category:detailed Tracking /r

Para recuperar a política para duas categorias com as categorias especificadas como
GUIDs, que relata todas as configurações de política de auditoria de todas as
subcategorias em duas categorias, digite:

auditpol /get /category:{69979849-797a-11d9-bed3-505054503030},{69997984a-


797a-11d9-bed3-505054503030} subcategory:{0ccee921a-69ae-11d9-bed3-
505054503030}
Para recuperar o estado, habilitado ou desabilitado, da opção AuditBaseObjects, digite:

auditpol /get /option:AuditBaseObjects

Em que as opções disponíveis são AuditBaseObjects, AuditBaseOperations e


FullprivilegeAuditing. Para recuperar o estado habilitado, desabilitado ou 2 da opção
CrashOnAuditFail, digite:

auditpol /get /option:CrashOnAuditFail /r

Links relacionados
Chave da sintaxe de linha de comando

comandos auditpol
auditpol list
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Lista categorias e subcategorias de política de auditoria ou lista os usuários para os


quais uma política de auditoria por usuário é definida.

Para executar operações de lista na política por usuário, você deve ter permissão de
Leitura para esse objeto definida no descritor de segurança. Você também poderá
executar operações de lista se tiver o direito de uso para Gerenciar log de auditoria e
segurança (SeSecurityPrivilege). No entanto, esse direito permite acesso adicional que
não é necessário para executar as operações de lista geral.

Sintaxe

auditpol /list
[/user|/category|subcategory[:<categoryname>|<{guid}>|*]]
[/v] [/r]

Parâmetros

Parâmetro Descrição

/user Recupera todos os usuários para os quais a política de auditoria por usuário foi
definida. Se usado com o parâmetro /v, o SID (identificador de segurança) do
usuário também será exibido.

/category Exibe os nomes das categorias compreendidas pelo sistema. Se usado com o
parâmetro /v, o GUID (identificador global exclusivo) da categoria também será
exibido.

/subcategory Exibe os nomes das subcategorias e o GUID associado.

/v Exibe o GUID com a categoria ou subcategoria ou, quando usado com /user,
exibe o SID de cada usuário.

/r Exibe a saída como um relatório no formato CSV (valor separado por vírgula).

/? Exibe a ajuda no prompt de comando.


Exemplos
Para listar todos os usuários que têm uma política de auditoria definida, digite:

auditpol /list /user

Para listar todos os usuários que têm uma política de auditoria definida e o SID
associado, digite:

auditpol /list /user /v

Para listar todas as categorias e subcategorias no formato de relatório, digite:

auditpol /list /subcategory:* /r

Para listar as subcategorias das categorias detalhadas Acompanhamento e Acesso ao


DS, digite:

auditpol /list /subcategory:detailed Tracking,DS Access

Links relacionados
Chave da sintaxe de linha de comando

Comandos auditpol
auditpol remove
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

O comando auditpol remove faz a remoção da política de auditoria por usuário de uma
conta especificada ou de todas as contas.

Para executar operações de remoção na política por usuário, você deve obter permissões
de Gravação ou Controle Total para esse objeto definido no descritor de segurança.
Você também poderá executar operações de remoção se tiver o direito de uso de
Gerenciar log de auditoria e segurança ( SeSecurityPrivilege ). No entanto, esse direito
permite o acesso que não é necessário para executar as operações gerais de remoção.

Sintaxe

auditpol /remove [/user[:<username>|<{SID}>]]


[/allusers]

Parâmetros

Parâmetro Descrição

/user Especifica o SID (identificador de segurança) ou o nome de usuário do usuário para


o qual a política de auditoria por usuário deve ser excluída.

/allusers Remove a política de auditoria por usuário de todos os usuários.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para remover a política de auditoria por usuário do usuário mikedan por nome, digite:

auditpol /remove /user:mikedan


Para remover a política de auditoria por usuário do usuário mikedan por SID, digite:

auditpol /remove /user:{S-1-5-21-397123471-12346959}

Remove a política de auditoria por usuário de todos os usuários, digite:

auditpol /remove /allusers

Links relacionados
Chave da sintaxe de linha de comando

Comandos auditpol
auditpol resourceSACL
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 7 and Windows
Server 2008 R2

Configura as SACLs (listas globais de controle de acesso do sistema de recursos).

Para executar as operações resourceSACL, você deve ter permissões de Gravação ou


Controle Total para esse objeto no descritor de segurança. Você também poderá
executar operações de resourceSACL se tiver o direito de usuário para Gerenciar log de
auditoria e segurança (SeSecurityPrivilege).

Sintaxe

auditpol /resourceSACL
[/set /type:<resource> [/success] [/failure] /user:<user> [/access:<access
flags>]]
[/remove /type:<resource> /user:<user> [/type:<resource>]]
[/clear [/type:<resource>]]
[/view [/user:<user>] [/type:<resource>]]

Parâmetros

Parâmetro Descrição

/set Adiciona uma nova entrada ou atualiza uma entrada existente no SACL de recurso
para o tipo de recurso especificado.

/remove Remove todas as entradas para o usuário especificado na lista global de auditoria
de acesso a objetos.

/clear Remove todas as entradas da lista global de auditoria de acesso a objetos.

/view Lista as entradas de auditoria de acesso de objeto global em uma SACL de recurso.
Os tipos de usuário e de recurso são opcionais.

/? Exibe a ajuda no prompt de comando.

Argumentos
Argumento Descrição

/type O recurso para o qual a auditoria de acesso ao objeto está sendo configurada. Os
valores de argumento compatíveis, que diferenciam maiúsculas de minúsculas, são
Arquivo (para diretórios e arquivos) e Chave (para chaves do registro).

/success Especifica a auditoria com êxito.

/failure Especifica a auditoria de falhas.

/user Especifica um usuário em um dos seguintes formulários:


DomainName\Account (como DOM\Administrators)
StandaloneServer\Group Account (confira a função LookupAccountName)
{S-1-x-x-x-x} (x é expresso em decimal e todo o SID deve estar entre chaves).
Por exemplo: {S-1-5-21-5624481-130208933-164394174-1001}
Observação: se o formulário SID for usado, nenhuma verificação será feita
para conferir a existência dessa conta.

/access Especifica uma máscara de permissão que pode ser especificada por meio de:
Direitos de acesso genéricos, incluindo:

GA – GENERIC ALL
GR – GENERIC READ
GW – GENERIC WRITE
GX – GENERIC EXECUTE

Direitos de acesso para arquivos, incluindo:

FA – ARQUIVO DE ACESSO TOTAL


FR – LEITURA GENÉRICA DE ARQUIVO
FW – GRAVAÇÃO GENÉRICA DE ARQUIVO
FX – ARQUIVO DE EXECUÇÃO GENÉRICA

Direitos de acesso para chaves do registro, incluindo:

KA – CHAVE DE ACESSO TOTAL


KR – LEITURA DA CHAVE
KW – GRAVAÇÃO DE CHAVE
KX – CHAVE DE EXECUÇÃO

Por exemplo: /access:FRFW habilita eventos de auditoria para operações de leitura


e gravação.

Um valor hexadecimal que representa a máscara de acesso (como 0x1200a9)

Isso é útil ao usar máscaras de bits específicas do recurso que não fazem parte do
padrão SDDL (linguagem de definição de descritor de segurança). Se omitido, o
acesso completo será usado.
Exemplos
Para definir um SACL de recurso global para auditar tentativas de acesso bem-sucedidas
por um usuário em uma chave do registro:

auditpol /resourceSACL /set /type:Key /user:MYDOMAIN\myuser /success

Para definir um SACL de recurso global para auditar tentativas bem-sucedidas e com
falha de um usuário para executar funções genéricas de leitura e gravação em arquivos
ou pastas:

auditpol /resourceSACL /set /type:File /user:MYDOMAIN\myuser /success


/failure /access:FRFW

Para remover todas as entradas SACL de recursos globais para arquivos ou pastas:

auditpol /resourceSACL /type:File /clear

Para remover todas as entradas SACL de recursos globais para um usuário específico de
arquivos ou pastas:

auditpol /resourceSACL /remove /type:File /user:{S-1-5-21-56248481-


1302087933-1644394174-1001}

Para listar as entradas de auditoria de acesso ao objeto global definidas em arquivos ou


pastas:

auditpol /resourceSACL /type:File /view

Para listar as entradas de auditoria de acesso de objeto global para um usuário


específico definido em arquivos ou pastas:
auditpol /resourceSACL /type:File /view /user:MYDOMAIN\myuser

Links relacionados
Chave da sintaxe de linha de comando

comandos auditpol
auditpol restore
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Restaura as configurações de política de auditoria do sistema, as configurações de


política de auditoria por usuário para todos os usuários e todas as opções de auditoria
de um arquivo sintaticamente consistente com o formato de arquivo CSV (arquivo de
valores separados por vírgula) usado pela opção /backup.

Para executar operações de restauração nas políticas de sistema e por usuário, você
precisa obter permissão de Gravação ou Controle Total para esse objeto definida no
descritor de segurança. Você também poderá executar operações de restauração, se
tiver o direito de usuário de Gerenciar log de auditoria e segurança
(SeSecurityPrivilege), o que é útil ao restaurar o descritor de segurança em caso de erro
ou ataque mal-intencionado.

Sintaxe

auditpol /restore /file:<filename>

Parâmetros

Parâmetro Descrição

/file Especifica o arquivo no qual a política de auditoria deve ser restaurada. O arquivo
deve ter sido criado usando a opção /backup ou deve ser sintaticamente
consistente com o formato de arquivo CSV usado pela opção /backup.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para restaurar as configurações de política de auditoria do sistema, as configurações de
política de auditoria por usuário para todos os usuários e todas as opções de auditoria
de um arquivo chamado auditpolicy.csv que foi criado usando o comando /backup,
digite:

auditpol /restore /file:c:\auditpolicy.csv

Links relacionados
Chave da sintaxe de linha de comando

auditpol backup

comandos auditpol
auditpol set
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Define a política de auditoria por usuário, a política de auditoria do sistema ou as


opções de auditoria.

Para executar operações de definir nas políticas de sistema e por usuário, obtenha
permissão de Gravação ou Controle Total para esse objeto definido no descritor de
segurança. Você também poderá executar operações de definir se tiver o direito de uso
para Gerenciar log de auditoria e segurança (SeSecurityPrivilege). No entanto, esse
direito permite acesso adicional que não é necessário para executar as operações de
configuração geral.

Sintaxe

auditpol /set
[/user[:<username>|<{sid}>][/include][/exclude]]
[/category:<name>|<{guid}>[,:<name|<{guid}> ]]
[/success:<enable>|<disable>][/failure:<enable>|<disable>]
[/subcategory:<name>|<{guid}>[,:<name|<{guid}> ]]
[/success:<enable>|<disable>][/failure:<enable>|<disable>]
[/option:<option name> /value: <enable>|<disable>]

Parâmetros

Parâmetro Descrição

/usuário A entidade de segurança para a qual a política de auditoria por usuário


especificada pela categoria ou subcategoria está definida. A opção categoria ou
subcategoria deve ser especificada, como um SID (identificador de segurança) ou
um nome.

/incluir Especificado com /usuário; indica que a política por usuário do usuário fará com
que uma auditoria seja gerada mesmo que não seja especificada pela política de
auditoria do sistema. Essa configuração é o padrão e é aplicada automaticamente
se nem os parâmetros /incluir nem /excluir forem especificados explicitamente.
Parâmetro Descrição

/excluir Especificado com /usuário; indica que a política por usuário do usuário fará com
que uma auditoria seja suprimida independentemente da política de auditoria do
sistema. Essa configuração é ignorada para usuários que são membros do grupo
Administradores local.

/category Uma ou mais categorias de auditoria especificadas pelo GUID (identificador


global exclusivo) ou pelo nome. Se nenhum usuário for especificado, a política do
sistema será definida.

/subcategoria Uma ou mais subcategorias de auditoria especificadas por GUID ou nome. Se


nenhum usuário for especificado, a política do sistema será definida.

/êxito Especifica a auditoria com êxito. Essa configuração é o padrão e é aplicada


automaticamente se nem os parâmetros /êxito nem /falha forem especificados
explicitamente. Essa configuração deve ser usada com um parâmetro que indica
se deseja habilitar ou desabilitar a configuração.

/falha Especifica a auditoria de falhas. Essa configuração deve ser usada com um
parâmetro que indica se deseja habilitar ou desabilitar a configuração.

/opção Define a política de auditoria para as opções CrashOnAuditFail,


FullprivilegeAuditing, AuditBaseObjects ou AuditBasedirectories.

/sd Define o descritor de segurança usado para delegar acesso à política de


auditoria. O descritor de segurança deve ser especificado usando o SDDL
(Security Descriptor Definition Language). O descritor de segurança deve ter uma
DACL (lista de controle de acesso discricionário).

/? Exibe a ajuda no prompt de comando.

Exemplos
Para definir a política de auditoria por usuário para todas as subcategorias na categoria
Controle detalhado do usuário mikedan para que todas as tentativas com êxito do
usuário sejam auditadas, digite:

auditpol /set /user:mikedan /category:detailed Tracking /include


/success:enable

Para definir a política de auditoria por usuário para categorias especificadas por nome e
GUID e subcategorias especificadas pelo GUID para suprimir a auditoria para qualquer
tentativa com êxito ou com falha, digite:
auditpol /set /user:mikedan /exclude /category:Object Access,System,
{6997984b-797a-11d9-bed3-505054503030}
/subcategory:{0ccee9210-69ae-11d9-bed3-505054503030},:{0ccee9211-69ae-11d9-
bed3-505054503030}, /success:enable /failure:enable

Para definir a política de auditoria por usuário para o usuário especificado para todas as
categorias para a supressão da auditoria de todas as tentativas, mas com êxito, digite:

auditpol /set /user:mikedan /exclude /category:* /success:enable

Para definir a política de auditoria do sistema para todas as subcategorias na categoria


Controle detalhado para incluir a auditoria apenas para tentativas com êxito, digite:

auditpol /set /category:detailed Tracking /success:enable

7 Observação

A configuração de falha não é alterada.

Para definir a política de auditoria do sistema para as categorias Acesso a Objetos e


Sistema (o que está implícito porque as subcategorias estão listadas) e as subcategorias
especificadas pelos GUIDs para a supressão de tentativas com falha e a auditoria de
tentativas com êxito, digite:

auditpol /set /subcategory:{0ccee9210-69ae-11d9-bed3-505054503030},


{0ccee9211-69ae-11d9-bed3-505054503030}, /failure:disable /success:enable

Para definir as opções de auditoria para o estado habilitado para a opção


CrashOnAuditFail, digite:

auditpol /set /option:CrashOnAuditFail /value:enable


Links relacionados
Chave da sintaxe de linha de comando

Comandos auditpol
autochk
Artigo • 17/04/2023

Será executado quando o computador for iniciado e antes de o Windows Server


começar a verificar a integridade lógica de um sistema de arquivos.

O autochk.exe é uma versão do chkdsk executada somente em discos NTFS e somente


antes de o Windows Server ser iniciado. O autochk não pode ser executado diretamente
a partir da linha de comando. Em vez disso, o autochk é executado nas seguintes
situações:

Se você tentar executar o chkdsk no volume de inicialização.

Se o chkdsk não puder obter o uso exclusivo do volume.

Se o volume estiver sinalizado como sujo.

Comentários

2 Aviso

A ferramenta de linha de comando autochk não pode ser executada diretamente


na linha de comando. Em vez disso, use a ferramenta de linha de comando chkntfs
para configurar a maneira como você deseja que o autochk seja executado na
inicialização.

Você pode usar o chkntfs com o parâmetro /x para impedir que o autochk
seja executado em um volume específico ou em vários volumes.

Use a ferramenta de linha de comando chkntfs.exe com o parâmetro /t para


alterar o atraso do autochk de 0 segundo para até 3 dias (259.200 segundos).
No entanto, um longo atraso significa que o computador não será iniciado
até que o tempo se desfaça ou até que você pressione uma tecla para
cancelar o autochk.

Links relacionados
Chave da sintaxe de linha de comando

Comando chkdsk
Comando chkntfs
autoconv
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Converte volumes Fat (tabela de alocação de arquivos) e Fat32 no sistema de arquivos


NTFS, deixando os arquivos e diretórios existentes intactos na inicialização, após
executar o autochk. os volumes convertidos no sistema de arquivos NTFS não podem
ser convertidos novamente em Fat ou Fat32.

) Importante

Não é possível executar o autoconv na linha de comando. Ele só poderá ser


executado na inicialização, se definido por meio do convert.exe.

Links relacionados
Chave da sintaxe de linha de comando

comando autochk

comando convert
autofmt
Artigo • 12/04/2023

Inicia o Utilitário de Formato do Sistema de Arquivos Automático, que formata uma


unidade ou partição quando chamado do Console de Recuperação do Windows.

) Importante

Não é possível executar o autofmt diretamente na linha de comando.

Links relacionados
Chave da sintaxe de linha de comando

WinRE (Ambiente de Recuperação do Windows)

Como usar o Ambiente de Recuperação do Windows (WinRE) para solucionar


problemas comuns de inicialização
montagem automática
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Chave da sintaxe de linha de comando

) Importante

Nas configurações de SAN (rede de área de armazenamento), desabilitar a


montagem automática impede que o Windows acione ou atribua automaticamente
as letras da unidade a novos volumes básicos visíveis ao sistema.

Syntax
automount [ { enable | disable | scrub } ] [noerr]

Parâmetros

Parâmetro Descrição

enable Permite que o Windows monte automaticamente novos volumes básicos e


dinâmicos adicionados ao sistema e atribua a eles as letras da unidade.

disable Impede que o Windows monte automaticamente novos volumes básicos e


dinâmicos adicionados ao sistema.
Observação: desabilitar a montagem automática pode fazer com que os clusters de
failover falhem na parte de armazenamento do Assistente para Validar uma
Configuração.

scrub Remove os diretórios de ponto de montagem de volume e as configurações de


registro para volumes que não estão mais no sistema. Isso impede que os volumes
que estavam anteriormente no sistema sejam montados automaticamente e
recebam os pontos de montagem de volume anteriores, quando forem adicionados
novamente ao sistema.

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.
Exemplos
Para ver se o recurso de montagem automática está habilitado, digite os seguintes
comandos de dentro do comando diskpart:

automount

Para habilitar o recurso de montagem automática, digite:

automount enable

Para desabilitar o recurso de montagem automática, digite:

automount disable

Links relacionados
Chave da sintaxe de linha de comando

comandos diskpart
bcdboot
Artigo • 12/04/2023

Permite configurar rapidamente uma partição do sistema ou reparar o ambiente de


inicialização localizado na partição do sistema. A partição do sistema é configurada
copiando um conjunto simples de arquivos BCD (Dados de Configuração de
Inicialização) para uma partição vazia existente.

Sintaxe

bcdboot <source> [/l] [/s]

Parâmetros

Parâmetro Descrição

source Especifica o local do diretório do Windows a ser usado como a origem para copiar
arquivos de ambiente de inicialização.

/l Especifica a localidade. A localidade padrão é inglês dos EUA.

/s Especifica a letra de volume da partição do sistema. O padrão é a partição do


sistema identificada pelo firmware.

Exemplos
Para obter informações sobre onde encontrar BCDboot e exemplos de como usar esse
comando, consulte o tópico Opções de linha de comando do BCDboot.

Links relacionados
Chave da sintaxe de linha de comando
bcdedit
Artigo • 17/04/2023

Os arquivos BCD (Dados de Configuração da Inicialização) fornecem um repositório


usado para descrever os aplicativos de inicialização e as configurações do aplicativo de
inicialização. Os objetos e elementos no repositório substituem efetivamente o Boot.ini.

O BCDEdit é uma ferramenta de linha de comando para gerenciar repositórios BCD. Ele
pode ser usado para uma variedade de finalidades, incluindo a criação de novos
repositórios, a modificação de repositórios existentes, a adição de parâmetros do menu
de inicialização, entre outras. O BCDEdit serve essencialmente à mesma finalidade que
Bootcfg.exe em versões anteriores do Windows, mas com duas melhorias importantes:

Ele expõe um intervalo maior de parâmetros de inicialização do que o Bootcfg.exe.

Ele melhorou o suporte a scripts.

7 Observação

Para usar o BCDEdit para modificar o BCD, é preciso ter privilégios administrativos.

O BCDEdit é a principal ferramenta para editar a configuração de inicialização do


Windows Vista e versões posteriores do Windows. Ele está incluído na distribuição do
Windows Vista na pasta %WINDIR%\System32.

O BCDEdit é limitado aos tipos de dados padrão e foi projetado principalmente para
executar alterações comuns simples no BCD. Para operações mais complexas ou tipos
de dados não padrão, considere usar a API (interface de programação de aplicativo) do
WMI (Instrumentação de Gerenciamento do Windows) de BCD para criar ferramentas
personalizadas mais poderosas e flexíveis.

Sintaxe

bcdedit /command [<argument1>] [<argument2>] ...

Parâmetros
Opções gerais da linha de comando do BCDEdit

Opção Descrição

/? Exibe uma lista de comandos do BCDEdit. Ao executar esse comando sem um


argumento, é exibido um resumo dos comandos disponíveis. Para exibir ajuda detalhada
para um comando específico, execute bcdedit /? <command> , em que <command> é o
nome do comando sobre o qual você está buscando mais informações. Por exemplo,
bcdedit /? createstore exibe uma ajuda detalhada para o comando Createstore.

Parâmetros que operam em um repositório

Opção Descrição

/createstore Cria um novo armazenamento de dados de configuração de inicialização vazio. O


repositório criado não é um repositório do sistema.

/export Exporta o conteúdo do repositório do sistema para um arquivo. Esse arquivo pode
ser usado posteriormente para restaurar o estado do repositório do sistema. Esse
comando é válido apenas para o repositório do sistema.

/import Restaura o estado do repositório do sistema usando um arquivo de dados de


backup gerado anteriormente usando a opção /export. Esse comando exclui todas
as entradas existentes no repositório do sistema antes que a importação ocorra.
Esse comando é válido apenas para o repositório do sistema.

/store Essa opção pode ser usada com a maioria dos comandos do BCDedit para
especificar o repositório a ser usado. Se essa opção não for especificada, o BCDEdit
operará no repositório do sistema. Executar o comando bcdedit /store por si só é
equivalente a executar o comando bcdedit /enum active.

Parâmetros que operam em entradas em um repositório

Parâmetro Descrição

/copy Faz uma cópia de uma entrada de inicialização especificada no mesmo repositório
do sistema.

/create Cria uma nova entrada no armazenamento de dados de configuração de


inicialização. Se um identificador conhecido for especificado, os parâmetros
/application, /inherit e /device não poderão ser especificados. Se um identificador
não for especificado ou não for bem conhecido, uma opção /application, /inherit
ou /device deverá ser especificada.

/delete Exclui um elemento de uma entrada especificada.


Parâmetros que operam em opções de entrada

Parâmetro Descrição

/deletevalue Exclui um elemento especificado de uma entrada de inicialização.

/set Define um valor de opção de entrada.

Parâmetros que controlam a saída

Parâmetro Descrição

/enum Lista entradas em um repositório. A opção /enum é o valor padrão para o BCEdit e,
portanto, executar o comando bcdedit sem parâmetros é equivalente a executar o
comando bcdedit /enum active.

/v Modo detalhado. Normalmente, todos os identificadores de entrada conhecidos são


representados pelo formulário abreviado amigável. Especificar /v como uma opção
de linha de comando exibe todos os identificadores na íntegra. Executar o comando
bcdedit /v por si só é equivalente a executar o comando bcdedit /enum active /v.

Parâmetros que controlam o gerenciador de inicialização

Parâmetro Descrição

/bootsequence Especifica uma ordem de exibição única a ser usada para a próxima
inicialização. Esse comando é semelhante à opção /displayorder, exceto que
ele é usado apenas na próxima vez que o computador for iniciado.
Posteriormente, o computador é revertido para a ordem de exibição original.

/default Especifica a entrada padrão que o gerenciador de inicialização seleciona


quando o tempo limite expira.

/displayorder Especifica a ordem de exibição que o gerenciador de inicialização usa ao


exibir parâmetros de inicialização para um usuário.

/timeout Especifica o tempo de espera, em segundos, antes que o gerenciador de


inicialização selecione a entrada padrão.

/toolsdisplayorder Especifica a ordem de exibição para o gerenciador de inicialização usar ao


exibir o menu Ferramentas.

Parâmetros que controlam os serviços de gerenciamento de


emergência
Parâmetro Descrição

/bootems Habilita ou desabilita o EMS (Serviços de Gerenciamento de Emergências) para a


entrada especificada.

/ems Habilita ou desabilita o EMS para a entrada de inicialização do sistema operacional


especificada.

/emssettings Define as configurações globais do EMS para o computador. O /emssettings não


habilita nem desabilita o EMS para qualquer entrada de inicialização específica.

Parâmetros que controlam a depuração

Parâmetro Descrição

/bootdebug Habilita ou desabilita o depurador de inicialização para uma entrada de


inicialização especificada. Embora esse comando funcione para qualquer entrada
de inicialização, ele é eficaz apenas para aplicativos de inicialização.

/dbgsettings Especifica ou exibe as configurações globais do depurador para o sistema. Esse


comando não habilita nem desabilita o depurador de kernel; use a opção /debug
para essa finalidade. Para definir uma configuração de depurador global individual,
use o comando bcdedit /set <dbgsettings> <type> <value> .

/debug Habilita ou desabilita o depurador de kernel para uma entrada de inicialização


especificada.

Links relacionados
Para obter exemplos de como usar o BCDEdit, consulte o artigo Referência de opções
do BCDEdit.

Para ver a notação usada para indicar a sintaxe da linha de comando, consulte Chave de
sintaxe da linha de comando.
bdehdcfg
Artigo • 10/04/2023

Prepara um disco rígido com as partições necessárias para a Criptografia de Unidade de


Disco BitLocker. A maioria das instalações do Windows 7 não precisará usar essa
ferramenta porque a instalação do BitLocker inclui a capacidade de preparar e
reparticionar unidades conforme necessário.

2 Aviso

Existe um conflito conhecido com a configuração Negar acesso de gravação a


unidades fixas não protegidas por BitLocker da Política de Grupo localizada em
Configuração do Computador\Modelos Administrativos\Componentes do
Windows\Criptografia de Unidade de Disco BitLocker\Unidades de Dados Fixas.

Se bdehdcfg for executado em um computador quando essa configuração de


política estiver habilitada, você poderá enfrentar os seguintes problemas:

Se você tentar reduzir a unidade e criar a unidade do sistema, o tamanho da


unidade será reduzida com êxito e uma partição não processada será criada.
Entretanto, a partição não processada não será formatada. A seguinte
mensagem de erro é exibida: A nova unidade ativa não pode ser formatada.
Poderá ser necessário preparar a unidade manualmente para o BitLocker.

Se você tentar usar um espaço não alocado para criar a unidade do sistema,
uma partição não processada será criada. Entretanto, a partição não
processada não será formatada. A seguinte mensagem de erro é exibida: A
nova unidade ativa não pode ser formatada. Poderá ser necessário preparar a
unidade manualmente para o BitLocker.

Se você tentar mesclar uma unidade existente à unidade do sistema, ocorrerá


uma falha na ferramenta ao copiar o arquivo de inicialização necessário na
unidade de destino para a criação da unidade do sistema. A seguinte
mensagem de erro é exibida: A instalação do BitLocker falhou ao copiar os
arquivos de inicialização. Poderá ser necessário preparar a unidade
manualmente para o BitLocker.

Se a configuração dessa política estiver sendo imposta, um disco rígido não


poderá ser reparticionado, pois a unidade estará protegida. Se estiver
atualizando os computadores de sua organização a partir de uma versão
anterior do Windows e eles estiverem configurados com uma única partição,
você deverá criar a partição de sistema BitLocker necessária antes de aplicar a
configuração da política aos computadores.

Sintaxe

bdehdcfg [–driveinfo <drive_letter>] [-target {default|unallocated|


<drive_letter> shrink|<drive_letter> merge}] [–newdriveletter] [–size
<size_in_mb>] [-quiet]

Parâmetros

Parâmetro Descrição

bdehdcfg: Exibe a letra da unidade, o tamanho total, o espaço livre máximo e as


driveinfo características das partições na unidade especificada. Apenas as partições válidas
são listadas. O espaço não alocado não será listado se já existirem quatro
partições primárias ou estendidas.

bdehdcfg: Define qual parte de uma unidade usar como a unidade do sistema e ativa essa
target parte.

bdehdcfg: Atribui uma nova letra de unidade à parte de uma unidade usada como unidade
newdriveletter do sistema.

bdehdcfg: size Determina o tamanho da partição do sistema ao criar uma unidade do sistema.

bdehdcfg: Impede a exibição de todas as ações e erros na interface de linha de comando e


quiet instrui bdehdcfg a usar a resposta Sim para todos os prompts Sim/Não que
ocorrerem durante a preparação subsequente da unidade.

bdehdcfg: Instrui o computador a reiniciar após a conclusão da preparação da unidade.


restart

/? Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
bdehdcfg: driveinfo
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe a letra da unidade, o tamanho total, o espaço livre máximo e as características da


partição. Apenas as partições válidas são listadas. O espaço não alocado não será listado
se já existirem quatro partições primárias ou estendidas.

7 Observação

Esse comando é somente informativo e não faz alterações na unidade.

Sintaxe

bdehdcfg -driveinfo <drive_letter>

Parâmetros

Parâmetro Descrição

<drive_letter> Especifica uma letra da unidade seguida de dois-pontos.

Exemplo
Para exibir as informações da unidade para a unidade C:

bdehdcfg driveinfo C:

Links relacionados
Chave da sintaxe de linha de comando
bdehdcfg
bdehdcfg: newdriveletter
Artigo • 11/04/2023

Atribui uma nova letra de unidade à parte de uma unidade usada como unidade do
sistema. Como prática recomendada, sugerimos não atribuir uma letra de unidade à sua
unidade do sistema.

Sintaxe

bdehdcfg -target {default|unallocated|<drive_letter> shrink|<drive_letter>


merge} -newdriveletter <drive_letter>

Parâmetros

Parâmetro Descrição

<drive_letter> Define a letra da unidade que será atribuída à unidade de destino especificada.

Exemplos
Para atribuir a unidade padrão à letra da unidade P :

bdehdcfg -target default -newdriveletter P:

Links relacionados
Chave da sintaxe de linha de comando

bdehdcfg
bdehdcfg: quiet
Artigo • 12/04/2023

Informa à ferramenta de linha de comando bdehdcfg que todas as ações e erros não
devem ser exibidos na interface de linha de comando. Qualquer solicitação de Sim/Não
(Y/N) exibido durante a preparação da unidade assumirá uma resposta "Sim". Para exibir
os erros ocorridos durante a preparação da unidade, examine o log de eventos do
sistema no provedor de eventos Microsoft-Windows-BitLocker-DrivePreparationTool.

Sintaxe

bdehdcfg -target {default|unallocated|<drive_letter> shrink|<drive_letter>


merge} -quiet

Parâmetros

Esse comando não tem parâmetros adicionais.

Exemplos
Para usar o comando quiet:

bdehdcfg -target default -quiet

Links relacionados
Chave da sintaxe de linha de comando

bdehdcfg
bdehdcfg: restart
Artigo • 12/04/2023

Informa à ferramenta de linha de comando bdehdcfg que o computador deve ser


reiniciado após a conclusão da preparação da unidade. Se outros usuários estiverem
conectados ao computador e o comando quiet não for especificado, será exibido um
prompt para confirmar que o computador deve ser reiniciado.

Sintaxe

bdehdcfg -target {default|unallocated|<drive_letter> shrink|<drive_letter>


merge} -restart

Parâmetros
Esse comando não tem parâmetros adicionais.

Exemplos
Para usar o comando restart:

bdehdcfg -target default -restart

Links relacionados
Chave da sintaxe de linha de comando

bdehdcfg
bdehdcfg: size
Artigo • 10/04/2023

Especifica o tamanho da partição do sistema ao criar uma unidade do sistema. Se você


não especificar um tamanho, a ferramenta usará o valor padrão de 300 MB. O tamanho
mínimo da unidade de sistema é 100 MB. Se você for armazenar a recuperação do
sistema ou outras ferramentas de sistema na partição do sistema, aumente o tamanho
de forma correspondente.

7 Observação

O comando size não pode ser combinado com o comando target <drive_letter>
merge .

Sintaxe

bdehdcfg -target {default|unallocated|<drive_letter> shrink} -size


<size_in_mb>

Parâmetros

Parâmetro Descrição

<size_in_mb> Indica o número de megabytes (MB) que deve ser usado para a nova partição.

Exemplos
Para alocar 500 MB para a unidade do sistema padrão:

bdehdcfg -target default -size 500

Links relacionados
Chave da sintaxe de linha de comando
bdehdcfg
bdehdcfg: target
Artigo • 11/04/2023

Prepara uma partição para usar como uma unidade do sistema pelo BitLocker e pela
Recuperação do Windows. Por padrão, essa partição é criada sem uma letra de unidade.

Sintaxe

bdehdcfg -target {default|unallocated|<drive_letter> shrink|<drive_letter>


merge}

Parâmetros

Parâmetro Descrição

padrão Indica que a ferramenta da linha de comando seguirá o mesmo processo que o
assistente de instalação do BitLocker.

unallocated Cria a partição do sistema fora do espaço não alocado disponível no disco.

<drive_letter> Reduz a unidade especificada pela quantidade necessária para criar uma
shrink partição do sistema ativa. Para usar esse comando, a unidade especificada deve
ter pelo menos 5% de espaço livre.

<drive_letter> Usa a unidade especificada como partição do sistema ativa. A unidade do


merge sistema operacional não pode ser um destino para mesclagem.

Exemplos
Para designar uma unidade existente (P) como a unidade do sistema:

bdehdcfg -target P: merge

Links relacionados
Chave da sintaxe de linha de comando
bdehdcfg
begin backup
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2,
Windows Server 2012

Inicia uma sessão de backup completa. Esse comando substitui a configuração do


backup de cópia padrão.

Syntax

begin backup

Links relacionados
Chave da sintaxe de linha de comando

comando begin restore


begin restore
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2,
Windows Server 2012

Inicia uma sessão de restauração e emite um evento PreRestore para os gravadores


envolvidos.

Syntax

begin restore

Links relacionados
Chave da sintaxe de linha de comando

Comando begin backup

Preparar para a restauração


bitsadmin
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2, Windows Server 2012 e Windows 10

O bitsadmin é uma ferramenta de linha de comando usada para criar, baixar ou carregar
trabalhos e monitorar seu progresso. A ferramenta bitsadmin usa opções para
identificar o trabalho a ser executado. Você pode chamar bitsadmin /? ou bitsadmin
/help para obter uma lista de opções.

A maioria das opções exige um parâmetro <job> , que você define como o nome de
exibição do trabalho ou GUID. O nome de exibição de um trabalho não precisa ser
exclusivo. Os opções /create e /list retornam o GUID de um trabalho.

Por padrão, você pode acessar as informações sobre seus próprios trabalhos. Para
acessar as informações dos trabalhos de outro usuário, você deve ter privilégios de
administrador. Se o trabalho foi criado em um estado elevado, você deve executar o
bitsadmin em uma janela elevada. Caso contrário, você terá acesso somente leitura ao
trabalho.

Muitas das opções correspondem aos métodos nas interfaces BITS. Para obter detalhes
adicionais que podem ser relevantes para o uso de uma opção, confira o método
correspondente.

Use as opções a seguir para criar um trabalho, definir e recuperar as propriedades de


um trabalho e monitorar o status de um trabalho. Para obter exemplos que mostram
como usar algumas dessas opções para executar tarefas, confira Exemplos de bitsadmin.

Opções disponíveis
bitsadmin /addfile
bitsadmin /addfileset
bitsadmin /addfilewithranges
bitsadmin /cache
bitsadmin /cache /delete
bitsadmin /cache /deleteurl
bitsadmin /cache /getexpirationtime
bitsadmin /cache /getlimit
bitsadmin /cache /help
bitsadmin /cache /info
bitsadmin /cache /list
bitsadmin /cache /setexpirationtime
bitsadmin /cache /setlimit
bitsadmin /cache /clear
bitsadmin /cancel
bitsadmin /complete
bitsadmin /create
bitsadmin /examples
bitsadmin /getaclflags
bitsadmin /getbytestotal
bitsadmin /getbytestransferred
bitsadmin /getclientcertificate
bitsadmin /getcompletiontime
bitsadmin /getcreationtime
bitsadmin /getcustomheaders
bitsadmin /getdescription
bitsadmin /getdisplayname
bitsadmin /geterror
bitsadmin /geterrorcount
bitsadmin /getfilestotal
bitsadmin /getfilestransferred
bitsadmin /gethelpertokenflags
bitsadmin /gethelpertokensid
bitsadmin /gethttpmethod
bitsadmin /getmaxdownloadtime
bitsadmin /getminretrydelay
bitsadmin /getmodificationtime
bitsadmin /getnoprogresstimeout
bitsadmin /getnotifycmdline
bitsadmin /getnotifyflags
bitsadmin /getnotifyinterface
bitsadmin /getowner
bitsadmin /getpeercachingflags
bitsadmin /getpriority
bitsadmin /getproxybypasslist
bitsadmin /getproxylist
bitsadmin /getproxyusage
bitsadmin /getreplydata
bitsadmin /getreplyfilename
bitsadmin /getreplyprogress
bitsadmin /getsecurityflags
bitsadmin /getstate
bitsadmin /gettemporaryname
bitsadmin /gettype
bitsadmin /getvalidationstate
bitsadmin /help
bitsadmin /info
bitsadmin /list
bitsadmin /listfiles
bitsadmin /makecustomheaderswriteonly
bitsadmin /monitor
bitsadmin /nowrap
bitsadmin /peercaching
bitsadmin /peercaching /getconfigurationflags
bitsadmin /peercaching /help
bitsadmin /peercaching /setconfigurationflags
bitsadmin /peers
bitsadmin /peers /clear
bitsadmin /peers /discover
bitsadmin /peers /help
bitsadmin /peers /list
bitsadmin /rawreturn
bitsadmin /removeclientcertificate
bitsadmin /removecredentials
bitsadmin /replaceremoteprefix
bitsadmin /reset
bitsadmin /resume
bitsadmin /setaclflag
bitsadmin /setclientcertificatebyid
bitsadmin /setclientcertificatebyname
bitsadmin /setcredentials
bitsadmin /setcustomheaders
bitsadmin /setdescription
bitsadmin /setdisplayname
bitsadmin /sethelpertoken
bitsadmin /sethelpertokenflags
bitsadmin /sethttpmethod
bitsadmin /setmaxdownloadtime
bitsadmin /setminretrydelay
bitsadmin /setnoprogresstimeout
bitsadmin /setnotifycmdline
bitsadmin /setnotifyflags
bitsadmin /setpeercachingflags
bitsadmin /setpriority
bitsadmin /setproxysettings
bitsadmin /setreplyfilename
bitsadmin /setsecurityflags
bitsadmin /setvalidationstate
bitsadmin /suspend
bitsadmin /takeownership
bitsadmin /transfer
bitsadmin /util
bitsadmin /util /enableanalyticchannel
bitsadmin /util /getieproxy
bitsadmin /util /help
bitsadmin /util /repairservice
bitsadmin /util /setieproxy
bitsadmin /util /version
bitsadmin /wrap
bitsadmin addfile
Artigo • 17/04/2023

Adiciona um arquivo ao trabalho especificado.

Sintaxe

bitsadmin /addfile <job> <remoteURL> <localname>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

remoteURL A URL do arquivo no servidor.

localname O nome do arquivo no computador local. Localname deve conter um caminho


absoluto para o arquivo.

Exemplos
Para adicionar um arquivo ao trabalho:

bitsadmin /addfile myDownloadJob http://downloadsrv/10mb.zip c:\10mb.zip

Repita esta chamada para cada arquivo a adicionar. Se vários trabalhos usarem
myDownloadJob como nome, você deverá substituir myDownloadJob pelo GUID do
trabalho para identificar exclusivamente o trabalho.

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin addfileset
Artigo • 12/04/2023

Adiciona um ou mais arquivos ao trabalho especificado.

Sintaxe

bitsadmin /addfileset <job> <textfile>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

textfile Um arquivo de texto, cada linha da qual contém um nome de arquivo local e
remoto. Observação: os nomes devem ser delimitados por espaço. As linhas que
começam com um caractere # são tratadas como um comentário.

Exemplos

bitsadmin /addfileset files.txt

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin addfilewithranges
Artigo • 10/04/2023

Adiciona um arquivo ao trabalho especificado. O BITS baixa os intervalos especificados


do arquivo remoto. Essa alternância é válida apenas para trabalhos de download.

Sintaxe

bitsadmin /addfilewithranges <job> <remoteURL> <localname> <rangelist>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

remoteURL URL do arquivo no servidor.

localname Nome do arquivo no computador local. Deve conter um caminho absoluto para o
arquivo.

rangelist Lista delimitada por vírgulas de pares offset:length. Use dois-pontos para separar o
valor de deslocamento do valor de comprimento. Por exemplo, um valor de
0:100,2000:100,5000:eof informa ao BITS para transferir 100 bytes do
deslocamento 0, 100 bytes do deslocamento 2.000 e os bytes restantes do
deslocamento de 5.000 para o final do arquivo.

Comentários
O token eof é um valor de comprimento válido dentro dos pares de deslocamento
e comprimento no <rangelist> . Ele instrui o serviço a ler até o final do arquivo
especificado.

O comando addfilewithranges falhará com o código de erro 0x8020002c, se um


intervalo de comprimento zero for especificado junto com outro intervalo usando
o mesmo deslocamento, como:

c:\bits>bitsadmin /addfilewithranges j2 http://bitsdc/dload/1k.zip c:\1k.zip

100:0,100:5
Mensagem de erro: não é possível adicionar arquivo ao trabalho – 0x8020002c. A
lista de intervalos de bytes contém alguns intervalos sobrepostos, que não têm
suporte.

Solução alternativa: não especifique o intervalo de comprimento zero primeiro.


Por exemplo, use bitsadmin /addfilewithranges j2 http://bitsdc/dload/1k.zip
c:\1k.zip 100:5,100:0

Exemplos
Para transferir 100 bytes do deslocamento 0, 100 bytes do deslocamento 2.000 e os
bytes restantes do deslocamento de 5.000 para o final do arquivo:

bitsadmin /addfilewithranges http://downloadsrv/10mb.zip c:\10mb.zip


0:100,2000:100,5000:eof

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin cache
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Contém uma lista dos comutadores bitsadmin/cache.

Contém uma lista dos comutadores bitsadmin/cache.

Sintaxe

bitsadmin /cache /help


bitsadmin /cache /clear
bitsadmin /cache /delete
bitsadmin /cache /deleteURL
bitsadmin /cache /list
bitsadmin /cache /info
bitsadmin /cache /getlimit
bitsadmin /cache /setlimit
bitsadmin /cache /getexpirationtime
bitsadmin /cache /setexpirationtime

Parâmetros

Parâmetro Descrição

bitsadmin cache and help Exibe o uso da linha de comando para os comutadores
/cache.

bitsadmin cache and clear Limpa o cache local.

bitsadmin cache and delete Exclui uma entrada de cache.

bitsadmin cache e deleteURL Exclui todas as entradas de cache para o URL fornecido.

bitsadmin cache and list Lista todas as entradas de cache.

bitsadmin cache and info Despeja uma entrada de cache específica.

bitsadmin cache and getlimit Recupera o limite de cache.

bitsadmin cache and setlimit Define o limite de cache.


Parâmetro Descrição

bitsadmin cache and Recupera a hora de expiração do cache.


getexpirationtime

bitsadmin cache and Define a hora de expiração do cache.


setexpirationtime

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin cache and delete
Artigo • 11/04/2023

Exclui uma entrada de cache específica.

Sintaxe

bitsadmin /cache /delete recordID

Parâmetros

Parâmetro Descrição

recordID O GUID associado à entrada de cache.

Exemplos
Para excluir a entrada de cache com o valor recordID {6511FB02-E195-40A2-B595-
E8E2F8F47702}:

bitsadmin /cache /delete {6511FB02-E195-40A2-B595-E8E2F8F47702}

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin cache


bitsadmin cache e deleteURL
Artigo • 12/04/2023

Exclui todas as entradas de cache para o URL fornecido.

Sintaxe

bitsadmin /deleteURL URL

Parâmetros

Parâmetro Descrição

URL O Uniform Resource Locator que identifica um arquivo remoto.

Exemplos
Para excluir todas as entradas de cache para
https://www.contoso.com/en/us/default.aspx :

bitsadmin /deleteURL https://www.contoso.com/en/us/default.aspx

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin cache


bitsadmin cache and getexpirationtime
Artigo • 12/04/2023

Recupera a hora de expiração do cache.

Sintaxe

bitsadmin /cache /getexpirationtime

Exemplos
Para recuperar a hora de expiração do cache:

bitsadmin /cache /getexpirationtime

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin cache


bitsadmin cache and getlimit
Artigo • 10/04/2023

Recupera o limite de cache.

Sintaxe

bitsadmin /cache /getlimit

Exemplos
Para recuperar o limite de cache:

bitsadmin /cache /getlimit

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin cache


bitsadmin cache and help
Artigo • 12/04/2023

Exibe o uso da linha de comando para os comutadores de cache.

Sintaxe

bitsadmin /cache /help

Exemplos
Para mostrar a ajuda da linha de comando para os comutadores de cache.

bitsadmin /cache /help

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin cache


bitsadmin cache and info
Artigo • 11/04/2023

Despeja uma entrada de cache específica.

Sintaxe

bitsadmin /cache /info recordID [/verbose]

Parâmetros

Parâmetro Descrição

recordID O GUID associado à entrada de cache.

Exemplos
Para despejar a entrada de cache com o valor recordID {6511FB02-E195-40A2-B595-
E8E2F8F47702}:

bitsadmin /cache /info {6511FB02-E195-40A2-B595-E8E2F8F47702}

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin cache


bitsadmin cache and list
Artigo • 11/04/2023

Lista todas as entradas de cache.

Sintaxe

bitsadmin /cache /list [/verbose]

Exemplos
Para listar todas as entradas de cache no formato detalhado.

bitsadmin /cache /list /verbose

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin cache


bitsadmin cache and setexpirationtime
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Define a hora de expiração do cache.

Sintaxe

bitsadmin /cache /setexpirationtime secs

Parâmetros

Parâmetro Descrição

segundos O número de segundos até que o cache expire.

Exemplos
Para definir que o cache expire em 60 segundos:

bitsadmin /cache / setexpirationtime 60

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin cache


bitsadmin cache and setlimit
Artigo • 12/04/2023

Define o limite de tamanho do cache.

Sintaxe

bitsadmin /cache /setlimit percent

Parâmetros

Parâmetro Descrição

percent O limite de cache definido como uma porcentagem do espaço total em disco rígido.

Exemplos
Para definir o limite de tamanho do cache como 50%:

bitsadmin /cache /setlimit 50

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin cache


bitsadmin cache and clear
Artigo • 06/04/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O comando bitsadmin cache and clear limpa o cache local.

Sintaxe

bitsadmin /cache /clear

Exemplos
Para limpar o cache local:

bitsadmin /cache /clear

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin cache


bitsadmin cancel
Artigo • 10/04/2023

Remove o trabalho da fila de transferência e exclui todos os arquivos temporários


associados a ele.

Sintaxe

bitsadmin /cancel <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para remover o trabalho myDownloadJob da fila de transferência:

bitsadmin /cancel myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin complete
Artigo • 11/04/2023

Conclui o trabalho. Use essa opção depois que o trabalho for para o estado transferido.
Caso contrário, somente os arquivos que foram transferidos com êxito estarão
disponíveis.

Sintaxe

bitsadmin /complete <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplo
Para concluir o trabalho myDownloadJob, depois que ele atinge o estado TRANSFERRED :

bitsadmin /complete myDownloadJob

Se vários trabalhos usarem myDownloadJob como nome, você deverá usar o GUID do
trabalho para identificá-lo exclusivamente para a conclusão.

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin create
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria um trabalho de transferência com o nome de exibição fornecido.

7 Observação

Os tipos de parâmetro /Upload e /Upload-Reply não são compatíveis com o BITS


1.2 e versões anteriores.

Sintaxe

bitsadmin /create [type] displayname

Parâmetros

Parâmetro Descrição

type Há três tipos de trabalho:


/Download. Transfere dados de um servidor para um arquivo local.
/Upload. Transfere dados de um arquivo local para um servidor.
/Upload-Reply. Transfere dados de um arquivo local para um servidor e
recebe um arquivo de resposta do servidor.

Esse parâmetro usará /Download como padrão se não for especificado.

displayname O nome de exibição atribuído ao trabalho recém-criado.

Exemplos
Para criar um trabalho de download denominado myDownloadJob:

bitsadmin /create myDownloadJob


Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin resume

comando bitsadmin
bitsadmin examples
Artigo • 12/04/2023

Os exemplos a seguir mostram como usar a ferramenta bitsadmin para executar as


tarefas mais comuns.

Transferir um arquivo
Para criar um trabalho, adicione arquivos, ative o trabalho na fila de transferência e
conclua o trabalho:

bitsadmin /transfer myDownloadJob /download /priority normal


https://downloadsrv/10mb.zip c:\\10mb.zip

O BITSAdmin continua a mostrar informações de progresso na janela MS-DOS até que a


transferência seja concluída ou ocorra um erro.

Criar um trabalho de download


Para criar um trabalho de download denominado myDownloadJob:

bitsadmin /create myDownloadJob

O BITSAdmin retorna um GUID que identifica exclusivamente o trabalho. Use o GUID ou


o nome do trabalho em chamadas subsequentes. O texto a seguir é uma saída de
exemplo.

Saída de exemplo
created job {C775D194-090F-431F-B5FB-8334D00D1CB6}

Adicionar arquivos ao trabalho de download


Para adicionar um arquivo ao trabalho:

bitsadmin /addfile myDownloadJob https://downloadsrv/10mb.zip c:\\10mb.zip


Repita esta chamada para cada arquivo que queira adicionar. Se vários trabalhos usarem
myDownloadJob como nome, use o GUID do trabalho para identificá-lo exclusivamente
para a conclusão.

Ativar o trabalho de download


Depois de criar um novo trabalho, o BITS suspende automaticamente o trabalho. Para
ativar o trabalho na fila de transferência:

bitsadmin /resume myDownloadJob

Se vários trabalhos usarem myDownloadJob como nome, use o GUID do trabalho para
identificá-lo exclusivamente para a conclusão.

Determinar o progresso do trabalho de


download
A opção /info retorna o estado do trabalho e o número de arquivos e bytes
transferidos. Quando o estado é mostrado como TRANSFERRED , isso significa que o BITS
transferiu com êxito todos os arquivos no trabalho. Você também pode adicionar o
argumento /verbose para obter detalhes completos do trabalho e /list ou /monitor
para obter todos os trabalhos na fila de transferência.

Para retornar o estado do trabalho:

bitsadmin /info myDownloadJob /verbose

Se vários trabalhos usarem myDownloadJob como nome, use o GUID do trabalho para
identificá-lo exclusivamente para a conclusão.

Conclua o trabalho de download


Para concluir o trabalho depois que o estado for alterado para TRANSFERRED :
bitsadmin /complete myDownloadJob

Executar a opção /complete antes que os arquivos no trabalho fiquem disponíveis. Se


vários trabalhos usarem myDownloadJob como nome, use o GUID do trabalho para
identificá-lo exclusivamente para a conclusão.

Monitorar trabalhos na fila de transferência


usando a opção /listar
Para retornar o estado do trabalho e o número de arquivos e bytes transferidos para
todos os trabalhos na fila de transferência:

bitsadmin /list

Saída de exemplo

{6AF46E48-41D3-453F-B7AF-A694BBC823F7} job1 SUSPENDED 0 / 0 0 / 0


{482FCAF0-74BF-469B-8929-5CCD028C9499} job2 TRANSIENT_ERROR 0 / 1 0 /
UNKNOWN

Listed 2 job(s).

Monitorar trabalhos na fila de transferência


usando a opção /monitorar
Para retornar o estado do trabalho e o número de arquivos e bytes transferidos para
todos os trabalhos na fila de transferência, atualizando os dados a cada 5 segundos:

bitsadmin /monitor

7 Observação

Para interromper a atualização, pressione CTRL+C.


Saída de exemplo

MONITORING BACKGROUND COPY MANAGER(5 second refresh)


{6AF46E48-41D3-453F-B7AF-A694BBC823F7} job1 SUSPENDED 0 / 0 0 / 0
{482FCAF0-74BF-469B-8929-5CCD028C9499} job2 TRANSIENT_ERROR 0 / 1 0 /
UNKNOWN
{0B138008-304B-4264-B021-FD04455588FF} job3 TRANSFERRED 1 / 1 100379370 /
100379370

Monitorar trabalhos na fila de transferência


usando a opção /info
Para retornar o estado do trabalho e o número de arquivos e bytes transferidos:

bitsadmin /info

Saída de exemplo

GUID: {482FCAF0-74BF-469B-8929-5CCD028C9499} DISPLAY: myDownloadJob


TYPE: DOWNLOAD STATE: TRANSIENT_ERROR OWNER: domain\user
PRIORITY: NORMAL FILES: 0 / 1 BYTES: 0 / UNKNOWN
CREATION TIME: 12/17/2002 1:21:17 PM MODIFICATION TIME: 12/17/2002 1:21:30
PM
COMPLETION TIME: UNKNOWN
NOTIFY INTERFACE: UNREGISTERED NOTIFICATION FLAGS: 3
RETRY DELAY: 600 NO PROGRESS TIMEOUT: 1209600 ERROR COUNT: 0
PROXY USAGE: PRECONFIG PROXY LIST: NULL PROXY BYPASS LIST: NULL
ERROR FILE: https://downloadsrv/10mb.zip -> c:\10mb.zip
ERROR CODE: 0x80072ee7 - The server name or address could not be resolved
ERROR CONTEXT: 0x00000005 - The error occurred while the remote file was
being
processed.
DESCRIPTION:
JOB FILES:
0 / UNKNOWN WORKING https://downloadsrv/10mb.zip -> c:\10mb.zip
NOTIFICATION COMMAND LINE: none
Excluía trabalhos da fila de transferência
Para remover todos os trabalhos da fila de transferência, use a opção /reiniciar:

bitsadmin /reset

Saída de exemplo

{DC61A20C-44AB-4768-B175-8000D02545B9} canceled.
{BB6E91F3-6EDA-4BB4-9E01-5C5CBB5411F8} canceled.
2 out of 2 jobs canceled.

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getaclflags
Artigo • 11/04/2023

Recupera os sinalizadores de propagação da ACL (lista de controle de acesso), refletindo


se os itens são herdados pelos objetos-filho.

Sintaxe

bitsadmin /getaclflags <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Comentários
Retorna um ou mais dos seguintes valores do sinalizador:

o – Copia as informações do proprietário com o arquivo.

g – Copia as informações do grupo com o arquivo.

d – Copia as informações da DACL (lista de controle de acesso discricionário) com


o arquivo.

s – Copia as informações da SACL (lista de controle de acesso do sistema) com o


arquivo.

Exemplos
Para recuperar os sinalizadores de propagação da lista de controle de acesso para o
trabalho chamado myDownloadJob:

bitsadmin /getaclflags myDownloadJob


Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getbytestotal
Artigo • 12/04/2023

Recupera o tamanho do trabalho especificado.

Sintaxe

bitsadmin /getbytestotal <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar o tamanho do trabalho chamado myDownloadJob:

bitsadmin /getbytestotal myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getbytestransferred
Artigo • 11/04/2023

Recupera o número de bytes transferidos para o trabalho especificado.

Sintaxe

bitsadmin /getbytestransferred <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar o número de bytes transferidos no trabalho chamado myDownloadJob:

bitsadmin /getbytestransferred myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getclientcertificate
Artigo • 11/04/2023

Recupera o certificado do cliente a partir do trabalho.

Sintaxe

bitsadmin /getclientcertificate <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar o certificado do cliente para o trabalho chamado myDownloadJob:

bitsadmin /getclientcertificate myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getcompletiontime
Artigo • 11/04/2023

Recupera a hora em que o trabalho terminou de transferir os dados.

Sintaxe

bitsadmin /getcompletiontime <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar a hora em que o trabalho chamado myDownloadJob terminou de
transferir os dados:

bitsadmin /getcompletiontime myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getcreationtime
Artigo • 12/04/2023

Recupera o tempo de criação do trabalho especificado.

Sintaxe

bitsadmin /getcreationtime <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar a hora de criação do trabalho denominado myDownloadJob:

bitsadmin /getcreationtime myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getcustomheaders
Artigo • 12/04/2023

Recupera os cabeçalhos HTTP personalizados do trabalho.

Sintaxe

bitsadmin /getcustomheaders <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para obter os cabeçalhos personalizados para o trabalho denominado myDownloadJob:

bitsadmin /getcustomheaders myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin getdescription
Artigo • 11/04/2023

Recupera a descrição do trabalho especificado.

Sintaxe

bitsadmin /getdescription <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar a descrição do trabalho chamado myDownloadJob:

bitsadmin /getdescription myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getdisplayname
Artigo • 11/04/2023

Recupera o nome de exibição do trabalho especificado.

Sintaxe

bitsadmin /getdisplayname <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar o nome de exibição do trabalho chamado myDownloadJob:

bitsadmin /getdisplayname myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin geterror
Artigo • 11/04/2023

Obtém informações detalhadas do erro para o trabalho especificado.

Sintaxe

bitsadmin /geterror <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar as informações de erro do trabalho chamado myDownloadJob:

bitsadmin /geterror myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin geterrorcount
Artigo • 12/04/2023

Recupera uma contagem do número de vezes que o trabalho especificado gerou um


erro transitório.

Sintaxe

bitsadmin /geterrorcount <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar as informações de erro do trabalho denominado myDownloadJob:

bitsadmin /geterrorcount myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin getfilestotal
Artigo • 10/04/2023

Recupera o número de arquivos no trabalho especificado.

Sintaxe

bitsadmin /getfilestotal <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar o número de arquivos incluídos no trabalho chamado myDownloadJob:

bitsadmin /getfilestotal myDownloadJob

Consulte Também
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin getfilestransferred
Artigo • 11/04/2023

Recupera o número de arquivos transferidos para o trabalho especificado.

Sintaxe

bitsadmin /getfilestransferred <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar o número de arquivos transferidos no trabalho chamado
myDownloadJob:

bitsadmin /getfilestransferred myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin gethelpertokenflags
Artigo • 17/04/2023

Retorna os sinalizadores de uso para um token auxiliar associado a um trabalho de


transferência de BITS.

7 Observação

Esse comando não é compatível com o BITS 3.0 e anteriores.

Sintaxe

bitsadmin /gethelpertokenflags <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Comentários
Possíveis valores retornados, incluindo:

0x0001. O token auxiliar é usado para abrir o arquivo local de um trabalho de


upload, para criar ou renomear o arquivo temporário de um trabalho de download
ou para criar ou renomear o arquivo de resposta de um trabalho de upload-
resposta.

0x0002. O token auxiliar é usado para abrir o arquivo remoto de um trabalho de


upload ou download do protocolo SMB ou em resposta a um desafio de servidor
HTTP ou proxy para credenciais implícitas de NTLM ou Kerberos. Você deve
chamar /SetCredentialsJob TargetScheme NULL NULL para permitir que as
credenciais sejam enviadas por HTTP.

Exemplos
Para recuperar os sinalizadores de uso de um token auxiliar associado a um trabalho de
transferência de BITS chamado myDownloadJob:

bitsadmin /gethelpertokenflags myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin gethelpertokensid
Artigo • 11/04/2023

Retorna o SID do token auxiliar de um trabalho de transferência BITS, se um foi definido.

7 Observação

Esse comando não é compatível com o BITS 3.0 e versões anteriores.

Sintaxe

bitsadmin /gethelpertokensid <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar o SID de um trabalho de transferência BITS chamado myDownloadJob:

bitsadmin /gethelpertokensid myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin gethttpmethod
Artigo • 12/04/2023

Obtém o verbo HTTP a ser usado com o trabalho.

Sintaxe

bitsadmin /gethttpmethod <Job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar o verbo HTTP a ser usado com o trabalho denominado myDownloadJob:

bitsadmin /gethttpmethod myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getmaxdownloadtime
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Recupera o tempo limite de download em segundos.

Sintaxe

bitsadmin /getmaxdownloadtime <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para obter o tempo máximo de download para o trabalho denominado myDownloadJob
em segundos:

bitsadmin /getmaxdownloadtime myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getminretrydelay
Artigo • 11/04/2023

Recupera o período de tempo, em segundos, que o serviço aguardará após encontrar


um erro transitório antes de tentar transferir o arquivo.

Sintaxe

bitsadmin /getminretrydelay <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar o atraso mínimo de nova tentativa para o trabalho chamado
myDownloadJob:

bitsadmin /getminretrydelay myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getmodificationtime
Artigo • 11/04/2023

Recupera a última vez em que o trabalho foi modificado ou se os dados foram


transferidos com êxito.

Sintaxe

bitsadmin /getmodificationtime <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar a hora da última modificação para o trabalho chamado myDownloadJob:

bitsadmin /getmodificationtime myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getnoprogresstimeout
Artigo • 12/04/2023

Recupera o tempo, em segundos, em que o serviço tentará transferir o arquivo, após


ocorrer um erro transitório.

Sintaxe

bitsadmin /getnoprogresstimeout <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar o valor de tempo limite de progresso do trabalho chamado
myDownloadJob:

bitsadmin /getnoprogresstimeout myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getnotifycmdline
Artigo • 11/04/2023

Recupera o comando da linha de comando executado depois que o trabalho


especificado termina de transferir os dados.

7 Observação

Esse comando não é compatível com o BITS 1.2 e anteriores.

Sintaxe

bitsadmin /getnotifycmdline <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar o comando da linha de comando usado pelo serviço quando o trabalho
chamado myDownloadJob termina.

bitsadmin /getnotifycmdline myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getnotifyflags
Artigo • 17/04/2023

Recupera os sinalizadores de notificação do trabalho especificado.

Sintaxe

bitsadmin /getnotifyflags <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Comentários
O trabalho pode conter um ou mais dos seguintes sinalizadores de notificação:

Sinalizador Descrição

0x001 Gerará um evento quando todos os arquivos no trabalho forem transferidos.

0x002 Gerará um evento quando ocorrer um erro.

0x004 Desabilita as notificações.

0x008 Gerará um evento quando o trabalho for modificado ou a transferência progredir.

Exemplos
Para recuperar os sinalizadores de notificação do trabalho chamado myDownloadJob:

bitsadmin /getnotifyflags myDownloadJob


Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin getnotifyinterface
Artigo • 11/04/2023

Determina se outro programa registrou uma interface de retorno de chamada COM (a


interface de notificação) para o trabalho especificado.

Sintaxe

bitsadmin /getnotifyinterface <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Saída

A saída para esse comando é exibida como Registrada ou Não Registrada.

7 Observação

Não é possível determinar o programa que registrou a interface de retorno de


chamada.

Exemplos
Para recuperar a interface de notificação para o trabalho chamado myDownloadJob:

bitsadmin /getnotifyinterface myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getowner
Artigo • 12/04/2023

Exibe o nome de exibição ou GUID do proprietário do trabalho especificado.

Sintaxe

bitsadmin /getowner <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para exibir o proprietário do trabalho denominadomyDownloadJob:

bitsadmin /getowner myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getpeercachingflags
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Recupera sinalizadores que determinam se os arquivos do trabalho podem ser


armazenados em cache e servidos aos pares e se o BITS pode baixar conteúdo para o
trabalho dos pares.

Sintaxe

bitsadmin /getpeercachingflags <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar os sinalizadores do trabalho chamado myDownloadJob:

bitsadmin /getpeercachingflags myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin getpriority
Artigo • 11/04/2023

Recupera a prioridade do trabalho especificado.

Sintaxe

bitsadmin /getpriority <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Saída
A prioridade retornada para esse comando pode ser:

FOREGROUND

HIGH

NORMAL

LOW

UNKNOWN

Exemplos
Para recuperar a prioridade do trabalho chamado myDownloadJob:

bitsadmin /getpriority myDownloadJob


Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getproxybypasslist
Artigo • 06/04/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O comando bitsadmin /getproxybypasslist recupera a lista de bypass de proxy para o


trabalho especificado.

Sintaxe

bitsadmin /getproxybypasslist <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Comentários
A lista de bypass contém os nomes de host ou endereços IP, ou os dois, que não serão
roteados por meio de um proxy. A lista pode conter <local> para se referir a todos os
servidores na mesma LAN. A lista pode ser delimitada por ponto e vírgula (;) ou por
espaço.

Exemplos
Para recuperar a lista de bypass de proxy para o trabalho chamado myDownloadJob:

bitsadmin /getproxybypasslist myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando
Comando bitsadmin
bitsadmin getproxylist
Artigo • 10/04/2023

Recupera a lista delimitada por vírgulas de servidores proxy a serem usados para o
trabalho especificado.

Sintaxe

bitsadmin /getproxylist <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar a lista de proxies para o trabalho chamado myDownloadJob:

bitsadmin /getproxylist myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin getproxyusage
Artigo • 12/04/2023

Recupera a configuração de uso de proxy para o trabalho especificado.

Sintaxe

bitsadmin /getproxyusage <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Saída
Os valores de uso de proxy retornados podem ser:

Preconfig – Use os padrões do Internet Explorer do proprietário.

No_Proxy – Não use um servidor do proxy.

Override – use uma lista de proxy explícita.

Autodetect – Detecta automaticamente configurações de proxy.

Exemplos
Para recuperar o uso do proxy para o trabalho denominado myDownloadJob:

bitsadmin /getproxyusage myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin getreplydata
Artigo • 11/04/2023

Recupera os dados de upload-reply do servidor no formato hexadecimal para o


trabalho.

7 Observação

Esse comando não é compatível com o BITS 1.2 e anteriores.

Sintaxe

bitsadmin /getreplydata <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar os dados de upload-reply para o trabalho chamado myDownloadJob:

bitsadmin /getreplydata myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getreplyfilename
Artigo • 11/04/2023

Obtém o caminho do arquivo que contém o servidor upload-reply para o trabalho.

7 Observação

Esse comando não é compatível com o BITS 1.2 e anteriores.

Sintaxe

bitsadmin /getreplyfilename <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar o nome de arquivo de upload-reply para o trabalho chamado
myDownloadJob:

bitsadmin /getreplyfilename myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getreplyprogress
Artigo • 12/04/2023

Recupera o tamanho e o progresso do servidor upload-reply.

7 Observação

Esse comando não é compatível com o BITS 1.2 e anteriores.

Sintaxe

bitsadmin /getreplyprogress <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar o progresso de upload-reply para o trabalho denominado
myDownloadJob:

bitsadmin /getreplyprogress myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getsecurityflags
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Relata os sinalizadores de segurança HTTP para o redirecionamento de URL e as


verificações executadas no certificado do servidor durante a transferência.

Sintaxe

bitsadmin /getsecurityflags <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar os sinalizadores de segurança de um trabalho chamado myDownloadJob:

bitsadmin /getsecurityflags myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getstate
Artigo • 30/05/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O comando bitsadmin /getstate recupera o estado de um trabalho especificado.

Sintaxe

bitsadmin /getstate <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Saída

Os valores de saída retornados podem ser:

Estado Descrição

Queued O trabalho está aguardando a execução.

Connecting O BITS está entrando em contato com o servidor.

Transferring O BITS está transferindo dados.

Transferred O BITS transferiu com êxito todos os arquivos no trabalho.

Suspended O trabalho está em pausa.

Error Ocorreu um erro não recuperável; a transferência não é repetida.

Transient_Error Ocorreu um erro recuperável. A transferência tenta novamente quando o


atraso mínimo de repetição expira.

Acknowledged O trabalho foi concluído.

Canceled O trabalho foi cancelado.


Exemplos
Para recuperar o estado do trabalho chamado myDownloadJob:

bitsadmin /getstate myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin gettemporaryname
Artigo • 12/04/2023

Relata o nome de arquivo temporário do arquivo fornecido no trabalho.

Sintaxe

bitsadmin /gettemporaryname <job> <file_index>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

file_index Começa a partir de 0.

Exemplos
Para relatar o nome de arquivo temporário do arquivo 2 para o trabalho denominado
myDownloadJob:

bitsadmin /gettemporaryname myDownloadJob 1

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin gettype
Artigo • 11/04/2023

Recupera o tipo do trabalho especificado.

Sintaxe

bitsadmin /gettype <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Saída
Os valores de saída retornados podem ser:

Tipo Descrição

Baixar O trabalho é um download.

Carregar O trabalho é um upload.

Upload-Reply O trabalho é um upload-reply.

Unknown O trabalho tem um tipo desconhecido.

Exemplos
Para recuperar o tipo do trabalho chamado myDownloadJob:

bitsadmin /gettype myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin getvalidationstate
Artigo • 21/12/2022

Relata o estado de validação de conteúdo do arquivo determinado dentro do trabalho.

Sintaxe

bitsadmin /getvalidationstate <job> <file_index>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição ou GUID do trabalho.

file_index Começa em 0.

Exemplos
Para recuperar o estado de validação de conteúdo do arquivo 2 dentro do trabalho
chamado myDownloadJob:

bitsadmin /getvalidationstate myDownloadJob 1

Referências adicionais
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin help
Artigo • 06/04/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O comando bitsadmin help exibe informações de ajuda relacionadas aos parâmetros e


opções da linha de comando bitsadmin.

Sintaxe

bitsadmin /help | /?

Exemplos
Para recuperar a ajuda da linha de comando.

bitsadmin /help

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin info
Artigo • 12/04/2023

Exibe informações resumidas sobre o trabalho especificado.

Sintaxe

bitsadmin /info <job> [/verbose]

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

/verbose Opcional. Fornece informações detalhadas sobre cada trabalho.

Exemplos
Para recuperar informações sobre o trabalho denominado myDownloadJob:

bitsadmin /info myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

bitsadmin info
bitsadmin list
Artigo • 10/04/2023

Lista os trabalhos de transferência pertencentes ao usuário atual.

Sintaxe

bitsadmin /list [/allusers][/verbose]

Parâmetros

Parâmetro Descrição

/allusers Opcional. Lista trabalhos de todos os usuários. É preciso ter privilégios de


administrador para usar este parâmetro.

/verbose Opcional. Fornece informações detalhadas sobre cada trabalho.

Exemplos
Para recuperar informações sobre trabalhos pertencentes ao usuário atual.

bitsadmin /list

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin listfiles
Artigo • 12/04/2023

Lista os arquivos no trabalho especificado.

Sintaxe

bitsadmin /listfiles <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar a lista de arquivos para o trabalho denominado myDownloadJob:

bitsadmin /listfiles myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin makecustomheaderswriteonly
Artigo • 10/04/2023

Torne os cabeçalhos HTTP personalizados de um trabalho somente gravação.

) Importante

Essa ação não pode ser desfeita.

Sintaxe

bitsadmin /makecustomheaderswriteonly <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para tornar os cabeçalhos HTTP personalizados somente gravação para o trabalho
nomeado myDownloadJob:

bitsadmin /makecustomheaderswriteonly myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

bitsadmin command
bitsadmin monitor
Artigo • 17/04/2023

Monitora trabalhos na fila de transferência que pertençam ao usuário atual.

Sintaxe

bitsadmin /monitor [/allusers] [/refresh <seconds>]

Parâmetros

Parâmetro Descrição

/allusers Opcional. Monitora trabalhos para todos os usuários. É preciso ter privilégios de
administrador para usar este parâmetro.

/refresh Opcional. Atualiza os dados em um intervalo especificado por <seconds> . O


intervalo de atualização padrão é de cinco segundos. Para interromper a
atualização, pressione CTRL+C.

Exemplos
Para monitorar a fila de transferência quanto a trabalhos que pertençam ao usuário
atual e atualizar as informações a cada 60 segundos.

bitsadmin /monitor /refresh 60

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin nowrap
Artigo • 11/04/2023

Corta qualquer linha de texto da saída que passa da borda mais à direita da janela de
comando. Por padrão, todas as opções, exceto monitor, quebram a saída. Especifique a
opção nowrap antes das outras opções.

Sintaxe

bitsadmin /nowrap

Exemplos
Para recuperar o estado do trabalho chamado myDownloadJob enquanto não quebra a
saída:

bitsadmin /nowrap /getstate myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin peercaching
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Lista as opções /peercaching.

Lista as opções /peercaching.

Sintaxe

bitsadmin /peercaching /help


bitsadmin /peercaching /setconfigurationflags
bitsadmin /peercaching /getconfigurationflags

Parâmetros

Parâmetro Descrição

bitsadmin Exibe o uso da linha de comando para as opções /peercaching.


peercaching e help

bitsadmin Define os sinalizadores de configuração que determinam se o


peercaching e computador pode fornecer conteúdo para os pares e se ele pode baixar o
setconfigurationflags conteúdo dos pares.

bitsadmin Define os sinalizadores de configuração que determinam se o


peercaching e computador fornece conteúdo para os pares e se ele pode baixar o
getconfigurationflags conteúdo dos pares.

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin peercaching e
getconfigurationflags
Artigo • 12/04/2023

Define os sinalizadores de configuração que determinam se o computador fornece


conteúdo para os pares e se ele pode baixar o conteúdo dos pares.

Sintaxe

bitsadmin /peercaching /getconfigurationflags <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para obter os sinalizadores de configuração para o trabalho denominado
myDownloadJob:

bitsadmin /peercaching /getconfigurationflags myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin

comando bitsadmin peercaching


bitsadmin peercaching e help
Artigo • 12/04/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O comando bitsadmin exibe o uso da linha de comando para a opção /peercaching ,


quando combinado com a opção /help .

Syntax
A seguinte sintaxe é usada:

CLI

bitsadmin /peercaching /help

Exemplos
Para exibir a ajuda da linha de comando para as opções /peercaching , execute o
comando a seguir.

CLI

bitsadmin /peercaching /help

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin

comando bitsadmin peercaching


bitsadmin peercaching e
setconfigurationflags
Artigo • 12/04/2023

Define os sinalizadores de configuração que determinam se o computador pode


fornecer conteúdo para os pares e se ele pode baixar o conteúdo dos pares.

Sintaxe

bitsadmin /peercaching /setconfigurationflags <job> <value>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

value Um inteiro sem sinal com a seguinte interpretação para os bits na representação
binária:
Para permitir que os dados do trabalho sejam baixados de um par, defina o
bit menos significativo.
Para permitir que os dados do trabalho sejam atendidos aos pares, defina o
segundo bit da direita.

Exemplos
Para especificar os dados do trabalho a serem baixados de pares para o trabalho
denominadomyDownloadJob:

bitsadmin /peercaching /setconfigurationflags myDownloadJob 1

Links relacionados
Chave da sintaxe de linha de comando
comando bitsadmin

comando bitsadmin peercaching


bitsadmin peers
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Lista as opções /peers disponíveis.

Lista as opções /peers disponíveis.

bitsadmin /peers /help


bitsadmin /peers /discover
bitsadmin /peers /clear
bitsadmin /peers /list

Parâmetros

Parâmetro Descrição

bitsadmin peers e help Exibe o uso da linha de comando para as opções /peers.

bitsadmin peers e discover Descobre os pares novamente.

bitsadmin peers e clear Limpa a lista de pares.

bitsadmin peers e list Lista todos os pares.

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin peers e clear
Artigo • 30/05/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O comando bitsadmin /peers /clear limpa a lista de pares.

Sintaxe

bitsadmin /peers /clear

Exemplos
Para limpar a lista de pares.

bitsadmin /peers /clear

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin

comando bitsadmin peers


bitsadmin peers e discover
Artigo • 06/04/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O comando bitsadmin peers and discover redescobre pares.

Sintaxe

bitsadmin /peers /discover

Exemplos
Para redescobrir pares:

bitsadmin /peers /discover

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin

Comando bitsadmin peers


bitsadmin peers e help
Artigo • 11/04/2023

Exibe o uso da linha de comando para as opções /peers.

Sintaxe

bitsadmin /peers /help

Exemplos
Para exibir o uso da linha de comando para as opções /peers:

bitsadmin /peers /help

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin

comando bitsadmin peers


bitsadmin peers e list
Artigo • 30/05/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O comando bitsadmin lista todos os pares quando é combinado com comutadores de


pares e lista.

Sintaxe
CLI

bitsadmin /peers /list

Exemplos
Para listar todos os pares:

CLI

bitsadmin /peers /list

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin

comando bitsadmin peers


bitsadmin rawreturn
Artigo • 06/04/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O comando bitsadmin rawreturn retorna dados adequados para análise. Geralmente,


você usa esse comando com as alternâncias /create e /get* para receber apenas o valor.
Você deve especificar essa alternância antes de outras alternâncias.

7 Observação

Esse comando remove caracteres de nova linha e formatação da saída.

Sintaxe

bitsadmin /rawreturn

Exemplos
Para recuperar os dados brutos do estado do trabalho chamado myDownloadJob:

bitsadmin /rawreturn /getstate myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin removeclientcertificate
Artigo • 12/04/2023

Remove o certificado do cliente a partir do trabalho.

Sintaxe

bitsadmin /removeclientcertificate <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para remover o certificado do cliente do trabalho denominado myDownloadJob:

bitsadmin /removeclientcertificate myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin removecredentials
Artigo • 17/04/2023

Remove credenciais de um trabalho.

7 Observação

Esse comando não é compatível com o BITS 1.2 e anteriores.

Sintaxe

bitsadmin /removecredentials <job> <target> <scheme>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

destino Use SERVER ou PROXY.

scheme Use um dos seguintes:


BASIC. Esquema de autenticação no qual o nome de usuário e a senha são
enviados em texto não criptografado para o servidor ou proxy.
DIGEST. Um esquema de autenticação de desafio/resposta que utiliza uma
cadeia de caracteres de dados do servidor especificado para o desafio.
NTLM. Um esquema de autenticação de desafio/resposta que usa as
credenciais do usuário para autenticação em um ambiente de rede do
Windows.
NEGOTIATE (também conhecido como protocolo de Negociação Simples e
Protegido). Um esquema de autenticação de desafio/resposta que negocia
com o servidor ou proxy para determinar o esquema a ser utilizado para
autenticação. Os exemplos são o protocolo Kerberos e NTLM.
PASSPORT. Um serviço de autenticação centralizado fornecido pela Microsoft
que oferece um único logon para sites membros.

Exemplos
Para remover credenciais do trabalho chamado myDownloadJob:
bitsadmin /removecredentials myDownloadJob SERVER BASIC

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin replaceremoteprefix
Artigo • 12/04/2023

Altera a URL remota para todos os arquivos no trabalho de oldprefix para newprefix,
conforme necessário.

Sintaxe

bitsadmin /replaceremoteprefix <job> <oldprefix> <newprefix>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

oldprefix Prefixo de URL existente.

newprefix Novo prefixo de URL.

Exemplos
Para alterar a URL remota para todos os arquivos no trabalho chamado myDownloadJob
de http://stageserver para http://prodserver.

bitsadmin /replaceremoteprefix myDownloadJob http://stageserver


http://prodserver

Informações adicionais
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin reset
Artigo • 10/04/2023

Cancela todos os trabalhos na fila de transferência pertencente ao usuário atual. Não é


possível redefinir os trabalhos criados pelo Sistema Local. Em vez disso, seja um
administrador e use o agendador de tarefas para agendar esse comando como uma
tarefa usando as credenciais do Sistema Local.

7 Observação

Caso tenha privilégios de administrador no BITSAdmin 1.5 e anterior, a opção


/reset cancelará todos os trabalhos na fila. Além disso, não há suporte para a opção
/allusers.

Sintaxe

bitsadmin /reset [/allusers]

Parâmetros

Parâmetro Descrição

/allusers Opcional. Cancela todos os trabalhos na fila pertencente ao usuário atual. É preciso
ter privilégios de administrador para usar este parâmetro.

Exemplos
Para cancelar todos os trabalhos na fila de transferência para o usuário atual.

bitsadmin /reset

Links relacionados
Chave da sintaxe de linha de comando
bitsadmin command
bitsadmin resume
Artigo • 11/04/2023

Ativa um trabalho novo ou suspenso na fila de transferência. Se você retomou o


trabalho por engano ou simplesmente precisa suspender o trabalho, poderá usar a
opção bitsadmin suspend para suspender o trabalho.

Sintaxe

bitsadmin /resume <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para retomar o trabalho chamado myDownloadJob:

bitsadmin /resume myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin suspend

comando bitsadmin
bitsadmin setaclflag
Artigo • 17/04/2023

Define os sinalizadores de propagação da ACL (lista de controle de acesso) para o


trabalho. Os sinalizadores indicam que você deseja manter as informações de
proprietário e ACL com o arquivo que está sendo baixado. Por exemplo, para manter o
proprietário e o grupo com o arquivo, defina o parâmetro flags como og .

Sintaxe

bitsadmin /setaclflag <job> <flags>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

sinalizadores Especifique um ou mais dos valores, entre eles:


o – Copia as informações do proprietário com o arquivo.
g – Copia as informações do grupo com o arquivo.
d – Copia as informações da DACL (lista de controle de acesso
discricionário) com o arquivo.
s – Copia as informações da SACL (lista de controle de acesso do sistema)
com o arquivo.

Exemplos
Para definir os sinalizadores de propagação da lista de controle de acesso para o
trabalho chamado myDownloadJob, ele mantém as informações de proprietário e grupo
com os arquivos baixados.

bitsadmin /setaclflags myDownloadJob og

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin setclientcertificatebyid
Artigo • 17/04/2023

Especifica o identificador do certificado do cliente a ser usado para autenticação de


cliente em uma solicitação HTTPS (SSL).

Sintaxe

bitsadmin /setclientcertificatebyid <job> <store_location> <store_name>


<hexadecimal_cert_id>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

store_location Identifica o local de um repositório do sistema a ser usado para procurar o


certificado, incluindo:
CURRENT_USER
LOCAL_MACHINE
CURRENT_SERVICE
SERVICES
USUÁRIOS
CURRENT_USER_GROUP_POLICY
LOCAL_MACHINE_GROUP_POLICY
LOCAL_MACHINE_ENTERPRISE.

store_name O nome do repositório de certificados, incluindo:


AC (certificados de Autoridade de Certificação)
MY (certificados pessoais)
ROOT (certificados raiz)
SPC (Certificado do fornecedor do software).

hexadecimal_cert_id Um número hexadecimal que representa o hash do certificado.

Exemplos
Para especificar o identificador do certificado do cliente a ser usado para a autenticação
de cliente em uma solicitação HTTPS (SSL) para o trabalho chamado myDownloadJob:

bitsadmin /setclientcertificatebyid myDownloadJob


BG_CERT_STORE_LOCATION_CURRENT_USER MY A106B52356D3FBCD1853A41B619358BD

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin setclientcertificatebyname
Artigo • 11/04/2023

Especifica o nome da entidade do certificado do cliente a ser usado para autenticação


de cliente em uma solicitação HTTPS (SSL).

Sintaxe

bitsadmin /setclientcertificatebyname <job> <store_location> <store_name>


<subject_name>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

store_location Identifica o local de um repositório do sistema a ser usado para procurar o


certificado. Os valores possíveis incluem:
1 (CURRENT_USER)
2 (LOCAL_MACHINE)
3 (CURRENT_SERVICE)
4 (SERVICES)
5 (USERS)
6 (CURRENT_USER_GROUP_POLICY)
7 (LOCAL_MACHINE_GROUP_POLICY)
8 (LOCAL_MACHINE_ENTERPRISE)

store_name O nome do repositório de certificados. Os valores possíveis incluem:


CA (certificados de Autoridade de Certificação)
MY (certificados pessoais)
ROOT (certificados raiz)
SPC (Certificado do Fornecedor do Software)

subject_name Nome do certificado.

Exemplos
Para especificar o nome do certificado do cliente myCertificate a ser usado para
autenticação de cliente em uma solicitação HTTPS (SSL) para o trabalho chamado
myDownloadJob:

bitsadmin /setclientcertificatebyname myDownloadJob 1 MY myCertificate

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin setcredentials
Artigo • 10/04/2023

Adiciona credenciais a um trabalho.

7 Observação

Esse comando não é compatível com o BITS 1.2 e anteriores.

Sintaxe

bitsadmin /setcredentials <job> <target> <scheme> <username> <password>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

destino Use SERVER ou PROXY.

scheme Use um dos seguintes:


BASIC. Esquema de autenticação no qual o nome de usuário e a senha são
enviados em texto não criptografado para o servidor ou proxy.
DIGEST. Um esquema de autenticação de desafio/resposta que utiliza uma
cadeia de caracteres de dados do servidor especificado para o desafio.
NTLM. Um esquema de autenticação de desafio/resposta que usa as
credenciais do usuário para autenticação em um ambiente de rede do
Windows.
NEGOTIATE (também conhecido como protocolo de Negociação Simples e
Protegido). Um esquema de autenticação de desafio/resposta que negocia
com o servidor ou proxy para determinar o esquema a ser utilizado para
autenticação. Os exemplos são o protocolo Kerberos e NTLM.
PASSPORT. Um serviço de autenticação centralizado fornecido pela Microsoft
que oferece logon único para sites membros.

user_name O nome do usuário.

password A senha associada ao Nome de usuário fornecido.


Exemplos
Para adicionar credenciais ao trabalho chamado myDownloadJob:

bitsadmin /setcredentials myDownloadJob SERVER BASIC Edward password20

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin setcustomheaders
Artigo • 11/04/2023

Adicione um cabeçalho HTTP personalizado a uma solicitação GET enviada a um


servidor HTTP. Para obter mais informações sobre as solicitações GET, consulte
Definições do método e Definições do campo do cabeçalho .

Sintaxe

bitsadmin /setcustomheaders <job> <header1> <header2> <...>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

<header1> <header2> e assim por diante Os cabeçalhos personalizados para o trabalho.

Exemplos
Para adicionar um cabeçalho HTTP personalizado para o trabalho chamado
myDownloadJob:

bitsadmin /setcustomheaders myDownloadJob accept-encoding:deflate/gzip

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin setdescription
Artigo • 11/04/2023

Define a descrição do trabalho especificado.

Sintaxe

bitsadmin /setdescription <job> <description>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

descrição Texto usado para descrever o trabalho.

Exemplos
Para recuperar a descrição do trabalho chamado myDownloadJob:

bitsadmin /setdescription myDownloadJob music_downloads

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin setdisplayname
Artigo • 12/04/2023

Define o nome de exibição para o trabalho especificado.

Sintaxe

bitsadmin /setdisplayname <job> <display_name>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

display_name Texto usado como o nome exibido para o trabalho específico.

Exemplos
Para definir o nome de exibição do trabalho como myDownloadJob:

bitsadmin /setdisplayname myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin sethelpertoken
Artigo • 12/04/2023

Define o token primário do prompt de comando atual (ou um token arbitrário da conta
de usuário local, se especificado) como um token auxiliar do trabalho de transferência
de BITS.

7 Observação

Esse comando não é compatível com o BITS 3.0 e anteriores.

Sintaxe

bitsadmin /sethelpertoken <job> [<user_name@domain> <password>]

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

<username@domain> Opcional. As credenciais da conta de usuário local para o token a


<password> ser usado.

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin sethelpertokenflags
Artigo • 11/04/2023

Define os sinalizadores de uso para um token auxiliar associado a um trabalho de


transferência de BITS.

7 Observação

Esse comando não é compatível com o BITS 3.0 e versões anteriores.

Sintaxe

bitsadmin /sethelpertokenflags <job> <flags>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

sinalizadores Possíveis valores de token auxiliar, incluindo:


0x0001. Usado para abrir o arquivo local de um trabalho de upload, para
criar ou renomear o arquivo temporário de um trabalho de download ou
para criar ou renomear o arquivo de resposta de um trabalho de upload-
resposta.
0x0002. Usado para abrir o arquivo remoto de um trabalho de upload ou
download do protocolo SMB ou em resposta a um desafio de servidor HTTP
ou proxy para credenciais implícitas de NTLM ou Kerberos.

Você deve chamar /setcredentialsjob targetscheme null null para enviar as


credenciais por HTTP.

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin sethttpmethod
Artigo • 12/04/2023

Define o verbo HTTP a ser usado.

Sintaxe

bitsadmin /sethttpmethod <job> <httpmethod>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

httpmethod O verbo HTTP a ser usado. Para obter informações sobre os verbos disponíveis,
confira Definições de Método .

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin setmaxdownloadtime
Artigo • 11/04/2023

Define o tempo limite de download em segundos.

Sintaxe

bitsadmin /setmaxdownloadtime <job> <timeout>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

tempo limite A duração do tempo limite de download, em segundos.

Exemplos
Para definir o tempo limite para o trabalho chamado myDownloadJob para 10 segundos.

bitsadmin /setmaxdownloadtime myDownloadJob 10

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin setminretrydelay
Artigo • 17/04/2023

Define o tempo mínimo, em segundos, que o BITS aguarda depois encontrar um erro
transitório até tentar transferir o arquivo.

Sintaxe

bitsadmin /setminretrydelay <job> <retrydelay>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

retrydelay Período mínimo de tempo, em segundos, para o BITS aguardar após um erro
durante a transferência.

Exemplos
Para definir como 35 segundos o atraso mínimo de repetição para o trabalho chamado
myDownloadJob:

bitsadmin /setminretrydelay myDownloadJob 35

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin setnoprogresstimeout
Artigo • 12/04/2023

Define o tempo, em segundos, durante o qual o BITS tenta transferir o arquivo após a
ocorrência do primeiro erro transitório.

Sintaxe

bitsadmin /setnoprogresstimeout <job> <timeoutvalue>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

timeoutvalue O período de tempo que o BITS aguarda para transferir um arquivo após o
primeiro erro, em segundos.

Comentários
O intervalo de tempo limite "sem progresso" começa quando o trabalho encontra
seu primeiro erro transitório.

O intervalo de tempo limite é interrompido ou redefinido quando um byte de


dados é transferido com êxito.

Se o intervalo de tempo limite "sem progresso" exceder timeoutvalue, o trabalho


será colocado em um estado de erro fatal.

Exemplos
Para definir o valor de tempo limite "sem progresso" como 20 segundos, para o
trabalho denominado myDownloadJob:

bitsadmin /setnoprogresstimeout myDownloadJob 20


Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin setnotifycmdline
Artigo • 12/04/2023

Define o comando de linha de comando que é executado depois que o trabalho termina
de transferir dados ou depois que um trabalho entra em um estado especificado.

7 Observação

Esse comando não é compatível com o BITS 1.2 e anteriores.

Sintaxe

bitsadmin /setnotifycmdline <job> <program_name> [program_parameters]

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

program_name Nome do comando a ser executado quando o trabalho for concluído. É


possível definir esse valor como NULL, mas se o fizer, o
program_parameters também deverá ser definido como NULL.

program_parameters Parâmetros que você quer passar para program_name. Defina esse valor
como NULL. Se o program_parameters não estiver definido como NULL, o
primeiro parâmetro no program_parameters deverá corresponder ao
program_name.

Exemplos
Para executar Notepad.exe na conclusão do trabalho denominado myDownloadJob:

bitsadmin /setnotifycmdline myDownloadJob c:\winnt\system32\notepad.exe NULL


Para mostrar o texto do EULA no Notepad.exe, na conclusão do trabalho denominado
myDownloadJob:

bitsadmin /setnotifycmdline myDownloadJob c:\winnt\system32\notepad.exe


notepad c:\eula.txt

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin setnotifyflags
Artigo • 17/04/2023

Define os sinalizadores de notificação de evento para o trabalho especificado.

Sintaxe

bitsadmin /setnotifyflags <job> <notifyflags>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

notifyflags Pode incluir um ou mais dos seguintes sinalizadores de notificação, incluindo:


1. Gerará um evento quando todos os arquivos no trabalho forem
transferidos.
2. Gerará um evento quando ocorrer um erro.
3. Gerará um evento quando todos os arquivos tiverem concluído a
transferência ou quando ocorrer um erro.
4. Desabilitará as notificações.

Exemplos
Para definir que os sinalizadores de notificação gerem um evento quando ocorrer um
erro, em um trabalho chamado myDownloadJob:

bitsadmin /setnotifyflags myDownloadJob 2

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin setpeercachingflags
Artigo • 12/04/2023

Define sinalizadores que determinam se os arquivos do trabalho podem ser


armazenados em cache e enviados aos pares e se o trabalho pode baixar conteúdo de
pares.

Sintaxe

bitsadmin /setpeercachingflags <job> <value>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

value Um inteiro sem sinal, incluindo:


1. O trabalho pode baixar conteúdo de pares.
2. Os arquivos do trabalho podem ser armazenados em cache e enviados aos
pares.

Exemplos
Para permitir que o trabalho denominadomyDownloadJob baixe conteúdo de pares:

bitsadmin /setpeercachingflags myDownloadJob 1

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin setpriority
Artigo • 11/04/2023

Define a prioridade do trabalho especificado.

Sintaxe

bitsadmin /setpriority <job> <priority>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

priority Define a prioridade do trabalho, incluindo:


FOREGROUND
HIGH
NORMAL
LOW

Exemplos
Para definir a prioridade do trabalho chamado myDownloadJob para normal:

bitsadmin /setpriority myDownloadJob NORMAL

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin setproxysettings
Artigo • 12/04/2023

Define as configurações de proxy para o trabalho especificado.

Sintaxe

bitsadmin /setproxysettings <job> <usage> [list] [bypass]

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

uso Define o uso do proxy, incluindo:


PRECONFIG. Use os padrões do Internet Explorer do proprietário.
NO_PROXY. Não use um servidor proxy.
OVERRIDE. Use uma lista de proxy explícita e uma lista de bypass. A lista de
proxy e as informações de bypass de proxy devem seguir.
AUTODETECT. Detecta automaticamente configurações de proxy.

list Usado quando o parâmetro Uso é definido como OVERRIDE. Deve conter uma lista
delimitada por vírgulas de servidores de proxy a serem usados.

ignorar Usado quando o parâmetro Uso é definido como OVERRIDE. Deve conter uma lista
delimitada por espaço de nomes de host ou endereços IP, ou ambos, para os quais
as transferências não devem ser roteadas por meio de um proxy. Isso pode ser
<local> para se referir a todos os servidores na mesma LAN. Valores de NULL
podem ser usados para uma lista de bypass de proxy vazia.

Exemplos
Para definir as configurações de proxy usando as várias opções de uso para o trabalho
denominadomyDownloadJob:

bitsadmin /setproxysettings myDownloadJob PRECONFIG


bitsadmin /setproxysettings myDownloadJob NO_PROXY

bitsadmin /setproxysettings myDownloadJob OVERRIDE proxy1:80

bitsadmin /setproxysettings myDownloadJob OVERRIDE proxy1,proxy2,proxy3 NULL

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin setreplyfilename
Artigo • 12/04/2023

Especifica o caminho do arquivo que contém o servidor upload-reply.

7 Observação

Esse comando não é compatível com o BITS 1.2 e anteriores.

Sintaxe

bitsadmin /setreplyfilename <job> <file_path>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

file_path Local para colocar o servidor upload-reply.

Exemplos
Para definir o caminho do arquivo do nome do arquivo de upload-reply para o trabalho
denominado myDownloadJob:

bitsadmin /setreplyfilename myDownloadJob c:\upload-reply

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin setsecurityflags
Artigo • 12/04/2023

Defina sinalizadores de segurança para HTTP para determinar se o BITS deve verificar a
lista de certificados revogados, ignorar determinados erros de certificado e definir a
política a ser usada quando um servidor redireciona a solicitação HTTP. O valor é um
inteiro sem sinal.

Sintaxe

bitsadmin /setsecurityflags <job> <value>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

value Pode incluir um ou mais dos seguintes sinalizadores de notificação, incluindo:


Defina o bit menos significativo para habilitar a Verificação de CRL.
Defina o segundo bit da direita para ignorar nomes comuns incorretos no
certificado do servidor.
Defina o terceiro bit da direita para ignorar datas incorretas no certificado do
servidor.
Defina o quarto bit da direita para ignorar as autoridades de certificação
incorretas no certificado do servidor.
Defina o quinto bit da direita para ignorar o uso incorreto no certificado do
servidor.
Defina do nono ao décimo primeiro (11º) bit da direita para implementar sua
política de redirecionamento especificada, incluindo:
0,0,0. Redirecionamentos são permitidos automaticamente.
0,0,1. O nome remoto na interface IBackgroundCopyFile será atualizado se
ocorrer um redirecionamento.
0,1,0. O BITS falhará no trabalho se ocorrer um redirecionamento.
Defina o décimo segundo (12º) bit da direita para permitir o
redirecionamento de HTTPS para HTTP.

Exemplos
Para definir os sinalizadores de segurança para habilitar uma verificação de CRL para o
trabalho denominado myDownloadJob:

bitsadmin /setsecurityflags myDownloadJob 0x0001

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin setvalidationstate
Artigo • 11/04/2023

Define o estado de validação do conteúdo do arquivo especificado dentro do trabalho.

Sintaxe

bitsadmin /setvalidationstate <job> <file_index> <TRUE|FALSE>

Parâmetros

Parâmetro Descrição

Trabalho O nome de exibição do trabalho ou o GUID.

file_index Inicia em 0.

TRUE ou TRUE ativa a validação do conteúdo para o arquivo especificado, enquanto FALSE
FALSE a desativa.

Exemplos
Para definir o estado de validação do conteúdo do arquivo 2 para TRUE do trabalho
chamado myDownloadJob:

bitsadmin /setvalidationstate myDownloadJob 2 TRUE

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin suspend
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Suspende o trabalho especificado. Se você suspendeu o trabalho por engano, pode usar
a opção bitsadmin resume para reiniciá-lo.

Sintaxe

bitsadmin /suspend <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplo
Para retomar o trabalho chamado myDownloadJob:

bitsadmin /suspend myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin resume

comando bitsadmin
bitsadmin takeownership
Artigo • 12/04/2023

Permite que um usuário com privilégios administrativos assuma a propriedade do


trabalho especificado.

Sintaxe

bitsadmin /takeownership <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para assumir a propriedade do trabalho chamado myDownloadJob:

bitsadmin /takeownership myDownloadJob

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin
bitsadmin transfer
Artigo • 17/04/2023

Transfere um ou mais arquivos. Por padrão, o serviço BITSAdmin cria um trabalho de


download que é executada com prioridade NORMAL e atualiza a janela de comando
com informações de progresso até que a transferência seja concluída ou até que ocorra
um erro crítico.

O serviço concluirá o trabalho se transferir todos os arquivos com êxito e o cancelará se


ocorrer um erro crítico. O serviço não criará o trabalho se não for possível adicionar
arquivos ao trabalho ou se você especificar um valor inválido para type ou job_priority.
Para transferir mais de um arquivo, especifique vários pares de <RemoteFileName>-
<LocalFileName> . Os pares devem ser delimitados por espaço.

7 Observação

O comando BITSAdmin continuará sendo executado se ocorrer um erro transitório.


Para encerrar o comando, pressione CTRL+C.

Sintaxe

bitsadmin /transfer <name> [<type>] [/priority <job_priority>] [/ACLflags


<flags>] [/DYNAMIC] <remotefilename> <localfilename>

Parâmetros

Parâmetro Descrição

name O nome do trabalho. Esse comando não pode ser um GUID.

tipo Opcional. Define o tipo de trabalho, incluindo:


/DOWNLOAD. O valor padrão. Escolha esse tipo para trabalhos de
download.
/UPLOAD. Escolha esse tipo para trabalhos de upload.
Parâmetro Descrição

priority Opcional. Define a prioridade do trabalho, incluindo:


FOREGROUND
HIGH
NORMAL
LOW

ACLflags Opcional. Indica que você deseja manter as informações de proprietário e ACL
com o arquivo que está sendo baixado. Especifique um ou mais dos valores,
entre eles:
o – Copia as informações do proprietário com o arquivo.
g – Copia as informações do grupo com o arquivo.
d – Copia as informações da DACL (lista de controle de acesso
discricionário) com o arquivo.
s – Copia as informações da SACL (lista de controle de acesso do sistema)
com o arquivo.

/DYNAMIC Configura o trabalho usando BITS_JOB_PROPERTY_DYNAMIC_CONTENT, o


que abranda os requisitos do lado do servidor.

remotefilename O nome do arquivo depois que ele é transferido para o servidor.

localfilename O nome do arquivo que reside localmente.

Exemplos
Para iniciar um trabalho de transferência chamado myDownloadJob:

bitsadmin /transfer myDownloadJob http://prodserver/audio.wma


c:\downloads\audio.wma

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin
bitsadmin util
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Lista as opções /util.

Lista as opções util.

Sintaxe

bitsadmin /util /help


bitsadmin /util /getieproxy
bitsadmin /util /repairservice
bitsadmin /util /setieproxy
bitsadmin /util /version

Parâmetros

Parâmetro Descrição

bitsadmin util e Exibe o uso da linha de comando para as opções /Util. Você também pode
help especificar /?.

bitsadmin util e Recupera o uso de proxy para a conta de serviço fornecida.


getieproxy

bitsadmin util e Repara os problemas conhecidos com o serviço BITS.


repairservice

bitsadmin util e Especifica as configurações de proxy a serem usadas ao transferir os


setieproxy arquivos usando uma conta de serviço.

bitsadmin util e Exibe a versão do serviço BITS.


version

Links relacionados
Chave da sintaxe de linha de comando
comando bitsadmin
bitsadmin util e enableanalyticchannel
Artigo • 12/04/2023

Habilita ou desabilita o canal analítico do cliente do BITS.

Syntax

bitsadmin /util /enableanalyticchannel TRUE|FALSE

Parâmetro Descrição

TRUE ou TRUE ativa a validação do conteúdo para o arquivo especificado, enquanto FALSE
FALSE a desativa.

Exemplos
Para ativar ou desativar o canal analítico do cliente do BITS.

bitsadmin /util / enableanalyticchannel TRUE

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin util

comando bitsadmin
bitsadmin util e getieproxy
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Recupera o uso de proxy para a conta de serviço fornecida. Esse comando mostra o
valor de cada uso de proxy, não apenas o uso de proxy especificado para a conta de
serviço. Para obter detalhes sobre como definir o uso de proxy para contas de serviço
específicas, consulte o comando bitsadmin util e setieproxy.

Sintaxe

bitsadmin /util /getieproxy <account> [/conn <connectionname>]

Parâmetros

Parâmetro Descrição

account Especifica a conta de serviço cujas configurações de proxy você quer


recuperar. Os valores possíveis incluem:
LOCALSYSTEM
NETWORKSERVICE
LOCALSERVICE.

connectionname Opcional. Usado com o parâmetro /conn para especificar qual conexão de
modem usar. Se não especificar o parâmetro /conn, o BITS usará a conexão
LAN.

Exemplos
Para exibir o uso de proxy para a conta NETWORK SERVICE:

bitsadmin /util /getieproxy NETWORKSERVICE


Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin util

comando bitsadmin
bitsadmin util e help
Artigo • 06/04/2023

Aplica-se a: Windows Server (todas as versões com suporte)

Exibe a ajuda para a alternância de comando bitsadmin util quando combinado com a
alternância help.

Sintaxe

bitsadmin /util /help

Exemplos
Exibe a ajuda da linha de comando para as alternâncias /util executando o comando a
seguir.

CLI

bitsadmin /util /help

Links relacionados
Chave da sintaxe de linha de comando

Comando bitsadmin util

Comando bitsadmin
bitsadmin util e repairservice
Artigo • 12/04/2023

Se o BITS não for iniciado, essa opção tentará resolver erros relacionados à configuração
de serviço incorreta e dependências em serviços do Windows (como
LANManworkstation) e no diretório de rede. Essa opção também gera uma saída que
indica se os problemas foram resolvidos.

7 Observação

Esse comando não é compatível com o BITS 1.5 e anteriores.

Sintaxe

bitsadmin /util /repairservice [/force]

Parâmetros

Parâmetro Descrição

/force Opcional. Exclui e cria o serviço novamente.

7 Observação

Se o BITS criar o serviço novamente, a cadeia de caracteres de descrição do serviço


poderá ser definida como inglês mesmo em um sistema localizado.

Exemplos
Para reparar a configuração do serviço de BITS:

bitsadmin /util /repairservice


Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin util

comando bitsadmin
bitsadmin util e setieproxy
Artigo • 10/04/2023

Defina as configurações de proxy a serem usadas ao transferir os arquivos usando uma


conta de serviço. Executar esse comando em um prompt de comando com privilégios
elevados para que ele seja concluído com êxito.

7 Observação

Esse comando não é compatível com o BITS 1.5 e anteriores.

Sintaxe

bitsadmin /util /setieproxy <account> <usage> [/conn <connectionname>]

Parâmetros

Parâmetro Descrição

account Especifica a conta de serviço cujas configurações de proxy deseja definir. Os


valores possíveis incluem:
LOCALSYSTEM
NETWORKSERVICE
LOCALSERVICE.
Parâmetro Descrição

uso Especifica a forma de detecção de proxy a ser usada. Os valores possíveis


incluem:
NO_PROXY. Não use um servidor proxy.
AUTODETECT. Detecta automaticamente configurações de proxy.
MANUAL_PROXY. Use uma lista de proxy especificada e uma lista de
bypass. Especifique suas listas imediatamente após a marca de uso. Por
exemplo, MANUAL_PROXY proxy1,proxy2 NULL .
Lista de proxy. Uma lista delimitada por vírgulas de servidores proxy
a serem usados.
Lista de bypass. Uma lista delimitada por espaço de nomes de host
ou endereços IP, ou ambos, para os quais as transferências não
devem ser roteadas por meio de um proxy. Isso pode ser <local>
para se referir a todos os servidores na mesma LAN. Valores de NULL
ou podem ser usados para uma lista de bypass de proxy vazia.
AUTOSCRIPT. O mesmo que AUTODETECT, exceto que ele também
executa um script. Especificar o URL do script imediatamente após a
marca de uso. Por exemplo, AUTOSCRIPT http://server/proxy.js .
RESET. O mesmo que NO_PROXY, exceto por remover os URLs de proxy
manuais (se especificadas) e quaisquer URLs descobertos usando a
detecção automática.

connectionname Opcional. Usado com o parâmetro /conn para especificar qual conexão de
modem usar. Se não especificar o parâmetro /conn, o BITS usará a conexão
LAN.

Comentários
Cada chamada sucessiva usando essa opção substitui o uso especificado anteriormente,
mas não os parâmetros do uso definido anteriormente. Por exemplo, ao especificar
NO_PROXY, AUTODETECT e MANUAL_PROXY em chamadas separadas, o BITS usará o
último uso fornecido, mas manterá os parâmetros do uso definido anteriormente.

Exemplos
Para definir o uso de proxy para a conta LOCALSYSTEM:

bitsadmin /util /setieproxy localsystem AUTODETECT


bitsadmin /util /setieproxy localsystem MANUAL_PROXY proxy1,proxy2,proxy3
NULL

bitsadmin /util /setieproxy localsystem MANUAL_PROXY proxy1:80

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin util

comando bitsadmin
bitsadmin util e version
Artigo • 11/04/2023

Exibe a versão do serviço BITS (por exemplo, 2.0).

7 Observação

Esse comando não é compatível com o BITS 1.5 e anteriores.

Sintaxe

bitsadmin /util /version [/verbose]

Parâmetros

Parâmetro Descrição

/verbose Use essa opção para exibir a versão do arquivo para cada DLL relacionada a BITS e
verificar se o serviço BITS pode ser iniciado.

Exemplos
Para exibir a versão do serviço BITS.

bitsadmin /util /version

Links relacionados
Chave da sintaxe de linha de comando

comando bitsadmin util

comando bitsadmin
bitsadmin wrap
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Encapsula qualquer linha de texto da saída que passa da borda mais à direita da janela
de comando para a próxima linha. Especificar essa alternância antes de qualquer outra
alternância.

Por padrão, todas as alternâncias, exceto bitsadmin monitor, encapsulam o texto de


saída.

Sintaxe

bitsadmin /wrap <job>

Parâmetros

Parâmetro Descrição

trabalho O nome de exibição do trabalho ou o GUID.

Exemplos
Para recuperar informações para o trabalho chamado myDownloadJob e encapsular o
texto de saída:

bitsadmin /wrap /info myDownloadJob /verbose

Links relacionados
Chave da sintaxe de linha de comando
bitsadmin command
bootcfg
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Configura, consulta ou altera as configurações do arquivo Boot.ini.

Sintaxe

bootcfg <parameter> [arguments...]

Parâmetros

Parâmetro Descrição

bootcfg Adiciona opções de carga do sistema operacional para uma entrada de sistema
addsw operacional especificada.

bootcfg Faz uma cópia de uma entrada de inicialização existente, à qual você pode adicionar
copy opções da linha de comando.

bootcfg Configura a depuração de porta 1394 para uma entrada de sistema operacional
dbg1394 especificada.

bootcfg Adiciona ou altera as configurações de depuração de uma entrada do sistema


debug operacional especificada.

bootcfg Especifica a entrada do sistema operacional a ser designada como o padrão.


default

bootcfg Exclui uma entrada do sistema operacional na seção [sistemas operacionais] do


delete arquivo Boot.ini.

bootcfg Permite que o usuário adicione ou altere as configurações de redirecionamento do


ems console dos Serviços de Gerenciamento de Emergência para um computador
remoto.

bootcfg Consulta e exibe as entradas da seção [carregador de inicialização] e [sistemas


query operacionais] no Boot.ini.
Parâmetro Descrição

bootcfg Adiciona opções de carga do sistema operacional especificadas como uma cadeia
raw de caracteres a uma entrada do sistema operacional na seção [sistemas
operacionais] do arquivo Boot.ini.

bootcfg Remove as opções de carga do sistema operacional de uma entrada de sistema


rmsw operacional especificada.

bootcfg Altera o valor do tempo limite do sistema operacional.


timeout
bootcfg addsw
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Adiciona opções de carga do sistema operacional para uma entrada de sistema


operacional especificada.

Sintaxe

bootcfg /addsw [/s <computer> [/u <domain>\<user> /p <password>]] [/mm


<maximumram>] [/bv] [/so] [/ng] /id <osentrylinenum>

Parâmetros

Termo Definição

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (não use


barras invertidas). O padrão é o computador local.

/u <domain>\ Executa o comando com as permissões de conta do usuário especificado por


<user> <user> ou <domain>\<user> . O padrão são as permissões do usuário
conectado atualmente no computador que emite o comando.

/p <password> Especifica a senha da conta de usuário definida no parâmetro /u.

/mm Especifica a quantidade máxima de RAM, em megabytes, que o sistema


<maximumram> operacional pode usar. O valor deve ser igual ou maior que 32 Megabytes.

/bv Adiciona a opção /basevideo ao especificado <osentrylinenum> , direcionando


o sistema operacional a usar o modo VGA padrão para o driver de vídeo
instalado.

/so Adiciona a opção /sos ao especificado <osentrylinenum> , direcionando o


sistema operacional para exibir nomes de driver de dispositivo enquanto eles
estão sendo carregados.

./ng Adiciona a opção /noguiboot ao especificado <osentrylinenum> ,


desabilitando a barra de progresso exibida antes do prompt de logon
CTRL+ALT+DEL.
Termo Definição

/id Especifica o número de linha da entrada do sistema operacional na seção


<osentrylinenum> [sistemas operacionais] do arquivo Boot.ini ao qual as opções de carga do
sistema operacional são adicionadas. A primeira linha após o cabeçalho da
seção [sistemas operacionais] é 1.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para usar o comando bootcfg /addsw:

bootcfg /addsw /mm 64 /id 2


bootcfg /addsw /so /id 3
bootcfg /addsw /so /ng /s srvmain /u hiropln /id 2
bootcfg /addsw /ng /id 2
bootcfg /addsw /mm 96 /ng /s srvmain /u maindom\hiropln /p p@ssW23 /id 2

Links relacionados
Chave da sintaxe de linha de comando

comando bootcfg
bootcfg copy
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Faz uma cópia de uma entrada de inicialização existente, à qual você pode adicionar
opções da linha de comando.

Sintaxe

bootcfg /copy [/s <computer> [/u <domain>\<user> /p <password>]] [/d


<description>] [/id <osentrylinenum>]

Parâmetros

Parâmetro Descrição

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (não use


barras invertidas). O padrão é o computador local.

/u <domain>\ Executa o comando com as permissões de conta do usuário especificado por


<user> <user> ou <domain>\<user> . O padrão são as permissões do usuário
conectado atualmente no computador emitindo o comando.

/p <password> Especifica a senha da conta de usuário especificada no parâmetro /u.

/d Especifica a descrição da nova entrada do sistema operacional.


<description>

/id Especifica o número de linha da entrada do sistema operacional na seção


<osentrylinenum> [sistemas operacionais] do arquivo Boot.ini ao qual as opções de carga do
sistema operacional são adicionadas. A primeira linha após o cabeçalho da
seção [sistemas operacionais] é 1.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para copiar a entrada de inicialização 1 e inserir \ABC Server\ como a descrição:
bootcfg /copy /d \ABC Server\ /id 1

Links relacionados
Chave da sintaxe de linha de comando

comando bootcfg
bootcfg dbg1394
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Configura a depuração de porta 1394 para uma entrada de sistema operacional


especificada.

Sintaxe

bootcfg /dbg1394 {on | off}[/s <computer> [/u <domain>\<user> /p


<password>]] [/ch <channel>] /id <osentrylinenum>

Parâmetros

Parâmetro Descrição

{on | off} Especifica o valor da depuração de porta 1394, incluindo:


em. Habilita o suporte à depuração remota através da adição da opção
/dbg1394 ao <osentrylinenum> especificado.
desativado. Desabilita o suporte à depuração remota removendo a
opção /dbg1394 do <osentrylinenum> especificado.

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (não use


barras invertidas). O padrão é o computador local.

/u <domain>\ Executa o comando com as permissões de conta do usuário especificado por


<user> <user> ou <domain>\<user> . O padrão são as permissões do usuário
conectado atualmente no computador que emite o comando.

/p <password> Especifica a senha da conta de usuário especificada no parâmetro /u.

/ch <channel> Especifica o canal a ser usado para depuração. Os valores válidos incluem
números inteiros entre 1 e 64. Não use esse parâmetro se a depuração de
porta 1394 estiver desabilitada.

/id Especifica o número de linha da entrada do sistema operacional na seção


<osentrylinenum> [sistemas operacionais] do arquivo Boot.ini ao qual as opções de carga do
sistema operacional são adicionadas. A primeira linha após o cabeçalho da
seção [sistemas operacionais] é 1.
Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Exemplos
Para usar o comando bootcfg /dbg1394:

bootcfg /dbg1394 /id 2


bootcfg /dbg1394 on /ch 1 /id 3
bootcfg /dbg1394 edit /ch 8 /id 2
bootcfg /s srvmain /u maindom\hiropln /p p@ssW23 /dbg1394 off /id 2

Links relacionados
Chave da sintaxe de linha de comando

Comando bootcfg
bootcfg debug
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Adiciona ou altera as configurações de depuração de uma entrada do sistema


operacional especificada.

7 Observação

Se você estiver tentando depurar a porta 1394, use o comando bootcfg dbg1394.

Sintaxe

bootcfg /debug {on | off | edit}[/s <computer> [/u <domain>\<user> /p


<password>]] [/port {COM1 | COM2 | COM3 | COM4}] [/baud {9600 | 19200 |
38400 | 57600 | 115200}] [/id <osentrylinenum>]

Parâmetros

Parâmetro Descrição

{on | off | Especifica o valor da depuração de porta, incluindo:


edit} em. Habilita o suporte à depuração remota através da adição da opção
/debug ao <osentrylinenum> especificado.
desativado. Desabilita o suporte à depuração remota removendo a
opção /debug do <osentrylinenum> especificado.
editar. Permite alterações nas configurações de porta e taxa de baud,
alterando os valores associados à opção /debug para o
<osentrylinenum> especificado.

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (não use


barras invertidas). O padrão é o computador local.

/u <domain>\ Executa o comando com as permissões de conta do usuário especificado por


<user> <user> ou <domain>\<user> . O padrão são as permissões do usuário
conectado atualmente no computador que emite o comando.
Parâmetro Descrição

/p <password> Especifica a senha da conta de usuário especificada no parâmetro /u.

/port {COM1 | Especifica a porta COM a ser usada para depuração. Não use esse parâmetro,
COM2 | COM3 | se o SSL estiver desabilitado.
COM4}

/baud {9600 | Especifica a taxa de baud a ser usada para depuração. Não use esse
19200 | 38400 | parâmetro, se o SSL estiver desabilitado.
57600 | 115200}

/id Especifica o número de linha da entrada do sistema operacional na seção


<osentrylinenum> [sistemas operacionais] do arquivo Boot.ini ao qual as opções de carga do
sistema operacional são adicionadas. A primeira linha após o cabeçalho da
seção [sistemas operacionais] é 1.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para usar o comando bootcfg /debug:

bootcfg /debug on /port com1 /id 2


bootcfg /debug edit /port com2 /baud 19200 /id 2
bootcfg /s srvmain /u maindom\hiropln /p p@ssW23 /debug off /id 2

Links relacionados
Chave da sintaxe de linha de comando

comando bootcfg
bootcfg default
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Especifica a entrada do sistema operacional a ser designada como o padrão.

Sintaxe

bootcfg /default [/s <computer> [/u <domain>\<user> /p <password>]] [/id


<osentrylinenum>]

Parâmetros

Parâmetro Descrição

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (não use


barras invertidas). O padrão é o computador local.

/u <domain>\ Executa o comando com as permissões de conta do usuário especificado por


<user> <user> ou <domain>\<user> . O padrão são as permissões do usuário
conectado atualmente no computador que emite o comando.

/p <password> Especifica a senha da conta de usuário definida no parâmetro /u.

/id Especifica o número de linha da entrada do sistema operacional na seção


<osentrylinenum> [sistemas operacionais] do arquivo Boot.ini ao qual as opções de carga do
sistema operacional são adicionadas. A primeira linha após o cabeçalho da
seção [sistemas operacionais] é 1.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para usar o comando bootcfg /default:
bootcfg /default /id 2
bootcfg /default /s srvmain /u maindom\hiropln /p p@ssW23 /id 2

Links relacionados
Chave da sintaxe de linha de comando

comando bootcfg
bootcfg delete
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exclui uma entrada do sistema operacional na seção [sistemas operacionais] do arquivo


Boot.ini.

Sintaxe

bootcfg /delete [/s <computer> [/u <domain>\<user> /p <password>]] [/id


<osentrylinenum>]

Parâmetros

Parâmetro Descrição

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (não use


barras invertidas). O padrão é o computador local.

/u <domain>\ Executa o comando com as permissões de conta do usuário especificado por


<user> <user> ou <domain>\<user> . O padrão são as permissões do usuário
conectado atualmente no computador que emite o comando.

/p <password> Especifica a senha da conta de usuário definida no parâmetro /u.

/id Especifica o número de linha da entrada do sistema operacional na seção


<osentrylinenum> [sistemas operacionais] do arquivo Boot.ini ao qual as opções de carga do
sistema operacional são adicionadas. A primeira linha após o cabeçalho da
seção [sistemas operacionais] é 1.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para usar o comando bootcfg /delete :
bootcfg /delete /id 1
bootcfg /delete /s srvmain /u maindom\hiropln /p p@ssW23 /id 3

Links relacionados
Chave da sintaxe de linha de comando

comando bootcfg
bootcfg ems
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Permite que o usuário adicione ou altere as configurações de redirecionamento do


console dos Serviços de Gerenciamento de Emergência para um computador remoto.
Habilitando os Serviços de Gerenciamento de Emergência, adiciona uma linha
redirect=Port# à seção [carregador de inicialização] do arquivo Boot.ini, juntamente
com uma opção /redirect para a linha de entrada do sistema operacional especificada. O
recurso de Serviços de Gerenciamento de Emergência está habilitado somente em
servidores.

Sintaxe

bootcfg /ems {on | off | edit}[/s <computer> [/u <domain>\<user> /p


<password>]] [/port {COM1 | COM2 | COM3 | COM4 | BIOSSET}] [/baud {9600 |
19200 | 38400 | 57600 | 115200}] [/id <osentrylinenum>]

Parâmetros

Parâmetro Descrição

{on | off | Especifica o valor do redirecionamento dos Serviços de Gerenciamento de


edit} Emergência, incluindo:
em. Habilita a saída remota para o <osentrylinenum> especificado.
Também adiciona uma opção /redirect ao <osentrylinenum>
especificado e uma configuração redirect=com<X> à seção [carregador
de inicialização]. O valor de com<X> é definido pelo parâmetro /port.
desativado. Desabilita a saída para um computador remoto. Também
remove a opção /redirect para o <osentrylinenum> especificado e a
configuração redirect=com<X> da seção [carregador de inicialização].
editar. Permite alterações nas configurações de porta alterando a
configuração redirect=com<X> na seção [carregador de inicialização]. O
valor de com<X> é definido pelo parâmetro /port.

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (não use


barras invertidas). O padrão é o computador local.
Parâmetro Descrição

/u <domain>\ Executa o comando com as permissões de conta do usuário especificado por


<user> <user> ou <domain>\<user> . O padrão são as permissões do usuário
conectado atualmente no computador emitindo o comando.

/p <password> Especifica a senha da conta de usuário especificada no parâmetro /u.

/port {COM1 | Especifica a porta COM a ser usada para redirecionamento. O parâmetro
COM2 | COM3 | BIOSSET direciona os Serviços de Gerenciamento de Emergência para obter
COM4 | BIOSSET} as configurações do BIOS para determinar qual porta deve ser usada para
redirecionamento. Não use esse parâmetro se a saída administrada
remotamente estiver desabilitada.

/baud {9600 | Especifica a taxa de baud a ser usada para redirecionamento. Não use esse
19200 | 38400 | parâmetro se a saída administrada remotamente estiver desabilitada.
57600 | 115200}

/id Especifica o número da linha de entrada do sistema operacional ao qual a


<osentrylinenum> opção Serviços de Gerenciamento de Emergência é adicionada na seção
[sistemas operacionais] do arquivo Boot.ini. A primeira linha após o cabeçalho
da seção [sistemas operacionais] é 1. Esse parâmetro é necessário quando o
valor dos Serviços de Gerenciamento de Emergência é definido como ativado
ou desativado.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para usar o comando bootcfg /ems:

bootcfg /ems on /port com1 /baud 19200 /id 2


bootcfg /ems on /port biosset /id 3
bootcfg /s srvmain /ems off /id 2
bootcfg /ems edit /port com2 /baud 115200
bootcfg /s srvmain /u maindom\hiropln /p p@ssW23 /ems off /id 2

Links relacionados
Chave da sintaxe de linha de comando

comando bootcfg
bootcfg query
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Consulta e exibe as entradas da seção [carregador de inicialização] e [sistemas


operacionais] no Boot.ini.

Sintaxe

bootcfg /query [/s <computer> [/u <domain>\<user> /p <password>]]

Parâmetros

Parâmetro Descrição

/s Especifica o nome ou o endereço IP de um computador remoto (não use barras


<computer> invertidas). O padrão é o computador local.

/u Executa o comando com as permissões de conta do usuário especificado por


<domain>\ <user> ou <domain>\<user> . O padrão são as permissões do usuário conectado
<user> atualmente no computador que emite o comando.

/p Especifica a senha da conta de usuário especificada no parâmetro /u.


<password>

/? Exibe a ajuda no prompt de comando.

Saída de exemplo
Saída de exemplo do comando bootcfg /query:

Boot Loader Settings


----------
timeout: 30
default: multi(0)disk(0)rdisk(0)partition(1)\WINDOWS
Boot Entries
------
Boot entry ID: 1
Friendly Name:
path: multi(0)disk(0)rdisk(0)partition(1)\WINDOWS
OS Load Options: /fastdetect /debug /debugport=com1:

A área Configurações do Carregador de Inicialização mostra cada entrada na


seção [carregador de inicialização] do Boot.ini.

A área Entradas de Inicialização mostra mais detalhes para cada entrada do


sistema operacional na seção [sistemas operacionais] do Boot.ini

Exemplos
Para usar o comando bootcfg /query:

bootcfg /query
bootcfg /query /s srvmain /u maindom\hiropln /p p@ssW23
bootcfg /query /u hiropln /p p@ssW23

Links relacionados
Chave da sintaxe de linha de comando

comando bootcfg
bootcfg raw
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Adiciona opções de carga do sistema operacional especificadas como uma cadeia de


caracteres a uma entrada do sistema operacional na seção [sistemas operacionais] do
arquivo Boot.ini. Esse comando substitui todas as opções de entrada do sistema
operacional existentes.

Sintaxe

bootcfg /raw [/s <computer> [/u <domain>\<user> /p <password>]]


<osloadoptionsstring> [/id <osentrylinenum>] [/a]

Parâmetros

Parâmetro Descrição

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (não


use barras invertidas). O padrão é o computador local.

/u <domain>\<user> Executa o comando com as permissões de conta do usuário


especificado por <user> ou <domain>\<user> . O padrão são as
permissões do usuário conectado atualmente no computador que emite
o comando.

/p <password> Especifica a senha da conta de usuário definida no parâmetro /u.

<osloadoptionsstring> Especifica as opções de carga do sistema operacional a serem


adicionadas à entrada do sistema operacional. Essas opções de carga
substituem as opções de carga existentes associadas à entrada do
sistema operacional. Não há validação em relação ao parâmetro
<osloadoptions> .

/id <osentrylinenum> Especifica o número de linha da entrada do sistema operacional na


seção [sistemas operacionais] do arquivo Boot.ini ao qual as opções de
carga do sistema operacional são adicionadas. A primeira linha após o
cabeçalho da seção [sistemas operacionais] é 1.
Parâmetro Descrição

/a Especifica quais opções do sistema operacional devem ser


acrescentadas a todas as opções de sistema operacional existentes.

/? Exibe a ajuda no prompt de comando.

Exemplos
Esse texto deve conter opções de carregamento do sistema operacional válidas, como
/debug, /fastdetect, /nodebug, /baudrate, /crashdebug e /sos.

Para adicionar /debug /fastdetect ao final da primeira entrada do sistema operacional,


substituindo as opções de entrada anteriores do sistema operacional:

bootcfg /raw /debug /fastdetect /id 1

Para usar o comando bootcfg /raw:

bootcfg /raw /debug /sos /id 2


bootcfg /raw /s srvmain /u maindom\hiropln /p p@ssW23 /crashdebug /id 2

Links relacionados
Chave da sintaxe de linha de comando

comando bootcfg
bootcfg rmsw
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Remove as opções de carga do sistema operacional de uma entrada de sistema


operacional especificada.

Sintaxe

bootcfg /rmsw [/s <computer> [/u <domain>\<user> /p <password>]] [/mm] [/bv]


[/so] [/ng] /id <osentrylinenum>

Parâmetros

Parâmetro Descrição

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (não use


barras invertidas). O padrão é o computador local.

/u <domain>\ Executa o comando com as permissões de conta do usuário especificado por


<user> <user> ou <domain>\<user> . O padrão são as permissões do usuário
conectado atualmente no computador emitindo o comando.

/p <password> Especifica a senha da conta de usuário especificada no parâmetro /u.

/mm Remove a opção /maxmem e seu valor máximo de memória associado do


<osentrylinenum> especificado. A opção /maxmem especifica a quantidade
máxima de RAM que o sistema operacional pode usar.

/bv Remove a opção /basevideo do <osentrylinenum> especificado. A opção


/basevideo direciona o sistema operacional a usar o modo VGA padrão para
o driver de vídeo instalado.

/so Remove a opção /sos do <osentrylinenum> especificado. A opção /sos


direciona o sistema operacional a exibir os nomes dos drivers de dispositivo
enquanto eles estão sendo carregados.
Parâmetro Descrição

/ng Remove a opção /noguiboot do <osentrylinenum> especificado. A opção


/noguiboot desabilita a barra de progresso exibida antes do prompt de logon
CTRL+ALT+DEL.

/id Especifica o número de linha da entrada do sistema operacional na seção


<osentrylinenum> [sistemas operacionais] do arquivo Boot.ini ao qual as opções de carga do
sistema operacional são adicionadas. A primeira linha após o cabeçalho da
seção [sistemas operacionais] é 1.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para usar o comando bootcfg /rmsw:

bootcfg /rmsw /mm 64 /id 2


bootcfg /rmsw /so /id 3
bootcfg /rmsw /so /ng /s srvmain /u hiropln /id 2
bootcfg /rmsw /ng /id 2
bootcfg /rmsw /mm 96 /ng /s srvmain /u maindom\hiropln /p p@ssW23 /id 2

Links relacionados
Chave da sintaxe de linha de comando

comando bootcfg
bootcfg timeout
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o valor do tempo limite do sistema operacional.

Sintaxe

bootcfg /timeout <timeoutvalue> [/s <computer> [/u <domain>\<user> /p


<password>]]

Parâmetros

Parâmetro Descrição

/timeout Especifica o valor do tempo limite na seção [carregador de inicialização]. O


<timeoutvalue> <timeoutvalue> é o número de segundos em que o usuário precisa selecionar
um sistema operacional na tela do carregador de inicialização antes que o
NTLDR carregue o padrão. O intervalo válido para <timeoutvalue> é 0-999. Se o
valor for 0, o NTLDR iniciará imediatamente o sistema operacional padrão sem
exibir a tela do carregador de inicialização.

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (não use barras


invertidas). O padrão é o computador local.

/u <domain>\ Executa o comando com as permissões de conta do usuário especificado por


<user> <user> ou <domain>\<user> . O padrão são as permissões do usuário conectado
atualmente no computador que emite o comando.

/p <password> Especifica a senha da conta de usuário especificada no parâmetro /u.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para usar o comando bootcfg /timeout:
bootcfg /timeout 30
bootcfg /s srvmain /u maindom\hiropln /p p@ssW23 /timeout 50

Links relacionados
Chave da sintaxe de linha de comando

Comando bootcfg
break
Artigo • 12/04/2023

) Importante

Esse comando não é mais usado. Ele é incluído somente para preservar a
compatibilidade com arquivos de MS-DOS existentes, mas não tem nenhum efeito
na linha de comando porque a funcionalidade é automática.

Define ou limpa a verificação de CTRL+C estendida em sistemas MS-DOS. Se usado sem


parâmetros, o break exibe o valor de configuração existente.

Se as extensões de comando estiverem habilitadas e em execução na plataforma


Windows, inserir o comando break em um arquivo em lote coloca um ponto de
interrupção embutido em código, se estiver sendo depurado por um depurador.

Syntax

break=[on|off]

7 Observação

Como o comando break não tem efeito, geralmente é usado para criar arquivos
vazios ou excluir o conteúdo de um arquivo existente. Por exemplo:

rem -- cleans the content of the file --


break>log

Links relacionados
Chave da sintaxe de linha de comando

comando break
cacls
Artigo • 10/04/2023

) Importante

Esse comando foi preterido. Use icacls em vez dele.

Exibe ou modifica DACLs (listas de controle de acesso discricionário) em arquivos


especificados.

Sintaxe

cacls <filename> [/t] [/m] [/l] [/s[:sddl]] [/e] [/c] [/g user:<perm>] [/r
user [...]] [/p user:<perm> [...]] [/d user [...]]

Parâmetros

Parâmetro Descrição

<filename> Obrigatórios. Exibe ACLs de arquivos especificados.

/t Altera ACLs de arquivos especificados no diretório atual e em todos os


subdiretórios.

/m Altera ACLs de volumes montados em um diretório.

/l Funciona no Link Simbólico em si, em vez do destino.

/s:sddl Substitui as ACLs pelas especificadas na cadeia de caracteres SDDL. Esse parâmetro
não é válido para uso com os parâmetros /e, /g, /r, /p ou /d.

/e Edite uma ACL em vez de substituí-la.

/c Continue após erros de acesso negado.


Parâmetro Descrição

/g user: Concede os direitos de acesso de usuário especificados, incluindo estes valores


<perm> válidos para permissão:
n – Nenhum
r – Leitura
w – Gravação
c – Alteração (gravação)
f – Controle total

/r usuário Revoga os direitos de acesso do usuário especificado. Válido somente quando


[...] usado com o parâmetro /e.

[/p user: Substitua os direitos de acesso de usuário especificados, incluindo estes valores
<perm> válidos para permissão:
[...] n – Nenhum
r – Leitura
w – Gravação
c – Alteração (gravação)
f – Controle total

[/d usuário Negar acesso ao usuário especificado.


[...]

/? Exibe a ajuda no prompt de comando.

Saída de exemplo

Saída A ACE (entrada de controle de acesso) se aplica a

OI Herança de objeto. Esta pasta e arquivos.

CI Herança de contêiner. Esta pasta e subpastas.

IO Somente herança. A ACE não se aplica ao arquivo/diretório atual.

Nenhuma mensagem de saída Apenas esta pasta.

(OI)(CI) Esta pasta, as subpastas e os arquivos.

(OI)(CI)(IO) Apenas subpastas e arquivos.

(CI)(IO) Somente subpastas.

(OI)(IO) Somente arquivos.

Comentários
Você pode usar curingas (? e *) para especificar vários arquivos.

Você pode especificar mais de um usuário.

Links relacionados
Chave da sintaxe de linha de comando

icacls
chamada
Artigo • 10/04/2023

Chama um programa em lote de outro sem interromper o programa em lote pai. O


comando call aceita rótulos como o destino da chamada.

7 Observação

A chamada não tem efeito no prompt de comando quando é usada fora de um


script ou arquivo em lote.

Sintaxe

call [drive:][path]<filename> [<batchparameters>]]


call [:<label> [<arguments>]]

Parâmetros

Parâmetro Descrição

[<drive>:] Especifica o local e o nome do programa em lote que você deseja chamar. O
[<path>] parâmetro <filename> é necessário e precisa ter uma extensão .bat ou .cmd.
<filename>

<batchparameters> Especifica as informações de linha de comando exigidas pelo programa em


lote.

:<label> Especifica o rótulo para o qual você deseja que um controle de programa
em lote vá.

<arguments> Especifica as informações de linha de comando a serem passadas para a


nova instância do programa em lote, começando em :<label> .

/? Exibe a ajuda no prompt de comando.

Parâmetros de lote
As referências de argumento do script de lote (%0, %1,...) estão listadas nas tabelas a
seguir.
O uso do valor %* em um script de lote refere-se a todos os argumentos (por exemplo,
%1, %2, %3...).

Você pode usar as seguintes sintaxes opcionais como substituições para parâmetros de
lote (%n):

Parâmetro Descrição
de lote

%~1 Expande %1 e remove as aspas ao redor.

%~f1 Expande %1 para um caminho totalmente qualificado.

%~d1 Expande %1 apenas para uma letra de unidade.

%~p1 Expande %1 apenas para um caminho.

%~n1 Expande %1 apenas para um nome de arquivo.

%~x1 Expande %1 apenas para uma extensão de nome de arquivo.

%~s1 Expande %1 para um caminho totalmente qualificado que contém apenas nomes
curtos.

%~a1 Expande %1 para os atributos de arquivo.

%~t1 Expande %1 para a data e hora do arquivo.

%~z1 Expande %1 para o tamanho do arquivo.

%~$PATH:1 Pesquisa os diretórios listados na variável de ambiente PATH e expande %1 para o


nome totalmente qualificado do primeiro diretório encontrado. Se o nome da
variável de ambiente não estiver definido ou o arquivo não for encontrado pela
pesquisa, esse modificador expandirá para a cadeia de caracteres vazia.

A seguinte tabela mostra como você pode combinar modificadores com os parâmetros
de lote para resultados compostos:

Parâmetro de Descrição
lote com
modificador

%~dp1 Expande %1 apenas para uma letra de unidade e caminho.

%~nx1 Expande %1 apenas para um nome de arquivo e extensão.

%~dp$PATH:1 Pesquisa os diretórios listados na variável de ambiente PATH para %1 e


expande para a letra da unidade e o caminho do primeiro diretório
encontrado.
Parâmetro de Descrição
lote com
modificador

%~ftza1 Expande %1 para exibir uma saída semelhante ao comando dir.

Nos exemplos acima, %1 e PATH podem ser substituídos por outros valores válidos. A
sintaxe %~ é encerrada por um número de argumento válido. Os modificadores %~ não
podem ser usados com %*.

Comentários
Usando parâmetros de lote:

Parâmetros de lote podem conter qualquer informação que você possa passar
para um programa de lote, incluindo opções de linha de comando, nomes de
arquivo, os parâmetros de lote %0 a %9 e variáveis (por exemplo, %baud%).

Usando o parâmetro <label> :

Usando call com o parâmetro <label> , você cria um contexto de arquivo de lote e
passa o controle para a instrução após o rótulo especificado. Na primeira vez que
o final do arquivo de lote é encontrado (ou seja, depois de saltar para o rótulo), o
controle retorna para a instrução após a instrução call. Na segunda vez que o final
do arquivo de lote é encontrado, o script de lote é encerrado.

Usando barras verticais e símbolos de redirecionamento:

Não use barras verticais (|) nem símbolos de redirecionamento ( < ou > ) com
call.

Fazendo uma chamada recursiva

Você pode criar um programa em lote que chama a si mesmo. No entanto, você
precisa fornecer uma condição de saída. Caso contrário, os programas de lote pai
e filho poderão fazer um loop infinito.

Trabalhando com extensões de comando

Se as extensões de comando estiverem habilitadas, call aceitará <label> como


destino da chamada. A sintaxe correta é call :<label> <arguments> .

Exemplos
Para executar o programa checknew.bat de outro programa de lote, digite o seguinte
comando no programa de lote pai:

call checknew

Se o programa de lote pai aceitar dois parâmetros de lote e você quiser que ele passe
esses parâmetros para checknew.bat, digite o seguinte comando no programa de lote
pai:

call checknew %1 %2

Links relacionados
Chave da sintaxe de linha de comando
cd
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe o nome do diretório atual ou altera o diretório atual. Se usado apenas com uma
letra de unidade (por exemplo, cd C: ), cd exibirá os nomes do diretório atual na
unidade especificada. Se usado sem parâmetros, cd exibirá a unidade e o diretório
atuais.

7 Observação

Esse comando é igual ao comando chdir.

Sintaxe

cd [/d] [<drive>:][<path>]
cd [..]
chdir [/d] [<drive>:][<path>]
chdir [..]

Parâmetros

Parâmetro Descrição

/d Altera a unidade atual, bem como o diretório atual de uma unidade.

<drive>: Especifica a unidade a ser exibida ou alterada (se diferente da unidade atual).

<path> Especifica o caminho para o diretório que queira exibir ou alterar.

[..] Especifica que queira alterar para a pasta pai.

/? Exibe a ajuda no prompt de comando.

Comentários
Se as extensões de comando estiverem habilitadas, as seguintes condições se aplicarão
ao comando cd:

A cadeia de caracteres de diretório atual é convertida para usar o mesmo caso que
os nomes no disco. Por exemplo, cd c:\temp definiria o diretório atual como
C:\Temp se esse for o caso no disco.

Os espaços não são tratados como delimitadores, portanto <path> , podem conter
espaços sem incluir aspas. Por exemplo:

cd username\programs\start menu

é igual a:

cd "username\programs\start menu"

Se as extensões estiverem desabilitadas, as aspas serão necessárias.

Para desabilitar extensões de comando, digite:

cmd /e:off

Exemplos
Para retornar ao diretório raiz, a parte superior da hierarquia de diretório de uma
unidade:

cd\

Para alterar o diretório padrão em uma unidade diferente daquela em que você está:

cd [<drive>:[<directory>]]
Para verificar a alteração no diretório, digite:

cd [<drive>:]

Links relacionados
Chave da sintaxe de linha de comando

Comando chdir
certreq
Artigo • 11/04/2023

O comando certreq pode ser usado para solicitar certificados de uma autoridade de certificação (AC), para recuperar uma
resposta a uma solicitação anterior de uma AC, para criar uma nova solicitação de um arquivo. inf, para aceitar e instalar uma
resposta a uma solicitação, para criar uma solicitação de certificação cruzada ou de subordinação qualificada por meio de um
Certificado de Autoridade de Certificação ou solicitação existente e para assinar uma solicitação de certificação cruzada ou de
subordinação qualificada.

) Importante

Versões anteriores do comando certreq podem não fornecer todas as opções descritas aqui. Para ver as opções com
suporte com base em versões específicas do certreq, execute a opção de ajuda de linha de comando, certreq -v -? .

O comando certreq não dá suporte à criação de uma solicitação de certificado com base em um modelo de Atestado de
Chave quando em um ambiente CEP/CES.

2 Aviso

O conteúdo deste tópico é baseado nas configurações padrão do Windows Server; por exemplo, na definição do
comprimento da chave como 2048, na escolha do Provedor de Armazenamento de Chaves de Software da Microsoft
como o CSP e no uso do Algoritmo de Hash Seguro 1 (SHA1). Avalie essas seleções em relação aos requisitos da política
de segurança da sua empresa.

Sintaxe

certreq [-submit] [options] [requestfilein [certfileout [certchainfileout [fullresponsefileOut]]]]


certreq -retrieve [options] requestid [certfileout [certchainfileout [fullresponsefileOut]]]
certreq -new [options] [policyfilein [requestfileout]]
certreq -accept [options] [certchainfilein | fullresponsefilein | certfilein]
certreq -sign [options] [requestfilein [requestfileout]]
certreq –enroll [options] templatename
certreq –enroll –cert certId [options] renew [reusekeys]

Parâmetros

Parâmetro Descrição

-submit Envia uma solicitação a uma autoridade de certificação.

-retrieve <requestid> Recupera uma resposta a uma solicitação anterior de uma autoridade de certificação.

-new Cria uma solicitação de um arquivo .inf.

-accept Aceita e instala uma resposta a uma solicitação de certificado.

-policy Define a política de uma solicitação.

-sign Assina uma solicitação de subordinação qualificada ou certificação cruzada.

-enroll Registra ou renova um certificado.

-? Exibe uma lista de sintaxe, opções e descrições certreq.

<parameter> -? Exibe ajuda para o parâmetro especificado.

-v -? Exibe uma lista detalhada da sintaxe, opções e descrições certreq.


Exemplos

certreq -submit
Para enviar uma solicitação de certificado simples:

certreq –submit certrequest.req certnew.cer certnew.pfx

Comentários
Esse é o parâmetro de certreq.exe padrão. Se nenhuma opção for especificada no prompt de linha de comando,
certreq.exe tentará enviar uma solicitação de certificado a uma autoridade de certificação. Você precisa especificar um
arquivo de solicitação de certificado ao usar a opção -submit. Se esse parâmetro for omitido, uma janela de Arquivo
Aberto comum será exibida, permitindo que você selecione o arquivo de solicitação de certificado apropriado.

Para solicitar um certificado especificando o atributo SAN, consulte a seção Como usar o utilitário certreq.exe para criar e
enviar uma seção de solicitação de certificado da Base de Dados de Conhecimento da Microsoft 931351 Como adicionar
um Nome Alternativo da Entidade a um certificado LDAP seguro .

certreq -retrieve
Para recuperar o ID do certificado 20 e criar um arquivo de certificado (.cer) chamado MyCertificate:

certreq -retrieve 20 MyCertificate.cer

Comentários
Use certreq -retrieve requestid para recuperar o certificado depois que a autoridade de certificação o tiver emitido. O PKC
requestid pode ser um decimal ou hex com prefixo 0x e pode ser um número de série de certificado sem prefixo 0x. Você
também pode usá-lo para recuperar certificados que já tenham sido emitidos pela autoridade de certificação, incluindo
certificados revogados ou expirados, sem considerar se a solicitação do certificado já esteve no estado pendente.

Se você enviar uma solicitação à autoridade de certificação, o módulo de política da autoridade de certificação poderá
deixar a solicitação em um estado pendente e retornar a requestid ao chamador certreq para exibição. Eventualmente, o
administrador da autoridade de certificação emitirá o certificado ou negará a solicitação.

certreq -new
Para criar uma solicitação:

[newrequest]
; At least one value must be set in this section
subject = CN=W2K8-BO-DC.contoso2.com

Veja abaixo algumas das seções possíveis que podem ser adicionadas ao arquivo INF:

[newrequest]
Essa área do arquivo INF é obrigatória para qualquer novo modelo de solicitação de certificado e precisa incluir pelo menos
um parâmetro com um valor.
Key1 Descrição Value2 Exemplo

Assunto Vários aplicativos Valores de cadeia de caracteres de Nome Subject = CN=computer1.contoso.com


dependem das Diferenciado Relativo Subject=CN=John
informações do Smith,CN=Users,DC=Contoso,DC=com
assunto em um
certificado.
Recomendamos
especificar um valor
para essa chave. Se o
assunto não estiver
definido aqui,
recomendamos que
você inclua um nome
de entidade como
parte da extensão de
certificado de nome
alternativo da
entidade.

Exportável Se definida como true | false Exportable = TRUE . As chaves CNG podem
TRUE, a chave distinguir entre esse e o texto não
privada poderá ser criptografado exportável. As chaves CAPI1
exportada com o não podem.
certificado. Para
garantir um alto nível
de segurança, as
chaves privadas não
devem ser
exportáveis; no
entanto, em alguns
casos, poderá ser
necessário se vários
computadores ou
usuários precisarem
compartilhar a
mesma chave
privada.

ExportableEncrypted Especifica se a chave true | false ExportableEncrypted = true


privada deve ser
definida como Dica: nem todos os tamanhos e
exportável. algoritmos de chave pública funcionarão
com todos os algoritmos de hash. O CSP
especificado também precisa dar suporte
ao algoritmo de hash especificado. Para
ver a lista de algoritmos de hash com
suporte, você pode executar o comando:
certutil -oid 1 | findstr pwszCNGAlgid |
findstr /v CryptOIDInfo

HashAlgorithm Algoritmo de hash a Sha256, sha384, sha512, sha1, md5, md4, md2 HashAlgorithm = sha1 . Para ver a lista de
ser usado para essa algoritmos de hash com suporte, use:
solicitação. certutil -oid 1 | findstr pwszCNGAlgid |
findstr /v CryptOIDInfo

KeyAlgorithm O algoritmo que será RSA, DH, DSA, ECDH_P256, ECDH_P521, KeyAlgorithm = RSA
usado pelo provedor ECDSA_P256, ECDSA_P384, ECDSA_P521
de serviços para
gerar um par de
chaves públicas e
privadas.
Key1 Descrição Value2 Exemplo

KeyContainer Não recomendamos Valor de cadeia de caracteres aleatória KeyContainer = {C347BD28-7F69-4090-AA16-


definir esse Dica: use aspas duplas em torno de todo valor BC58CF4D749C}
parâmetro para de chave INF que tenha caracteres em branco ou
novas solicitações especiais para evitar possíveis problemas de
nas quais o novo análise do INF.
material de chave é
gerado. O contêiner
de chaves é gerado e
mantido
automaticamente
pelo sistema.
No caso de
solicitações em que
o material de chave
existente deve ser
usado, esse valor
pode ser definido
como o nome chave-
contêiner da chave
existente. Use o
comando certutil –
key para exibir a lista
de contêineres de
chave disponíveis
para o contexto do
computador. Use o
comando certutil –
key –user para o
contexto do usuário
atual.

KeyLength Define o Qualquer tamanho de chave válido com suporte KeyLength = 2048
comprimento da do provedor de serviços criptográficos.
chave pública e
privada. O tamanho
da chave tem um
impacto no nível de
segurança do
certificado. O
tamanho maior da
chave geralmente
fornece um nível de
segurança mais alto;
no entanto, alguns
aplicativos podem
ter limitações em
relação ao tamanho
da chave.

KeySpec Determina se a chave AT_NONE, AT_SIGNATURE, AT_KEYEXCHANGE KeySpec = AT_KEYEXCHANGE


pode ser usada em
assinaturas, no
Exchange
(criptografia) ou em
ambos.
Key1 Descrição Value2 Exemplo

KeyUsage Define para que a CERT_DIGITAL_SIGNATURE_KEY_USAGE -- 80 KeyUsage =


chave de certificado (128) CERT_DIGITAL_SIGNATURE_KEY_USAGE |
deve ser usada. CERT_NON_REPUDIATION_KEY_USAGE -- 40 CERT_KEY_ENCIPHERMENT_KEY_USAGE
(64)
CERT_KEY_ENCIPHERMENT_KEY_USAGE -- 20
Dica: vários valores usam um separador de
(32)
símbolo de barra vertical (|). Use aspas

CERT_DATA_ENCIPHERMENT_KEY_USAGE -- 10
duplas ao usar vários valores para evitar
problemas de análise do INF. Os valores
(16)
mostrados são valores hexadecimais
CERT_KEY_AGREEMENT_KEY_USAGE -- 8
(decimais) para cada definição de bit.
CERT_KEY_CERT_SIGN_KEY_USAGE -- 4
Sintaxes mais antigas também podem ser
CERT_OFFLINE_CRL_SIGN_KEY_USAGE -- 2
usadas: um único valor hexadecimal com
CERT_CRL_SIGN_KEY_USAGE -- 2
vários bits definidos, em vez da
CERT_ENCIPHER_ONLY_KEY_USAGE -- 1
representação simbólica. Por exemplo,
CERT_DECIPHER_ONLY_KEY_USAGE -- 8000
KeyUsage = 0xa0 .
(32768)

KeyUsageProperty Recupera um valor NCRYPT_ALLOW_DECRYPT_FLAG -- 1 KeyUsageProperty =


que identifica a NCRYPT_ALLOW_SIGNING_FLAG -- 2 NCRYPT_ALLOW_DECRYPT_FLAG |
finalidade específica NCRYPT_ALLOW_KEY_AGREEMENT_FLAG -- 4 NCRYPT_ALLOW_SIGNING_FLAG
para a qual uma NCRYPT_ALLOW_ALL_USAGES -- ffffff
chave privada pode (16777215)
ser usada.

MachineKeySet Essa chave é true | false . O padrão é falso. MachineKeySet = true


importante quando
você precisa criar
certificados que
pertencem ao
computador e não a
um usuário. O
material de chave
gerado é mantido no
contexto de
segurança da
entidade de
segurança (conta de
usuário ou
computador) que
criou a solicitação.
Quando um
administrador cria
uma solicitação de
certificado em nome
de um computador,
o material da chave
precisa ser criado no
contexto de
segurança do
computador e não
no contexto de
segurança do
administrador. Caso
contrário, o
computador não
poderia acessar sua
chave privada, pois
estaria no contexto
de segurança do
administrador.
Key1 Descrição Value2 Exemplo

NotBefore Especifica uma data Data ou data e hora NotBefore = 7/24/2012 10:31 AM
ou data e hora antes
das quais a Dica: NotBefore e NotAfter são apenas
solicitação não pode para R equestType=cert . A análise de data
ser emitida. tenta diferenciar localidades. O uso de
NotBefore pode ser nomes de mês será desambiguado e
usado com deverá funcionar em todas as localidades.
ValidityPeriod e
ValidityPeriodUnits .

NotAfter Especifica uma data Data ou data e hora NotAfter = 9/23/2014 10:31 AM
ou data e hora
depois das quais a Dica: NotBefore e NotAfter são apenas
solicitação não pode para RequestType=cert . A análise de data
ser emitida. NotAfter tenta diferenciar localidades. O uso de
não pode ser usado nomes de mês será desambiguado e
com ValidityPeriod deverá funcionar em todas as localidades.
ou
ValidityPeriodUnits .

PrivateKeyArchive A configuração true | false PrivateKeyArchive = true


PrivateKeyArchive só
funcionará se o
RequestType
correspondente
estiver definido
como CMC porque
apenas o formato de
solicitação de CMC
(Mensagens de
Gerenciamento de
Certificado) por CMS
permite transferir
com segurança a
chave privada do
solicitante para a AC
para fins de
arquivamento de
chave.

EncryptionAlgorithm O algoritmo de As opções possíveis variam, dependendo da EncryptionAlgorithm = 3des


criptografia a ser versão do sistema operacional e do conjunto de
usado. provedores criptográficos instalados. Para ver a
lista de algoritmos disponíveis, execute o
comando: certutil -oid 2 | findstr
pwszCNGAlgid . O CSP especificado usado
também precisa dar suporte ao algoritmo e ao
tamanho de criptografia simétrica especificados.

EncryptionLength Tamanho do Qualquer tamanho permitido pelo EncryptionLength = 128


algoritmo de EncryptionAlgorithm especificado.
criptografia a ser
usado.

ProviderName O nome do provedor Se você não souber o nome do provedor do CSP ProviderName = Microsoft RSA SChannel
é o nome de exibição que está usando, execute certutil –csplist em Cryptographic Provider
do CSP. uma linha de comando. O comando exibirá os
nomes de todos os CSPs disponíveis no sistema
local
Key1 Descrição Value2 Exemplo

ProviderType O tipo de provedor é Se você não souber o tipo de provedor do CSP ProviderType = 1
usado para que está usando, execute certutil –csplist em
selecionar um prompt de linha de comando. O comando
provedores exibirá o tipo de provedor de todos os CSPs
específicos com base disponíveis no sistema local.
na funcionalidade de
algoritmo específica,
como RSA Full.

RenewalCert Se você precisar O hash de certificado de qualquer certificado RenewalCert =


renovar um disponível no computador em que a solicitação 4EDF274BD2919C6E9EC6A522F0F3B153E9B1582D
certificado que existe de certificado é criada. Se você não souber o
no sistema em que a hash do certificado, use o Snap-In MMC de
solicitação de Certificados e examine o certificado que deve ser
certificado é gerada, renovado. Abra as propriedades do certificado e
especifique seu hash veja o atributo Thumbprint do certificado. A
de certificado como renovação de certificado requer um formato de
o valor dessa chave. solicitação PKCS#7 ou CMC .

RequesterName Faz a solicitação de Domain\User Requestername = Contoso\BSmith


registro em nome de
outra solicitação de
usuário. A solicitação
também precisa ser
assinada com um
certificado do
Agente de Registro
ou a AC rejeitará a
solicitação. Use a
opção -cert para
especificar o
certificado do agente
de registro. O nome
do solicitante poderá
ser especificado para
solicitações de
certificado se o
RequestType estiver
definido como
PKCS#7 ou CMC . Se o
RequestType estiver
definido como
PKCS#10 , essa chave
será ignorada. O
Requestername só
pode ser definido
como parte da
solicitação. Não é
possível manipular o
Requestername em
uma solicitação
pendente.

RequestType Determina o padrão PKCS10 -- 1 RequestType = CMC


usado para gerar e PKCS7 -- 2
enviar a solicitação CMC -- 3
de certificado. Cert -- 4
SCEP -- fd00 (64768)

Dica: essa opção indica um certificado


autoassinado ou autoemitido. Ele não gera uma
solicitação, mas sim um novo certificado, e o
instala. Autoassinado é o padrão. Especifique um
certificado de assinatura usando a opção -cert
para criar um certificado autoemitido que não é
autoassinado.
Key1 Descrição Value2 Exemplo

SecurityDescriptor Contém as SecurityDescriptor = D:P(A;;GA;;;SY)


informações de (A;;GA;;;BA)
segurança associadas
a objetos protegíveis.
Para a maioria dos
objetos protegíveis,
você pode
especificar o
descritor de
segurança de um
objeto na chamada
de função que cria o
objeto. Cadeias de
caracteres baseadas
na linguagem de
definição do
descritor de
segurança.

Dica: isso é relevante


apenas para chaves
de cartão não
inteligentes de
contexto do
computador.

AlternateSignatureAlgorithm Especifica e recupera true | false AlternateSignatureAlgorithm = false


um valor booliano
que indica se o OID Para uma assinatura RSA, false indica um
(identificador de Pkcs1 v1.5 ; já true indica uma assinatura

objeto do algoritmo v2.1 .


de assinatura) para
uma solicitação
PKCS#10 ou
assinatura de
certificado é distinto
ou combinado.

Silencioso Por padrão, essa true | false Silent = true


opção permite que o
CSP acesse a área de
trabalho interativa
do usuário e solicite
informações como
um PIN de cartão
inteligente do
usuário. Se essa
chave for definida
como TRUE, o CSP
não poderá interagir
com a área de
trabalho e será
impedido de exibir
qualquer interface do
usuário para o
usuário.
Key1 Descrição Value2 Exemplo

SMIME Se esse parâmetro true | false SMIME = true


for definido como
TRUE, uma extensão
com o valor do
identificador de
objeto
1.2.840.113549.1.9.15
será adicionada à
solicitação. O
número de
identificadores de
objeto depende da
versão do sistema
operacional instalada
e da funcionalidade
do CSP, que se
referem a algoritmos
de criptografia
simétrica que podem
ser usados por
aplicativos S/MIME
(Secure Multipurpose
Internet Mail
Extensions), como o
Outlook.

UseExistingKeySet Esse parâmetro é true | false UseExistingKeySet = true


usado para
especificar que um
par de chaves
existente deve ser
usado na criação de
uma solicitação de
certificado. Se essa
chave estiver
definida como TRUE,
você também
precisará especificar
um valor para a
chave RenewalCert
ou o nome
KeyContainer. Você
não pode definir a
chave exportável
porque não pode
alterar as
propriedades de uma
chave existente.
Nesse caso, nenhum
material de chave é
gerado quando a
solicitação de
certificado é criada.

KeyProtection Especifica um valor XCN_NCRYPT_UI_NO_PROTCTION_FLAG -- 0 KeyProtection =


que indica como XCN_NCRYPT_UI_PROTECT_KEY_FLAG -- 1 NCRYPT_UI_FORCE_HIGH_PROTECTION_FLAG
uma chave privada é XCN_NCRYPT_UI_FORCE_HIGH_PROTECTION_FLAG
protegida antes do -- 2
uso.
Key1 Descrição Value2 Exemplo

SuppressDefaults Especifica um valor true | false SuppressDefaults = true


booliano que indica
se as extensões e os
atributos padrão
estão incluídos na
solicitação. Os
padrões são
representados por
seus identificadores
de objeto (OIDs).

FriendlyName Um nome amigável Texto FriendlyName = Server1


para o novo
certificado.

ValidityPeriodUnits Especifica um Numérico ValidityPeriodUnits = 3


número de unidades
que devem ser
usadas com
ValidityPeriod.
Observação: isso é
usado somente
quando o request
type=cert .

ValidityPeriod ValidityPeriod precisa Years | Months | Weeks | Days | Hours | ValidityPeriod = Years
ser um período de Minutes | Seconds
tempo plural em
inglês dos EUA.
Observação: isso é
usado somente
quando a solicitação
type=cert.

1Parâmetro à esquerda do sinal de igual (=)

2
Parâmetro à direita do sinal de igual (=)

[extensions]

Esta seção é opcional.

OID de extensão Definição Exemplo

2.5.29.17 2.5.29.17 = {text}

continue continue = UPN=User@Domain.com&

continue continue = EMail=User@Domain.com&

continue continue = DNS=host.domain.com&

continue continue = DirectoryName=CN=Name,DC=Domain,DC=com&

continue continue = URL=<http://host.domain.com/default.html&>

continue continue = IPAddress=10.0.0.1&

continue continue = RegisteredId=1.2.3.4.5&

continue continue = 1.2.3.4.6.1={utf8}String&

continue continue = 1.2.3.4.6.2={octet}AAECAwQFBgc=&

continue continue = 1.2.3.4.6.2={octet}{hex}00 01 02 03 04 05 06 07&


OID de extensão Definição Exemplo

continue continue = 1.2.3.4.6.3={asn}BAgAAQIDBAUGBw==&

continue continue = 1.2.3.4.6.3={hex}04 08 00 01 02 03 04 05 06 07

2.5.29.37 2.5.29.37={text}

continue continue = 1.3.6.1.5.5.7

continue continue = 1.3.6.1.5.5.7.3.1

2.5.29.19 {text}ca=0pathlength=3

Crítico Critical=2.5.29.19

KeySpec AT_NONE -- 0
AT_SIGNATURE -- 2
AT_KEYEXCHANGE -- 1

RequestType PKCS10 -- 1
PKCS7 -- 2
CMC -- 3
Cert -- 4
SCEP -- fd00 (64768)

KeyUsage CERT_DIGITAL_SIGNATURE_KEY_USAGE -- 80 (128)


CERT_NON_REPUDIATION_KEY_USAGE -- 40 (64)
CERT_KEY_ENCIPHERMENT_KEY_USAGE -- 20 (32)
CERT_DATA_ENCIPHERMENT_KEY_USAGE -- 10 (16)
CERT_KEY_AGREEMENT_KEY_USAGE -- 8
CERT_KEY_CERT_SIGN_KEY_USAGE -- 4
CERT_OFFLINE_CRL_SIGN_KEY_USAGE -- 2
CERT_CRL_SIGN_KEY_USAGE -- 2
CERT_ENCIPHER_ONLY_KEY_USAGE -- 1
CERT_DECIPHER_ONLY_KEY_USAGE -- 8000 (32768)

KeyUsageProperty NCRYPT_ALLOW_DECRYPT_FLAG -- 1
NCRYPT_ALLOW_SIGNING_FLAG -- 2
NCRYPT_ALLOW_KEY_AGREEMENT_FLAG -- 4
NCRYPT_ALLOW_ALL_USAGES -- ffffff (16777215)

KeyProtection NCRYPT_UI_NO_PROTECTION_FLAG -- 0
NCRYPT_UI_PROTECT_KEY_FLAG -- 1
NCRYPT_UI_FORCE_HIGH_PROTECTION_FLAG -- 2

SubjectNameFlags template CT_FLAG_SUBJECT_REQUIRE_COMMON_NAME -- 40000000 (1073741824)


CT_FLAG_SUBJECT_REQUIRE_DIRECTORY_PATH -- 80000000 (2147483648)
CT_FLAG_SUBJECT_REQUIRE_DNS_AS_CN -- 10000000 (268435456)
CT_FLAG_SUBJECT_REQUIRE_EMAIL -- 20000000 (536870912)
CT_FLAG_OLD_CERT_SUPPLIES_SUBJECT_AND_ALT_NAME -- 8
CT_FLAG_SUBJECT_ALT_REQUIRE_DIRECTORY_GUID -- 1000000 (16777216)
CT_FLAG_SUBJECT_ALT_REQUIRE_DNS -- 8000000 (134217728)
CT_FLAG_SUBJECT_ALT_REQUIRE_DOMAIN_DNS -- 400000 (4194304)
CT_FLAG_SUBJECT_ALT_REQUIRE_EMAIL -- 4000000 (67108864)
CT_FLAG_SUBJECT_ALT_REQUIRE_SPN -- 800000 (8388608)
CT_FLAG_SUBJECT_ALT_REQUIRE_UPN -- 2000000 (33554432)
OID de extensão Definição Exemplo

X500NameFlags CERT_NAME_STR_NONE -- 0
CERT_OID_NAME_STR -- 2
CERT_X500_NAME_STR -- 3
CERT_NAME_STR_SEMICOLON_FLAG -- 40000000 (1073741824)
CERT_NAME_STR_NO_PLUS_FLAG -- 20000000 (536870912)
CERT_NAME_STR_NO_QUOTING_FLAG -- 10000000 (268435456)
CERT_NAME_STR_CRLF_FLAG -- 8000000 (134217728)
CERT_NAME_STR_COMMA_FLAG -- 4000000 (67108864)
CERT_NAME_STR_REVERSE_FLAG -- 2000000 (33554432)
CERT_NAME_STR_FORWARD_FLAG -- 1000000 (16777216)
CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG -- 10000 (65536)
CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG -- 20000 (131072)
CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG -- 40000 (262144)
CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG -- 80000 (524288)
CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG -- 100000 (1048576)
CERT_NAME_STR_ENABLE_PUNYCODE_FLAG -- 200000 (2097152)

7 Observação

SubjectNameFlags permite que o arquivo INF especifique quais campos de extensão Subject e SubjectAltName devem ser

preenchidos automaticamente pelo certreq com base nas propriedades atuais do usuário ou do computador atual: nome
DNS, UPN e assim por diante. O uso do modelo literal significa que os sinalizadores de nome do modelo são usados. Isso
permite que um único arquivo INF seja usado em vários contextos para gerar solicitações com informações de assunto
específicas do contexto.

X500NameFlags especifica os sinalizadores a serem transmitidos diretamente à API CertStrToName quando o valor Subject

INF keys é convertido em um NomeDiferenciado codificado em ASN.1.

Exemplo

Para criar um arquivo de política (.inf) no Bloco de Notas e salvá-lo como requestconfig.inf:

[NewRequest]
Subject = CN=<FQDN of computer you are creating the certificate>
Exportable = TRUE
KeyLength = 2048
KeySpec = 1
KeyUsage = 0xf0
MachineKeySet = TRUE
[RequestAttributes]
CertificateTemplate=WebServer
[Extensions]
OID = 1.3.6.1.5.5.7.3.1
OID = 1.3.6.1.5.5.7.3.2

No computador para o qual você está solicitando um certificado:

certreq –new requestconfig.inf certrequest.req

Para usar a sintaxe da seção [Strings] para OIDs e outros dados difíceis de interpretar. O novo exemplo de sintaxe {text} para a
extensão de EKU, que usa uma lista separada por vírgulas de OIDs:

[Version]
Signature=$Windows NT$
[Strings]
szOID_ENHANCED_KEY_USAGE = 2.5.29.37
szOID_PKIX_KP_SERVER_AUTH = 1.3.6.1.5.5.7.3.1
szOID_PKIX_KP_CLIENT_AUTH = 1.3.6.1.5.5.7.3.2

[NewRequest]
Subject = CN=TestSelfSignedCert
Requesttype = Cert

[Extensions]
%szOID_ENHANCED_KEY_USAGE%={text}%szOID_PKIX_KP_SERVER_AUTH%,
_continue_ = %szOID_PKIX_KP_CLIENT_AUTH%

certreq -accept
O parâmetro –accept vincula a chave privada gerada anteriormente ao certificado emitido e remove a solicitação de
certificado pendente do sistema em que o certificado é solicitado (se houver uma solicitação correspondente).

Para aceitar manualmente um certificado:

certreq -accept certnew.cer

2 Aviso

O uso do parâmetro -accept com as opções -user e –machine indica se o certificado de instalação deve ser instalado no
contexto do usuário ou do computador. Se houver uma solicitação pendente em algum contexto que corresponda à
chave pública que está sendo instalada, essas opções não serão necessárias. Se não houver nenhuma solicitação
pendente, uma delas precisará ser especificada.

certreq -policy
O arquivo policy.inf é um arquivo de configuração que define as restrições aplicadas a uma certificação de AC quando uma
subordinação qualificada é definida.

Para criar uma solicitação de certificado cruzado:

certreq -policy certsrv.req policy.inf newcertsrv.req

O uso de certreq -policy sem nenhum parâmetro adicional abre uma janela de diálogo, permitindo que você selecione o
arquivo solicitado (.req, .cmc, .txt, .der, .cer ou .crt). Depois de selecionar o arquivo solicitado e clicar em Abrir, outra janela de
diálogo será aberta, permitindo que você selecione o arquivo policy.inf.

Exemplos
Encontre um exemplo do arquivo policy.inf na sintaxe CAPolicy.inf.

certreq -sign
Para criar, assinar e enviar uma solicitação de certificado:

certreq -new policyfile.inf myrequest.req


certreq -sign myrequest.req myrequest.req
certreq -submit myrequest_sign.req myrequest_cert.cer
Comentários

O uso de certreq -sign sem nenhum parâmetro adicional abrirá uma janela de diálogo para que você possa selecionar o
arquivo solicitado (req, cmc, txt, der, cer ou crt).

A assinatura da solicitação de subordinação qualificada pode exigir credenciais de Administrador Corporativo. Essa é
uma prática recomendada para emitir certificados de autenticação de subordinação qualificada.

O certificado usado para assinar a solicitação de subordinação qualificada usa o modelo de subordinação qualificada. Os
Administradores da Empresa terão que assinar a solicitação ou conceder permissões de usuário aos indivíduos que
assinarem o certificado.

Talvez seja necessário que outras pessoas assinem a solicitação do CMC depois de você. Isso dependerá do nível de
garantia associado à subordinação qualificada.

Se a AC pai da AC subordinada qualificada que você está instalando estiver offline, você precisará obter o certificado de
AC para a AC subordinada qualificada do pai offline. Se a AC pai estiver online, especifique o certificado de AC para a AC
subordinada qualificada durante o assistente de Instalação dos Serviços de Certificados.

certreq -enroll
Você pode usar esse comentário para registrar ou renovar seus certificados.

Exemplos

Para registrar um certificado, usando o modelo WebServer e selecionando o servidor de política com U/I:

certreq -enroll –machine –policyserver * WebServer

Para renovar um certificado usando um número de série:

certreq –enroll -machine –cert 61 2d 3c fe 00 00 00 00 00 05 renew

Você só pode renovar certificados válidos. Os certificados expirados não podem ser renovados e precisam ser substituídos por
um novo certificado.

Opções
Opções Descrição

-any Force ICertRequest::Submit para determinar o tipo de codificação.

-attrib Especifica os pares de cadeia de caracteres Nome e Valor, separados por dois pontos.
<attributestring>
Separe os pares de cadeia de caracteres Name e Value usando \n (por exemplo, Name1:value1\nName2:value2).

-binary Formata arquivos de saída como binários em vez de codificados em base64.

-policyserver ldap: <path>


<policyserver> Insira o URI ou o ID exclusivo de um computador que executa o serviço Web da Política de Registro de Certificado.

Para especificar que você gostaria de usar um arquivo de solicitação pela navegação, basta usar um sinal de subtração
(-) para <policyserver> .
Opções Descrição

-config Processa a operação usando a CA especificada na cadeia de caracteres de configuração (isto é, CAHostName\CAName.
<ConfigString> Para uma conexão https:\\, especifique o URI do servidor de registro. Para a AC do repositório do computador local, use
um sinal de subtração (-).

-anonymous Use credenciais anônimas para serviços Web de Registro de Certificado.

-kerberos Use credenciais Kerberos (domínio) para serviços Web de Registro de Certificado.

-clientcertificate Você pode substituir o <ClientCertId> por uma impressão digital do certificado, CN, EKU, modelo, email, UPN ou pela
<ClientCertId> nova sintaxe name=value .

-username Usado com serviços Web de Registro de Certificado. Você pode substituir <username> pelo nome SAM ou pelo valor
<username> domain\user. Essa opção é usada com a opção -p .

-p <password> Usado com serviços Web de Registro de Certificado. Substitua <password> pela senha do usuário real. Essa opção é
usada com a opção -username .

-user Configura o contexto -user para uma nova solicitação de certificado ou especifica o contexto para uma aceitação de
certificado. Esse é o contexto padrão, se nenhum for especificado no INF ou modelo.

-machine Configura uma nova solicitação de certificado ou especifica o contexto para uma aceitação de certificado do contexto
do computador. Para novas solicitações, ela precisa ser consistente com a chave INF MachineKeyset e o contexto do
modelo. Se essa opção não for especificada e o modelo não definir um contexto, o padrão será o contexto do usuário.

-crl Inclui CRLs (listas de certificados revogados) na saída para o arquivo PKCS nº 7 codificado em base64 especificado por
certchainfileout ou para o arquivo codificado em base64 especificado por requestfileout .

-rpc Instrui o AD CS (Serviços de Certificados do Active Directory) a usar uma conexão de servidor RPC (chamada de
procedimento remoto) em vez de COM distribuído.

- Use o Serviço de Chave ou representação para enviar a solicitação do contexto do Sistema Local. Exige que o usuário
adminforcemachine que invoca essa opção seja membro dos Administradores Locais.

-renewonbehalfof Envia uma renovação em nome da entidade identificada no certificado de autenticação. Isso define CR_IN_ROBO na
hora de chamar o método ICertRequest::Submit

-f Força os arquivos existentes a serem substituídos. Também ignora modelos e políticas de cache.

-Q Usa o modo silencioso; suprime todos os prompts interativos.

-unicode Grava a saída Unicode quando a saída padrão é redirecionada ou canalizada para outro comando, o que ajuda quando
invocado de scripts do Windows PowerShell.

-unicodetext Envia saída Unicode ao gravar blobs de dados codificados em texto base64 em arquivos.

Formatos
Formatos Descrição

requestfilein Nome do arquivo de entrada binário ou codificado em Base64: solicitação de certificado PKCS nº 10, solicitação de
certificado CMS, solicitação de renovação de certificado PKCS #7, certificado X.509 a ser certificado cruzado ou
solicitação de certificado de formato de marca KeyGen.

requestfileout Nome do arquivo de saída codificado em Base64.

certfileout Nome do arquivo X-509 codificado em Base64.

PKCS10fileout Para uso somente com o parâmetro certreq -policy . Nome do arquivo de saída PKCS10 codificado em Base64.

certchainfileout Nome do arquivo PKCS nº 7 codificado em Base64.

fullresponsefileout Nome do arquivo de resposta completo codificado em Base64.

policyfilein Para uso somente com o parâmetro certreq -policy . Arquivo INF que contém uma representação textual de extensões
usadas para qualificar uma solicitação.
Recursos adicionais
Os seguintes artigos contêm exemplos de uso certreq:

Como adicionar um nome alternativo da entidade a um certificado LDAP seguro

Test Lab Guide: Deploying an AD CS Two-Tier PKI Hierarchy

Apêndice 3: sintaxe Certreq.exe

Como criar um certificado SSL do servidor Web manualmente

Registro de certificado para o Agente do System Center Operations Manager

Visão geral dos Serviços de Certificados do Active Directory

Como habilitar o LDAP via SSL com uma autoridade de certificação de terceiros
certutil
Artigo • 23/03/2023

Certutil.exe é um programa de linha de comando instalado como parte dos Serviços de


Certificados. Use o certutil.exe para exibir informações de configuração da AC
(autoridade de certificação) e configurar os Serviços de Certificado, além de fazer
backup e restauração dos componentes da AC. O programa também verifica os
certificados, os pares de chaves e as cadeias de certificados.

Se o CertUtil for executado em uma autoridade de certificação sem outros parâmetros,


ele exibirá a configuração atual da autoridade de certificação. Se certutil for executado
em uma autoridade que não é de certificação, o comando usará como padrão a
execução do comando certutil [-dump] .

) Importante

Versões anteriores de certutil podem não fornecer todas as opções descritas neste
documento. Veja todas as opções que uma versão específica de certutil fornece
executando certutil -? ou certutil <parameter> -? .

Parâmetros

-dump
Despejar informações ou arquivos de configuração.

certutil [options] [-dump]


certutil [options] [-dump] file

[-f] [-silent] [-split] [-p password] [-t timeout]

-asn
Analisar e exibir o conteúdo de um arquivo usando a sintaxe ASN.1 (Abstract Syntax
Notation). Os tipos de arquivo incluem arquivos formatados .CER, .DER e PKCS #7.
certutil [options] -asn file [type]

[type] : tipo de decodificação CRYPT_STRING_* numérica

-decodehex
Decodificar um arquivo codificado em hexadecimal.

certutil [options] -decodehex infile outfile [type]

[type] : tipo de codificação CRYPT_STRING_* numérica

[-f]

-decode
Decodificar um arquivo codificado em Base64.

certutil [options] -decode infile outfile

[-f]

-encode
Codificar um arquivo em Base64.

certutil [options] -encode infile outfile


[-f] [-unicodetext]

-deny
Negar uma solicitação pendente.

certutil [options] -deny requestID

[-config Machine\CAName]

-resubmit
Reenviar uma solicitação pendente.

certutil [options] -resubmit requestId

[-config Machine\CAName]

-setattributes
Definir atributos para uma solicitação de certificado pendente.

certutil [options] -setattributes RequestID attributestring

Em que:

requestID é a ID de solicitação numérica para a solicitação pendente.

attributestring são os pares de nome e valor do atributo de solicitação.


[-config Machine\CAName]

Comentários
Nomes e valores precisam ser separados por dois-pontos, enquanto vários pares
de nome e valor precisam ser separados por nova linha. Por exemplo:
CertificateTemplate:User\nEMail:User@Domain.com em que a sequência \n é

convertida em um separador de nova linha.

-setextension
Definir uma extensão para uma solicitação de certificado pendente.

certutil [options] -setextension requestID extensionname flags {long | date


| string | \@infile}

Em que:

requestID é a ID de solicitação numérica para a solicitação pendente.

extensionname é a cadeia de caracteres ObjectId da extensão.

flags define a prioridade da extensão. 0 é recomendado, enquanto 1 define a


extensão como crítica, 2 desabilita a extensão e 3 faz as duas coisas.

[-config Machine\CAName]

Comentários
Se o último parâmetro for numérico, ele será entendido como Longo.

Se o último parâmetro puder ser analisado como uma data, ele será entendido
como uma Data.

Se o último parâmetro começar com \@ , o restante do token será entendido como


o nome do arquivo com dados binários ou um despejo hexadecimal de texto
ASCII.
Se o último parâmetro for qualquer outra coisa, ele será entendido como uma
cadeia de caracteres.

-revoke
Revogar um certificado.

certutil [options] -revoke serialnumber [reason]

Em que:

serialnumber é uma lista separada por vírgulas de números de série de certificado


a serem revogados.

reason é a representação numérica ou simbólica do motivo da revogação,


incluindo:

0. CRL_REASON_UNSPECIFIED – não especificado (padrão)

1. CRL_REASON_KEY_COMPROMISE – comprometimento da chave

2. CRL_REASON_CA_COMPROMISE – comprometimento da Autoridade de


Certificação

3. CRL_REASON_AFFILIATION_CHANGED – afiliação alterada

4. CRL_REASON_SUPERSEDED – substituído

5. CRL_REASON_CESSATION_OF_OPERATION – cessação da operação

6. CRL_REASON_CERTIFICATE_HOLD – retenção de certificado

8. CRL_REASON_REMOVE_FROM_CRL – remover do CRL

-1. Cancelar a revogação - Unrevoke

[-config Machine\CAName]

-isvalid
Exibir a disposição do certificado atual.
certutil [options] -isvalid serialnumber | certhash

[-config Machine\CAName]

-getconfig
Obter a cadeia de caracteres de configuração padrão.

certutil [options] -getconfig

[-config Machine\CAName]

-ping
Tentar entrar em contato com a interface de Solicitação dos Serviços de Certificados do
Active Directory.

certutil [options] -ping [maxsecondstowait | camachinelist]

Em que:

camachinelist é uma lista separada por vírgulas de nomes de computador da AC.


Para um só computador, usar uma vírgula de encerramento. Essa opção também
exibe o custo do site para cada computador da AC.

[-config Machine\CAName]

-cainfo
Exibir informações sobre a autoridade de certificação.

certutil [options] -cainfo [infoname [index | errorcode]]

Em que:

infoname indica a propriedade do CA a ser exibido, com base na seguinte sintaxe


do argumento infoname:

file – versão do arquivo

product – versão do produto

exitcount – contagem de módulos de saída

exit [index] – descrição do módulo de saída

policy – descrição do módulo de política

name – nome da AC

sanitizedname – nome da Autoridade de Certificação sanitizado

dsname – nome curto da Autoridade de Certificação sanitizado (nome DS)

sharedfolder – pasta compartilhada

error1 ErrorCode – texto da mensagem de erro

error2 ErrorCode – texto e código de erro da mensagem de erro

type – tipo de AC

info – informações da AC

parent – AC pai

certcount – contagem de certificados da AC

xchgcount – contagem de certificados de troca da AC

kracount – contagem de certificados KRA

kraused – contagem de certificados KRA usados

propidmax – PropId de AC máxima


certstate [index] - certificado da AC

certversion [index] – versão do certificado da AC

certstatuscode [index] – status de verificação do certificado da AC

crlstate [index] – CRL

krastate [index] – certificado KRA

crossstate+ [index] – certificado de encaminhamento cruzado

crossstate- [index] – certificado cruzado de regressão

cert [index] – certificado da AC

certchain [index] - cadeia de certificados da AC

certcrlchain [index] - cadeia de certificados da AC com CRLs

xchg [index] - certificado de troca de AC

xchgchain [index] - cadeia de certificados de troca de AC

xchgcrlchain [index] - cadeia de certificados de troca de AC com CRLs

kra [index] - certificado KRA

cross+ [index] - certificado de encaminhamento cruzado

cross- [index] – certificado cruzado de regressão

CRL [index] - CRL base

deltacrl [index] - CRL delta

crlstatus [index] - status de publicação de CRL

deltacrlstatus [index] - status de publicação de CRL delta

dns – nome DNS

role – separação de funções

ads – servidor avançado

templates - modelos
csp [index] – URLs OCSP

aia [index] - URLs AIA

cdp [index] - URLs CDP

localename - nome da localidade da AC

subjecttemplateoids - OIDs de modelo de entidade

* – exibe todas as propriedades

index é o índice de propriedade baseado em zero opcional.

errorcode é o código de erro numérico.

[-f] [-split] [-config Machine\CAName]

-ca.cert
Recuperar o certificado da autoridade de certificação.

certutil [options] -ca.cert outcacertfile [index]

Em que:

outcacertfile é o arquivo de saída.

index é o índice de renovação do Certificado de Autoridade de Certificação (o


padrão é o mais recente).

[-f] [-split] [-config Machine\CAName]

-ca.chain
Recuperar a cadeia de certificados da autoridade de certificação.
certutil [options] -ca.chain outcacertchainfile [index]

Em que:

outcacertchainfile is the output file.

index é o índice de renovação do Certificado de Autoridade de Certificação (o


padrão é o mais recente).

[-f] [-split] [-config Machine\CAName]

-getcrl
Obtém uma CRL (lista de certificados revogados).

certutil [options] -getcrl outfile [index] [delta]

Em que:

index é o índice da CRL ou índice de chave (o padrão é a CRL para a chave mais
recente).

delta é a CRL delta (o padrão é a CRL base).

[-f] [-split] [-config Machine\CAName]

-crl
Publicar novas CRLs (listas de certificados revogados) ou CRLs delta.

certutil [options] -crl [dd:hh | republish] [delta]

Em que:

dd:hh é o novo período de validade da CRL em dias e horas.


republish republica as CRLs mais recentes.

delta publica somente as CRLs delta (o padrão é CRLs base e delta).

[-split] [-config Machine\CAName]

-shutdown
Desliga os Serviços de Certificados do Active Directory.

certutil [options] -shutdown

[-config Machine\CAName]

-installcert
Instala um certificado de autoridade de certificação.

certutil [options] -installcert [cacertfile]

[-f] [-silent] [-config Machine\CAName]

-renewcert
Renova um certificado de autoridade de certificação.

certutil [options] -renewcert [reusekeys] [Machine\ParentCAName]


Use -f para ignorar uma solicitação de renovação pendente e para gerar uma
nova solicitação.

[-f] [-silent] [-config Machine\CAName]

-schema
Despeja o esquema do certificado.

certutil [options] -schema [ext | attrib | cRL]

Em que:

O comando usa como padrão a tabela Solicitação e Certificado.

ext é a tabela de extensão.

attribute é a tabela de atributos.

crl é a tabela CRL.

[-split] [-config Machine\CAName]

-view
Despeja a exibição de certificados.

certutil [options] -view [queue | log | logfail | revoked | ext | attrib |


crl] [csv]

Em que:

queue despeja uma fila de solicitação específica.

log despeja os certificados emitidos ou revogados, além de solicitações com falha.


logfail despeja as solicitações com falha.

revoked despeja os certificados revogados.

ext despeja a tabela de extensão.

attribute despeja a tabela de atributos.

crl despeja a tabela de CRL.

csv fornece a saída usando valores separados por vírgulas.

[-silent] [-split] [-config Machine\CAName] [-restrict RestrictionList] [-


out ColumnList]

Comentários
Para exibir a coluna StatusCode de todas as entradas, digite -out StatusCode

Para exibir todas as colunas da última entrada, digite: -restrict RequestId==$

Para exibir a RequestID e Disposição para três solicitações, digite: -restrict


requestID>37,requestID<40 -out requestID,disposition

Para exibir IDs de linha e números de CRL para todas as CRLs base, digite: -
restrict crlminbase=0 -out crlrowID,crlnumber crl

Para exibir , digite: -v -restrict crlminbase=0,crlnumber=3 -out crlrawcrl crl

Para exibir toda a tabela de CRL, digite: CRL

Use Date[+|-dd:hh] para restrições de data.

Use now+dd:hh para uma data relativa à hora atual.

-db
Despeja o banco de dados bruto.

certutil [options] -db


[-config Machine\CAName] [-restrict RestrictionList] [-out ColumnList]

-deleterow
Exclui uma linha do banco de dados do servidor.

certutil [options] -deleterow rowID | date [request | cert | ext | attrib |


crl]

Em que:

request exclui as solicitações com falha e pendentes, com base na data de envio.

cert exclui os certificados expirados e revogados, com base na data de validade.

ext exclui a tabela de extensão.

attribute exclui a tabela de atributos.

crl exclui a tabela de CRL.

[-f] [-config Machine\CAName]

Exemplos

Para excluir solicitações com falha e pendentes enviadas até 22 de janeiro de 2001,
digite: 1/22/2001 request

Para excluir todos os certificados que expiraram até 22 de janeiro de 2001, digite:
1/22/2001 cert

Para excluir a linha de certificado, os atributos e as extensões do RequestID 37,


digite: 37

Para excluir CRLs que expiraram até 22 de janeiro de 2001, digite: 1/22/2001 crl

-backup
Faz backup dos Serviços de Certificados do Active Directory.

certutil [options] -backup backupdirectory [incremental] [keeplog]

Em que:

backupdirectory é o diretório para armazenar os dados de backup.

incremental executa apenas um backup incremental (o padrão é o backup


completo).

keeplog preserva os arquivos de log do banco de dados (o padrão é truncar


arquivos de log).

[-f] [-config Machine\CAName] [-p Password]

-backupdb
Faz backup do banco de dados dos Serviços de Certificados do Active Directory.

certutil [options] -backupdb backupdirectory [incremental] [keeplog]

Em que:

backupdirectory é o diretório para armazenar os arquivos de banco de dados de


backup.

incremental executa apenas um backup incremental (o padrão é o backup


completo).

keeplog preserva os arquivos de log do banco de dados (o padrão é truncar


arquivos de log).

[-f] [-config Machine\CAName]


-backupkey
Faz backup do certificado e da chave privada dos Serviços de Certificados do Active
Directory.

certutil [options] -backupkey backupdirectory

Em que:

backupdirectory é o diretório para armazenar o arquivo PFX de backup.

[-f] [-config Machine\CAName] [-p password] [-t timeout]

-restore
Restaura os Serviços de Certificados do Active Directory.

certutil [options] -restore backupdirectory

Em que:

backupdirectory é o diretório que contém os dados a serem restaurados.

[-f] [-config Machine\CAName] [-p password]

-restoredb
Restaura o banco de dados dos Serviços de Certificados do Active Directory.

certutil [options] -restoredb backupdirectory

Em que:
backupdirectory é o diretório que contémarquivos de banco de dados a serem
restaurados.

[-f] [-config Machine\CAName]

-restorekey
Restaura o certificado e da chave privada dos Serviços de Certificados do Active
Directory.

certutil [options] -restorekey backupdirectory | pfxfile

Em que:

backupdirectory é o diretório que contém o arquivo PFX a serem restaurados.

[-f] [-config Machine\CAName] [-p password]

-importpfx
Importar o certificado e a chave privada. Para obter mais informações, consulte o
parâmetro -store neste artigo.

certutil [options] -importpfx [certificatestorename] pfxfile [modifiers]

Em que:

certificatestorename é o nome do repositório de certificados.

modifiers são a lista separada por vírgulas, que pode incluir um ou mais dos
seguintes:

1. AT_SIGNATURE – altera o keyspec para assinatura

2. AT_KEYEXCHANGE – altera o keyspec para troca de chaves


3. NoExport – torna a chave privada não exportável

4. NoCert – não importa o certificado

5. NoChain – não importa a cadeia de certificados

6. NoRoot – não importa o certificado raiz

7. Protect – protege chaves usando uma senha

8. NoProtect – não protege chaves por senha

[-f] [-user] [-p password] [-csp provider]

Comentários
O padrão é o repositório do computador pessoal.

-dynamicfilelist
Exibe uma lista de arquivos dinâmicos.

certutil [options] -dynamicfilelist

[-config Machine\CAName]

-databaselocations
Exibe locais de banco de dados.

certutil [options] -databaselocations

[-config Machine\CAName]
-hashfile
Gera e exibe um hash criptográfico em um arquivo.

certutil [options] -hashfile infile [hashalgorithm]

-store
Despeja o repositório de certificados

certutil [options] -store [certificatestorename [certID [outputfile]]]

Em que:

certificatestorename é o nome do repositório de certificados. Por exemplo:

My, CA (default), Root,

ldap:///CN=Certification Authorities,CN=Public Key

Services,CN=Services,CN=Configuration,DC=cpandl,DC=com?cACertificate?one?
objectClass=certificationAuthority (View Root Certificates)

ldap:///CN=CAName,CN=Certification Authorities,CN=Public Key

Services,CN=Services,CN=Configuration,DC=cpandl,DC=com?cACertificate?base?
objectClass=certificationAuthority (Modify Root Certificates)

ldap:///CN=CAName,CN=MachineName,CN=CDP,CN=Public Key
Services,CN=Services,CN=Configuration,DC=cpandl,DC=com?

certificateRevocationList?base?objectClass=cRLDistributionPoint (View CRLs)

ldap:///CN=NTAuthCertificates,CN=Public Key
Services,CN=Services,CN=Configuration,DC=cpandl,DC=com?cACertificate?base?

objectClass=certificationAuthority (Enterprise CA Certificates)

ldap: (AD computer object certificates)

-user ldap: (AD user object certificates)


certID é o token de correspondência de CRL ou certificado. Pode ser um número
de série, um certificado SHA-1, CRL, CTL ou hash de chave pública, um índice de
certificado numérico (0, 1 e assim por diante), um índice de CRL numérico (.0, .1 e
assim por diante), um índice de CTL numérico (.. 0, .. 1 e assim por diante), uma
chave pública, assinatura ou extensão ObjectId, um Nome Comum da entidade de
certificado, um endereço de email, nome UPN ou DNS, um nome de contêiner de
chave ou nome CSP, um nome de modelo ou ObjectId, um ObjectId de Políticas de
Aplicativo ou EKU ou um Nome Comum do emissor de CRL. Muitos deles podem
resultar em várias correspondências.

outputfile é o arquivo usado para salvar os certificados correspondentes.

[-f] [-user] [-enterprise] [-service] [-grouppolicy] [-silent] [-split] [-dc


DCName]

Opções
A opção -user acessa um repositório de usuários em vez de um repositório de
computadores.

A opção -enterprise acessa um repositório corporativo de computadores.

A opção -service acessa um repositório de serviços de computador.

A opção -grouppolicy acessa um repositório de políticas de grupo de


computadores.

Por exemplo:

-enterprise NTAuth

-enterprise Root 37

-user My 26e0aaaf000000000004

CA .11

-addstore
Adiciona um certificado ao repositório. Para obter mais informações, consulte o
parâmetro -store neste artigo.
certutil [options] -addstore certificatestorename infile

Em que:

certificatestorename é o nome do repositório de certificados.

infile é o arquivo de certificado ou CRL que você deseja adicionar ao repositório.

[-f] [-user] [-enterprise] [-grouppolicy] [-dc DCName]

-delstore
Exclui um certificado do repositório. Para obter mais informações, consulte o parâmetro
-store neste artigo.

certutil [options] -delstore certificatestorename certID

Em que:

certificatestorename é o nome do repositório de certificados.

certID é o token de correspondência de CRL ou certificado.

[-enterprise] [-user] [-grouppolicy] [-dc DCName]

-verifystore
Verifica um certificado no repositório. Para obter mais informações, consulte o
parâmetro -store neste artigo.

certutil [options] -verifystore certificatestorename [certID]

Em que:
certificatestorename é o nome do repositório de certificados.

certID é o token de correspondência de CRL ou certificado.

[-enterprise] [-user] [-grouppolicy] [-silent] [-split] [-dc DCName] [-t


timeout]

-repairstore
Repara uma associação de chaves ou atualiza as propriedades do certificado ou o
descritor de segurança da chave. Para obter mais informações, consulte o parâmetro -
store neste artigo.

certutil [options] -repairstore certificatestorename certIDlist


[propertyinffile | SDDLsecuritydescriptor]

Em que:

certificatestorename é o nome do repositório de certificados.

certIDlist é a lista separada por vírgulas de tokens de correspondência de


certificado ou CRL. Para obter mais informações, consulte a descrição -store
certID neste artigo.

propertyinffile é o arquivo INF que contém propriedades externas, incluindo:

[Properties]
19 = Empty ; Add archived property, OR:
19 = ; Remove archived property

11 = {text}Friendly Name ; Add friendly name property

127 = {hex} ; Add custom hexadecimal property


_continue_ = 00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f
_continue_ = 10 11 12 13 14 15 16 17 18 19 1a 1b 1c 1d 1e 1f

2 = {text} ; Add Key Provider Information property


_continue_ = Container=Container Name&
_continue_ = Provider=Microsoft Strong Cryptographic Provider&
_continue_ = ProviderType=1&
_continue_ = Flags=0&
_continue_ = KeySpec=2

9 = {text} ; Add Enhanced Key Usage property


_continue_ = 1.3.6.1.5.5.7.3.2,
_continue_ = 1.3.6.1.5.5.7.3.1,

[-f] [-enterprise] [-user] [-grouppolicy] [-silent] [-split] [-csp provider]

-viewstore
Despeja o repositório de certificados. Para obter mais informações, consulte o
parâmetro -store neste artigo.

certutil [options] -viewstore [certificatestorename [certID [outputfile]]]

Em que:

certificatestorename é o nome do repositório de certificados.

certID é o token de correspondência de CRL ou certificado.

outputfile é o arquivo usado para salvar os certificados correspondentes.

[-f] [-user] [-enterprise] [-service] [-grouppolicy] [-dc DCName]

Opções

A opção -user acessa um repositório de usuários em vez de um repositório de


computadores.

A opção -enterprise acessa um repositório corporativo de computadores.

A opção -service acessa um repositório de serviços de computador.

A opção -grouppolicy acessa um repositório de políticas de grupo de


computadores.

Por exemplo:
-enterprise NTAuth

-enterprise Root 37

-user My 26e0aaaf000000000004

CA .11

-viewdelstore
Exclui um certificado do repositório.

certutil [options] -viewdelstore [certificatestorename [certID


[outputfile]]]

Em que:

certificatestorename é o nome do repositório de certificados.

certID é o token de correspondência de CRL ou certificado.

outputfile é o arquivo usado para salvar os certificados correspondentes.

[-f] [-user] [-enterprise] [-service] [-grouppolicy] [-dc DCName]

Opções

A opção -user acessa um repositório de usuários em vez de um repositório de


computadores.

A opção -enterprise acessa um repositório corporativo de computadores.

A opção -service acessa um repositório de serviços de computador.

A opção -grouppolicy acessa um repositório de políticas de grupo de


computadores.

Por exemplo:

-enterprise NTAuth
-enterprise Root 37

-user My 26e0aaaf000000000004

CA .11

-dspublish
Publica um certificado ou uma CRL (lista de certificados revogados) no Active Directory.

certutil [options] -dspublish certfile [NTAuthCA | RootCA | SubCA | CrossCA


| KRA | User | Machine]

certutil [options] -dspublish CRLfile [DSCDPContainer [DSCDPCN]]

Em que:

certfile é o nome do arquivo de certificado a ser publicado.

NTAuthCA publica o certificado no repositório Enterprise do DS.

RootCA publica o certificado no repositório de Raiz Confiável do DS.

SubCA publica o Certificado de Autoridade de Certificação no objeto de AC do DS.

CrossCA publica o certificado cruzado no objeto de AC do DS.

KRA publica o certificado no objeto do Agente de Recuperação de Chave do DS.

User publica o certificado no objeto User do DS.

Machine publica o certificado no objeto Machine do DS.

CRLfile é o nome do arquivo CRL a ser publicado.

DSCDPContainer é o CN do contêiner CDP do DS, geralmente o nome do


computador da AC.

DSCDPCN é o CN do objeto CDP do DS, geralmente com base no índice de chave


e no nome curto da AC sanitizado.

Use -f para criar um objeto DS.


[-f] [-user] [-dc DCName]

-adtemplate
Exibe modelos do Active Directory.

certutil [options] -adtemplate [template]

[-f] [-user] [-ut] [-mt] [-dc DCName]

-template
Exibe os modelos de certificado.

certutil [options] -template [template]

[-f] [-user] [-silent] [-policyserver URLorID] [-anonymous] [-kerberos] [-


clientcertificate clientcertID] [-username username] [-p password]

-templatecas
Exibe as autoridades de certificação (ACs) de um modelo de certificado.

certutil [options] -templatecas template

[-f] [-user] [-dc DCName]


-catemplates
Exibe modelos para a Autoridade de Certificação.

certutil [options] -catemplates [template]

[-f] [-user] [-ut] [-mt] [-config Machine\CAName] [-dc DCName]

-setcasites
Gerencia nomes de site, incluindo a configuração, a verificação e a exclusão de nomes
de site da Autoridade de Certificação

certutil [options] -setcasites [set] [sitename]


certutil [options] -setcasites verify [sitename]
certutil [options] -setcasites delete

Em que:

sitename é permitido somente ao direcionar uma só Autoridade de Certificação.

[-f] [-config Machine\CAName] [-dc DCName]

Comentários
A opção -config direciona uma só Autoridade de Certificação (o padrão é todas
as ACs).

A opção -f pode ser usada para substituir erros de validação para o nome do site
especificado ou para excluir todos os nomes de site da AC.

7 Observação
Para obter mais informações sobre como configurar CAs para reconhecimento de
site do AD DS (Active Directory Domain Services), consulte Reconhecimento de site
do AD DS para clientes do AD CS e PKI.

-enrollmentserverURL
Exibe, adiciona ou exclui URLs do servidor de registro associadas a uma AC.

certutil [options] -enrollmentServerURL [URL authenticationtype [priority]


[modifiers]]
certutil [options] -enrollmentserverURL URL delete

Em que:

authenticationtype especifica um dos seguintes métodos de autenticação de


cliente, ao adicionar uma URL:

1. kerberos – usar credenciais SSL Kerberos.

2. username – usar uma conta nomeada para credenciais SSL.

3. clientcertificate – usar credenciais SSL de Certificado X.509.

4. anonymous – usar credenciais SSL anônimas.

delete exclui a URL especificada associada à AC.

priority, por padrão, será 1 se não for especificado ao adicionar uma URL.

modifiers é uma lista separada por vírgulas, que inclui um ou mais dos seguintes:

1. allowrenewalsonly – somente solicitações de renovação podem ser enviadas a


essa AC por meio dessa URL.

2. allowkeybasedrenewal – permite o uso de um certificado sem nenhuma conta


associada no AD. Isso se aplica apenas com o modo clientcertificate e
allowrenewalsonly

[-config Machine\CAName] [-dc DCName]


-adca
Exibe as Autoridades de Certificação do Active Directory.

certutil [options] -adca [CAName]

[-f] [-split] [-dc DCName]

-ca
Exibe as Autoridades de Certificação da política de registro.

certutil [options] -CA [CAName | templatename]

[-f] [-user] [-silent] [-split] [-policyserver URLorID] [-anonymous] [-


kerberos] [-clientcertificate clientcertID] [-username username] [-p
password]

-policy
Exibe a política de registro.

[-f] [-user] [-silent] [-split] [-policyserver URLorID] [-anonymous] [-


kerberos] [-clientcertificate clientcertID] [-username username] [-p
password]

-policycache
Exibe ou exclui entradas de cache da política de registro.
certutil [options] -policycache [delete]

Em que:

delete exclui as entradas de cache do servidor de política.

-f exclui todas as entradas de cache

[-f] [-user] [-policyserver URLorID]

-credstore
Exibe, adiciona ou exclui entradas do Repositório de Credenciais.

certutil [options] -credstore [URL]


certutil [options] -credstore URL add
certutil [options] -credstore URL delete

Em que:

URL é a URL de destino. Você também pode usar * para corresponder a todas as
entradas ou https://machine* para corresponder a um prefixo de URL.

add adiciona uma entrada do repositório de credenciais. Usar essa opção também
requer o uso de credenciais SSL.

delete exclui entradas do repositório de credenciais.

-f substitui uma só entrada ou exclui várias entradas.

[-f] [-user] [-silent] [-anonymous] [-kerberos] [-clientcertificate


clientcertID] [-username username] [-p password]

-installdefaulttemplates
Instala modelos de certificado padrão.
certutil [options] -installdefaulttemplates

[-dc DCName]

-URLcache
Exibe ou exclui entradas do cache de URL.

certutil [options] -URLcache [URL | CRL | * [delete]]

Em que:

URL é a URL armazenada em cache.

CRL é executado somente em URLs de CRL armazenadas em cache.

* opera em todas as URLs armazenadas em cache.

delete exclui as URLs relevantes do cache local do usuário atual.

-f força a busca de uma URL específica e a atualização do cache.

[-f] [-split]

-pulse
Pulsa eventos de registro automático.

certutil [options] -pulse

[-user]
-machineinfo
Exibe informações sobre o objeto de computador do Active Directory.

certutil [options] -machineinfo domainname\machinename$

-DCInfo
Exibe informações sobre o controlador de domínio. O padrão exibe certificados DC sem
verificação.

certutil [options] -DCInfo [domain] [verify | deletebad | deleteall]

[-f] [-user] [-urlfetch] [-dc DCName] [-t timeout]

 Dica

A capacidade de especificar um domínio do AD DS (Active Directory Domain


Services) [Domínio] e especificar um controlador de domínio (-dc) foi adicionada
no Windows Server 2012. Para executar o comando com êxito, você precisa usar
uma conta que seja membro de Administradores de Domínio ou Administradores
Corporativos. As modificações de comportamento desse comando são as
seguintes:

1. 1. Se um domínio não for especificado e um controlador de domínio


específico não for especificado, essa opção retornará uma lista de
controladores de domínio a serem processados do controlador de domínio
padrão.
2. 2. Se um domínio não for especificado, mas um controlador de domínio for,
um relatório dos certificados no controlador de domínio especificado será
gerado.
3. 3. Se um domínio for especificado, mas um controlador de domínio não for,
uma lista de controladores de domínio será gerada junto com relatórios sobre
os certificados para cada controlador de domínio na lista.
4. 4. Se o domínio e o controlador de domínio forem especificados, uma lista de
controladores de domínio será gerada do controlador de domínio de destino.
Um relatório dos certificados de cada controlador de domínio na lista
também é gerado.

Por exemplo, suponha que haja um domínio chamado CPANDL com um


controlador de domínio chamado CPANDL-DC1. Você pode executar o seguinte
comando para recuperar uma lista de controladores de domínio e seus certificados
de CPANDL-DC1: certutil -dc cpandl-dc1 -DCInfo cpandl

-entinfo
Exibe informações sobre uma Autoridade de Certificação corporativa.

certutil [options] -entinfo domainname\machinename$

[-f] [-user]

-tcainfo
Exibe informações sobre a Autoridade de Certificação.

certutil [options] -tcainfo [domainDN | -]

[-f] [-enterprise] [-user] [-urlfetch] [-dc DCName] [-t timeout]

-scinfo
Exibe informações sobre o cartão inteligente.
certutil [options] -scinfo [readername [CRYPT_DELETEKEYSET]]

Em que:

CRYPT_DELETEKEYSET exclui todas as chaves no cartão inteligente.

[-silent] [-split] [-urlfetch] [-t timeout]

-scroots
Gerencia certificados raiz de cartão inteligente.

certutil [options] -scroots update [+][inputrootfile] [readername]


certutil [options] -scroots save \@in\\outputrootfile [readername]
certutil [options] -scroots view [inputrootfile | readername]
certutil [options] -scroots delete [readername]

[-f] [-split] [-p Password]

-DeleteHelloContainer
Exclui o contêiner do Windows Hello, removendo todas as credenciais associadas
armazenadas no dispositivo, incluindo todas as credenciais webAuthn e FIDO.

Os usuários precisarão sair depois de usar essa opção para que ela seja concluída.

CertUtil [Options] -DeleteHelloContainer

-verifykeys
Verifica um conjunto de chaves públicas ou privadas.
certutil [options] -verifykeys [keycontainername cacertfile]

Em que:

keycontainername é o nome do contêiner de chave da chave a ser verificada. Essa


opção usa como padrão chaves de computador. Para alternar para chaves de
usuário, use -user .

cacertfile assina ou criptografa arquivos de certificado.

[-f] [-user] [-silent] [-config Machine\CAName]

Comentários
Se nenhum argumento for especificado, cada certificado de AC de assinatura será
verificado em relação à chave privada.

Essa operação só pode ser executada em uma AC local ou chaves locais.

-verify
Verifica um certificado, uma CRL (lista de certificados revogados) ou uma cadeia de
certificados.

certutil [options] -verify certfile [applicationpolicylist | -


[issuancepolicylist]]
certutil [options] -verify certfile [cacertfile [crossedcacertfile]]
certutil [options] -verify CRLfile cacertfile [issuedcertfile]
certutil [options] -verify CRLfile cacertfile [deltaCRLfile]

Em que:

certfile é o nome do certificado a ser verificado.

applicationpolicylist é a lista opcional separada por vírgula de ObjectIds da


Política de Aplicativo necessária.

issuancepolicylist é a lista opcional separada por vírgula de ObjectIds da Política


de Emissão necessária.
cacertfile é o Certificado de Autoridade de Certificação emissor opcional a ser
verificado.

crossedcacertfile é o certificado opcional com certificação cruzada pelo certfile.

CRLfile é o arquivo CRL usado para verificar o cacertfile.

issuedcertfile é o certificado emitido opcional coberto pelo CRLfile.

deltaCRLfile é o arquivo CRL delta opcional.

[-f] [-enterprise] [-user] [-silent] [-split] [-urlfetch] [-t timeout]

Comentários
O uso de applicationpolicylist restringe a criação de cadeia apenas a cadeias
válidas para as Políticas de Aplicativo especificadas.

O uso de issuancepolicylist restringe a criação de cadeia apenas a cadeias válidas


para as Políticas de Emissão especificadas.

O uso de cacertfile verifica os campos no arquivo em relação a certfile ou CRLfile.

O uso de issuedcertfile verifica os campos no arquivo em relação a CRLfile.

O uso de deltaCRLfile verifica os campos no arquivo em relação a certfile.

Se cacertfile não for especificado, a cadeia completa será criada e verificada em


relação a certfile.

Se cacertfile e crossedcacertfile forem especificados, os campos em ambos os


arquivos serão verificados em relação a certfile.

-verifyCTL
Verifica a CTL de Certificados AuthRoot ou Não Permitidos.

certutil [options] -verifyCTL CTLobject [certdir] [certfile]

Em que:
CTLobject identifica a CTL a ser verificada, incluindo:

AuthRootWU – lê o CAB de AuthRoot e os certificados correspondentes do


cache de URL. Use -f para baixar do Windows Update.

DisallowedWU - lê o CAB de Certificados Não Permitidos e o arquivo de


repositório de certificados não permitidos do cache de URL. Use -f para baixar
do Windows Update.

AuthRoot - lê a CTL AuthRoot armazenada em cache do Registro. Use com -f e


um arquivo de certificado não confiável para forçar o registro armazenado em
cache AuthRoot e CTLs de certificado não permitidos a serem atualizados.

Disallowed – lê a CTL de Certificados Não Permitidos armazenados em cache


do Registro. Use com -f e um arquivo de certificado não confiável para forçar
o registro armazenado em cache AuthRoot e CTLs de certificado não permitidos
a serem atualizados.

CTLfilename especifica o arquivo ou caminho HTTP para o arquivo CTL ou CAB.

certdir especifica a pasta que contém certificados que correspondem às entradas


de CTL. O padrão é a mesma pasta ou site que o CTLobject. O uso de um caminho
de pasta HTTP requer um separador de caminho no final. Se você não especificar
AuthRoot ou Disallowed, vários locais serão pesquisados em busca de certificados
correspondentes, incluindo repositórios de certificados locais, crypt32.dll recursos
e o cache de URL local. Use -f para baixar do Windows Update, conforme
necessário.

certfile especifica os certificados a serem verificados. Os certificados são


comparados com entradas de CTL, exibindo os resultados. Essa opção suprime a
maior parte da saída padrão.

[-f] [-user] [-split]

-sign
Assina novamente uma CRL (lista de certificados revogados) ou certificado.

certutil [options] -sign infilelist | serialnumber | CRL outfilelist


[startdate+dd:hh] [+serialnumberlist | -serialnumberlist | -objectIDlist |
\@extensionfile]
certutil [options] -sign infilelist | serialnumber | CRL outfilelist
[#hashalgorithm] [+alternatesignaturealgorithm | -
alternatesignaturealgorithm]

Em que:

infilelist é a lista separada por vírgulas de arquivos de CRL ou certificados para


modificar e assinar novamente.

serialnumber é o número de série do certificado a ser criado. O período de


validade e outras opções não podem estar presentes.

CRL cria uma CRL vazia. O período de validade e outras opções não podem estar
presentes.

outfilelist é a lista separada por vírgulas de arquivos de saída de certificado ou CRL


modificados. O número de arquivos precisa corresponder a infilelist.

startdate+dd:hh é o novo período de validade dos arquivos de certificado ou CRL,


incluindo:

data opcional mais

período de validade dos dias e horas opcionais

Se ambos forem especificados, você precisará usar um separador de sinal de


adição (+). Use now[+dd:hh] para começar no momento atual. Use never para não
ter data de validade (somente para CRLs).

serialnumberlist é a lista de números de série separados por vírgulas dos arquivos


a serem adicionados ou removidos.

objectIDlist é a lista de ObjectId de extensão separada por vírgulas dos arquivos a


serem removidos.

@extensionfile é o arquivo INF que contém as extensões a serem atualizadas ou


removidas. Por exemplo:

[Extensions]
2.5.29.31 = ; Remove CRL Distribution Points extension
2.5.29.15 = {hex} ; Update Key Usage extension
_continue_=03 02 01 86
hashalgorithm é o nome do algoritmo de hash. Ele deve ser apenas o texto
precedido pelo sinal # .

alternatesignaturealgorithm é o especificador do algoritmo de assinatura


alternativo.

[-nullsign] [-f] [-silent] [-cert certID]

Comentários

O uso do sinal de subtração (-) remove números de série e extensões.

Usar o sinal de adição (+) adiciona números de série a uma CRL.

Você pode usar uma lista para remover números de série e ObjectIDs de uma CRL
ao mesmo tempo.

Usar o sinal de subtração antes de alternatesignaturealgorithm permite que você


use o formato de assinatura herdado. Usar o sinal de adição permite usar o
formato de assinatura alternativo. Se você não especificar
alternatesignaturealgorithm, o formato de assinatura no certificado ou CRL será
usado.

-vroot
Cria ou exclui raízes virtuais da Web e compartilhamentos de arquivos.

certutil [options] -vroot [delete]

-vocsproot
Cria ou exclui raízes virtuais da Web para um proxy Web OCSP.

certutil [options] -vocsproot [delete]


-addenrollmentserver
Adicionar um aplicativo do Servidor de Registro e um pool de aplicativos, se necessário,
para a Autoridade de Certificação especificada. Esse comando não instala binários nem
pacotes.

certutil [options] -addenrollmentserver kerberos | username |


clientcertificate [allowrenewalsonly] [allowkeybasedrenewal]

Em que:

addenrollmentserver exige que você use um método de autenticação para a


conexão do cliente com o Servidor de Registro de Certificado, incluindo:

kerberos usa credenciais SSL Kerberos.

username usa a conta nomeada para credenciais SSL.

clientcertificate usa credenciais SSL de Certificado X.509.

allowrenewalsonly permite apenas envios de solicitação de renovação para a


Autoridade de Certificação por meio da URL.

allowkeybasedrenewal permite o uso de um certificado sem nenhuma conta


associada no Active Directory. Isso se aplica quando usado com o modo
clientcertificate e allowrenewalsonly.

[-config Machine\CAName]

-deleteenrollmentserver
Exclui um aplicativo do Servidor de Registro e um pool de aplicativos, se necessário,
para a Autoridade de Certificação especificada. Esse comando não instala binários nem
pacotes.

certutil [options] -deleteenrollmentserver kerberos | username |


clientcertificate
Em que:

deleteenrollmentserver exige que você use um método de autenticação para a


conexão do cliente com o Servidor de Registro de Certificado, incluindo:

kerberos usa credenciais SSL Kerberos.

username usa a conta nomeada para credenciais SSL.

clientcertificate usa credenciais SSL de Certificado X.509.

[-config Machine\CAName]

-addpolicyserver
Adicionar um aplicativo do Servidor de Política e um pool de aplicativos, se necessário.
Esse comando não instala binários nem pacotes.

certutil [options] -addpolicyserver kerberos | username | clientcertificate


[keybasedrenewal]

Em que:

addpolicyserver exige que você use um método de autenticação para a conexão


do cliente com o Servidor de Política de Certificado, incluindo:

kerberos usa credenciais SSL Kerberos.

username usa a conta nomeada para credenciais SSL.

clientcertificate usa credenciais SSL de Certificado X.509.

keybasedrenewal permite o uso de políticas retornadas ao cliente contendo


modelos keybasedrenewal. Essa opção se aplica somente à autenticação com
nome de usuário e clientcertificate.

-deletepolicyserver
Exclui um aplicativo do Servidor de Política e um pool de aplicativos, se necessário. Esse
comando não remove binários nem pacotes.
certutil [options] -deletePolicyServer kerberos | username |
clientcertificate [keybasedrenewal]

Em que:

deletepolicyserver exige que você use um método de autenticação para a


conexão do cliente com o Servidor de Política de Certificado, incluindo:

kerberos usa credenciais SSL Kerberos.

username usa a conta nomeada para credenciais SSL.

clientcertificate usa credenciais SSL de Certificado X.509.

keybasedrenewal permite o uso de um servidor de política KeyBasedRenewal.

-oid
Exibe o identificador de objeto ou define um nome de exibição.

certutil [options] -oid objectID [displayname | delete [languageID [type]]]


certutil [options] -oid groupID
certutil [options] -oid agID | algorithmname [groupID]

Em que:

objectID exibe ou adiciona o nome de exibição.

groupID é o número de groupID (decimal) que as objectIDs enumeram.

algID é a ID hexadecimal que objectID pesquisa.

algorithmname é o nome do algoritmo que objectID pesquisa.

displayname exibe o nome a ser armazenado no DS.

delete exclui o nome de exibição.

LanguageId é o valor da ID do idioma (o padrão é o atual: 1033).

Type é o tipo do objeto DS a ser criado, incluindo:

1 – modelo (padrão)
2 – Política de Emissão

3 – Política de Aplicativo

-f cria um objeto DS.

-error
Exibe o texto da mensagem associado a um código de erro.

certutil [options] -error errorcode

-getreg
Exibe um valor do Registro.

certutil [options] -getreg [{ca | restore | policy | exit | template |


enroll |chain | policyservers}\[progID\]][registryvaluename]

Em que:

ca usa uma chave do Registro da Autoridade de Certificação.

restore usa a chave do Registro de restauração da Autoridade de Certificação.

policy usa a chave do Registro do módulo de política.

exit usa a chave do Registro do primeiro módulo de saída.

template usa a chave do Registro de modelo (usar -user para modelos de


usuário).

enroll usa a chave do Registro de inscrição (usar -user para o contexto do


usuário).

chain usa a chave do Registro de configuração de cadeia.

policyservers usa a chave do Registro dos Servidores de Política.

progID usa a ProgID do módulo de política ou de saída (nome da subchave do


Registro).
registryvaluename usa o nome do valor do registro (usar Name* para
correspondência de prefixo).

value usa o novo valor numérico, de cadeia de caracteres ou de registro de data,


ou nome do arquivo. Se um valor numérico começar com + ou - , os bits
especificados no novo valor serão definidos ou limpos no valor do Registro
existente.

[-f] [-user] [-grouppolicy] [-config Machine\CAName]

Comentários
Se um valor de cadeia de caracteres começar com + ou - e o valor existente for
um valor REG_MULTI_SZ , a cadeia de caracteres será adicionada ou removida do
valor existente do Registro. Para forçar a criação de um valor REG_MULTI_SZ ,
adicione \n ao final do valor da cadeia de caracteres.

Se o valor começar com \@ , o restante do valor será o nome do arquivo que


contém a representação de texto hexadecimal de um valor binário. Se ele não se
referir a um arquivo válido, será analisado como [Date][+|-][dd:hh] – uma data
opcional mais ou menos dias e horas opcionais. Se ambos forem especificados,
use um separador de sinal de adição (+) ou de subtração (-). Use now+dd:hh para
uma data relativa à hora atual.

Use chain\chaincacheresyncfiletime \@now para liberar efetivamente CRLs


armazenadas em cache.

-setreg
Define um valor do Registro.

certutil [options] -setreg [{ca | restore | policy | exit | template |


enroll |chain | policyservers}\[progID\]]registryvaluename value

Em que:

ca usa uma chave do Registro da Autoridade de Certificação.


restore usa a chave do Registro de restauração da Autoridade de Certificação.

policy usa a chave do Registro do módulo de política.

exit usa a chave do Registro do primeiro módulo de saída.

template usa a chave do Registro de modelo (usar -user para modelos de


usuário).

enroll usa a chave do Registro de inscrição (usar -user para o contexto do


usuário).

chain usa a chave do Registro de configuração de cadeia.

policyservers usa a chave do Registro dos Servidores de Política.

progID usa a ProgID do módulo de política ou de saída (nome da subchave do


Registro).

registryvaluename usa o nome do valor do registro (usar Name* para


correspondência de prefixo).

value usa o novo valor numérico, de cadeia de caracteres ou de registro de data,


ou nome do arquivo. Se um valor numérico começar com + ou - , os bits
especificados no novo valor serão definidos ou limpos no valor do Registro
existente.

[-f] [-user] [-grouppolicy] [-config Machine\CAName]

Comentários

Se um valor de cadeia de caracteres começar com + ou - e o valor existente for


um valor REG_MULTI_SZ , a cadeia de caracteres será adicionada ou removida do
valor existente do Registro. Para forçar a criação de um valor REG_MULTI_SZ ,
adicione \n ao final do valor da cadeia de caracteres.

Se o valor começar com \@ , o restante do valor será o nome do arquivo que


contém a representação de texto hexadecimal de um valor binário. Se ele não se
referir a um arquivo válido, será analisado como [Date][+|-][dd:hh] – uma data
opcional mais ou menos dias e horas opcionais. Se ambos forem especificados,
use um separador de sinal de adição (+) ou de subtração (-). Use now+dd:hh para
uma data relativa à hora atual.

Use chain\chaincacheresyncfiletime \@now para liberar efetivamente CRLs


armazenadas em cache.

-delreg
Exclui um valor do Registro.

certutil [options] -delreg [{ca | restore | policy | exit | template |


enroll |chain | policyservers}\[progID\]][registryvaluename]

Em que:

ca usa uma chave do Registro da Autoridade de Certificação.

restore usa a chave do Registro de restauração da Autoridade de Certificação.

policy usa a chave do Registro do módulo de política.

exit usa a chave do Registro do primeiro módulo de saída.

template usa a chave do Registro de modelo (usar -user para modelos de


usuário).

enroll usa a chave do Registro de inscrição (usar -user para o contexto do


usuário).

chain usa a chave do Registro de configuração de cadeia.

policyservers usa a chave do Registro dos Servidores de Política.

progID usa a ProgID do módulo de política ou de saída (nome da subchave do


Registro).

registryvaluename usa o nome do valor do registro (usar Name* para


correspondência de prefixo).

value usa o novo valor numérico, de cadeia de caracteres ou de registro de data,


ou nome do arquivo. Se um valor numérico começar com + ou - , os bits
especificados no novo valor serão definidos ou limpos no valor do Registro
existente.
[-f] [-user] [-grouppolicy] [-config Machine\CAName]

Comentários
Se um valor de cadeia de caracteres começar com + ou - e o valor existente for
um valor REG_MULTI_SZ , a cadeia de caracteres será adicionada ou removida do
valor existente do Registro. Para forçar a criação de um valor REG_MULTI_SZ ,
adicione \n ao final do valor da cadeia de caracteres.

Se o valor começar com \@ , o restante do valor será o nome do arquivo que


contém a representação de texto hexadecimal de um valor binário. Se ele não se
referir a um arquivo válido, será analisado como [Date][+|-][dd:hh] – uma data
opcional mais ou menos dias e horas opcionais. Se ambos forem especificados,
use um separador de sinal de adição (+) ou de subtração (-). Use now+dd:hh para
uma data relativa à hora atual.

Use chain\chaincacheresyncfiletime \@now para liberar efetivamente CRLs


armazenadas em cache.

-importKMS
Importa chaves de usuário e certificados para o banco de dados do servidor para
arquivamento de chave.

certutil [options] -importKMS userkeyandcertfile [certID]

Em que:

userkeyandcertfile é um arquivo de dados com chaves privadas do usuário e


certificados que devem ser arquivados. Esse arquivo pode ser:

Um arquivo de exportação do KMS (Servidor de Gerenciamento de Chaves do


Exchange).

Um arquivo PFX.

certID é um token de correspondência de certificado de descriptografia de arquivo


de exportação KMS. Para obter mais informações, consulte o parâmetro -store
neste artigo.

-f importa certificados não emitidos pela Autoridade de Certificação.

[-f] [-silent] [-split] [-config Machine\CAName] [-p password] [-symkeyalg


symmetrickeyalgorithm[,keylength]]

-importcert
Importa um arquivo de certificado para o banco de dados.

certutil [options] -importcert certfile [existingrow]

Em que:

existingrow importa o certificado no lugar de uma solicitação pendente para a


mesma chave.

-f importa certificados não emitidos pela Autoridade de Certificação.

[-f] [-config Machine\CAName]

Comentários
A Autoridade de Certificação também pode precisar ser configurada para dar suporte a
certificados estrangeiros. Para fazer isso, digite import - certutil -setreg ca\KRAFlags
+KRAF_ENABLEFOREIGN .

-getkey
Recupera um blob de recuperação de chave privada arquivado, gera um script de
recuperação ou recupera chaves arquivadas.

certutil [options] -getkey searchtoken [recoverybloboutfile]


certutil [options] -getkey searchtoken script outputscriptfile
certutil [options] -getkey searchtoken retrieve | recover outputfilebasename

Em que:

script gera um script para recuperar chaves (comportamento padrão se vários


candidatos à recuperação correspondentes forem encontrados ou se o arquivo de
saída não for especificado).

retrieve recupera um ou mais Blobs de Recuperação de Chave (comportamento


padrão se exatamente um candidato de recuperação correspondente for
encontrado e se o arquivo de saída for especificado). O uso dessa opção trunca
qualquer extensão e acrescenta a cadeia de caracteres específica do certificado e a
extensão .rec para cada blob de recuperação de chave. Cada arquivo contém uma
cadeia de certificados e uma chave privada associada, ainda criptografadas para
um ou mais certificados do Agente de Recuperação de Chave.

recover recupera chaves privadas em uma etapa (requer certificados do Agente de


Recuperação de Chave e chaves privadas). O uso dessa opção trunca qualquer
extensão e acrescenta a extensão .p12. Cada arquivo contém as cadeias de
certificados recuperadas e as chaves privadas associadas, armazenadas como um
arquivo PFX.

searchtoken seleciona as chaves e os certificados a serem recuperados, incluindo:

1. Nome comum do certificado

2. Número de série do certificado

3. Hash SHA-1 do certificado (impressão digital)

4. Hash SHA-1 da KeyId do certificado (Identificador de Chave da Entidade)

5. Nome do solicitante (domínio\usuário)

6. UPN (usuário@domínio)

recoverybloboutfile gera um arquivo com uma cadeia de certificados e uma chave


privada associada, ainda criptografadas para um ou mais certificados do Agente de
Recuperação de Chave.

outputscriptfile gera um arquivo com um script em lote para recuperar chaves


privadas.

outputfilebasename gera um nome base de arquivo.


[-f] [-unicodetext] [-silent] [-config Machine\CAName] [-p password] [-
protectto SAMnameandSIDlist] [-csp provider]

-recoverkey
Recuperar uma chave privada arquivada.

certutil [options] -recoverkey recoveryblobinfile [PFXoutfile


[recipientindex]]

[-f] [-user] [-silent] [-split] [-p password] [-protectto SAMnameandSIDlist]


[-csp provider] [-t timeout]

-mergePFX
Mescla arquivos PFX.

certutil [options] -mergePFX PFXinfilelist PFXoutfile [extendedproperties]

Em que:

PFXinfilelist é uma lista separada por vírgulas de arquivos de entrada PFX.

PFXoutfile é o nome do arquivo de saída PFX.

extendedproperties inclui as propriedades estendidas.

[-f] [-user] [-split] [-p password] [-protectto SAMnameAndSIDlist] [-csp


provider]

Comentários

A senha especificada na linha de comando deve ser uma lista de senhas separadas
por vírgulas.
Se mais de uma senha for especificada, a última senha será usada para o arquivo
de saída. Se apenas uma senha for fornecida ou se a última senha for * , o usuário
será solicitado a fornecer a senha do arquivo de saída.

-convertEPF
Converte um arquivo PFX em um arquivo EPF.

certutil [options] -convertEPF PFXinfilelist PFXoutfile [cast | cast-]


[V3CAcertID][,salt]

Em que:

PFXinfilelist é uma lista separada por vírgulas de arquivos de entrada PFX.

PFXoutfile é o nome do arquivo de saída PFX.

EPF é o nome do arquivo de saída EPF.

cast usa criptografia CAST 64.

cast - usa a criptografia CAST 64 (exportação)

V3CAcertID é o token de correspondência de certificado de AC V3. Para obter


mais informações, consulte o parâmetro -store neste artigo.

salt é a cadeia de caracteres de sal do arquivo de saída do EPF.

[-f] [-silent] [-split] [-dc DCName] [-p password] [-csp provider]

Comentários
A senha especificada na linha de comando deve ser uma lista de senhas separadas
por vírgulas.

Se mais de uma senha for especificada, a última senha será usada para o arquivo
de saída. Se apenas uma senha for fornecida ou se a última senha for * , o usuário
será solicitado a fornecer a senha do arquivo de saída.
-?
Exibe a lista de parâmetros.

certutil -?
certutil <name_of_parameter> -?
certutil -? -v

Em que:

-? exibe a lista de parâmetros completa

- <name_of_parameter> -? exibe o conteúdo da ajuda para o parâmetro


especificado.

-? -v exibe uma lista completa de parâmetros e opções.

-syncWithWU
É sincronizado com o Windows Update. Os arquivos a seguir são baixados por meio do
mecanismo de atualização automática.

CertUtil [Options] -syncWithWU DestinationDir

Em que:

DestinationDir é a pasta que recebe os arquivos por meio do mecanismo de


atualização automática.

[-f] [-Unicode] [-gmt] [-seconds] [-v] [-privatekey] [-pin PIN] [-sid


WELL_KNOWN_SID_TYPE]

Em que:

f força uma substituição


Unicode grava a saída redirecionada em Unicode
Gmt Exibe as horas como GMT
seconds Exibe as horas com os segundos e os milissegundos
v é uma operação detalhada
PIN é o PIN de Cartão Inteligente
WELL_KNOWN_SID_TYPE é um SID numérico:
22 – Sistema Local
23 – Serviço Local
24 – Serviço de Rede

Comentários
Os arquivos a seguir são baixados usando o mecanismo de atualização automática:

authrootstl.cab Contém as CTLs dos certificados raiz não Microsoft.


disallowedcertstl.cab Contém as CTLs de certificados não confiáveis.

disallowedcert.sst Contém o repositório de certificados serializado, incluindo os


certificados não confiáveis.
thumbprint.crt Contém os certificados raiz não Microsoft.

Por exemplo, CertUtil -syncWithWU \\server1\PKI\CTLs .

Se você usar um caminho ou uma pasta local não existente como a pasta de destino,
verá o erro:

The system can't find the file specified. 0x80070002 (WIN32: 2

ERROR_FILE_NOT_FOUND)

Se você usar um local de rede não existente ou não disponível como a pasta de destino,
verá o erro:

The network name can't be found. 0x80070043 (WIN32: 67 ERROR_BAD_NET_NAME)

Se o seu servidor não conseguir se conectar pela porta TCP 80 aos servidores de
Atualização Automática da Microsoft, você receberá o seguinte erro:

A connection with the server couldn't be established 0x80072efd (INet: 12029


ERROR_INTERNET_CANNOT_CONNECT)

Se o seu servidor não conseguir acessar os servidores de Atualização Automática da


Microsoft com o nome de DNS ctldl.windowsupdate.com , você receberá o seguinte erro:

The server name or address couldn't be resolved 0x80072ee7 (INet: 12007


ERROR_INTERNET_NAME_NOT_RESOLVED).
Se você não usar a opção -f e algum dos arquivos da CTL já existir no diretório, você
receberá o erro "O arquivo já existe":

CertUtil: -syncWithWU command FAILED: 0x800700b7 (WIN32/HTTP: 183

ERROR_ALREADY_EXISTS) Certutil: Can't create a file when that file already exists.

Se houver uma alteração nos certificados raiz confiáveis, você verá:

Warning! Encountered the following no longer trusted roots: <folder path>\

<thumbprint>.crt. Use "-f -f" options to force the delete of the above ".crt"
files. Was "authrootstl.cab" updated? If yes, consider deferring the delete until

all clients have been updated.

-generateSSTFromWU SSTFile
Gera um SST por meio do mecanismo de atualização automática.

CertUtil [Options] -generateSSTFromWU SSTFile

Em que:

SSTFile é o arquivo .sst a ser criado.

[-f] [-Unicode] [-gmt] [-seconds] [-v] [-privatekey] [-pin PIN] [-sid


WELL_KNOWN_SID_TYPE]

Em que:

f força uma substituição


Unicode grava a saída redirecionada em Unicode
Gmt Exibe as horas como GMT
seconds Exibe as horas com os segundos e os milissegundos
v é uma operação detalhada
PIN é o PIN de Cartão Inteligente
WELL_KNOWN_SID_TYPE é um SID numérico:
22 – Sistema Local
23 – Serviço Local
24 – Serviço de Rede
Comentários
O arquivo .sst gerado contém as raízes de terceiros baixadas do Windows
Update.

Opções
Esta seção define todas as opções que você pode especificar, com base no comando.
Cada parâmetro inclui informações sobre quais opções são válidas para uso.

Opções Descrição

-nullsign Usar o hash dos dados como uma assinatura.

-f Forçar substituição.

-enterprise Usar o repositório de certificados do registro empresarial do


computador local.

-user Usar as teclas HKEY_CURRENT_USER ou o armazenamento


de certificados.

-GroupPolicy Usar o repositório de certificados de política de grupo.

-ut Exibir modelos de usuário.

-mt Exibir modelos de computador.

-Unicode Gravar a saída redirecionada em Unicode.

-UnicodeText Gravar o arquivo de saída em Unicode.

-gmt Exibir horários usando GMT.

-seconds Exibir horários usando segundos e milissegundos.

-silent Use o sinalizador silent para adquirir o contexto de


criptografia.

-split Dividir elementos ASN.1 inseridos e salvar em arquivos.

-v Fornecer informações mais detalhadas.

-privatekey Exibir dados de senha e chave privada.

-pin PIN PIN do cartão inteligente.

-urlfetch Recuperar e verificar certificados AIA e CRLs CDP.


Opções Descrição

-config Machine\CAName Cadeia de caracteres de nome do computador e Autoridade


de Certificação.

-policyserver URLorID URL ou ID do Servidor de Política. Para U/I de seleção, use -


policyserver . Para todos os Servidores de Política, use -
policyserver *

-anonymous Usar credenciais SSL anônimas.

-kerberos Usar credenciais SSL Kerberos.

-clientcertificate clientcertID Usar credenciais SSL de Certificado X.509. Para U/I de


seleção, use -clientcertificate .

-username username Usar a conta nomeada para credenciais SSL. Para U/I de
seleção, use -username .

-cert certID Certificado de autenticação.

-dc DCName Direcionar um controlador de domínio específico.

-restrict restrictionlist Lista de Restrições separadas por vírgulas. Cada restrição é


composta por um nome de coluna, um operador relacional
e um inteiro constante, cadeia de caracteres ou data. Um
nome de coluna pode ser precedido por um sinal de mais
ou de menos para indicar a ordem de classificação. Por
exemplo: requestID = 47 , +requestername >= a,
requestername ou -requestername > DOMAIN, Disposition =
21

-out columnlist Lista de colunas separadas por vírgulas.

-p senha Senha

-protectto SAMnameandSIDlist Lista de SID/nome SAM separado por vírgulas.

-csp provider Provedor

-t timeout Tempo limite de busca de URL em milissegundos.

-symkeyalg Nome do Algoritmo de Chave Simétrica com comprimento


symmetrickeyalgorithm[,keylength] de chave opcional. Por exemplo: AES,128 ou 3DES

-syncWithWU DestinationDir Sincronizar com o Windows Update.

-generateSSTFromWU SSTFile Gera SST usando o mecanismo de atualização automática.

Links relacionados
Para ver mais alguns exemplos de como usar esse comando, consulte

AD CS (Serviços de Certificados do Active Directory)

Tarefas de certutil para gerenciar certificados

Configurar raízes confiáveis e certificados não permitidos no Windows


alterar
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera as configurações do servidor Host da Sessão da Área de Trabalho Remota para


logons, mapeamentos de porta COM e modo de instalação.

7 Observação

Para descobrir as novidades da última versão, confira Novidades nos Serviços de


Área de Trabalho Remota do Windows Server.

Sintaxe

change logon
change port
change user

Parâmetros

Parâmetro Descrição

Comando Habilita ou desabilita logons de sessões de cliente em um servidor Host da Sessão


change da Área de Trabalho Remota ou exibe o status de logon atual.
logon

comando Lista ou altera os mapeamentos de porta COM para serem compatíveis com os
change port aplicativos MS-DOS.

comando Altera o modo de instalação do servidor Host da Sessão da Área de Trabalho


change user Remota.

Links relacionados
Chave da sintaxe de linha de comando
Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de
Terminal)
change logon
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Habilita ou desabilita logons de sessões de cliente ou exibe o status de logon atual. Esse
utilitário é útil para manutenção do sistema. Você precisa ser um administrador para
executar esse comando.

7 Observação

Para descobrir as novidades da última versão, confira Novidades nos Serviços de


Área de Trabalho Remota do Windows Server.

Sintaxe

change logon {/query | /enable | /disable | /drain | /drainuntilrestart}

Parâmetros

Parâmetro Descrição

/Query Exibe o status de logon atual, seja ele habilitado ou desabilitado.

/enable Habilita logons de sessões de cliente, mas não do console.

/disable Desabilita logons subsequentes de sessões de cliente, mas não do console.


Não afeta usuários conectados no momento.

/drain Desabilita logons de novas sessões de cliente, mas permite reconexões a


sessões existentes.

/drainuntilrestart Desabilita logons de novas sessões de cliente até que o computador seja
reiniciado, mas permite reconexões a sessões existentes.

/? Exibe a ajuda no prompt de comando.


Comentários
Os logons são reabilitados quando você reinicia o sistema.

Se você estiver conectado ao servidor Host da Sessão da Área de Trabalho Remota


de uma sessão de cliente e desabilitar logons e fizer logoff antes de reabilitar os
logons, não conseguirá se reconectar à sessão. Para reabilitar logons de sessões de
cliente, faça logon no console.

Exemplos
Para exibir o status de logon atual, digite:

change logon /query

Para habilitar logons de sessões de cliente, digite:

change logon /enable

Para desabilitar logons de cliente, digite:

change logon /disable

Links relacionados
Chave da sintaxe de linha de comando

Comando change

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
change port
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Lista ou altera os mapeamentos de porta COM para serem compatíveis com os


aplicativos MS-DOS.

7 Observação

Para descobrir as novidades da última versão, confira Novidades nos Serviços de


Área de Trabalho Remota do Windows Server.

Sintaxe

change port [<portX>=<portY>| /d <portX> | /query]

Parâmetros

Parâmetro Descrição

<portX> = <portY> Mapeia COM <portX> para <portY>

/d <portX> Exclui o mapeamento para COM <portX>

/Query Exibe os mapeamentos de porta atuais.

/? Exibe a ajuda no prompt de comando.

Comentários

A maioria dos aplicativos MS-DOS dá suporte apenas a portas serial COM1 a


COM4. O comando change port mapeia uma porta serial para um número de
porta diferente, permitindo que aplicativos que não dão suporte a portas COM de
alta numeração acessem a porta serial. O remapeamento funciona apenas para a
sessão atual e não é mantido se fizer logoff de uma sessão e, em seguida, fazer
logon novamente.

Use o alterar porta sem parâmetros para exibir as portas COM disponíveis e seus
mapeamentos atuais.

Exemplos
Para mapear COM12 para COM1 para uso por um aplicativo baseado em MS-DOS,
digite:

change port com12=com1

Para exibir os mapeamentos de porta atuais, digite:

change port /query

Links relacionados
Chave da sintaxe de linha de comando

comando change

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
change user
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o modo de instalação do servidor Host da Sessão da Área de Trabalho Remota.

7 Observação

Para descobrir as novidades da última versão, veja Novidades nos Serviços de Área
de Trabalho Remota do Windows Server.

Sintaxe

change user {/execute | /install | /query}

Parâmetros

Parâmetro Descrição

/execute Habilita o mapeamento de arquivos .ini para o diretório base. Essa é a configuração
padrão.

/install Desabilita o mapeamento de arquivos .ini para o diretório base. Todos os arquivos
.ini são lidos e gravados no diretório do sistema. Você deve desabilitar o
mapeamento de arquivos .ini ao instalar aplicativos em um servidor Host da Sessão
da Área de Trabalho Remota.

/Query Exibe a configuração atual para o mapeamento de arquivos .ini.

/? Exibe a ajuda no prompt de comando.

Comentários
Use change user /install antes de instalar um aplicativo para criar arquivos .ini para
o aplicativo no diretório do sistema. Esses arquivos são usados como a origem
quando arquivos .ini específicos do usuário são criados. Depois de instalar o
aplicativo, use change user /execute para reverter para o mapeamento de
arquivos .ini padrão.

Na primeira vez que você executar o aplicativo, ele pesquisa o diretório base para
seus arquivos .ini. Se os arquivos de .ini não forem encontrados no diretório base,
mas forem encontrados no diretório do sistema, os Serviços de Área de Trabalho
Remota copiarão os arquivos .ini para o diretório inicial, garantindo que cada
usuário tenha uma cópia exclusiva dos arquivos .ini do aplicativo. Todos os novos
arquivos .ini são criados no diretório base.

Cada usuário deve ter uma cópia exclusiva dos arquivos .ini para um aplicativo.
Isso impede instâncias em que diferentes usuários podem ter configurações de
aplicativo incompatíveis (por exemplo, diretórios padrão diferentes ou resoluções
de tela).

Quando o sistema está executando change user /install, várias coisas ocorrem.
Todas as entradas do Registro criadas são sombreadas em
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
NT\Currentversion\Terminal Server\Install, na subchave \SOFTWARE ou na
subchave \MACHINE. As subchaves adicionadas a HKEY_CURRENT_USER são
copiadas na subchave \SOFTWARE e nas subchaves adicionadas a
HKEY_LOCAL_MACHINE são copiadas na subchave \MACHINE. Se o aplicativo
consultar o diretório do Windows usando chamadas do sistema, como
GetWindowsdirectory, o servidor Host da Sessão rd retornará o diretório
systemroot. Se as entradas de arquivo .ini forem adicionadas usando chamadas do
sistema, como WritePrivateProfileString, elas serão adicionadas aos arquivos .ini no
diretório systemroot.

Quando o sistema retorna para change user /execute, e o aplicativo tenta ler uma
entrada do Registro em HKEY_CURRENT_USER que não existe, os Serviços de Área
de Trabalho Remota verificam se existe uma cópia da chave na subchave \Terminal
Server\Install. Se isso acontecer, as subchaves serão copiadas para o local
apropriado em HKEY_CURRENT_USER. Se o aplicativo tentar ler de um arquivo .ini
que não existe, os Serviços de Área de Trabalho Remota procurarão esse arquivo
.ini na raiz do sistema. Se o arquivo .ini estiver na raiz do sistema, ele será copiado
para o subdiretório \Windows do diretório base do usuário. Se o aplicativo
consultar o diretório do Windows, o servidor host de sessão rd retornará o
subdiretório \Windows do diretório base do usuário.

Quando você faz logon, os Serviços de Área de Trabalho Remota verificam se os


arquivos .ini do sistema são mais recentes do que os arquivos .ini no computador.
Se a versão do sistema for mais recente, o arquivo .ini será substituído pela ou
mesclado com a versão mais recente. Isso depende se o bit INISYNC, 0x40, está
definido para esse arquivo .ini. Sua versão anterior do arquivo .ini é renomeada
como Inifile.ctx. Se os valores do registro do sistema na subchave \Terminal
Server\Install forem mais recentes do que sua versão em HKEY_CURRENT_USER,
sua versão das subchaves será excluída e substituída pelas novas subchaves de
\Terminal Server\Install.

Exemplos
Para desabilitar o mapeamento de arquivos .ini no diretório inicial, digite:

change user /install

Para habilitar o mapeamento de arquivos .ini no diretório inicial, digite:

change user /execute

Para exibir a configuração atual para o mapeamento de arquivos .ini, digite:

change user /query

Links relacionados
Chave da sintaxe de linha de comando

comando change

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
chcp
Artigo • 17/04/2023

Altera a página de código do console ativo. Se usado sem parâmetros, chcp exibirá o
número da página de código do console ativo.

Sintaxe

chcp [<nnn>]

Parâmetros

Parâmetro Descrição

<nnn> Especifica a página do código.

/? Exibe a ajuda no prompt de comando.

A tabela a seguir lista cada página de código com suporte e seu país/região ou idioma:

Página de código País/região ou idioma

437 Estados Unidos

850 Multilíngue (Latino I)

852 Eslavo (Latino II)

855 Cirílico (russo)

857 Turco

860 Português

861 Islandês

863 Francês canadense

865 Nórdico

866 Russo

869 Grego Moderno


Página de código País/região ou idioma

936 Chinês

Comentários
Somente a página de código OEM (fabricante do equipamento original) instalada
com o Windows aparece corretamente em uma janela da Solicitação de Comando
que usa fontes Raster. Outras páginas de código aparecem corretamente no modo
de tela inteira ou nas janelas da Solicitação de Comando que usam fontes
TrueType.

Você não precisa preparar páginas de código (como no MS-DOS).

Os programas que você inicia depois de atribuir uma nova página de código usam
a nova página de código. No entanto, os programas (exceto Cmd.exe) iniciados
antes de atribuir a nova página de código continuarão a usar a página de código
original.

Exemplos
Para exibir a configuração de página de código ativo, digite:

chcp

Uma mensagem semelhante à seguinte é exibida: Active code page: 437

Para alterar a página de código ativo para 850 (multilíngue), digite:

chcp 850

Se a página de código especificada for inválida, a seguinte mensagem de erro será


exibida: Invalid code page

Links relacionados
Chave da sintaxe de linha de comando
BitFields da Página de Código
Identificadores de página de código
chdir
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe o nome do diretório atual ou altera o diretório atual. Se usado apenas com uma
letra de unidade (por exemplo, chdir C: ), chdir exibirá os nomes do diretório atual na
unidade especificada. Se usado sem parâmetros, chdir exibirá a unidade e o diretório
atuais.

7 Observação

Esse comando foi substituído pelo comando cd. Para obter mais informações,
incluindo a sintaxe e os detalhes do parâmetro, consulte o comando cd.

Links relacionados
Chave da sintaxe de linha de comando

comando cd
chglogon
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Habilita ou desabilita logons de sessões de cliente em um servidor Host da Sessão da


Área de Trabalho Remota ou exibe o status de logon atual.

7 Observação

Esse comando foi substituído pelo comando change log. Para obter mais
informações, incluindo a sintaxe e os detalhes do parâmetro, consulte o comando
change port.

Links relacionados
Chave da sintaxe de linha de comando

Comando change logon

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
chgport
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Lista ou altera os mapeamentos de porta COM para serem compatíveis com os


aplicativos MS-DOS.

7 Observação

Esse comando foi substituído pelo comando change port. Para obter mais
informações, incluindo a sintaxe e os detalhes do parâmetro, consulte o comando
change port.

Links relacionados
Chave da sintaxe de linha de comando

comando change port

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
chgusr
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o modo de instalação do servidor Host da Sessão da Área de Trabalho Remota.

7 Observação

Esse comando foi substituído pelo comando change user. Para obter mais
informações, incluindo a sintaxe e os detalhes do parâmetro, consulte o comando
change user.

Links relacionados
Chave da sintaxe de linha de comando

comando change user

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
chkdsk
Artigo • 11/04/2023

Verifica os metadados do sistema de arquivos e do sistema de arquivos de um volume


em busca de erros lógicos e físicos. Se usado sem parâmetros, chkdsk exibe apenas o
status do volume e não corrige nenhum erro. Se usado com os parâmetros /f, /r, /xou
/b, ele corrigirá erros no volume.

) Importante

A associação no grupo de Administradores local, ou equivalente, é o mínimo


necessário para executar chkdsk. Para abrir um prompt de comando como
administrador: no menu Iniciar, clique com o botão direito do mouse em Prompt
de Comando e clique em Executar como administrador.

) Importante

Não é recomendável interromper chkdsk. No entanto, cancelar ou interromper


chkdsk não deve deixar o volume mais corrompido do que estava antes da
execução de chkdsk. A execução de chkdsk novamente verifica e deve reparar
eventual resto de corrupção no volume.

7 Observação

O chkdsk só pode ser usado em discos locais. O comando não pode ser usado com
uma letra de unidade local que foi redirecionada pela rede.

Sintaxe
Prompt de comando do Windows

chkdsk [<volume>[[<path>]<filename>]] [/f] [/v] [/r] [/x] [/i] [/c] [/l[:


<size>]] [/b]

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

<volume> Especifica a letra da unidade (seguida por dois-pontos), o ponto de


montagem ou o nome do volume.

[ [<path>] Use apenas com FAT (tabela de alocação de arquivo) e FAT32. Especifica o
<filename> local e o nome de um arquivo ou conjunto de arquivos no qual você
deseja que chkdsk verifique se há fragmentação. Você pode usar os
caracteres curinga ? e * para especificar vários arquivos.

/f Corrige erros no disco. O disco precisa ser bloqueado. Se chkdsk não


puder bloquear a unidade, será exibida uma mensagem que pergunta se
você deseja verificar a unidade na próxima vez que reiniciar o computador.

/v Exibe o nome de cada arquivo em cada diretório conforme o disco é


verificado.

/r Localiza setores inválidos e recupera informações legíveis. O disco precisa


ser bloqueado. /r inclui a funcionalidade de /f, com a análise adicional de
erros de disco físico.

/x Força o volume a desmontar primeiro, se necessário. Todos os


identificadores abertos para a unidade são invalidados. /x também inclui a
funcionalidade de /f.

/i Use apenas com NTFS. Executa uma verificação menos vigorosa das
entradas de índice, o que reduz o tempo necessário para executar chkdsk.

/c Use apenas com NTFS. Não verifica os ciclos dentro da estrutura de pastas,
o que reduz o tempo necessário para executar chkdsk.

/l[: <size> ] Use apenas com NTFS. Altera o tamanho do arquivo de log para o
tamanho que você digitar. Se você omitir o parâmetro size, /l exibirá o
tamanho atual.

/b Use apenas com NTFS. Limpa a lista de clusters inválidos no volume e


verifica erros novamente em todos os clusters alocados e gratuitos. /b
também inclui a funcionalidade de /r. Use esse parâmetro após a geração
de imagens de um volume para uma nova unidade de disco rígido.

/scan Use apenas com NTFS. Executa uma verificação online no volume.

/forceofflinefix Use somente com NTFS (deve ser usado com /scan). Ignora todos os
reparos online; todos os defeitos encontrados são enfileirados para reparo
offline (por exemplo, chkdsk /spotfix ).

/perf Use somente com NTFS (deve ser usado com /scan). Usa mais recursos do
sistema para concluir uma verificação o mais rápido possível. Isso pode ter
um impacto negativo no desempenho de outras tarefas em execução no
sistema.
Parâmetro Descrição

/spotfix Use apenas com NTFS. Executa a correção de spot no volume.

/sdcleanup Use apenas com NTFS. O lixo coleta dados desnecessários do descritor de
segurança (implica /f).

/offlinescanandfix Executa uma verificação e correção offline no volume.

/freeorphanedchains Use somente com FAT/FAT32/exFAT. Libera todas as cadeias de cluster


órfãs em vez de recuperar seu conteúdo.

/markclean Use somente com FAT/FAT32/exFAT. Marcará o volume limpo se nenhuma


corrupção tiver sido detectada, mesmo que /f não tenha sido especificado.

/? Exibe a ajuda no prompt de comando.

Comentários
A opção /i ou /c reduz o tempo necessário para executar chkdsk ignorando
determinadas verificações de volume.

Se você quiser que chkdsk corrija erros de disco, não poderá ter arquivos abertos
na unidade. Se os arquivos estiverem abertos, a seguinte mensagem de erro será
exibida:

Chkdsk cannot run because the volume is in use by another process.


Would you like to schedule this volume to be checked the next time the
system restarts? (Y/N)

Se você optar por verificar a unidade na próxima vez em que reiniciar o


computador, chkdsk verificará a unidade e corrigirá os erros automaticamente ao
reiniciar o computador. Se a partição da unidade for uma partição de inicialização,
chkdsk reiniciará automaticamente o computador depois de verificar a unidade.

Você também pode usar o comando chkntfs /c para agendar o volume a ser
verificado na próxima vez em que o computador for reiniciado. Use o comando
fsutil dirty set para definir o bit sujo do volume (indicando corrupção), para

que o Windows execute chkdsk quando o computador for reiniciado.

Você deve usar chkdsk ocasionalmente em sistemas de arquivos FAT e NTFS para
verificar se há erros de disco. Chkdsk examina o espaço em disco e o uso do disco
e fornece um relatório de status específico para cada sistema de arquivos. O
relatório de status mostra os erros encontrados no sistema de arquivos. Se você
executar chkdsk sem o parâmetro /f em uma partição ativa, ele poderá relatar
erros hipotéticos porque não pode bloquear a unidade.

Chkdsk apenas corrige erros de disco lógico se você especificar o parâmetro /f.
Chkdsk precisa ser capaz de bloquear a unidade para corrigir erros.

Como os reparos em sistemas de arquivos FAT geralmente alteram a tabela de


alocação de arquivos de um disco e, às vezes, causam perda de dados, chkdsk
pode exibir uma mensagem de confirmação semelhante à seguinte:

10 lost allocation units found in 3 chains.


Convert lost chains to files?

Se você pressionar Y, o Windows salvará cada cadeia perdida no diretório raiz


como um arquivo com um nome no formato File. <nnnn> chk. Quando chkdsk for
concluído, você poderá verificar esses arquivos para ver se eles contêm os
dados necessários.

Se você pressionar N, o Windows corrigirá o disco, mas não salvará o conteúdo


das unidades de alocação perdidas.

Se você não usar o parâmetro /f, chkdsk exibirá uma mensagem informando que o
arquivo precisa ser corrigido, mas não corrige nenhum erro.

Se você usar chkdsk /f* em um disco muito grande ou em um disco com um


número muito grande de arquivos (por exemplo, milhões de arquivos), chkdsk /f
poderá levar muito tempo para ser concluído.

Use o parâmetro /r para encontrar erros de disco físico no sistema de arquivos e


tentar recuperar dados de todos os setores de disco afetados.

Se você especificar o parâmetro /f, chkdsk exibirá uma mensagem de erro se


houver arquivos abertos no disco. Se você não especificar o parâmetro /f e os
arquivos abertos existirem, chkdsk poderá relatar unidades de alocação perdidas
no disco. Isso poderá acontecer se os arquivos abertos ainda não tiverem sido
registrados na tabela de alocação de arquivos. Se chkdsk relatar a perda de um
grande número de unidades de alocação, considere reparar o disco.

Como o volume de origem das Cópias de Sombra para Pastas Compartilhadas não
pode ser bloqueado enquanto Cópias de Sombra para Pastas Compartilhadas
estiver habilitada, a execução de chkdsk no volume de origem pode relatar erros
falsos ou fazer com que chkdsk seja encerrado inesperadamente. No entanto, você
pode verificar erros em cópias de sombra executando chkdsk no modo somente
leitura (sem parâmetros) para verificar o volume de armazenamento Cópias de
Sombra para Pastas Compartilhadas.

O comando chkdsk, com parâmetros diferentes, está disponível no Console de


Recuperação.

Em servidores que são reiniciados com pouca frequência, talvez seja melhor usar
chkntfs ou os comandos fsutil dirty query para determinar se o bit sujo do
volume já está definido antes de executar chkdsk.

Noções básicas sobre códigos de saída


A tabela a seguir lista os códigos de saída que chkdsk relata após a conclusão.

Código Descrição
de saída

0 Nenhum erro foi encontrado.

1 Erros foram encontrados e corrigidos.

2 Realizou a limpeza de disco (como coleta de lixo) ou não realizou a limpeza porque
/f não foi especificado.

3 Não foi possível verificar o disco, erros não puderam ser corrigidos ou erros não
foram corrigidos porque /f não foi especificado.

Exemplos
Para verificar o disco na unidade D e fazer com que o Windows corrija erros, digite:

Prompt de comando do Windows

chkdsk d: /f

Se encontrar erros, chkdsk pausará e exibirá mensagens. Chkdsk é concluído com a


exibição de um relatório que lista o status do disco. Não é possível abrir nenhum
arquivo na unidade especificada até que chkdsk seja concluído.

Para verificar blocos não contíguos em todos os arquivos em um disco FAT no diretório
atual, digite:
Prompt de comando do Windows

chkdsk *.*

Chkdsk exibe um relatório de status e lista os arquivos que correspondem às


especificações de arquivo que têm blocos não contíguos.

Exibindo logs de chkdsk


Há dois métodos que podem ser usados para recuperar arquivos de log de chkdsk no
Windows. Veja os métodos descritos abaixo:

Visualizador de Eventos

Para exibir logs com o Visualizador de Eventos, navegue até o seguinte:

1. Inicie >Painel de Controle>Ferramentas Administrativas>Visualizador de


Eventos.

Como alternativa, pressione as teclas Win + R para abrir a caixa de diálogo de


execução, digite eventvwr.msc e selecione OK.

2. Expanda Logs do Windows> clique com o botão direito do mouse em


Aplicativo> selecione Filtrar Log Atual.

3. Na janela Filtrar Log Atual, navegue até o menu suspenso Fontes de eventos,
selecione Chkdsk e Wininit.

4. Clique em OK para concluir a filtragem dessas duas fontes.

Links relacionados
Chave da sintaxe de linha de comando
chkntfs
Artigo • 12/04/2023

Exibe ou modifica a verificação automática de disco quando o computador é iniciado.


Se usado sem opções, chkntfs exibirá o sistema de arquivos do volume especificado. Se
a verificação automática de arquivos estiver agendada para ser executada, chkntfs
exibirá se o volume especificado está sujo ou se está agendado para ser verificado na
próxima vez que o computador for iniciado.

7 Observação

Para executar chkntfs, deverá ser membro do grupo de administradores.

Sintaxe

chkntfs <volume> [...]


chkntfs [/d]
chkntfs [/t[:<time>]]
chkntfs [/x <volume> [...]]
chkntfs [/c <volume> [...]]

Parâmetros

Parâmetro Descrição

<volume> Especifica um ou mais volumes a serem verificados quando o computador é


[...] iniciado. Os volumes válidos incluem letras da unidade (seguidas por dois-pontos),
pontos de montagem ou nomes de volume.

/d Restaura todas as configurações padrão do chkntfs, exceto o tempo de contagem


regressiva para verificação automática de arquivos. Por padrão, todos os volumes
são verificados quando o computador é iniciado e o chkdské executado naqueles
que estão sujos.

/t [ : Altera o tempo de contagem regressiva de inicialização do Autochk.exe para a


<time> ] quantidade de tempo especificada em segundos. Se você não inserir uma hora, /t
exibirá o tempo de contagem regressiva atual.
Parâmetro Descrição

/x Especifica um ou mais volumes a serem excluídos da verificação quando o


<volume> computador é iniciado, mesmo que o volume esteja marcado como exigindo
[...] chkdsk.

/c Agenda um ou mais volumes a serem verificados quando o computador é iniciado e


<volume> executa chkdsk naqueles que estão sujos.
[...]

/? Exibe a ajuda no prompt de comando.

Exemplos
Para exibir o tipo de sistema de arquivos para a unidade C, digite:

chkntfs c:

7 Observação

Se a verificação automática de arquivos estiver agendada para ser executada, a


saída adicional será exibida, indicando se a unidade está suja ou se foi agendada
manualmente para ser verificada na próxima vez que o computador for iniciado.

Para exibir o tempo de contagem regressiva de inicialização do Autochk.exe, digite:

chkntfs /t

Para alterar o tempo de contagem regressiva de iniciação do Autochk.exe para 30


segundos, digite:

chkntfs /t:30

7 Observação
Embora você possa definir o tempo de contagem regressiva de iniciação do
Autochk.exe como zero, isso impedirá que você cancele uma verificação de arquivo
automática potencialmente demorada.

Para excluir a verificação de vários volumes, liste cada um deles em um único comando.
Por exemplo, para excluir os volumes D e E, digite:

chkntfs /x d: e:

) Importante

A opção de linha de comando /x não é acumulada. Se você digitá-lo mais de uma


vez, a entrada mais recente substituirá a entrada anterior.

Para agendar a verificação automática de arquivos no volume D, mas não nos volumes C
ou E, digite os seguintes comandos na ordem:

chkntfs /d
chkntfs /x c: d: e:
chkntfs /c d:

) Importante

A opção de linha de comando /c é acumulada. Se digitar /c mais de uma vez, cada


entrada permanecerá. Para garantir que apenas um volume específico seja
verificado, redefina os padrões para limpar todos os comandos anteriores, exclua
todos os volumes de serem verificados e agende a verificação automática de
arquivos no volume desejado.

Links relacionados
Chave da sintaxe de linha de comando
opção
Artigo • 10/04/2023

Solicita que o usuário selecione um item de uma lista de opções de caractere único em
um programa em lotes e, em seguida, retorna o índice da escolha selecionada. Se usado
sem parâmetros, opção exibirá as opções padrão S e N.

Sintaxe

choice [/c [<choice1><choice2><…>]] [/n] [/cs] [/t <timeout> /d <choice>]


[/m <text>]

Parâmetros

Parâmetro Descrição

/c Especifica a lista de opções a serem criadas. As opções válidas incluem a-z, A-Z, 0-9
<choice1> e caracteres ASCII estendidos (128-254). A lista padrão é SN, que é exibida como
<choice2> [Y,N]? .
<…>

/n Oculta a lista de opções, embora as opções ainda estejam habilitadas e o texto da


mensagem (se especificado por /m) ainda seja exibido.

/cs Especifica que as opções diferenciam maiúsculas de minúsculas. Por padrão, as


opções não diferenciam maiúsculas de minúsculas.

/t Especifica o número de segundos a serem pausados antes de usar a opção padrão


<timeout> especificada por /d. Os valores aceitáveis são de 0 a 9999. Se /t estiver definido
como 0, a opção não pausará antes de retornar a opção padrão.

/d Especifica a opção padrão a ser usada depois de aguardar o número de segundos


<choice> especificado por /t. A opção padrão deve estar na lista de opções especificadas por
/c.

/m <text> Especifica uma mensagem a ser exibida antes da lista de opções. Se /m não for
especificado, somente o prompt de opção será exibido.

/? Exibe a ajuda no prompt de comando.

Comentários
A variável de ambiente ERRORLEVEL é definida como o índice da chave que o
usuário seleciona na lista de opções. A primeira opção na lista retorna um valor de
1 , o segundo um valor de 2 e assim por diante. Se o usuário pressionar uma tecla

que não é uma opção válida, a opção soará um aviso sonoro.

Se a opção detectar uma condição de erro, ela retornará um valor ERRORLEVEL de


255 . Se o usuário pressionar CTRL+BREAK ou CTRL+C, a opção retornará um valor

ERRORLEVEL de 0 .

7 Observação

Ao usar valores ERRORLEVEL em um programa em lotes, você deve listá-los em


ordem decrescente.

Exemplos
Para apresentar as opções S, N e C, digite a seguinte linha em um arquivo em lote:

choice /c ync

O seguinte prompt é exibido quando o arquivo em lote executa o comando de opção :

[Y,N,C]?

Para ocultar as opções S, N e C, mas exibir o texto Sim, Não ou Continuar, digite a
seguinte linha em um arquivo em lote:

choice /c ync /n /m "Yes, No, or Continue?"

7 Observação

Se usar o parâmetro /n, mas não usar /m, o usuário não será solicitado quando a
opção estiver aguardando a entrada.
Para mostrar o texto e as opções usadas nos exemplos anteriores, digite a seguinte linha
em um arquivo em lote:

choice /c ync /m "Yes, No, or Continue"

Para definir um limite de tempo de cinco segundos e especificar N como o valor padrão,
digite a seguinte linha em um arquivo em lote:

choice /c ync /t 5 /d n

7 Observação

Neste exemplo, se o usuário não pressionar uma tecla dentro de cinco segundos, a
opção selecionará N por padrão e retornará um valor de erro de 2 . Caso contrário,
a opção retornará o valor correspondente à escolha do usuário.

Links relacionados
Chave da sintaxe de linha de comando
cipher
Artigo • 10/04/2023

Exibe ou altera a criptografia de diretórios e pastas em volumes NTFS. Se usado sem


parâmetros, o cipher exibe o estado de criptografia do diretório atual e quaisquer
arquivos que ele contém.

Sintaxe

cipher [/e | /d | /c] [/s:<directory>] [/b] [/h] [pathname [...]]


cipher /k
cipher /r:<filename> [/smartcard]
cipher /u [/n]
cipher /w:<directory>
cipher /x[:efsfile] [filename]
cipher /y
cipher /adduser [/certhash:<hash> | /certfile:<filename>] [/s:directory]
[/b] [/h] [pathname [...]]
cipher /removeuser /certhash:<hash> [/s:<directory>] [/b] [/h] [<pathname>
[...]]
cipher /rekey [pathname [...]]

Parâmetros

Parâmetros Descrição

/b Anula se um erro for encontrado. Por padrão, a codificação continua a ser


executada mesmo se forem encontrados erros.

/c Exibe informações sobre o arquivo criptografado.

/d Descriptografa os arquivos ou diretórios especificados.

/e Criptografa os arquivos ou diretórios especificados. Os diretórios são


marcados para que os arquivos adicionados posteriormente sejam
criptografados.

/h Exibe arquivos com atributos ocultos ou do sistema. Por padrão, esses


arquivos não são criptografados ou descriptografados.

/k Cria um novo certificado e uma chave para uso com arquivos EFS (Encrypting
File System). Se o parâmetro /k for especificado, todos os outros parâmetros
serão ignorados.
Parâmetros Descrição

/r: <filename> Gera uma chave e um certificado do agente de recuperação do EFS e, em


[/smartcard] seguida, grava-os em um arquivo .pfx (contendo certificado e chave privada)
e um arquivo .cer (contendo apenas o certificado). Se /smartcard for
especificado, ele gravará a chave de recuperação e o certificado em um
cartão inteligente e nenhum arquivo .pfx será gerado.

/s: <directory> Executa a operação especificada em todos os subdiretórios no diretório


especificado.

/u [/n] Localiza todos os arquivos criptografados nas unidade locais. Se usado com o
parâmetro /n, nenhuma atualização será feita. Se usado sem /n, /u compara a
chave de criptografia de arquivo do usuário ou a chave do agente de
recuperação com as atuais, e atualiza-los se elas alteraram. Esse parâmetro
funciona apenas com /n.

/w: <directory> Remove dados do espaço em disco não utilizado disponível em todo o
volume. Caso use o parâmetro /w, todos os outros parâmetros serão
ignorados. O diretório especificado pode estar localizado em qualquer lugar
em um volume local. Se for um ponto de montagem ou apontar para um
diretório em outro volume, os dados nesse volume serão removidos.

/x[:efsfile] Faz backup do certificado do EFS e das chaves para o nome do arquivo
[ <FileName> ] especificado. Se usado com :efsfile, /x faz backup dos certificados do usuário
que foram usados para criptografar o arquivo. Caso contrário, o certificado e
as chaves do EFS atuais do usuário serão copiados em backup.

/y Exibe a miniatura do certificado do EFS atual no computador local.

/adduser /certfile: <filename> ]


[/certhash: <hash>

/rekey Atualizações os arquivos criptografados especificados para usar a chave do


EFS configurada no momento.

/removeuser Remove um usuário dos arquivos especificados. O Hash fornecido para


/certhash: <hash> /certhash deve ser o hash SHA1 do certificado a ser removido.

/? Exibe a ajuda no prompt de comando.

Comentários
Se o diretório pai não estiver criptografado, um arquivo criptografado poderá ser
descriptografado ao ser alterado. Portanto, ao criptografar um arquivo, você
também deve criptografar o diretório pai.

Um administrador pode adicionar o conteúdo de um arquivo .cer à política de


recuperação do EFS para criar o agente de recuperação para os usuários e, em
seguida, importar o arquivo .pfx para recuperar arquivos individuais.

Use vários nomes de diretório e curingas.

Coloque espaços entre vários parâmetros.

Exemplos
Para exibir o status de criptografia de cada um dos arquivos e subdiretórios no diretório
atual, digite:

cipher

Arquivos e diretórios criptografados são marcados com um E. Arquivos e diretórios não


criptografados são marcados com um U. Por exemplo, a saída a seguir indica que o
diretório atual e todo o conteúdo estão descriptografados no momento:

Listing C:\Users\MainUser\Documents\
New files added to this directory will not be encrypted.
U Private
U hello.doc
U hello.txt

Para habilitar a criptografia no diretório Privado usado no exemplo anterior, digite:

cipher /e private

O seguinte resultado é exibido:

Encrypting files in C:\Users\MainUser\Documents\


Private [OK]
1 file(s) [or directorie(s)] within 1 directorie(s) were encrypted.

O comando cipher exibe a seguinte saída:


Listing C:\Users\MainUser\Documents\
New files added to this directory will not be encrypted.
E Private
U hello.doc
U hello.txt

Onde o diretório Privado agora está marcado como criptografado.

Links relacionados
Chave da sintaxe de linha de comando
clean
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Remove todas as partições ou formatação de volume do disco com foco.

7 Observação

Para obter uma versão do PowerShell desse comando, consulte comando clear-
disk.

Sintaxe

clean [all]

Parâmetros

Parâmetro Descrição

all Especifica que cada setor do disco está definido como zero, o que exclui
completamente todos os dados contidos no disco.

Comentários
Em discos MBR (registro mestre de inicialização), somente as informações de
particionamento do MBR e informações do setor oculto são substituídas.

Em discos gpt (tabela de partição de GUID), as informações de particionamento de


gpt, incluindo o MBR de proteção, são substituídas. Não há informações de setor
oculto.

Um disco precisa estar selecionado para que essa operação seja bem-sucedida.
Use o comando select disk para selecionar um disco e mudar o foco para ele.
Exemplos
Para remover toda a formatação do disco selecionado, digite:

clean

Links relacionados
Comando clear-disk

Chave da sintaxe de linha de comando


cleanmgr
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012, Windows Server 2008 R2

Limpa arquivos desnecessários do disco rígido do computador. É possível usar as


opções de linha de comando para instruir o Cleanmgr a limpar arquivos temporários,
arquivos da Internet, arquivos baixados e arquivos da Lixeira. Depois, é possível agendar
a execução da tarefa para um momento específico usando a ferramenta Tarefas
Agendadas.

Sintaxe

cleanmgr [/d <driveletter>] [/sageset:n] [/sagerun:n] [/TUNEUP:n]


[/LOWDISK] [/VERYLOWDISK]

Parâmetros

Parâmetro Descrição

/d Especifica a unidade que você deseja limpar com a Limpeza de Disco.


<driveletter> NOTA: a opção /d não é utilizada com /sagerun:n .

/sageset:n Exibe a caixa de diálogo Configurações de Limpeza de Disco e também cria


uma chave do Registro para armazenar as configurações selecionadas. O valor
de n , que é armazenado no Registro, permite que você especifique tarefas para
a execução da Limpeza de Disco. O valor de n pode ser qualquer valor inteiro de
0 a 9999.

/sagerun:n Executará as tarefas especificadas atribuídas ao valor n se você usar a opção


/sageset. Todas as unidades no computador são enumeradas e o perfil
selecionado é executado em cada unidade.

/tuneup:n Execute /sageset e /sagerun para o mesmo n .

/lowdisk Execute com as configurações padrão.

/verylowdisk Execute com as configurações padrão, sem solicitações ao usuário.

/? Exibe a ajuda no prompt de comando.


Opções
As opções para os arquivos que você pode especificar para Limpeza de Disco usando
/sageset e /sagerun incluem:

Arquivos de Instalação Temporários - são arquivos que foram criados por um


programa de instalação que não está mais em execução.

Arquivos de Programas Baixados - arquivos de programas baixados são controles


ActiveX e programas Java baixados automaticamente da Internet quando você
visualiza determinadas páginas. Esses arquivos são armazenados temporariamente
na pasta Arquivos de Programas Baixados no disco rígido. Essa opção inclui um
botão Exibir Arquivos para que você possa ver os arquivos antes que a Limpeza de
Disco os remova. O botão abre a pasta C:\Winnt\Arquivos de Programas Baixados.

Arquivos Temporários da Internet - a pasta Arquivos Temporários da Internet


contém páginas da Web armazenadas em seu disco rígido para visualização
rápida. A Limpeza de Disco remove essas páginas, mas deixa as configurações
personalizadas de páginas da Web intactas. Essa opção também inclui um botão
Exibir Arquivos, que abre a pasta C:\Documents and
Settings\Username\Configurações Locais\Arquivos de Internet
Temporários\Content.IE5.

Arquivos antigos do Chkdsk - quando o Chkdsk verifica se há erros em um disco,


o Chkdsk pode salvar fragmentos de arquivo perdidos como arquivos na pasta raiz
do disco. Esses arquivos são desnecessários.

Lixeira - a Lixeira contém arquivos que você excluiu do computador. Esses


arquivos não serão removidos permanentemente até que você esvazie a Lixeira.
Essa opção inclui um botão Exibir Arquivos que abre a Lixeira.

Nota: uma Lixeira pode aparecer em mais de uma unidade, por exemplo, não
apenas em %SystemRoot%.

Arquivos Temporários - os programas às vezes armazenam informações


temporárias em uma pasta Temporária. Antes que um programa seja encerrado, o
programa geralmente exclui essas informações. Você pode excluir com segurança
arquivos temporários que não foram modificados na última semana.

Arquivos Offline Temporários - arquivos offline temporários são cópias locais de


arquivos de rede usados recentemente. Esses arquivos são armazenados em cache
automaticamente para que você possa usá-los depois de se desconectar da rede.
Um botão Exibir Arquivos abre a pasta Arquivos Offline.
Arquivos Offline - arquivos offline são cópias locais de arquivos de rede que você
deseja ter disponíveis especificamente offline para que você possa usá-los depois
de se desconectar da rede. Um botão Exibir Arquivos abre a pasta Arquivos
Offline.

Compactar Arquivos Antigos - o Windows pode compactar arquivos que você não
usou recentemente. Compactar arquivos economiza espaço em disco, mas você
ainda pode usar os arquivos. Nenhum arquivo é excluído. Como os arquivos são
compactados a taxas diferentes, a quantidade exibida de espaço em disco que
você ganhará é aproximada. Um botão Opções permite que você especifique o
número de dias até a Limpeza de Disco compactar um arquivo não utilizado.

Arquivos de Catálogo para o Indexador de Conteúdo - o serviço de Indexação


acelera e melhora as pesquisas de arquivos mantendo um índice dos arquivos que
estão no disco. Esses arquivos de Catálogo perduram de uma operação de
indexação anterior e podem ser excluídos com segurança.

Nota: o Arquivo de Catálogo pode aparecer em mais de uma unidade, por


exemplo, não apenas em %SystemRoot% .

7 Observação

Se você especificar a limpeza da unidade que contém a instalação do Windows,


todas essas opções estarão disponíveis na guia Limpeza de Disco. Se você
especificar qualquer outra unidade, somente a Lixeira e os arquivos de Catálogo
para opções de índice de conteúdo estarão disponíveis na guia Limpeza de Disco.

Exemplos
Para executar o aplicativo Limpeza de Disco para que você possa usar sua caixa de
diálogo para especificar opções para uso posterior, salvando as configurações no
conjunto 1, digite o seguinte:

cleanmgr /sageset:1

Para executar a Limpeza de Disco e incluir as opções especificadas com o comando


cleanmgr /sageset:1, digite:
cleanmgr /sagerun:1

Para executar cleanmgr /sageset:1 e cleanmgr /sagerun:1 juntos, digite:

cleanmgr /tuneup:1

Links relacionados
Liberar espaço em disco no Windows 10

Chave da sintaxe de linha de comando


clip
Artigo • 11/04/2023

Redireciona a saída do comando da linha de comando para a área de transferência do


Windows. Você pode usar esse comando para copiar dados diretamente para qualquer
aplicativo que possa receber texto da Área de Transferência. Você também pode colar
essa saída de texto em outros programas.

Sintaxe

<command> | clip
clip < <filename>

Parâmetros

Parâmetro Descrição

<command> Especifica um comando cuja saída você deseja enviar para a área de transferência
do Windows.

<filename> Especifica um arquivo cujo conteúdo você deseja enviar para a área de transferência
do Windows.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para copiar a listagem de diretórios atual para a área de transferência do Windows,
digite:

dir | clip

Para copiar a saída de um programa chamado generic.awk para a área de transferência


do Windows, digite:
awk -f generic.awk input.txt | clip

Para copiar o conteúdo de um arquivo chamado readme.txt para a área de transferência


do Windows, digite:

clip < readme.txt

Links relacionados
Chave da sintaxe de linha de comando
cls
Artigo • 10/04/2023

Limpa a janela do Prompt de Comando.

Sintaxe

cls

Parâmetros

Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Exemplos
Para limpar todas as informações exibidas na janela do Prompt de Comando e retornar
a uma janela em branco, digite:

cls

Links relacionados
Chave da sintaxe de linha de comando
cmd
Artigo • 11/04/2023

Inicia uma nova instância do interpretador de comando, Cmd.exe. Se usado sem


parâmetros, cmd exibirá as informações de versão e direitos autorais do sistema
operacional.

Sintaxe

cmd [/c|/k] [/s] [/q] [/d] [/a|/u] [/t:{<b><f> | <f>}] [/e:{on | off}] [/f:
{on | off}] [/v:{on | off}] [<string>]

Parâmetros

Parâmetro Descrição

/c Executa o comando especificado por string e para.

/k Executa o comando especificado por string e continua.

/s Modifica o tratamento da string após /c ou /k.

/q Desativa o eco.

/d Desabilita a execução de comandos de Execução Automática.

/a Formata a saída de comando interno para um pipe ou um arquivo como ANSI


(American National Standards Institute).

/u Formata a saída de comando interno para um pipe ou um arquivo como Unicode.

/t:{ <b><f> | Define as cores da tela de fundo (b) e do primeiro plano (f).
<f> }

/e:on Habilita extensões de comando.

/e:off Desabilita extensões de comando.

/f:on Habilita op preenchimento do nome do arquivo e do diretório.

/f:off Desabilita o preenchimento do nome do arquivo e do diretório.

/v:on Habilita a expansão de variável de ambiente atrasada.


Parâmetro Descrição

/v:off Desabilita a expansão da variável de ambiente atrasada.

<string> Especifica o comando que você deseja executar.

/? Exibe a ajuda no prompt de comando.

A tabela abaixo lista dígitos hexadecimais válidos que você pode usar como os valores
para <b> e <f> :

Valor Color

0 Preto

1 Azul

2 Verde

3 Aqua

4 Vermelho

5 Roxo

6 Amarelo

7 Branca

8 Cinza

9 Azul-claro

um verde-claro

b Azul-água claro

c Vermelho-claro

d Roxo-claro

e Amarelo-claro

f Branco brilhante

Comentários
Para usar vários comandos para <string> , separe-os pelo separador de comando
&&. Por exemplo:
<command1>&&<command2>&&<command3>

Se o caminho do diretório e os arquivos tiverem espaços em seus nomes, eles


precisarão ser colocados entre aspas duplas. Por exemplo:

mkdir Test&&mkdir "Test 2"&&move "Test 2" Test

Se você especificar /c ou /k, os processos cmd, o restante da string e as aspas


serão preservados somente se todas as seguintes condições forem atendidas:

Você também não usa /s.

Você usa exatamente um conjunto de aspas.

Você não usa caracteres especiais dentro das aspas (por exemplo: &<> ( ) @ ^ |
).

Você usa um ou mais caracteres de espaço em branco dentro das aspas.

A string entre aspas é o nome de um arquivo executável.

Se as condições anteriores não forem atendidas, a string será processada com o


exame do primeiro caractere para verificar se é aspas de abertura. Se o primeiro
caractere for aspas de abertura, ele será removido junto com as aspas de
fechamento. Todo texto após as aspas de fechamento é preservado.

Se você não especificar /d na string, Cmd.exe procurará as seguintes subchaves do


Registro:

HKEY_LOCAL_MACHINE\Software\Microsoft\Command
Processor\AutoRun\REG_SZ

HKEY_CURRENT_USER\Software\Microsoft\Command
Processor\AutoRun\REG_EXPAND_SZ

Se uma ou ambas as subchaves do registro estiverem presentes, elas serão


executadas antes de todas as outras variáveis.

U Cuidado
A edição incorreta do Registro pode causar danos graves ao sistema. Antes de
alterar o Registro, faça backup de todos os dados importantes do
computador.

Você pode desabilitar extensões de comando para um processo específico usando


/e:off. Você pode habilitar ou desabilitar extensões para todas as opções de linha
de comando cmd em um computador ou sessão de usuário definindo os seguintes
valores REG_DWORD :

HKEY_LOCAL_MACHINE\Software\Microsoft\Command
Processor\EnableExtensions\REG_DWORD

HKEY_CURRENT_USER\Software\Microsoft\Command
Processor\EnableExtensions\REG_DWORD

Defina o valor REG_DWORD como 0x1 (habilitado) ou 0x0 (desabilitado) no


registro usando Regedit.exe. As configurações especificadas pelo usuário têm
precedência sobre as configurações do computador, e as opções de linha de
comando têm precedência sobre as configurações do Registro.

U Cuidado

A edição incorreta do Registro pode causar danos graves ao sistema. Antes de


alterar o Registro, faça backup de todos os dados importantes do
computador.

Quando você habilita extensões de comando, os seguintes comandos são


afetados:

assoc

call

chdir (cd)

color

del (erase)

endlocal

for

ftype
goto

if

mkdir (md)

popd

prompt

pushd

set

setlocal

shift

start (também inclui alterações em processos de comando externos)

Se você habilitar a expansão de variável de ambiente atrasada, poderá usar o


caractere de ponto de exclamação para substituir o valor de uma variável de
ambiente no tempo de execução.

O preenchimento do nome do arquivo e do diretório não está habilitada por


padrão. Você pode habilitar ou desabilitar o preenchimento do nome do arquivo
para um processo específico do comando cmd com /f:{on | off}. Você pode
habilitar ou desabilitar o preenchimento de nomes de arquivo e diretório para
todos os processos do comando cmd em um computador ou para uma sessão de
logon do usuário definindo os seguintes valores de REG_DWORD:

HKEY_LOCAL_MACHINE\Software\Microsoft\Command
Processor\CompletionChar\REG_DWORD

HKEY_LOCAL_MACHINE\Software\Microsoft\Command
Processor\PathCompletionChar\REG_DWORD

HKEY_CURRENT_USER\Software\Microsoft\Command
Processor\CompletionChar\REG_DWORD

HKEY_CURRENT_USER\Software\Microsoft\Command
Processor\PathCompletionChar\REG_DWORD

Para definir o valor REG_DWORD, execute Regedit.exe e use o valor hexadecimal


de um caractere de controle para determinada função (por exemplo, 0x9 é TAB e
0x08 é BACKSPACE). As configurações especificadas pelo usuário têm precedência
sobre as configurações do computador, e as opções de linha de comando têm
precedência sobre as configurações do Registro.

U Cuidado

A edição incorreta do Registro pode causar danos graves ao sistema. Antes de


alterar o Registro, faça backup de todos os dados importantes do
computador.

Se você habilitar o preenchimento de nome de arquivo e diretório usando /f:on,


use CTRL+D para preenchimento de nome de diretório e CTRL+F para
preenchimento de nome de arquivo. Para desabilitar um caractere de
preenchimento específico no registro, use o valor de espaço em branco [0x20]
porque ele não é um caractere de controle válido.

Pressionar CTRL+D ou CTRL+F processa o preenchimento do nome do arquivo


e do diretório. Essas funções de combinação de teclas acrescentam um
caractere curimba àstring (se não houver), criam uma lista de caminhos que
correspondem e exibem o primeiro caminho correspondente.

Se nenhum dos caminhos corresponder, a função de preenchimento de nome


de arquivo e diretório será exibida e não alterará a exibição. Para percorrer a
lista de caminhos correspondentes, pressione CTRL+D ou CTRL+F
repetidamente. Para percorrer a lista para trás, pressione a tecla SHIFT e
CTRL+D ou CTRL+F simultaneamente. Para descartar a lista salva de caminhos
correspondentes e gerar uma nova lista, edite string e pressione CTRL+D ou
CTRL+F. Se você alternar entre CTRL+D e CTRL+F, a lista salva de caminhos
correspondentes será descartada e uma nova lista será gerada. A única
diferença entre as combinações de teclas CTRL+D e CTRL+F é que CTRL+D
corresponde apenas aos nomes de diretório e CTRL+F corresponde aos nomes
de arquivo e diretório. Se você usar o preenchimento de nome de arquivo e
diretório em qualquer um dos comandos de diretório internos (ou seja, CD,
MDou RD), a conclusão do diretório será assumida.

A conclusão do nome do arquivo e do diretório processa corretamente nomes


de arquivo que contêm espaço em branco ou caracteres especiais se você
colocar aspas em torno do caminho correspondente.

Você precisa usar aspas em torno dos seguintes caracteres especiais: &<> [ ] | {
} ^ = ; ! ' + , ` ~ [espaço em branco].
Se as informações fornecidas contiverem espaços, você precisará usar aspas ao
redor do texto (por exemplo, "Nome do Computador").

Se você processar a conclusão do nome do arquivo e do diretório de dentro da


string, qualquer parte do caminho à direita do cursor será descartada (no ponto
na string em que a conclusão foi processada).

Links relacionados
Chave da sintaxe de linha de comando
cmdkey
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria, lista e exclui nomes de usuário e senhas ou credenciais armazenados.

Sintaxe

cmdkey [{/add:<targetname>|/generic:<targetname>}] {/smartcard | /user:


<username> [/pass:<password>]} [/delete{:<targetname> | /ras}] /list:
<targetname>

Parâmetros

Parâmetros Descrição

/add: <targetname> Adiciona um nome de usuário e uma senha à lista.


Requer o parâmetro do <targetname> qual identifica o computador ou o
nome de domínio ao qual essa entrada será associada.

/generic: <targetname> Adiciona credenciais genéricas à lista.


Requer o parâmetro do <targetname> qual identifica o computador ou o
nome de domínio ao qual essa entrada será associada.

/smartcard Recupera a credencial de um cartão inteligente. Se mais de um cartão


inteligente for encontrado no sistema quando essa opção for usada, o
cmdkey exibirá informações sobre todos os cartões inteligentes
disponíveis e solicitará que o usuário especifique qual deles usar.

/user: <username> Especifica o nome de usuário ou conta a ser armazenado com essa
entrada. Se <username> não for fornecido, ele será solicitado.

/pass: <password> Especifica a senha a ser armazenada com essa entrada. Se <password>
não for fornecido, ele será solicitado. As senhas não são exibidas depois
de armazenadas.

/delete: {<targetname> Exclui um nome de usuário e uma senha da lista. Se <targetname> for
\| /ras} especificado, essa entrada será excluída. Se /ras for especificado, a
entrada de acesso remoto armazenado será excluída.
Parâmetros Descrição

/list: <targetname> Exibe a lista de nomes de usuário armazenados e credenciais. Se


<targetname> não for especificado, todos os nomes de usuário
armazenados e credenciais serão listados.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para exibir uma lista de todos os nomes de usuário e credenciais armazenados, digite:

cmdkey /list

Para adicionar um nome de usuário e senha para o usuário Mikedan acessar o


computador Server01 com a senha Kleo, digite:

cmdkey /add:server01 /user:mikedan /pass:Kleo

Para adicionar um nome de usuário e uma senha para o usuário Mikedan acessar o
computador Server01 e solicitar a senha sempre que o Server01 for acessado, digite:

cmdkey /add:server01 /user:mikedan

Para excluir uma credencial armazenada pelo acesso remoto, digite:

cmdkey /delete /ras

Para excluir uma credencial armazenada para Server01, digite:

cmdkey /delete:server01
Links relacionados
Chave da sintaxe de linha de comando
cmstp
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Instala ou remove um perfil de serviço do Gerenciador de Conexões. Usado sem


parâmetros opcionais, o cmstp instala um perfil de serviço com configurações padrão
apropriadas ao sistema operacional e às permissões do usuário.

Syntax
Sintaxe 1 – essa é a sintaxe típica usada em um aplicativo de instalação personalizado.
Para usar essa sintaxe, execute o cmstp do diretório que contém o arquivo
<serviceprofilefilename>.exe .

<serviceprofilefilename>.exe /q:a /c:cmstp.exe <serviceprofilefilename>.inf


[/nf] [/s] [/u]

Sintaxe 2

cmstp.exe [/nf] [/s] [/u] [drive:][path]serviceprofilefilename.inf

Parâmetros

Parâmetro Descrição

<serviceprofilefilename>.exe Especifica, por nome, o pacote de instalação que contém o perfil


que deseja instalar.
Necessário para a Sintaxe 1, mas não válido para a Sintaxe 2.

/q:a Especifica que o perfil deve ser instalado sem solicitar ao usuário.
A mensagem de verificação de que a instalação foi bem-
sucedida ainda será exibida.
Necessário para a Sintaxe 1, mas não válido para a Sintaxe 2.
Parâmetro Descrição

[drive:][path] Obrigatórios. Especifica, por nome, o arquivo de configuração


<serviceprofilefilename>.inf que determina como o perfil deve ser instalado.
O parâmetro [drive:][path] não é válido para a Sintaxe 1.

/nf Especifica que os arquivos de suporte não devem ser instalados.

/s Especifica que o perfil de serviço deve ser instalado ou


desinstalado silenciosamente (sem solicitar a resposta do usuário
ou exibir a mensagem de verificação). Esse é o único parâmetro
que é possível usar em combinação com /u.

/u Especifica que o perfil de serviço deve ser desinstalado.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para instalar o perfil de serviço de ficção sem nenhum arquivo de suporte, digite:

fiction.exe /c:cmstp.exe fiction.inf /nf

Para instalar silenciosamente o perfil de serviço de ficção para um único usuário, digite:

fiction.exe /c:cmstp.exe fiction.inf /s /su

Para desinstalar silenciosamente o perfil de serviço de ficção, digite:

fiction.exe /c:cmstp.exe fiction.inf /s /u

Links relacionados
Chave da sintaxe de linha de comando
cor
Artigo • 17/04/2023

Altera as cores do primeiro plano e da tela de fundo na janela Solicitação de comando


da sessão atual. Se usada sem parâmetros, color restaurará as cores padrão da janela
Solicitação de comando e do plano de fundo.

Sintaxe

color [[<b>]<f>]

Parâmetros

Parâmetro Descrição

<b> Especifica a cor do plano de fundo.

<f> Especifica a cor do primeiro plano.

/? Exibe a ajuda no prompt de comando.

Em que:

A tabela abaixo lista dígitos hexadecimais válidos que você pode usar como os valores
para <b> e <f> :

Valor Color

0 Preto

1 Azul

2 Verde

3 Aqua

4 Vermelho

5 Roxo

6 Amarelo
Valor Color

7 Branca

8 Cinza

9 Azul-claro

um verde-claro

b Azul-água claro

c Vermelho-claro

d Roxo-claro

e Amarelo-claro

f Branco brilhante

Comentários
Não use caracteres de espaço entre <b> e <f> .

Caso especifique apenas um dígito hexadecimal, a cor correspondente será usada


como a cor de primeiro plano e a cor da tela de fundo será definida como a cor
padrão.

Para definir a cor padrão da janela Solicitação de comando, selecione o canto


superior esquerdo da janela Solicitação de comando, Padrões, a guia Cores e, em
seguida, as cores que você deseja usar para o Texto da tela e Tela de fundo.

Caso <b> e <f> sejam o mesmo valor de cor, ERRORLEVEL será definido como 1 ,
e nenhuma alteração será feita no primeiro plano ou na cor da tela de fundo.

Exemplos
Para alterar a cor da tela de fundo da janela Solicitação de comando para cinza e a cor
de primeiro plano para vermelho, digite:

color 84

Para alterar a cor do primeiro plano da janela Solicitação de comando para amarelo
claro, digite:
color e

7 Observação

Nesse exemplo, a tela de fundo é definida como a cor padrão porque apenas um
dígito hexadecimal é especificado.

Links relacionados
Chave da sintaxe de linha de comando
comp
Artigo • 12/04/2023

Compara o conteúdo de dois arquivos ou conjuntos de arquivos byte por byte. Esses
arquivos podem ser armazenados na mesma unidade ou em unidades diferentes e no
mesmo diretório ou em diretórios diferentes. Quando esse comando compara arquivos,
ele exibe os nomes de arquivos e a localização. Se usado sem parâmetros, comp
solicitará que você insira os arquivos a serem comparados.

Sintaxe

comp [<data1>] [<data2>] [/d] [/a] [/l] [/n=<number>] [/c]

Parâmetros

Parâmetro Descrição

<data1> Especifica o local e o nome do primeiro arquivo ou conjunto de arquivos a serem


comparados. Use os caracteres curinga (* e ?) para especificar vários arquivos.

<data2> Especifica o local e o nome do segundo arquivo ou conjunto de arquivos a serem


comparados. Use os caracteres curinga (* e ?) para especificar vários arquivos.

/d Exibe diferenças no formato decimal. (O formato padrão é hexadecimal.)

/a Exibe diferenças como caracteres.

/l Exibe o número da linha em que ocorre uma diferença, em vez de exibir o


deslocamento de bytes.

/n= <number> Compara apenas o número de linhas especificadas para cada arquivo, mesmo que
os arquivos tenham tamanhos diferentes.

/c Executa uma comparação que não diferencia maiúsculas de minúsculas.

/off[line] Processa arquivos com o conjunto de atributos offline.

/? Exibe a ajuda no prompt de comando.

Comentários
Durante a comparação, comp exibe mensagens que identificam os locais de
informações desiguais entre os arquivos. Cada mensagem indica o endereço de
memória de deslocamento dos bytes diferentes e o conteúdo dos bytes (na
notação hexadecimal, a menos que o parâmetro de linha de comando /a ou /d
seja especificado). As mensagens são exibidas no seguinte formato:

Compare error at OFFSET xxxxxxxx


file1 = xx
file2 = xx

Após dez comparações desiguais, comp para de comparar os arquivos e exibe a


seguinte mensagem:

10 Mismatches - ending compare

Se você omitir componentes necessários de data1 ou data2 ou se omitir data2


inteiramente, esse comando solicitará as informações ausentes.

Se data1 contiver apenas uma letra de unidade ou um nome de diretório sem o


nome de arquivo, esse comando vai comparar todos os arquivos no diretório
especificado com o arquivo especificado em data1.

Se data2 contiver apenas uma letra de unidade ou um nome de diretório, o nome


de arquivo padrão para data2 será o mesmo nome de data1.

Se o comando comp não encontrar os arquivos especificados, ele exibirá uma


mensagem informando se você deseja comparar arquivos adicionais.

Os arquivos que você compara podem ter o mesmo nome de arquivo, desde que
estejam em diretórios ou unidades diferentes. Use os caracteres curinga (* e ?)
para especificar nomes de arquivos.

Especifique /n para comparar arquivos de tamanhos diferentes. Se os tamanhos de


arquivo forem diferentes e /n não for especificado, a seguinte mensagem será
exibida:

Files are different sizes


Compare more files (Y/N)?

Para comparar esses arquivos de qualquer maneira, pressione N para interromper


o comando. Em seguida, execute o comando comp novamente, usando a opção /n
para comparar apenas a primeira parte de cada arquivo.

Se você usar caracteres curinga (* e ?) para especificar vários arquivos, comp vai
localizar o primeiro arquivo que corresponde a data1 e compará-lo com o arquivo
correspondente em data2, se ele existir. O comando comp relata os resultados da
comparação para cada arquivo que corresponde a data1. Quando concluído, comp
exibe a seguinte mensagem:

Compare more files (Y/N)?

Para comparar mais arquivos, pressione Y. O comando comp solicita os locais e


nomes dos novos arquivos. Para interromper as comparações, pressione N.
Quando você pressiona Y, você será solicitado a informar quais opções de linha de
comando usar. Se você não especificar nenhuma opção de linha de comando,
comp usará as especificadas antes.

Exemplos
Para comparar o conteúdo do diretório c:\reports com o diretório de backup
\\sales\backup\april , digite:

comp c:\reports \\sales\backup\april

Para comparar as dez primeiras linhas dos arquivos de texto no diretório \invoice e
exibir o resultado no formato decimal, digite:

comp \invoice\*.txt \invoice\backup\*.txt /n=10 /d

Links relacionados
Chave da sintaxe de linha de comando
compact
Artigo • 12/04/2023

Exibe ou altera a compactação de arquivos ou diretórios em partições NTFS. Se usado


sem parâmetros, compact exibe o estado de compactação do diretório atual e dos
arquivos nele contidos.

Sintaxe

compact [/C | /U] [/S[:dir]] [/A] [/I] [/F] [/Q] [/EXE[:algorithm]]


[/CompactOs[:option] [/windir:dir]] [filename [...]]

Parâmetros

Parâmetro Descrição

/c Compacta o diretório ou arquivo especificado. Os diretórios são marcados para


que todos os arquivos adicionados posteriormente sejam compactados, a menos
que o parâmetro /EXE seja especificado.

/u Descompacta o diretório ou arquivo especificado. Os diretórios são marcados para


que os arquivos adicionados posteriormente não sejam compactados. Se o
parâmetro /EXE for especificado, somente os arquivos compactados como
executáveis serão descompactados; se você não especificar o parâmetro /EXE,
somente arquivos compactados NTFS serão descompactados.

/s [:<dir>] Executa a operação escolhida em arquivos no diretório especificado e em todos os


subdiretórios. Por padrão, o diretório atual é usado como o valor <dir> .

/a Exibe arquivos ocultos ou do sistema. Por padrão, esses arquivos não são
incluídos.

/i Continua executando a operação especificada, ignorando erros. Por padrão, esse


comando é interrompido quando um erro é encontrado.

/f Força a compactação ou a descompactação do diretório ou arquivo especificado.


Os arquivos já compactados são ignorados por padrão. O parâmetro /f é usado no
caso de um arquivo que foi parcialmente compactado quando a operação foi
interrompida por uma falha do sistema. Para forçar o arquivo a ser compactado
em sua totalidade, use os parâmetros /c e /f e especifique o arquivo parcialmente
compactado.

/q Relata apenas as informações mais essenciais.


Parâmetro Descrição

/EXE Usa compactação otimizada para arquivos executáveis que são lidos com
frequência, mas não modificados. Os algoritmos compatíveis são:
XPRESS4K (valor mais rápido e padrão)
XPRESS8K
XPRESS16K
LZX (mais compacto)

/CompactOs Define ou consulta o estado de compactação do sistema. As opções compatíveis


são:
query – Consulta o estado Compact do sistema.
always – Compacta todos os binários do sistema operacional e define o
estado do sistema como Compact, que permanece, a menos que o
administrador o altere.
never – Descompacta todos os binários do sistema operacional e define o
estado do sistema como non-Compact, que permanece, a menos que o
administrador o altere.

/windir Usado com o parâmetro /CompactOs:query ao consultar o sistema operacional


offline. Especifica o diretório em que o Windows está instalado.

<filename> Especifica um padrão, arquivo ou diretório. Você pode usar vários nomes de
arquivo e os caracteres curinga * e ?.

/? Exibe a ajuda no prompt de comando.

Comentários
Esse comando é a versão de linha de comando do recurso de compactação do
sistema de arquivos NTFS. O estado de compactação de um diretório indica se os
arquivos são compactados automaticamente quando são adicionados ao diretório.
Definir o estado de compactação de um diretório não altera necessariamente o
estado de compactação dos arquivos que já estão no diretório.

Você não pode usar esse comando para ler, gravar ou montar volumes
compactados usando DriveSpace ou DoubleSpace. Também não pode usar esse
comando para compactar partições FAT (tabela de alocação de arquivos) ou FAT32.

Exemplos
Para definir o estado de compactação do diretório atual, seus subdiretórios e arquivos
existentes, digite:
compact /c /s

Para definir o estado de compactação de arquivos e subdiretórios no diretório atual,


sem alterar o estado de compactação do próprio diretório atual, digite:

compact /c /s *.*

Para compactar um volume, no diretório raiz do volume, digite:

compact /c /i /s:\

7 Observação

Este exemplo define o estado de compactação de todos os diretórios (incluindo o


diretório raiz no volume) e compacta todos os arquivos no volume. O parâmetro /i
impede que mensagens de erro interrompam o processo de compactação.

Para compactar todos os arquivos com a extensão de nome de arquivo .bmp no


diretório \tmp e em todos os subdiretórios de \tmp, sem modificar o atributo
compactado dos diretórios, digite:

compact /c /s:\tmp *.bmp

Para forçar a compactação completa do arquivo zebra.bmp, que foi parcialmente


compactado durante uma falha do sistema, digite:

compact /c /f zebra.bmp

Para remover o atributo compactado do diretório c:\tmp, sem alterar o estado de


compactação de nenhum arquivo nesse diretório, digite:
compact /u c:\tmp

Links relacionados
Chave da sintaxe de linha de comando
compact vdisk
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Reduz o tamanho físico de um arquivo VHD (disco rígido virtual) em expansão dinâmica.
Esse parâmetro é útil porque os VHDs de expansão dinâmica aumentam de tamanho
conforme você adiciona arquivos, mas o tamanho não é reduzido automaticamente
quando arquivos são excluídos.

Sintaxe

compact vdisk

Comentários
Um VHD de expansão dinâmica deve ser selecionado para que essa operação seja
bem-sucedida. Use o comando select vdisk para selecionar um VHD e mudar o
foco para ele.

Você só pode usar VHDs compactos de expansão dinâmica que são desanexados
ou anexados como somente leitura.

Links relacionados
Chave da sintaxe de linha de comando

comando attach vdisk

comando detail vdisk

comando detach vdisk

comando expand vdisk

comando merge vdisk

comando select vdisk


Comando list
convert
Artigo • 11/04/2023

Converte um disco de um tipo em outro.

Sintaxe

convert basic
convert dynamic
convert gpt
convert mbr

Parâmetros

Parâmetro Descrição

comando Converte um disco dinâmico vazio em um disco básico.


convert
basic

comando Converte um disco básico em um disco dinâmico.


convert
dynamic

comando Converte um disco básico vazio com o estilo de partição MBR (registro mestre de
convert gpt inicialização) em um disco básico com o estilo de partição GPT (tabela de partição
GUID).

comando Converte um disco básico vazio com o estilo de partição GPT (Tabela de Partição
convert GUID) em um disco básico com o estilo de partição MBR (registro mestre de
mbr inicialização).

Links relacionados
Chave da sintaxe de linha de comando
convert basic
Artigo • 12/04/2023

Converte um disco dinâmico vazio em um disco básico. Um disco dinâmico deve ser
selecionado para que essa operação seja bem-sucedida. Use o comando select disk para
selecionar um disco dinâmico e mudar o foco para ele.

) Importante

O disco deve estar vazio para convertê-lo em um disco básico. Faça backup de seus
dados e exclua todas as partições ou volumes antes de converter o disco.

7 Observação

Para obter instruções sobre como usar esse comando, consulte Alterar um Disco
Dinâmico de volta para um Disco Básico).

Sintaxe

convert basic [noerr]

Parâmetros

Parâmetro Descrição

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Exemplos
Para converter o disco dinâmico selecionado em básico, digite:

convert basic
Links relacionados
Chave da sintaxe de linha de comando

Comando convert
convert dynamic
Artigo • 12/04/2023

Converte um disco básico em um disco dinâmico. Um disco básico deve ser selecionado
para que essa operação seja bem-sucedida. Use o comando select disk para selecionar
um disco básico e mudar o foco para ele.

7 Observação

Para obter instruções sobre como usar esse comando, consulte Alterar um disco
dinâmico de volta para um disco básico).

Sintaxe

convert dynamic [noerr]

Parâmetros

Parâmetro Descrição

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Comentários
Todas as partições existentes no disco básico se tornam volumes simples.

Exemplos
Para converter um disco básico em um disco dinâmico, digite:

convert dynamic
Links relacionados
Chave da sintaxe de linha de comando

comando convert
convert gpt
Artigo • 12/04/2023

Converte um disco básico vazio com o estilo de partição MBR (Registro Mestre de
Inicialização) em um disco básico com o estilo de partição GPT (Tabela de Partição de
GUID). Um disco básico MBR deve ser selecionado para que essa operação seja bem-
sucedida. Use o comando select disk para selecionar um disco básico e mudar o foco
para ele.

) Importante

O disco deve estar vazio para convertê-lo em um disco básico. Faça backup de seus
dados e exclua todas as partições ou volumes antes de converter o disco. O
tamanho mínimo necessário do disco para conversão em GPT é de 128 megabytes.

7 Observação

Para obter instruções sobre como usar esse comando, confira Alterar um disco de
registro mestre de inicialização em um disco de tabela de partição de GUID.

Sintaxe

convert gpt [noerr]

Parâmetros

Parâmetro Descrição

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Exemplos
Para converter um disco básico do estilo de partição MBR para o estilo de partição GPT,
digite:
convert gpt

Links relacionados
Chave da sintaxe de linha de comando

comando convert
convert mbr
Artigo • 17/04/2023

Converte um disco básico vazio com o estilo de partição GPT (Tabela de partição GUID)
em um disco básico com o estilo de partição MBR (Registro mestre de inicialização). Um
disco básico deve ser selecionado para que essa operação seja bem-sucedida. Use o
comando select disk para selecionar um disco básico e mudar o foco para ele.

) Importante

O disco deve estar vazio para convertê-lo em um disco básico. Faça backup de seus
dados e exclua todas as partições ou volumes antes de converter o disco.

7 Observação

Para obter instruções sobre como usar esse comando, confira Trocar um disco de
Tabela de partição GUID por um disco de Registro mestre de inicialização.

Sintaxe

convert mbr [noerr]

Parâmetros

Parâmetro Descrição

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Exemplos
Para converter um disco básico do estilo de partição GPT para o estilo de partição MBR,
digite>:
convert mbr

Links relacionados
Chave da sintaxe de linha de comando

Comando convert
copy
Artigo • 12/04/2023

Copia um ou mais arquivos de um local para o outro.

7 Observação

O comando copy também pode ser usado com parâmetros diferentes no Console
de Recuperação. Para obter mais informações sobre o console de recuperação,
consulte Ambiente de Recuperação do Windows (Windows RE).

Sintaxe

copy [/d] [/v] [/n] [/y | /-y] [/z] [/a | /b] <source> [/a | /b] [+<source>
[/a | /b] [+ ...]] [<destination> [/a | /b]]

Parâmetros

Parâmetro Descrição

/d Permite que os arquivos criptografados que estão sendo copiados sejam salvos
como arquivos descriptografados no destino.

/v Verifica se novos arquivos foram gravados corretamente.

/n Usa um nome de arquivo curto, se disponível, ao copiar um arquivo com um


nome com mais de oito caracteres ou com uma extensão de nome de arquivo
com mais de três caracteres.

/y Suprime a solicitação para confirmar que você deseja substituir um arquivo de


destino existente.

/-y Solicita que você confirme que deseja substituir um arquivo de destino existente.

/z Copia arquivos em rede no modo reinicializável.

/a Indica um arquivo de texto ASCII.

/b Indica um arquivo binário.


Parâmetro Descrição

<source> Obrigatórios. Especifica o local do qual você deseja copiar um arquivo ou um


conjunto de arquivos. Source pode incluir uma letra da unidade e dois-pontos,
um nome de diretório, um nome de arquivo ou uma combinação deles.

<destination> Obrigatórios. Especifica o local para o qual você deseja copiar um arquivo ou um
conjunto de arquivos. Destination pode incluir uma letra da unidade e dois-
pontos, um nome de diretório, um nome de arquivo ou uma combinação deles.

/? Exibe a ajuda no prompt de comando.

Comentários
Você pode copiar um arquivo de texto ASCII que usa um caractere de fim de
arquivo (CTRL+Z) para indicar o final do arquivo.

Se /a preceder ou seguir uma lista de arquivos na linha de comando, ele se


aplicará a todos os arquivos listados até que copy encontre /b. Nesse caso, /b se
aplica ao arquivo anterior a /b.

O efeito de /a depende de sua posição na cadeia de caracteres de linha de


comando: – Se /a seguir source, o comando copy tratará o arquivo como um
arquivo ASCII e copiará os dados que precedem o primeiro caractere de fim de
arquivo (CTRL+Z). – Se /a seguir destination, o comando copy adicionará um
caractere de fim de arquivo (CTRL+Z) como o último caractere do arquivo.

Se /b direcionar o interpretador de comando para ler o número de bytes


especificado pelo tamanho do arquivo no diretório. /b é o valor padrão para copy,
a menos que copy combine arquivos.

Se /b precede ou segue uma lista de arquivos na linha de comando, ele se aplica a


todos os arquivos listados até que copy encontre /a. Nesse caso, /a se aplica ao
arquivo anterior a /a.

O efeito de /b depende de sua posição na cadeia de caracteres da linha de


comando: – Se /b seguir source, o comando copy copiará todo o arquivo, incluindo
qualquer caractere de fim de arquivo (CTRL+Z). – Se /b seguir destination, o
comando copy não adicionará um caractere de fim de arquivo (CTRL+Z).

Se uma operação de gravação não puder ser verificada, uma mensagem de erro
será exibida. Embora erros de gravação raramente ocorram com o comando copy,
você pode usar /v para verificar se os dados críticos foram registrados
corretamente. A opção de linha de comando /v também reduz a velocidade do
comando copy, pois cada setor registrado no disco deve ser verificado.

Se /y for predefinido na variável de ambiente COPYCMD, você poderá substituir


essa configuração usando /-y na linha de comando. Por padrão, você é avisado
quando substituir essa configuração, a menos que o comando copy seja
executado em um script em lote.

Para acrescentar arquivos, especifique um único arquivo para destination, mas


vários arquivos para source (use caracteres curinga ou formato o
arquivo1+arquivo2+arquivo3).

Se a conexão for perdida durante a fase de cópia (por exemplo, se o servidor que
ficar offline interromper a conexão), você poderá usar copy /z para retomar depois
que a conexão for restabelecida. A opção /z também exibe o percentual da
operação de cópia concluída para cada arquivo.

Você pode substituir um nome de dispositivo por uma ou mais ocorrências source
ou destination.

Se destination for um dispositivo (por exemplo, Com1 ou Lpt1), a opção /b copiará


dados para o dispositivo no modo binário. No modo binário, copy /b copia todos
os caracteres (incluindo caracteres especiais, como CTRL+C, CTRL+S, CTRL+Z e
ENTER) para o dispositivo como dados. No entanto, se você omitir /b, os dados
serão copiados para o dispositivo no modo ASCII. No modo ASCII, caracteres
especiais podem fazer com que os arquivos sejam combinados durante o processo
de cópia.

Se você não especificar um arquivo de destino, uma cópia será criada com o
mesmo nome, data e hora modificadas como o arquivo original. A nova cópia é
armazenada no diretório atual na unidade atual. Se o arquivo de origem estiver na
unidade atual e no diretório atual e você não especificar uma unidade ou diretório
diferente para o arquivo de destino, o comando copy será interrompido e exibirá a
seguinte mensagem de erro:

File cannot be copied onto itself


0 File(s) copied

Se você especificar mais de um arquivo em source, o comando copy combinará


todos eles em um único arquivo usando o nome de arquivo especificado em
destination. O comando copy pressupõe que os arquivos combinados sejam
arquivos ASCII, a menos que você use a opção /b.

Para copiar arquivos com 0 bytes de comprimento ou copiar todos os arquivos e


subdiretórios de um diretório, use o comando xcopy.

Para atribuir a hora e a data atuais a um arquivo sem modificá-lo, use a seguinte
sintaxe:

copy /b <source> +,,

Onde as vírgulas indicam que o parâmetro de destination foi intencionalmente


deixado de fora.

Exemplos
Para copiar um arquivo chamado memo.doc para letter.doc na unidade atual e garantir
que um caractere de fim de arquivo (CTRL+Z) esteja no final do arquivo copiado, digite:

copy memo.doc letter.doc /a

Para copiar um arquivo chamado robin.typ da unidade e diretório atual para um


diretório existente chamado Birds localizado na unidade C, digite:

copy robin.typ c:\birds

7 Observação

Se o diretório Birds não existir, o arquivo robin.typ será copiado para um arquivo
chamado Birds localizado no diretório raiz do disco na unidade C.

Para combinar Mar89.rpt, Apr89.rpt e May89.rpt, que estão localizados no diretório atual,
e colocá-los em um arquivo chamado Report (também no diretório atual), digite:
copy mar89.rpt + apr89.rpt + may89.rpt Report

7 Observação

Se você combinar arquivos, o comando copy marcará o arquivo de destino com a


data e a hora atuais. Se você omitir destination, os arquivos serão combinados e
armazenados sob o nome do primeiro arquivo na lista.

Para combinar todos os arquivos em Report, quando um arquivo chamado Report já


existir, digite:

copy report + mar89.rpt + apr89.rpt + may89.rpt

Para combinar todos os arquivos no diretório atual que têm a extensão de nome de
arquivo .txt em um único arquivo chamado Combined.doc, digite:

copy *.txt Combined.doc

Para combinar vários arquivos binários em um arquivo usando caracteres curinga, inclua
/b. Isso impede que o Windows trate CTRL+Z como um caractere de fim de arquivo. Por
exemplo, digite:

copy /b *.exe Combined.exe

U Cuidado

Se você combinar arquivos binários, o arquivo resultante poderá ser inutilizável


devido à formatação interna.

Combinar cada arquivo que tem uma extensão .txt com seu arquivo .ref
correspondente cria um arquivo com o mesmo nome de arquivo, mas com uma
extensão .doc. O comando Copy combina arquivo1.txt com arquivo1.ref para
formar arquivo1.doc e, em seguida, o comando combina arquivo2.txt com
arquivo2.ref para formar arquivo2.doc e assim por diante. Por exemplo, digite:
copy *.txt + *.ref *.doc

Para combinar todos os arquivos com a extensão .txt e combinar todos os arquivos com
a extensão .ref em um arquivo chamado Combined.doc, digite:

copy *.txt + *.ref Combined.doc

Links relacionados
Chave da sintaxe de linha de comando

comando xcopy
create
Artigo • 12/04/2023

Cria uma partição ou sombra em um disco, um volume em um ou mais discos ou um


VHD (disco rígido virtual). Se você estiver usando esse comando para criar um volume
no disco de sombra, já deverá ter pelo menos um volume no conjunto de cópias de
sombra.

Sintaxe

create partition
create volume

Parâmetros

Parâmetro Descrição

comando create Cria uma partição primária no disco básico com foco.
partition primary

comando create Cria uma partição de sistema EFI (Extensible Firmware Interface) em um disco
partition efi GPT (Tabela de Partição de GUID) em computadores baseados em Itanium.

comando create Cria uma partição estendida no disco com foco.


partition
extended

comando create Cria uma partição lógica em uma partição estendida existente.
partition logical

comando create Cria uma partição MSR (Reservada da Microsoft) em um disco GPT (tabela de
partition msr partição de GUID).

comando create Cria um volume simples no disco dinâmico especificado.


volume simple

comando create Cria um espelho de volume usando os dois discos dinâmicos especificados.
volume mirror

comando create Cria um volume RAID-5 usando três ou mais discos dinâmicos especificados.
volume raid
Parâmetro Descrição

comando create Cria um volume distribuído usando dois ou mais discos dinâmicos
volume stripe especificados.

Links relacionados
Chave da sintaxe de linha de comando
create partition efi
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria uma partição de sistema EFI (Interface de Firmware Extensível) em um disco gpt
(Tabela de partição de GUID) em computadores baseados em Itanium. Depois que a
partição for criada, será dado foco à nova partição.

7 Observação

Um disco gpt precisa estar selecionado para que essa operação seja bem-sucedida.
Use o comando select disk para selecionar um disco e mudar o foco para ele.

Sintaxe

create partition efi [size=<n>] [offset=<n>] [noerr]

Parâmetros

Parâmetro Descrição

size= <n> O tamanho da partição em megabytes (MB). Se nenhum tamanho for especificado,
a partição continuará até que não haja mais espaço livre na região atual.

offset= <n> O deslocamento em quilobytes (KB), no qual a partição é criada. Se nenhum


deslocamento for fornecido, a partição será colocada na primeira extensão de disco
grande o suficiente para mantê-la.

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Comentários
Você deve adicionar pelo menos um volume com o comando add volume antes
de poder usar o comando create.
Depois de executar o comando create, você pode usar o comando exec para
executar um script de duplicação para backup da cópia de sombra.

Você pode usar o comando begin backup para especificar um backup completo,
em vez de um backup de cópia.

Exemplos
Para criar uma partição EFI de 1.000 megabytes no disco selecionado, digite:

create partition efi size=1000

Links relacionados
Chave da sintaxe de linha de comando

Comando create

select disk
criar partição estendida
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria uma partição estendida no disco com foco. Quando a partição for criada, o foco
mudará automaticamente para a nova partição.

) Importante

Use esse comando somente em discos MBR (Registro mestre de inicialização). Use
o comando select disk para selecionar um disco MBR básico e mudar o foco para
ele.

Crie uma partição estendida antes de criar unidades lógicas. Somente uma partição
estendida pode ser criada por disco. Esse comando falhará se você tentar criar uma
partição estendida dentro de outra partição estendida.

Sintaxe

create partition extended [size=<n>] [offset=<n>] [align=<n>] [noerr]

Parâmetros

Parâmetro Descrição

size= <n> Especifica o tamanho da partição em megabytes (MB). Se nenhum tamanho for
dado, a partição continuará até que não haja mais espaço livre na partição
estendida.

offset= <n> Especifica o deslocamento em quilobytes (KB), no qual a partição é criada. Se


nenhum deslocamento for fornecido, a partição começará no início do espaço livre
no disco que é grande o suficiente para manter a nova partição.
Parâmetro Descrição

align= <n> Alinha todas as extensões de partição ao limite de alinhamento mais próximo.
Normalmente usado com matrizes de LUN (número de unidade lógica) do RAID de
hardware para melhorar o desempenho. <n> é o número de KB (quilobytes) desde o
início do disco até o limite de alinhamento mais próximo.

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Exemplos
Para criar uma partição estendida de 1000 megabytes de tamanho, digite:

create partition extended size=1000

Links relacionados
Chave da sintaxe de linha de comando

Comando create

select disk
create partition logical
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria uma partição lógica em uma partição estendida existente. Quando a partição for
criada, o foco mudará automaticamente para a nova partição.

) Importante

Use esse comando somente em discos MBR (registro mestre de inicialização). Use o
comando select disk para selecionar um disco MBR básico e mudar o foco para ele.

Crie uma partição estendida antes de criar unidades lógicas.

Sintaxe

create partition logical [size=<n>] [offset=<n>] [align=<n>] [noerr]

Parâmetros

Parâmetro Descrição

size= <n> Especifica o tamanho da partição lógica em megabytes (MB), que deve ser menor
que a partição estendida. Se nenhum tamanho for especificado, a partição
continuará até que não haja mais espaço livre na partição estendida.

offset= <n> Especifica o deslocamento em quilobytes (KB), no qual a partição é criada. O


deslocamento arredonda para cima para preencher completamente qualquer
tamanho de cilindro usado. Se nenhum deslocamento for fornecido, a partição será
colocada na primeira extensão de disco grande o suficiente para mantê-la. A
partição é no mínimo tão longa em bytes quanto o número especificado por size=
<n> . Se você especificar um tamanho para a partição lógica, ele deverá ser menor
que a partição estendida.
Parâmetro Descrição

align= <n> Alinha todas as extensões de partição ou volume ao limite de alinhamento mais
próximo. Normalmente usado com matrizes de LUN (número de unidade lógica) do
RAID de hardware para melhorar o desempenho. <n> é o número de quilobytes
(KB) desde o início do disco até o limite de alinhamento mais próximo.

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Comentários
Se os parâmetros tamanho e deslocamento não forem especificados, a partição
lógica será criada na maior extensão de disco disponível na partição estendida.

Exemplos
Para criar uma partição lógica de 1000 megabytes de tamanho, na partição estendida
do disco selecionado, digite:

create partition logical size=1000

Links relacionados
Chave da sintaxe de linha de comando

Comando create

select disk
create partition msr
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria uma partição MSR (Microsoft Reserved) em um disco GPT (tabela de partição de
GUID). Uma partição MSR é necessária em cada disco gpt. O tamanho dessa partição
depende do tamanho total do disco gpt. O tamanho do disco gpt deve ser de pelo
menos 32 MB para criar uma partição Microsoft Reserved.

) Importante

Tenha muito cuidado ao usar este comando. Como os discos gpt exigem um layout
de partição específico, a criação de partições Microsoft Reserved pode fazer com
que o disco se torne ilegível.

Um disco gpt básico deve ser selecionado para que essa operação seja bem-
sucedida. Você deve usar o comando select disk para selecionar um disco gpt
básico e mudar o foco para ele.

Sintaxe

create partition msr [size=<n>] [offset=<n>] [noerr]

Parâmetros

Parâmetro Descrição

size= <n> O tamanho da partição em megabytes (MB). A partição é no mínimo tão longa em
bytes quanto o número especificado por <n> . Se nenhum tamanho for especificado,
a partição continuará até que não haja mais espaço livre na região atual.

offset= <n> Especifica o deslocamento em quilobytes (KB), no qual a partição é criada. O


deslocamento arredonda para cima para preencher completamente qualquer
tamanho de setor usado. Se nenhum deslocamento for fornecido, a partição será
colocada na primeira extensão de disco grande o suficiente para mantê-la.
Parâmetro Descrição

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Comentários
Em discos gpt usados para inicializar o sistema operacional Windows, a partição do
sistema EFI (Extensible Firmware Interface) é a primeira partição no disco, seguida
pela partição MSR. Os discos gpt usados apenas para armazenamento de dados
não têm uma partição do sistema EFI. Nesse caso, a partição MSR é a primeira
partição.

O Windows não monta partições MSR. Você não pode armazenar dados nelas e
não pode excluí-las.

Exemplos
Para criar uma partição MSR de 1000 megabytes de tamanho, digite:

create partition msr size=1000

Links relacionados
Chave da sintaxe de linha de comando

Comando create

select disk
create partition primary
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria uma partição primária no disco básico com foco. Quando a partição for criada, o
foco mudará automaticamente para a nova partição.

) Importante

Um disco básico deve ser selecionado para que essa operação seja bem-sucedida.
Use o comando select disk para selecionar um disco básico e mudar o foco para
ele.

Sintaxe

create partition primary [size=<n>] [offset=<n>] [id={ <byte> | <guid> }]


[align=<n>] [noerr]

Parâmetros

Parâmetro Descrição

size= <n> Especifica o tamanho da partição em megabytes (MB). Se nenhum tamanho for
dado, a partição continuará até que não haja mais espaço não alocado na região
atual.

offset= <n> O deslocamento em quilobytes (KB), no qual a partição é criada. Se nenhum


deslocamento for fornecido, a partição começará no início da maior extensão de
disco que é grande o suficiente para mantê-la.

align= <n> Alinha todas as extensões de partição ao limite de alinhamento mais próximo.
Normalmente usado com matrizes de LUN (número de unidade lógica) do RAID de
hardware para melhorar o desempenho. <n> é o número de quilobytes (KB) desde o
início do disco até o limite de alinhamento mais próximo.
Parâmetro Descrição

id={ Especifica o tipo de partição. Esse parâmetro destina-se apenas ao uso original do
<byte> | fabricante do equipamento (OEM). Qualquer byte de tipo de partição ou GUID pode
<guid> } ser especificado com esse parâmetro. DiskPart não verifica a validade do tipo de
partição, exceto para garantir que ele seja um byte no formato hexadecimal ou um
GUID. Cuidado: a criação de partições com esse parâmetro pode fazer com que o
computador falhe ou não consiga iniciar. A menos que você seja um OEM ou um
profissional de TI com discos gpt, não crie partições em discos gpt usando esse
parâmetro. Em vez disso, sempre use o comando create partition efi para criar
partições do Sistema EFI, o comando create partition msr para criar partições MSR e
o comando create partition primary (sem o parâmetro id={ <byte> | <guid> ) para
criar partições primárias em discos gpt.

Para discos MBR (registro de inicialização mestre), você deve especificar um byte
de tipo de partição, no formato hexadecimal, para a partição. Se esse parâmetro não
for especificado, o comando criará uma partição do tipo 0x06 , que especifica que
um sistema de arquivos não está instalado. Os exemplos incluem:

Partição de dados LDM: 0x42


Partição de recuperação: 0x27
Partição OEM reconhecida: 0x12, 0x84, 0xDE, 0xFE, 0xA0

Para discos de tabela de partição GUID (gpt), você pode especificar um GUID de
tipo de partição para a partição que deseja criar. Os GuiDs reconhecidos incluem:

Partição do sistema EFI: c12a7328-f81f-11d2-ba4b-00a0c93ec93b


Partição MSR: e3c9e316-0b5c-4db8-817d-f92df00215ae
Partição de dados básica: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
Partição de metadados LDM (disco dinâmico): 5808c8aa-7e8f-42e0-85d2-
e1e90434cfb3
Partição de dados LDM (disco dinâmico): af9b60a0-1431-4f62-bc68-
3311714a69ad
Partição de recuperação: de94bba4-06d1-4d40-a16a-bfd50179d6ac

Se esse parâmetro não for especificado para um disco gpt, o comando criará
uma partição de dados básica.

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem o parâmetro noerr, um erro
faz com que o DiskPart saia com um código de erro.

Exemplos
Para criar uma partição primária de 1000 megabytes de tamanho, digite:
create partition primary size=1000

Links relacionados
Chave da sintaxe de linha de comando

comando assign

Comando create

select disk
create volume mirror
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria um espelho de volume usando os dois discos dinâmicos especificados. Quando o


volume for criado, o foco mudará automaticamente para o novo volume.

Sintaxe

create volume mirror [size=<n>] disk=<n>,<n>[,<n>,...] [align=<n>] [noerr]

Parâmetros

Parâmetro Descrição

size= <n> Especifica a quantidade de espaço em disco, em megabytes (MB), que o


volume ocupará em cada disco. Se nenhum tamanho for determinado, o novo
volume assumirá o espaço livre restante no menor disco e uma quantidade
igual de espaço em cada disco subsequente.

disk= <n> , <n> [ , Especifica os discos dinâmicos nos quais o volume espelho é criado. Você
<n>,... ] precisa de dois discos dinâmicos para criar um volume espelho. Uma
quantidade de espaço igual ao tamanho especificado com o parâmetro size é
alocada em cada disco.

align= <n> Alinha todas as extensões de volume ao limite de alinhamento mais próximo.
Esse parâmetro normalmente é usado com matrizes de LUN (número de
unidade lógica) do RAID de hardware para melhorar o desempenho. <n> é o
número de quilobytes (KB) desde o início do disco até o limite de alinhamento
mais próximo.

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a


processar os comandos como se o erro não tivesse ocorrido. Sem esse
parâmetro, um erro faz com que o DiskPart saia com um erro.

Exemplos
Para criar um volume espelhado de 1000 megabytes de tamanho, nos discos 1 e 2,
digite:

create volume mirror size=1000 disk=1,2

Links relacionados
Chave da sintaxe de linha de comando

Comando create
create volume raid
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria um volume RAID-5 usando três ou mais discos dinâmicos especificados. Depois de
criar o volume, o foco muda automaticamente para o novo volume.

Sintaxe

create volume raid [size=<n>] disk=<n>,<n>,<n>[,<n>,...] [align=<n>] [noerr]

Parâmetros

Parâmetro Descrição

size= <n> A quantidade de espaço em disco, em megabytes (MB), que o volume ocupará em
cada disco. Se nenhum tamanho for dado, o maior volume RAID-5 possível será
criado. O disco com o menor espaço livre contíguo disponível determina o tamanho
do volume RAID-5 e a mesma quantidade de espaço é alocada de cada disco. A
quantidade real de espaço em disco utilizável no volume RAID-5 é menor do que a
quantidade combinada de espaço em disco porque parte do espaço em disco é
necessária para paridade.

disk= <n>, Os discos dinâmicos nos quais criar o volume RAID-5. Você precisa de pelo menos
<n>,<n>[, três discos dinâmicos para criar um volume RAID-5. Uma quantidade de espaço
<n>,...] igual a size=<n> é alocada em cada disco.

align= <n> Alinha todas as extensões de volume ao limite de alinhamento mais próximo.
Normalmente usado com matrizes de LUN (número de unidade lógica) do RAID de
hardware para melhorar o desempenho. <n> é o número de quilobytes (KB) desde o
início do disco até o limite de alinhamento mais próximo.

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Exemplos
Para criar um volume RAID-5 de 1000 megabytes de tamanho, usando discos 1, 2 e 3,
digite:

create volume raid size=1000 disk=1,2,3

Links relacionados
Chave da sintaxe de linha de comando

Comando create
create volume simple
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria um volume simples no disco dinâmico especificado. Depois de criar o volume, o


foco muda automaticamente para o novo volume.

Sintaxe

create volume simple [size=<n>] [disk=<n>] [align=<n>] [noerr]

Parâmetros

Parâmetro Descrição

size= <n> O tamanho do volume em megabytes (MB). Se nenhum tamanho for dado, o novo
volume assumirá o espaço livre restante no disco.

disk= <n> O disco dinâmico no qual o volume é criado. Se nenhum disco for especificado, o
disco atual será usado.

align= <n> Alinha todas as extensões de volume ao limite de alinhamento mais próximo.
Normalmente usado com matrizes de LUN (número de unidade lógica) do RAID de
hardware para melhorar o desempenho. <n> é o número de KB (quilobytes) desde o
início do disco até o limite de alinhamento mais próximo.

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Exemplos
Para criar um volume de 1.000 megabytes de tamanho, no disco 1, digite:

create volume simple size=1000 disk=1


Links relacionados
Chave da sintaxe de linha de comando

Comando create
create volume stripe
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria um volume distribuído usando dois ou mais discos dinâmicos especificados. Depois
de criar o volume, o foco muda automaticamente para o novo volume.

Sintaxe

create volume stripe [size=<n>] disk=<n>,<n>[,<n>,...] [align=<n>] [noerr]

Parâmetros

Parâmetro Descrição

size= <n> A quantidade de espaço em disco, em megabytes (MB), que o volume ocupará em
cada disco. Se nenhum tamanho for determinado, o novo volume assumirá o
espaço livre restante no menor disco e uma quantidade igual de espaço em cada
disco subsequente.

disk= <n>, Os discos dinâmicos nos quais é criado o volume distribuído. São precisos pelo
<n>[, menos dois discos dinâmicos para criar um volume distribuído. Uma quantidade de
<n>,...] espaço igual a size=<n> é alocada em cada disco.

align= <n> Alinha todas as extensões de volume ao limite de alinhamento mais próximo.
Normalmente usado com matrizes de LUN (número de unidade lógica) do RAID de
hardware para melhorar o desempenho. <n> é o número de quilobytes (KB) desde o
início do disco até o limite de alinhamento mais próximo.

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Exemplos
Para criar um volume distribuído de 1.000 megabytes de tamanho, nos discos 1 e 2,
digite:
create volume stripe size=1000 disk=1,2

Links relacionados
Chave da sintaxe de linha de comando

Comando create
cscript
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Inicia um script para ser executado em um ambiente de linha de comando.

) Importante

A execução desta tarefa não exige que você possua credenciais administrativas.
Portanto, como uma prática recomendada de segurança, considere a execução
desta tarefa como um usuário sem credenciais administrativas.

Sintaxe

cscript <scriptname.extension> [/b] [/d] [/e:<engine>] [{/h:cscript |


/h:wscript}] [/i] [/job:<identifier>] [{/logo | /nologo}] [/s] [/t:
<seconds>] [x] [/u] [/?] [<scriptarguments>]

Parâmetros

Parâmetro Descrição

scriptname.extension Especifica o caminho e o nome do arquivo de script com a extensão de


nome de arquivo opcional.

/b Especifica o modo de lote, que não exibe alertas, erros de script ou


prompts de entrada.

/d Inicia o depurador.

/e: <engine> Especifica o mecanismo usado para executar o script.

/h:cscript Registra cscript.exe como o host de script padrão para executar scripts.

/h:wscript Registra wscript.exe como o host de script padrão para executar scripts. O
padrão.
Parâmetro Descrição

/i Especifica o modo interativo, que exibe alertas, erros de script e prompts


de entrada. O padrão e o oposto de /b .

/job: <identifier> Executa o trabalho identificado pelo identificador em um arquivo de script


.wsf.

/logotipo Especifica que a faixa do Host de Script do Windows não seja exibida no
console antes da execução do script. O padrão e o oposto de /nologo .

/nologo Especifica que a faixa do Host de Script do Windows não seja exibida
antes da execução do script.

/s Salva as opções do prompt de comando atuais para o usuário atual.

/t: <seconds> Especifica o tempo máximo que o script pode executar (em segundos).
Especifique até 32.767 segundos. O padrão é sem limite de tempo.

/u Especifica o Unicode para entrada e saída que é redirecionado do console.

/x Inicia o script no depurador.

/? Exibe os parâmetros de comando disponíveis e fornece ajuda para usá-


los. O mesmo que digitar cscript.exe sem parâmetros e sem script.

scriptarguments Especifica os argumentos passados ao script. Cada argumento de script


deve ser precedido por uma barra (/).

Comentários
Cada parâmetro é opcional, no entanto, não é possível especificar argumentos de
script sem especificar um script. Se não especificar um script ou argumentos de
script, cscript.exe exibirá a sintaxe cscript.exe e as opções de host válidas.

O parâmetro /t impede a execução excessiva de scripts definindo um


temporizador. Quando o tempo de execução excede o valor especificado, o
wscript interrompe o mecanismo do script e encerra o processo.

Os arquivos de script do Windows geralmente têm uma das seguintes extensões


de nome de arquivo: .wsf, .vbs, .js. O Host de Script do Windows pode usar
arquivos de script .wsf. Cada arquivo .wsf pode usar vários mecanismos de script e
executar vários trabalhos.

Se clicar duas vezes um arquivo de script com uma extensão sem associação, a
caixa de diálogo Abrir com será exibida. Selecione wscript ou cscript e, em
seguida, selecione Sempre usar este programa para abrir esse tipo de arquivo.
Isso registra wscript.exe ou cscript como o host de script padrão para os arquivos
desse tipo de arquivo.

Links relacionados
Chave da sintaxe de linha de comando
date
Artigo • 12/04/2023

Exibe ou define a data do sistema. Se usado sem parâmetros, o date exibe a


configuração de data do sistema atual e solicita que você insira uma nova data.

) Importante

Você deve ser um administrador para usar esse comando.

Sintaxe

date [/t | <month-day-year>]

Parâmetros

Parâmetro Descrição

<month- Define a data especificada, onde mês é o mês (um ou dois dígitos, incluindo valores
day-year> de 1 a 12), dia é o dia (um ou dois dígitos, incluindo valores de 1 a 31) e ano é o ano
(dois ou quatro dígitos, incluindo os valores de 00 a 99 ou 1980 a 2099). Você deve
separar os valores para mês, dia e ano com pontos (.), hifens (-) ou barras (/).

Observação: fique atento, se você usar 2 dígitos para representar o ano, os valores
de 80 a 99 correspondem a 1980 até 1999.

/t Exibe a data atual sem solicitar uma nova data.

/? Exibe a ajuda no prompt de comando.

Exemplos
Se as extensões de comando estiverem habilitadas, para exibir a data atual do sistema,
digite:

date /t
Para alterar a data atual do sistema para 3 de agosto de 2007, você pode digitar
qualquer uma das seguintes opções:

date 08.03.2007
date 08-03-07
date 8/3/07

Para exibir a data atual do sistema, seguida de um prompt para inserir uma nova data,
digite:

date

Para manter a data atual e retornar ao prompt de comando, pressione ENTER. Para
alterar a data atual, digite a nova data com base na configuração de data atual,
conforme visto no segundo exemplo acima e pressione ENTER.

Links relacionados
Chave da sintaxe de linha de comando
Dcdiag
Artigo • 04/05/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016

O Dcdiag.exe analisa o estado dos controladores de domínio em uma floresta ou uma


empresa e relata os problemas para ajudar na solução deles.

Como um programa de relatório do usuário final, o dcdiag é uma ferramenta de linha


de comando que encapsula o conhecimento detalhado de como identificar um
comportamento anormal no sistema. O dcdiag exibe a saída do comando no prompt de
comando.

Ele consiste em uma estrutura para executar testes e uma série de testes para verificar
diferentes áreas funcionais do sistema. Essa estrutura seleciona os controladores de
domínio que são testados de acordo com as diretivas de escopo do usuário, como
empresa, site ou servidor único.

Para usar o dcdiag, execute-o em um prompt de comandos com privilégios elevados ou


no PowerShell com direitos administrativos.

Sintaxe do dcdiag
dcdiag [/s:<DomainController>] [/n:<NamingContext>] [/u:<Domain>\<UserName> /p:{* |
<Password> | ""}] [{/a | /e}] [{/q | /v}] [/i] [/f:<LogFile>] [/c [/skip:<Test>]]

[/test:<Test>] [/fix] [{/h | /?}] [/ReplSource:<SourceDomainController>]

O dcdiag usa os seguintes parâmetros:

Parâmetro Descrição

/s: <DomainController> Especifica o nome do servidor no qual o comando será executado.


Se esse parâmetro não for especificado, os testes serão executados
no controlador de domínio local.

Esse parâmetro é ignorado para os testes DcPromo e


RegisterInDns, que só podem ser executados localmente.

/n: <NamingContext> Usa NamingContext como o contexto de nomenclatura a ser


testado. Você pode especificar domínios no NetBIOS, no DNS
(Sistema de Nomes de Domínio) ou em um formato de nome
diferenciado.
Parâmetro Descrição

/u: <Domain> \ <UserName> /p: Usa Domain\UserName. O dcdiag usa as credenciais atuais do
{ <Password> | ""} usuário (ou do processo) que está conectado. Se forem necessárias
credenciais alternativas, use as opções a seguir para fornecer essas
credenciais para associá-las com a senha como a senha: use aspas
("") para uma senha vazia ou nula. Use o caractere curinga (*) para
solicitar a senha.

/a Testa todos os servidores neste site do AD DS.

/e Testa todos os servidores na empresa. Isso substitui /a .

/q Silencioso. Imprime somente as mensagens de erro.

/v Detalhado. Imprime informações estendidas.

/fix Afeta somente o teste MachineAccount. Esse parâmetro faz com


que o teste corrija os SPNs (nomes da entidade de serviço) no
objeto Conta do Computador do controlador de domínio.

/f: <LogFile> Redireciona toda a saída para um arquivo de log.

/c Completo. Executa todos os testes, exceto DCPromo e


RegisterInDNS, incluindo os testes não padrão. Opcionalmente,
você pode usar esse parâmetro com o parâmetro /skip para
ignorar os testes especificados.

Os seguintes testes não são executados por padrão:

Topologia
CutoffServers
OutboundSecureChannels.

/h ou /? Exibe a ajuda no prompt de comando.

/test: <Test> Executa somente este teste. O teste de conectividade, que não
pode ser ignorado, também é executado. Isso não pode ser usado
com o parâmetro /skip .

/ReplSource: Testa a conexão entre o controlador de domínio no qual você


<SourceDomainController> executa o comando e o controlador de domínio de origem. (Esse
parâmetro é usado para o teste CheckSecurityError).

SourceDomainController é o nome DNS, o nome NetBIOS ou o


nome diferenciado de um servidor real ou potencial que será o
controlador de domínio de origem para replicação, conforme
representado por um objeto de conexão real ou potencial.
Testes padrão do dcdiag
A tabela a seguir mostra os testes executados por padrão.

Teste Descrição

Publicidade Verifica se cada controlador de domínio se anuncia nas funções que


deve ter a capacidade de executar. Ocorrerá uma falha nesse teste se
o serviço Netlogon tiver parado ou não tiver sido iniciado.

CheckSDRefDom Verifica se todas as partições de diretório de aplicativo têm domínios


apropriados de referência de descritor de segurança.

CrossRefValidation Verifica a validade das referências cruzadas.

FrsEvent Verifica se há erros no sistema de replicação de arquivos. A falha na


replicação do compartilhamento SysVol pode causar problemas de
política.

FrsSysVol Verifica se o sistema de replicação de arquivos e o volume do


sistema estão prontos.

FSMOCheck Verifica se o controlador de domínio pode entrar em contato com


um KDC (centro de distribuição de chaves) Kerberos, um servidor de
horário, um servidor de horário preferencial, um controlador de
domínio primário e um servidor de catálogo global. Esse teste não
testa as funções mestre de operações em nenhum dos servidores.

Intersite Verifica se há falhas que impedem ou mantêm temporariamente a


replicação entre sites e prevê quanto tempo levará para o KCC
(Knowledge Consistency Checker) se recuperar.

KccEvent Verifica se o KCC está sendo concluído sem erros.

KnowsOfRoleHolders Verifica se o controlador de domínio pode entrar em contato com os


servidores que contêm as cinco funções mestre de operações
(também conhecidas como funções FSMO ou operações flexíveis de
mestre único).

MachineAccount Verifica se a conta do computador foi registrada corretamente e se


os serviços foram anunciados. Use o parâmetro
/RecreateMachineAccount para tentar executar um reparo se a conta
do computador local estiver ausente. Use o parâmetro
/FixMachineAccount se os sinalizadores de conta do computador
estiverem incorretos.

NCSecDesc Verifica se os descritores de segurança nos cabeçalhos do contexto


de nomeação têm permissões apropriadas para replicação.

NetLogons Verifica se existem privilégios de logon apropriados para permitir


Teste Descrição

que a replicação prossiga.

ObjectsReplicated Verifica se os objetos DSA (Agente do Sistema de Diretório) e Conta


do Computador foram replicados. Use o parâmetro /objectdn:dn
com o parâmetro /n:nc para especificar um objeto adicional para
verificação.

OutboundSecureChannels Verifica se existem canais seguros de todos os controladores de


domínio no domínio para os domínios especificados pelo parâmetro
/testdomain . O parâmetro /nositerestriction impede que o dcdiag
limite o teste aos controladores de domínio no site.

Replicações Verifica se há uma replicação em tempo hábil e se há erros de


replicação entre os controladores de domínio.

RidManager Verifica se o mestre RID (identificador relativo) está acessível e se ele


contém as informações adequadas.

Serviços Verifica se os serviços de controlador de domínio apropriados estão


em execução.

SystemLog Verifica se o sistema está sendo executado sem erros.

VerifyEnterpriseReferences Verifica se as referências de sistema especificadas estão intactas para


o FRS e para a infraestrutura de replicação em todos os objetos da
empresa em cada controlador de domínio.

VerifyReferences Verifica se determinadas referências do sistema estão intactas para o


FRS e a infraestrutura de replicação.

VerifyReplicas Verifica se foram criadas instâncias para todas as partições de


diretório do aplicativo em todos os servidores de réplica.

7 Observação

As verificações de conectividade nos controladores de domínio registrados na rede


e que se conectam a outros recursos, como DNS, LDAP e RPC, não podem ser
ignoradas.

Sintaxe de teste de DNS


dcdiag /test:DNS [/DnsBasic | /DnsForwarders | /DnsDelegation | /DnsDynamicUpdate |
/DnsRecordRegistration | /DnsResolveExtName [/DnsInternetName:<InternetName>] |
/DnsAll] [/f:<LogFile>] [/x:<XMLLog.xml>] [/xsl:<XSLFile.xsl> or <XSLTFile.xslt>]
[/s:<DomainController>] [/e] [/v]

O teste de DNS usa os seguintes parâmetros:

Parâmetro Descrição

/test:DNS Executa o teste DNS especificado. Se nenhum teste for


especificado, /DnsAll será usado como padrão.

/DnsBasic Executa testes de DNS básicos, incluindo conectividade de rede,


configuração do cliente DNS, disponibilidade de serviço e
existência de zona.

/DnsForwarders Executa os testes /DnsBasic e verifica a configuração de


encaminhadores.

/DnsDelegation Executa os testes /DnsBasic e verifica se há delegações


adequadas.

/DnsDynamicUpdate Executa os testes /DnsBasic e determina se a atualização


dinâmica está habilitada na zona do Active Directory.

/DnsRecordRegistration Executa os testes /DnsBasic e verifica se o endereço (A), o nome


canônico (CNAME) e os registros de recursos de serviço
conhecido (SRV) estão registrados. Além disso, cria um relatório
de inventário com base nos resultados do teste.

/DnsResolveExtName Executa os testes /DnsBasic e tenta resolver InternetName. Se


[/DnsInternetName:\ /DnsInternetName não for especificado, tentará resolver o nome
<InternetName> ] www.microsoft.com . Se /DnsInternetName for especificado,
tentará resolver o nome da Internet fornecido pelo usuário.

/DnsAll Executa todos os testes, exceto o teste /DnsResolveExtName , e


gera um relatório.

/f: <LogFile> Redireciona toda a saída para um arquivo de log.

/s: <DomainController> Executa os testes no controlador de domínio. Se esse parâmetro


não for especificado, os testes serão executados no controlador
de domínio local.

/e Executa todos os testes especificados por /test:DNS em todos


os controladores de domínio da floresta do Active Directory.

/v Detalhado. Apresenta informações estendidas sobre os


resultados de teste bem-sucedidos, além de informações sobre
erros e avisos.
Quando o parâmetro /v não é usado, fornece apenas
Parâmetro Descrição

informações de erro e aviso. Use a opção /v quando erros ou


avisos forem relatados na tabela de resumo.

/x: <XMLLog.xml> Redireciona toda a saída para xmllog.xml. Esse parâmetro só


funciona com a opção /test:DNS .

/xsl: <XSLFile.xsl> ou Adiciona as instruções de processamento que referenciam a


/xsl: <XSLTFile.xslt> planilha especificada. Esse parâmetro só funciona com a opção
/test:DNS /x:<XMLLog.xml .

7 Observação

Os tempos de execução para os testes de DNS podem ser significativos em


empresas de grande porte quando o parâmetro /e é usado. Os controladores de
domínio e os servidores DNS offline aumentarão os tempos de execução devido a
longos períodos de tempo limite para a RPC e outros protocolos.

Exemplos

Teste de conectividade
Para executar uma série de testes de conectividade no domínio local, execute o seguinte
comando:

PowerShell

dcdiag

Uma saída de teste de conectividade bem-sucedida pode ser vista abaixo:

PowerShell

PS C:\Users\Administrator> dcdiag

Directory Server Diagnosis

Performing initial setup:

Trying to find home server...

Home Server = MapleWaffle-WS22


* Identified AD Forest.
Done gathering initial info.

Doing initial required tests

Testing server: Default-First-Site-Name\MAPLEWAFFLE-WS2

Starting test: Connectivity

......................... MAPLEWAFFLE-WS2 passed test Connectivity

Doing primary tests

Testing server: Default-First-Site-Name\MAPLEWAFFLE-WS2

Starting test: Advertising


......................... MAPLEWAFFLE-WS2 passed test Advertising

Starting test: FrsEvent


......................... MAPLEWAFFLE-WS2 passed test FrsEvent

Starting test: DFSREvent


......................... MAPLEWAFFLE-WS2 passed test DFSREvent

Starting test: SysVolCheck


......................... MAPLEWAFFLE-WS2 passed test SysVolCheck

Starting test: KccEvent


......................... MAPLEWAFFLE-WS2 passed test KccEvent

Starting test: KnowsOfRoleHolders


......................... MAPLEWAFFLE-WS2 passed test
KnowsOfRoleHolders

Starting test: MachineAccount


......................... MAPLEWAFFLE-WS2 passed test
MachineAccount

Starting test: NCSecDesc


......................... MAPLEWAFFLE-WS2 passed test NCSecDesc

Starting test: NetLogons


......................... MAPLEWAFFLE-WS2 passed test NetLogons

Starting test: ObjectsReplicated


......................... MAPLEWAFFLE-WS2 passed test
ObjectsReplicated

Starting test: Replications


......................... MAPLEWAFFLE-WS2 passed test Replications

Starting test: RidManager


......................... MAPLEWAFFLE-WS2 passed test RidManager

Starting test: Services


......................... MAPLEWAFFLE-WS2 passed test Services

Starting test: SystemLog


......................... MAPLEWAFFLE-WS2 passed test SystemLog

Starting test: VerifyReferences


......................... MAPLEWAFFLE-WS2 passed test
VerifyReferences

Running partition tests on : ForestDnsZones

Starting test: CheckSDRefDom


......................... ForestDnsZones passed test CheckSDRefDom

Starting test: CrossRefValidation


......................... ForestDnsZones passed test
CrossRefValidation

Running partition tests on : DomainDnsZones

Starting test: CheckSDRefDom


......................... DomainDnsZones passed test CheckSDRefDom

Starting test: CrossRefValidation


......................... DomainDnsZones passed test
CrossRefValidation

Running partition tests on : Schema

Starting test: CheckSDRefDom


......................... Schema passed test CheckSDRefDom

Starting test: CrossRefValidation


......................... Schema passed test CrossRefValidation

Running partition tests on : Configuration

Starting test: CheckSDRefDom


......................... Configuration passed test
CheckSDRefDom

Starting test: CrossRefValidation


......................... Configuration passed test
CrossRefValidation

Running partition tests on : corp

Starting test: CheckSDRefDom


......................... corp passed test CheckSDRefDom

Starting test: CrossRefValidation


......................... corp passed test CrossRefValidation
Running enterprise tests on : corp.baconpancake.com

Starting test: LocatorCheck


......................... corp.baconpancake.com passed test
LocatorCheck

Starting test: Intersite


......................... corp.baconpancake.com passed test
Intersite

PS C:\Users\Administrator>

Para executar uma série de testes de conectividade em um controlador de domínio


específico, execute o seguinte comando:

PowerShell

dcdiag /s:<DomainControllerName>

Ele vai gerar resultados semelhantes ao teste local se nenhum problema for encontrado.

Saída para um arquivo de log


O dcdiag pode salvar os resultados da saída em um arquivo de texto executando o
seguinte:

PowerShell

dcdiag /s:<DomainControllerName> /f:<FileName.txt>

Se nenhum <FilePath> for especificado, os resultados serão salvos em C:\Users\


<UserName>\<FileName.txt> por padrão.

Para salvá-los em um local específico, execute o seguinte:

PowerShell

dcdiag /s:<DomainControllerName> /f:<DriveLetter>\<FilePath>\<FileName.txt>

Referências adicionais
Chave da sintaxe de linha de comando
dcgpofix
Artigo • 17/04/2023

Recria os GPOs padrão para um domínio. Para acessar o GPMC (Console de


Gerenciamento de Política de Grupo), instale o Gerenciamento de Política de Grupo
como um recurso por meio de Gerenciador do Servidor.

) Importante

Como prática recomendada, você deve configurar o GPO de Política de Domínio


Padrão apenas para gerenciar as configurações padrão de Políticas de Conta, a
Política de Senha, a Política de Bloqueio de Conta e a Política Kerberos. Além disso,
você deve configurar o GPO da Política de Controladores de Domínio Padrão
apenas para definir direitos de usuário e políticas de auditoria.

Sintaxe

dcgpofix [/ignoreschema] [/target: {domain | dc | both}] [/?]

Parâmetros

Parâmetro Descrição

/ignoreschema Ignora a versão do esquema do Active Directory quando você executa esse
comando. Caso contrário, o comando só funcionará na mesma versão de
esquema que a versão do Windows na qual o comando foi enviado.

/target Especifica se deve ser direcionada a política de Domínio Padrão, a política


{domain | dc | Controladores de Domínio Padrão ou ambos os tipos de políticas.
both

/? Exibe a ajuda no prompt de comando.

Exemplos
Para gerenciar as configurações padrão de Políticas de Conta, a Política de Senha, a
Política de Bloqueio de Conta e a Política Kerberos, ignorando a versão do esquema do
Active Directory, digite:

dcgpofix /ignoreschema /target:domain

Para configurar o GPO da Política de Controladores de Domínio Padrão apenas para


definir direitos de usuário e políticas de auditoria, ignorando a versão do esquema do
Active Directory, digite:

dcgpofix /ignoreschema /target:dc

Links relacionados
Chave da sintaxe de linha de comando
defrag
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Windows
Server 2016, Windows Server 2012 R2, Windows Server 2012

Localiza e consolida arquivos fragmentados em volumes locais para melhorar o


desempenho do sistema.

A associação no grupo de Administradores local, ou equivalente, é o mínimo necessário


para executar este comando.

Sintaxe

defrag <volumes> | /c | /e <volumes> [/h] [/m [n]| [/u] [v]]


defrag <volumes> | /c | /e <volumes> /a [/h] [/m [n]| [/u] [v]]
defrag <volumes> | /c | /e <volumes> /x [/h] [/m [n]| [/u] [v]]
defrag <volume> [<parameters>]

Parâmetros

Parâmetro Descrição

<volume> Especifica a letra da unidade ou o caminho do ponto de montagem do volume a ser


desfragmentado ou analisado.

/a Execute a análise nos volumes especificados.

/c Execute a operação em todos os volumes.

/d Execute o defrag tradicional (esse é o padrão). Em um volume em camadas, porém,


o defrag tradicional é executado apenas na camada Capacidade.

/e Execute a operação em todos os volumes, exceto os especificados.

/g Otimize as camadas de armazenamento nos volumes especificados.

/h Execute a operação com prioridade normal (o padrão é baixo).

/i [n] A otimização de camada seria executada por no máximo n segundos em cada


volume.
Parâmetro Descrição

/k Execute a consolidação de bloco nos volumes especificados.

/l Execute novas tentativas nos volumes especificados.

/m [n] Execute a operação em cada volume em paralelo em segundo plano. No máximo, n


threads otimizam as camadas de armazenamento em paralelo.

/o Execute a otimização adequada para cada tipo de mídia.

/t Acompanhe uma operação já em andamento no volume especificado.

/u Imprima o progresso da operação na tela.

/v Imprima saída detalhada que contém as estatísticas de fragmentação.

/x Execute a consolidação de espaço livre nos volumes especificados.

/? Exibe essas informações de ajuda.

Comentários
Não é possível desfragmentar volumes ou unidades específicas do sistema de
arquivos, incluindo:

Volumes bloqueados pelo sistema de arquivos.

Volumes do sistema de arquivos marcados como sujos, indicando possível


corrupção.
Execute chkdsk antes de desfragmentar esse volume ou unidade. Determine se
um volume está sujo usando o comando fsutil dirty .

Unidades de rede.

CD-ROMs.

Volumes do sistema de arquivos que não são NTFS, ReFS, Fat ou Fat32.

Para executar esse procedimento, você deve ser membro do grupo


Administradores no computador local ou deve ter recebido a autoridade
apropriada. Se o computador estiver em um domínio, é possível que os membros
do grupo Admins. do Domínio possam executar esse procedimento. Como melhor
prática de segurança, considere o uso de Executar Como para executar esse
procedimento.
Um volume deve ter pelo menos 15% de espaço livre para o defrag para
desfragmentá-lo completamente e adequadamente. O defrag usa esse espaço
como uma área de classificação para fragmentos de arquivo. Se um volume tiver
menos de 15% de espaço livre, o defrag desfragmentará apenas parcialmente.
Para aumentar o espaço livre em um volume, exclua arquivos desnecessários ou
mova-os para outro disco.

Enquanto o defrag está analisando e desfragmentando um volume, ele exibe um


cursor piscando. Quando o defrag terminar de analisar e desfragmentar o volume,
ele exibirá o relatório de análise, o relatório de desfragmentação ou ambos os
relatórios e sairá para o prompt de comando.

Por padrão, o defrag exibe um resumo dos relatórios de análise e


desfragmentação se não especificar os parâmetros / a ou /v.

Enviar os relatórios para um arquivo de texto digitando >FileName.txt, em que


FileName.txt é um nome de arquivo especificado. Por exemplo: defrag volume /v >
FileName.txt

Para interromper o processo de desfragmentação, na linha de comando, pressione


CTRL+C.

Executar o comando defrag e o Desfragmentador de disco são mutuamente


exclusivos. Caso esteja usando o Desfragmentador de disco para desfragmentar
um volume e executar o comando defrag em uma linha de comando, o comando
defrag falhará. Por outro lado, se você executar o comando defrag e abrir o
Desfragmentador de disco, as opções de desfragmentação no desfragmentador de
disco não estarão disponíveis.

Exemplos
Para desfragmentar o volume na unidade C enquanto fornece progresso e saída
detalhada, digite:

defrag c: /u /v

Para desfragmentar os volumes nas unidades C e D em paralelo em segundo plano,


digite:
defrag c: d: /m

Para executar uma análise de fragmentação de um volume montado na unidade C e


fornecer progresso, digite:

defrag c: mountpoint /a /u

Para desfragmentar todos os volumes com prioridade normal e fornecer uma saída
detalhada, digite:

defrag /c /h /v

Tarefa agendada
O processo de desfragmentação executa a tarefa agendada como uma tarefa de
manutenção, que normalmente é executada toda semana. Como administrador, altere a
frequência com que a tarefa é executada usando o aplicativo Otimizar Unidades.

Quando executado da tarefa agendada, o defrag usa as diretrizes de política


abaixo para SSDs:

Processos de otimização tradicionais. Inclui desfragmentação tradicional, por


exemplo, mover arquivos para torná-los razoavelmente contíguos e tentar
novamente. Isso é feito uma vez por mês. No entanto, se a desfragmentação
tradicional e a repetição forem ignoradas, a análise não será executada. Alterar
a frequência da tarefa agendada não afeta a cadência de uma vez por mês para
os SSDs.

Caso execute manualmente a desfragmentação tradicional em um SSD, entre


as execuções normalmente agendadas, a próxima execução de tarefa agendada
executará a análise e a repetição, mas ignorará a desfragmentação tradicional
nesse SSD.

Caso ignore a análise, não visualizará um último tempo de execução atualizado


no aplicativo Otimizar Unidades. Por causa disso, o último tempo de execução
pode ter até um mês de idade.
Descobra que a tarefa agendada não desfragmentou todos os volumes.
Normalmente, isso ocorre porque:

O processo não ativa o computador para ser executado.

O computador não está conectado. O processo não será executado se o


computador estiver em execução com energia da bateria.

O computador começou a fazer backup (retomado do ocioso).

Links relacionados
Chave da sintaxe de linha de comando

chkdsk

fsutil

fsutil dirty

Otimizar o volume do Powershell


del
Artigo • 12/04/2023

Exclui um ou mais arquivos. Esse comando executa as mesmas ações que o comando
apagar.

O comando del também pode ser executado no Console de Recuperação do Windows,


usando parâmetros diferentes. Para obter mais informações, consulte WinRE (Ambiente
de Recuperação do Windows).

2 Aviso

Caso use o del para excluir um arquivo do disco, não poderá recuperá-lo.

Sintaxe

del [/p] [/f] [/s] [/q] [/a[:]<attributes>] <names>


erase [/p] [/f] [/s] [/q] [/a[:]<attributes>] <names>

Parâmetros

Parâmetro Descrição

<names> Especifica uma lista de um ou mais arquivos ou diretórios. Curingas podem


ser usados para excluir vários arquivos. Se um diretório for especificado,
todos os arquivos dentro do diretório serão excluídos.

/p Solicita confirmação antes de excluir o arquivo especificado.

/f Força a exclusão de arquivos somente leitura.

/s Exclui arquivos especificados do diretório atual e de todos os subdiretórios.


Exibe os nomes dos arquivos conforme eles estão sendo excluídos.

/q Especifica o modo silencioso. Você não será solicitado a excluir a confirmação.


Parâmetro Descrição

/a[:] <attributes> Exclui arquivos com base nos seguintes atributos de arquivo:
r Arquivos somente leitura
h Arquivos ocultos
i Arquivos sem conteúdo indexado
s Arquivos do sistema
a Arquivos prontos para arquivamento
a Pontos de nova análise
- Usado como um prefixo que significa 'not'

/? Exibe a ajuda no prompt de comando.

Comentários

Caso use o comando del /p , visualizará a seguinte mensagem:

FileName, Delete (Y/N)?

Para confirmar a exclusão, pressione Y. Para cancelar a exclusão e exibir o próximo


nome de arquivo (se especificou um grupo de arquivos), pressione N. Para
interromper o comando del, pressione CTRL+C.

Caso desabilite a extensão de comando, o parâmetro /s exibirá os nomes de todos


os arquivos que não foram encontrados, em vez de exibir os nomes dos arquivos
que estão sendo excluídos.

Caso especifique pastas específicas no parâmetro <names> , todos os arquivos


incluídos também serão excluídos. Por exemplo, caso queira excluir todos os
arquivos na pasta \trabalho, digite:

del \work

Use os curingas (* e ?) para excluir mais de um arquivo por vez. No entanto, para
evitar a exclusão de arquivos involuntariamente, use os curingas com cautela. Por
exemplo, caso digite o seguinte comando:

del *.*
O comando del exibe o seguinte prompt:

Are you sure (Y/N)?

Para excluir todos os arquivos no diretório atual, pressione Y e pressione ENTER.


Para cancelar a exclusão, pressione N e pressione ENTER.

7 Observação

Antes de usar caracteres curinga com o comando del, use os mesmos


caracteres curinga com o comando dir para listar todos os arquivos que serão
excluídos.

Exemplos
Para excluir todos os arquivos em uma pasta chamada Teste na unidade C, digite um
dos seguintes:

del c:\test
del c:\test\*.*

Para excluir todos os arquivos em uma pasta em que a pasta tem um espaço em seu
nome, o caminho completo precisa ser encapsulado entre aspas duplas. Digite um
destes procedimentos:

del "c:\test folder\"


del "c:\test folder\*.*"

Para excluir todos os arquivos com a extensão de nome de arquivo .bat do diretório
atual, digite:

del *.bat

Para excluir todos os arquivos somente leitura no diretório atual, digite:


del /a:r *.*

Links relacionados
Chave da sintaxe de linha de comando

WinRE (Ambiente de Recuperação do Windows)


excluir
Artigo • 11/04/2023

Exclui uma partição ou um volume. Ele também exclui um disco dinâmico da lista de
discos.

Sintaxe

delete disk
delete partition
delete shadows
delete volume

Parâmetros

Parâmetro Descrição

Excluir disco Exclui um disco dinâmico ausente da lista de discos.

Excluir partição Exclui uma partição.

Excluir sombras Exclui cópias de sombra.

Excluir volume Exclui um volume.

Links relacionados
Chave da sintaxe de linha de comando
delete disk
Artigo • 12/04/2023

Exclui um disco dinâmico ausente da lista de discos.

7 Observação

Para obter instruções detalhadas sobre como usar esse comando, consulte
Remover um disco dinâmico ausente.

Sintaxe

delete disk [noerr] [override]

Parâmetros

Parâmetro Descrição

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

override Permite que o DiskPart exclua todos os volumes simples no disco. Se o disco
contiver metade de um volume espelhado, a metade do espelho no disco será
excluída. O comando excluir substituição de disco falhará se o disco for membro de
um volume RAID-5.

Exemplos
Exclui um disco dinâmico ausente da lista de discos:

delete disk

Links relacionados
Chave da sintaxe de linha de comando

comando delete
delete partition
Artigo • 17/04/2023

Exclui a partição com foco. Antes de começar, selecione uma partição para que essa
operação seja bem-sucedida. Use o comando select partition para selecionar uma
partição e deslocar o foco para ela.

2 Aviso

Excluir uma partição em um disco dinâmico pode excluir todos os volumes


dinâmicos no disco, destruindo todos os dados e deixando o disco em um estado
corrompido.

Você não pode excluir a partição do sistema, a partição de inicialização ou qualquer


partição que contenha o arquivo de paginação ativo ou informações de despejo de
memória.

Sintaxe

delete partition [noerr] [override]

Parâmetros

Parâmetro Descrição

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

override Permite que DiskPart exclua qualquer partição, independentemente do tipo.


Normalmente, DiskPart só permite que você exclua partições de dados conhecidas.

Comentários
Para excluir um volume dinâmico, use sempre o comando delete volume.

As partições podem ser excluídas de discos dinâmicos, mas não devem ser criadas.
Por exemplo, é possível excluir uma partição GPT (Tabela de Partição GUID) não
reconhecida em um disco GPT dinâmico. Excluir essa partição não faz com que o
espaço livre resultante fique disponível. Em vez disso, esse comando destina-se a
permitir que você recupere espaço em um disco dinâmico offline corrompido em
uma situação de emergência em que o comando clean no DiskPart não pode ser
usado.

Exemplos
Para excluir a partição com foco, digite:

delete partition

Links relacionados
Chave da sintaxe de linha de comando

select partition

Comando delete

Comando delete volume

Comando clean
delete shadows
Artigo • 17/04/2023

Exclui cópias de sombra.

Sintaxe

delete shadows [all | volume <volume> | oldest <volume> | set <setID> | id


<shadowID> | exposed {<drive> | <mountpoint>}]

Parâmetros

Parâmetro Descrição

all Exclui todas as cópias de sombra.

volume Exclui todas as cópias de sombra do volume determinado.


<volume>

oldest Exclui a cópia de sombra mais antiga do volume determinado.


<volume>

set <setID> Exclui as cópias de sombra no Conjunto de cópias de sombra da ID


determinada. Você pode especificar um alias usando o símbolo % se o alias
existir no ambiente atual.

id <shadowID> Exclui uma cópia de sombra da ID determinada. Você pode especificar um alias
usando o símbolo % se o alias existir no ambiente atual.

exposed Exclui cópias de sombra expostas na unidade especificada ou no ponto de


{ <drive> | montagem.
<mountpoint> }

Links relacionados
Chave da sintaxe de linha de comando

Comando delete
delete volume
Artigo • 12/04/2023

Exclui o volume selecionado. Antes de começar, você deve selecionar um volume para
que essa operação seja bem-sucedida. Use o comando select volume para selecionar
um volume e mudar o foco para ele.

) Importante

Não é possível excluir o volume do sistema, o volume de inicialização ou qualquer


volume contendo o arquivo de paginação ativo ou o despejo (despejo de
memória).

Sintaxe

delete volume [noerr]

Parâmetros

Parâmetro Descrição

noerr Somente para scripts. Quando um erro é encontrado, o DiskPart continua a


processar os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro,
um erro faz com que o DiskPart saia com um código de erro.

Exemplos
Para excluir o volume com foco, digite:

delete volume

Links relacionados
Chave da sintaxe de linha de comando
select volume

Comando delete
detach vdisk
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Impede que o VHD (disco rígido virtual) selecionado apareça como uma unidade de
disco rígido local no computador host. Quando um VHD é desanexado, você pode
copiá-lo a outros locais. Antes de começar, selecione um VHD para que essa operação
seja bem-sucedida. Use o comando select vdisk para selecionar um VHD e mudar o foco
para ele.

Sintaxe

detach vdisk [noerr]

Parâmetros

Parâmetro Descrição

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Exemplos
Para desanexar o VHD selecionado, digite:

detach vdisk

Links relacionados
Chave da sintaxe de linha de comando
comando attach vdisk

comando compact vdisk

comando detail vdisk

comando expand vdisk

comando merge vdisk

comando select vdisk

Comando list
detalhes
Artigo • 10/04/2023

Exibe informações sobre o disco, a partição, o volume ou o VHD (disco rígido virtual)
selecionado.

Sintaxe

detail disk
detail partition
detail volume
detail vdisk

Parâmetros

Parâmetro Descrição

Detail disk Exibe as propriedades do disco selecionado e os volumes existentes nele.

Detail partition Exibe as propriedades da partição selecionada.

Detail volume Exibe os discos nos quais o volume atual reside.

Detail vdisk Exibe as propriedades do VHD selecionado.

Links relacionados
Chave da sintaxe de linha de comando
detail disk
Artigo • 12/04/2023

Exibe as propriedades do disco selecionado e os volumes existentes nele. Antes de


começar, selecione um disco para que essa operação seja bem-sucedida. Use o
comando select disk para selecionar um disco e mudar o foco para ele. Se selecionar um
VHD (disco rígido virtual), esse comando mostrará o tipo de barramento do disco como
Virtual.

Sintaxe

detail disk

Exemplos
Para ver as propriedades do disco selecionado e as informações sobre os volumes no
disco, digite:

detail disk

Links relacionados
Chave da sintaxe de linha de comando

comando detail
detail partition
Artigo • 10/04/2023

Exibe as propriedades da partição selecionada. Antes de começar, selecione uma


partição para que essa operação seja bem-sucedida. Use o comando select partition
para selecionar uma partição e deslocar o foco para ela.

Sintaxe

detail partition

Exemplos
Para ver as propriedades da partição selecionada, digite:

detail partition

Links relacionados
Chave da sintaxe de linha de comando

Comando detail
detail vdisk
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe as propriedades do VHD selecionado. Antes de começar, selecione um VHD para


que essa operação seja bem-sucedida. Use o comando select vdisk para selecionar um
VHD e mudar o foco para ele.

Sintaxe

detail vdisk

Exemplos
Para exibir detalhes sobre o VHD selecionado, digite:

detail vdisk

Links relacionados
Chave da sintaxe de linha de comando

Comando detail

Comando attach vdisk

Comando compact vdisk

Comando detach vdisk

Comando expand vdisk

Comando merge vdisk


select vdisk

Comando list
detail volume
Artigo • 12/04/2023

Exibe os discos nos quais o volume atual reside. Antes de começar, você deve selecionar
um volume para que essa operação seja bem-sucedida. Use o comando select volume
para selecionar um volume e mudar o foco para ele. Os detalhes do volume não são
aplicáveis a volumes somente leitura, como uma unidade DVD-ROM ou CD-ROM.

Sintaxe

detail volume

Exemplos
Para ver todos os discos nos quais o volume atual reside, digite:

detail volume

Links relacionados
Chave da sintaxe de linha de comando

select volume

comando detail
dfsdiag
Artigo • 12/04/2023

Fornece informações de diagnóstico para os Namespaces do DFS.

Sintaxe

dfsdiag /testdcs [/domain:<domain name>]


dfsdiag /testsites </machine:<server name>| /DFSPath:<namespace root or DFS
folder> [/recurse]> [/full]
dfsdiag /testdfsconfig /DFSRoot:<namespace>
dfsdiag /testdfsintegrity /DFSRoot:<DFS root path> [/recurse] [/full]
dfsdiag /testreferral /DFSpath:<DFS path to get referrals> [/full]

Parâmetros

Parâmetro Descrição

dfsdiag testdcs Verifica a configuração do controlador de domínio.

dfsdiag testsites Verifica as associações de site.

dfsdiag testdfsconfig Verifica a configuração do Namespace do DFS.

dfsdiag testdfsintegrity Verifica a integridade do Namespace do DFS.

dfsdiag testreferral Verifica as respostas de referência.

/? Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
dfsdiag testdcs
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Verifica a configuração dos controladores de domínio executando os seguintes testes


em cada controlador no domínio especificado:

Verifica se o serviço de Namespace do DFS (Sistema de Arquivos Distribuído) está


em execução e se seu tipo de inicialização está definido como Automático.

Verifica o suporte de indicações com custo de site para o NETLOGON e SYSvol.

Verifica a consistência da associação de site por nome do host e endereço IP.

Sintaxe

dfsdiag /testdcs [/domain:<domain_name>]

Parâmetros

Parâmetro Descrição

/domain: <domain_name> Nome do domínio a ser verificado. Esse parâmetro é opcional. O valor
padrão é o domínio local ao qual o host local é adicionado.

Exemplos
Para verificar a configuração de controladores de domínio em contoso.com, digite:

dfsdiag /testdcs /domain:contoso.com

Links relacionados
Chave da sintaxe de linha de comando

Comando dfsdiag
dfsdiag testdfsconfig
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Verifica a configuração de um namespace do DFS (Sistema de Arquivos Distribuído)


executando as seguintes ações:

Verifica se o serviço de Namespace do DFS está em execução e se seu tipo de


inicialização está definido como Automático em todos os servidores de
namespace.

Verifica se a configuração do Registro do DFS é consistente entre os servidores de


namespace.

Valida as seguintes dependências em servidores de namespace clusterizados:

Dependência de recurso raiz do namespace no recurso de nome de rede.

Dependência de recurso de nome de rede no recurso de endereço IP.

Dependência de recurso raiz do namespace no recurso de disco físico.

Sintaxe

dfsdiag /testdfsconfig /DFSroot:<namespace>

Parâmetros

Parâmetro Descrição

/DFSroot: <namespace> O namespace (raiz DFS) a ser diagnosticado.

Exemplos
Para verificar a configuração de namespaces do DFS (Sistema de Arquivos Distribuído)
no contoso.com\MyNamespace, digite:
dfsdiag /testdfsconfig /DFSroot:\\contoso.com\MyNamespace

Links relacionados
Chave da sintaxe de linha de comando

Comando dfsdiag
dfsdiag testdfsintegrity
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Verifica a integridade do namespace do DFS (Sistema de Arquivos Distribuído)


executando os seguintes testes:

Verifica se há corrupção de metadados do DFS ou inconsistências entre


controladores de domínio.

Valida a configuração da enumeração baseada em acesso para garantir que seja


consistente entre os metadados do DFS e o compartilhamento do servidor de
namespace.

Detecta pastas DFS sobrepostas (links), pastas duplicadas e pastas com destinos de
pasta sobrepostos.

Sintaxe

dfsdiag /testdfsintegrity /DFSroot: <DFS root path> [/recurse] [/full]

Parâmetros

Parâmetro Descrição

/DFSroot: O namespace do DFS a ser diagnosticado.


<DFS root
path>

/recurse Executa o teste, incluindo eventuais interlinks de namespace.

/full Verifica a consistência das ACLs de compartilhamento e NTFS, juntamente com a


configuração do lado do cliente em todos os destinos de pasta. Também verifica se
a propriedade online está definida.

Exemplos
Para verificar a integridade e a consistência dos namespaces do DFS (Sistema de
Arquivos Distribuído) em contoso.com\MyNamespace, incluindo eventuais interlinks,
digite:

dfsdiag /testdfsintegrity /DFSRoot:\contoso.com\MyNamespace /recurse /full

Links relacionados
Chave da sintaxe de linha de comando

Comando dfsdiag
dfsdiag testreferral
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Verifica as indicações do DFS (Sistema de Arquivos Distribuído) executando os seguintes


testes:

Caso use o parâmetro DFSpath* sem argumentos, o comando validará que a lista
de indicações inclui todos os domínios confiáveis.

Caso especifique um domínio, o comando executará uma verificação de


integridade dos controladores de domínio ( dfsdiag /testdcs ) e testará as
associações de site e o cache de domínio do host local.

Caso especifique um domínio e \SYSvol ou \NETLOGON, o comando executará as


mesmas verificações de integridade do controlador de domínio, juntamente com a
verificação de que a TTL ( vida útil) das indicações SYSvol ou NETLOGON
corresponde ao valor padrão de 900 segundos.

Caso especifique uma raiz de namespace, o comando executará as mesmas


verificações de integridade do controlador de domínio, juntamente com a
execução de uma verificação de configuração do DFS ( dfsdiag /testdfsconfig ) e
uma verificação de integridade do namespace ( dfsdiag /testdfsintegrity ).

Caso especifique uma pasta DFS (link), o comando executará as mesmas


verificações de integridade raiz do namespace, além de validar a configuração do
site para destinos de pasta (dfsdiag /testsites) e validar a associação de site do
host local.

Sintaxe

dfsdiag /testreferral /DFSpath:<DFS path to get referrals> [/full]

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

/DFSpath: <path Um dos seguintes pode ser feito:


to get Vazio: testa apenas domínios confiáveis.
referrals> \\Domain: Testa apenas as indicações do controlador de domínio.
\\Domain\SYSvol: Testa apenas as indicações do SYSvol.
\\Domain\NETLOGON: Testa apenas indicações NETLOGON.
\\<domain or server>\<namespace root>: Testa apenas as indicações de
raiz do namespace.
\\<domain or server>\<namespace root>\<DFS folder>: Testa apenas as
indicações da pasta DFS (link).

/completo Aplica-se somente a referências de Domínio e Raiz. Verifica a consistência das


informações de associação de site entre o Registro e o AD DS (Active Directory
Domain Services).

Exemplos
Para verificar as indicações do DFS (Sistema de Arquivos Distribuído) em
contoso.com\MyNamespace, digite:

dfsdiag /testreferral /DFSpath:\\contoso.com\MyNamespace

Para verificar as indicações do DFS (Sistema de Arquivos Distribuído) em todos os


domínios confiáveis, digite:

dfsdiag /testreferral /DFSpath:

Links relacionados
Chave da sintaxe de linha de comando

Comando dfsdiag
dfsdiag testsites
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Verifica a configuração de sites do AD DS (Active Directory Domain Services) verificando


se os servidores que atuam como destinos de pasta ou servidores de namespace têm as
mesmas associações de site em todos os controladores de domínio.

Sintaxe

dfsdiag /testsites </machine:<server name>| /DFSpath:<namespace root or DFS


folder> [/recurse]> [/full]

Parâmetros

Parâmetro Descrição

/machine:<server O nome do servidor no qual verificar a associação do site.


name>

/DFSpath:<namespace A raiz do namespace ou a pasta DFS (Sistema de Arquivos Distribuído)


root or DFS folder> (link) com destinos para os quais verificar a associação do site.

/recurse Enumera e verifica as associações de site para todos os destinos de pasta


na raiz do namespace especificada.

/completo Verifica se o AD DS e o registro do servidor contêm as mesmas


informações de associação de site.

Exemplos
Para verificar as associações de site no computador\MyServer, digite:

dfsdiag /testsites /machine:MyServer


Para verificar uma pasta do DFS (Sistema de Arquivos Distribuído) para verificar a
associação do site, além de verificar se o AD DS e o registro do servidor contêm as
mesmas informações de associação de site, digite:

dfsdiag /TestSites /DFSpath:\\contoso.com\namespace1\folder1 /full

Para verificar uma raiz de namespace para verificar a associação do site, além de
enumerar e verificar as associações de site para todos os destinos de pasta na raiz do
namespace especificada e verificar se o AD DS e o Registro do servidor contêm as
mesmas informações de associação de site, digite:

dfsdiag /testsites /DFSpath:\\contoso.com\namespace2 /recurse /full

Links relacionados
Chave da sintaxe de linha de comando

Comando dfsdiag
dfsrmig
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

A ferramenta de migração para o serviço de Replicação do DFS, dfsrmig.exe, é instalada


com o serviço de Replicação do DFS. Essa ferramenta migra a replicação do SYSvol do
FRS (Serviço de Replicação de Arquivos) para a Replicação do DFS (Sistema de Arquivos
Distribuído). Ele também fornece informações sobre o progresso da migração e
modifica objetos do AD DS (Active Directory Domain Services) para dar suporte à
migração.

Sintaxe

dfsrmig [/setglobalstate <state> | /getglobalstate | /getmigrationstate |


/createglobalobjects |
/deleterontfrsmember [<read_only_domain_controller_name>] |
/deleterodfsrmember [<read_only_domain_controller_name>] | /?]

Parâmetros

Parâmetro Descrição

/setglobalstate <state> Define o estado de migração global do domínio como


um que corresponde ao valor especificado por estado.
Só é possível definir o estado de migração global como
um estado estável. Os valores de estado incluem:

0 – Estado Inicial
1 – Estado preparado
2 – Estado redirecionado
3 – Estado eliminado
Parâmetro Descrição

/getglobalstate Recupera o estado de migração global atual para o


domínio da cópia local do banco de dados do AD DS,
quando executado no emulador do PDC. Use essa opção
para confirmar se você definiu o estado de migração
global correto.
Importante: você só deve executar esse comando no
emulador do PDC.

/getmigrationstate Recupera o estado de migração local atual para todos os


controladores de domínio no domínio e determina se
esses estados locais correspondem ao estado de
migração global atual. Use essa opção para determinar
se todos os controladores de domínio atingiram o
estado de migração global.

/createglobalobjects Cria os objetos e as configurações globais no AD DS


usados pela Replicação do DFS. As únicas situações em
que deverá usar essa opção para criar manualmente
objetos e configurações são:
Um novo controlador de domínio somente
leitura é promovido durante a migração. Se um
novo controlador de domínio somente leitura for
promovido no domínio depois de migrar para o
estado Preparado, mas antes da migração para o
estado Eliminado, os objetos que correspondem
ao novo controlador de domínio não serão
criados, fazendo com que a replicação e a
migração falhem.
As configurações globais do serviço de
Replicação do DFS estão ausentes ou foram
excluídas. Se essas configurações estiverem
ausentes para um controlador de domínio, a
migração do estado Iniciar para o estado
Preparado será interrompida no estado
Preparando transição. Observação: como as
configurações globais do AD DS para o serviço de
Replicação do DFS para um controlador de
domínio somente leitura são criadas no emulador
do PDC, essas configurações precisam ser
replicadas para o controlador de domínio somente
leitura do emulador do PDC, antes que o serviço
de Replicação do DFS no controlador de domínio
somente leitura possa usar essas configurações.
Devido às latências de replicação do Active
Directory, essa replicação pode levar algum tempo
para ocorrer.
Parâmetro Descrição

/deleterontfrsmember Exclui as configurações globais do AD DS para replicação


[<read_only_domain_controller_name>] do FRS que correspondem ao controlador de domínio
somente leitura especificado ou exclui as configurações
globais do AD DS para replicação do FRS para todos os
controladores de domínio somente leitura se nenhum
valor for especificado para
<read_only_domain_controller_name> .

Não use essa opção durante um processo de migração


normal, pois o serviço de Replicação do DFS exclui
automaticamente essas configurações do AD DS durante
a migração do estado Redirecionado para o estado
Eliminado. Use essa opção para excluir manualmente as
configurações do AD DS somente quando a exclusão
automática falhar em um controlador de domínio
somente leitura e parar o controlador de domínio
somente leitura por um longo tempo durante a
migração do estado Redirecionado para o estado
Eliminado.

/deleterodfsrmember Exclui as configurações globais do AD DS para


[<read_only_domain_controller_name>] Replicação do DFS que correspondem ao controlador de
domínio somente leitura especificado ou exclui as
configurações globais do AD DS para replicação do DFS
para todos os controladores de domínio somente leitura
se nenhum valor for especificado para
<read_only_domain_controller_name> .

Use essa opção para excluir manualmente as


configurações do AD DS somente quando a exclusão
automática falhar em um controlador de domínio
somente leitura e parar o controlador de domínio
somente leitura por um longo tempo ao reverter a
migração do estado Preparado para o estado Inicial.

/? Exibe a ajuda no prompt de comando.

Comentários
Use o comando /setglobalstate <state> para definir o estado de migração global
no AD DS no emulador do PDC para iniciar e controlar o processo de migração. Se
o emulador do PDC não estiver disponível, esse comando falhará.

A migração para o estado Eliminado é irreversível e a reversão não é possível,


portanto, use um valor de 3 para o estado somente quando você estiver
totalmente comprometido em usar a Replicação do DFS para replicação do SYSvol.
Os estados de migração global devem ser um estado de migração estável.

A replicação do Active Directory replica o estado global para outros controladores


de domínio no domínio, mas devido a latências de replicação, é possível obter
inconsistências se executar dfsrmig /getglobalstate em um controlador de
domínio diferente do emulador do PDC.

A saída de dfsrmig /getmigrationstate indica se a migração para o estado global


atual está concluída, listando o estado de migração local para controladores de
domínio que ainda não atingiram o estado de migração global atual. O estado de
migração local para controladores de domínio também pode incluir estados de
transição para controladores de domínio que não atingiram o estado de migração
global atual.

Os controladores de domínio somente leitura não podem excluir as configurações


do AD DS, o emulador do PDC executa essa operação e as alterações
eventualmente são replicadas para os controladores de domínio somente leitura
após as latências aplicáveis para replicação do Active Directory.

O comando dfsrmig só tem suporte em controladores de domínio executados no


nível funcional do domínio do Windows Server, pois a migração do SYSvol do FRS
para a Replicação do DFS só é possível em controladores de domínio que operam
nesse nível.

É possível executar o comando dfsrmig em qualquer controlador de domínio, mas


as operações que criam ou manipulam objetos do AD DS só são permitidas em
controladores de domínio compatíveis com leitura/gravação (não em
controladores de domínio somente leitura).

Exemplos
Para definir o estado de migração global como Preparado (1) e iniciar a migração ou
reverter do estado Preparado, digite:

dfsrmig /setglobalstate 1

Para definir o estado de migração global como Iniciar (0) e iniciar a reversão para o
estado Iniciar, digite:
dfsrmig /setglobalstate 0

Para exibir o estado de migração global, digite:

dfsrmig /getglobalstate

Saída do comando dfsrmig /getglobalstate :

Current DFSR global state: Prepared


Succeeded.

Para exibir informações sobre se os estados de migração local em todos os


controladores de domínio correspondem ao estado de migração global e se há algum
estado de migração local em que o estado local não corresponde ao estado global,
digite:

dfsrmig /GetMigrationState

Saída do comando dfsrmig /getmigrationstate quando os estados de migração local


em todos os controladores de domínio correspondem ao estado de migração global:

All Domain Controllers have migrated successfully to Global state


(Prepared).
Migration has reached a consistent state on all Domain Controllers.
Succeeded.

Saída do comando dfsrmig /getmigrationstate quando os estados de migração local


em alguns controladores de domínio não correspondem ao estado de migração global.

The following Domain Controllers are not in sync with Global state
(Prepared):
Domain Controller (Local Migration State) DC type
=========
CONTOSO-DC2 (start) ReadOnly DC
CONTOSO-DC3 (Preparing) Writable DC
Migration has not yet reached a consistent state on all domain controllers
State information might be stale due to AD latency.

Para criar os objetos globais e as configurações que a Replicação do DFS usa no AD DS


em controladores de domínio em que essas configurações não foram criadas
automaticamente durante a migração ou onde essas configurações estão ausentes,
digite:

dfsrmig /createglobalobjects

Para excluir as configurações globais do AD DS para replicação do FRS para um


controlador de domínio somente leitura chamado contoso-dc2, se essas configurações
não foram excluídas automaticamente pelo processo de migração, digite:

dfsrmig /deleterontfrsmember contoso-dc2

Para excluir as configurações globais do AD DS para replicação do FRS para todos os


controladores de domínio somente leitura, se essas configurações não foram excluídas
automaticamente pelo processo de migração, digite:

dfsrmig /deleterontfrsmember

Para excluir as configurações globais do AD DS para Replicação do DFS para um


controlador de domínio somente leitura chamado contoso-dc2, se essas configurações
não foram excluídas automaticamente pelo processo de migração, digite:

dfsrmig /deleterodfsrmember contoso-dc2

Para excluir as configurações globais do AD DS para Replicação do DFS para todos os


controladores de domínio somente leitura, se essas configurações não foram excluídas
automaticamente pelo processo de migração, digite:
dfsrmig /deleterodfsrmember

Para exibe a ajuda no prompt de comando:

dfsrmig

dfsrmig /?

Links relacionados
Chave da sintaxe de linha de comando

Série de Migração SYSvol: Parte 2 – dfsrmig.exe: a ferramenta de migração


SYSvol

Active Directory Domain Services


diantz
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Empacote os arquivos existentes em um arquivo de gabinete (.cab). Esse comando


executa as mesmas ações que o comando makecab atualizado.

Sintaxe

diantz [/v[n]] [/d var=<value> ...] [/l <dir>] <source> [<destination>]


diantz [/v[<n>]] [/d var=<value> ...] /f <directives_file> [...]

Parâmetros

Parâmetro Descrição

<source> Arquivo a ser compactado.

<destination> Nome do arquivo a ser dado ao arquivo compactado. Se omitido, o último


caractere do nome do arquivo de origem será substituído por um
sublinhado (_) e usado como o destino.

/f Um arquivo com as diretivas diantz (pode ser repetido).


<directives_file>

/d var= <value> Define a variável com o valor especificado.

/l <dir> Local para colocar o destino (o padrão é o diretório atual).

/v[ <n> ] Defina o nível de detalhamento de depuração (0=none,...,3=full).

/? Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando

Formato do Microsoft Cabinet


dir
Artigo • 12/04/2023

Exibe uma lista de arquivos e subdiretórios de um diretório. Se usado sem parâmetros,


esse comando exibirá o rótulo de volume e o número de série do disco, seguido por
uma lista de diretórios e arquivos no disco (incluindo seus nomes e a data e hora em
que cada um foi modificado pela última vez). Para arquivos, esse comando exibe a
extensão de nome e o tamanho em bytes. Esse comando também exibe o número total
de arquivos e diretórios listados, seu tamanho acumulativo e o espaço livre (em bytes)
restantes no disco.

O comando dir também pode ser executado no Console de Recuperação do Windows,


usando parâmetros diferentes. Para obter mais informações, consulte WinRE (Ambiente
de Recuperação do Windows).

Sintaxe

dir [<drive>:][<path>][<filename>] [...] [/p] [/q] [/w] [/d] [/a[[:]


<attributes>]][/o[[:]<sortorder>]] [/t[[:]<timefield>]] [/s] [/b] [/l] [/n]
[/x] [/c] [/4] [/r]

Parâmetros

Parâmetro Descrição

[<drive>:] Especifica a unidade e o diretório para o qual queira visualizar uma listagem.
[<path>]

[<filename>] Especifica um determinado arquivo ou grupo de arquivos para o qual queira


visualizar uma listagem.

/p Exibe uma tela da listagem por vez. Para ver a próxima tela, pressione
qualquer tecla.

/q Exibe informações de propriedade do arquivo.

/w Exibe a listagem em formato largo, com até cinco nomes de arquivo ou


nomes de diretório em cada linha.

/d Exibe a listagem no mesmo formato que /w, mas os arquivos são


classificados por coluna.
Parâmetro Descrição

/a[[:] <attributes> ] Exibe apenas os nomes desses diretórios e arquivos com os atributos
determinados. Caso não use esse parâmetro, o comando exibirá os nomes
de todos os arquivos, exceto arquivos ocultos e do sistema. Caso use esse
parâmetro sem especificar nenhum atributo, o comando exibirá os nomes de
todos os arquivos, incluindo arquivos ocultos e do sistema. A lista de
possíveis valores de atributos é:

d – Diretórios
h – Arquivos ocultos
s – Arquivos do sistema
a – Pontos de nova análise
r – Arquivos somente leitura
a – Arquivos prontos para arquivamento
i – Arquivos sem conteúdo indexado

Use qualquer combinação desses valores, mas não separe os valores usando
espaços. Opcionalmente, use dois-pontos (:) separador ou use um hífen (-)
como um prefixo para significar, "não". Por exemplo, usar o atributo -s não
mostrará os arquivos do sistema.

/o[[:] <sortorder> ] Classifica a saída de acordo com sortorder, que pode ser qualquer
combinação dos seguintes valores:

n – Alfabeticamente por nome


e – Alfabético por extensão
g – Diretórios de grupo primeiro
s – Por tamanho, o menor primeiro
d – Por data/hora, a primeira mais antiga
Usar o prefixo - para reverter a ordem de classificação

Vários valores são processados na ordem em que você os lista. Não separe
vários valores com espaços, mas, opcionalmente, use dois-pontos (:).

Se sortorder não for especificado, o dir /o listará os diretórios em ordem


alfabética, seguidos pelos arquivos, que também são classificados em ordem
alfabética.

/t[[:] <timefield> ] Especifica qual campo de tempo exibir ou usar para classificação. Os valores
de timefield disponíveis são:

c – Criação
a – Acessado por Último
w – Última gravação

/s Lista todas as ocorrências do nome de arquivo determinado no diretório


especificado e em todos os subdiretórios.
Parâmetro Descrição

/b Exibe uma lista de diretórios e arquivos sem informações adicionais. O


parâmetro /b substitui /w.

/l Exibe nomes de diretórios e nomes de arquivo não classificados, usando


letras minúsculas.

/n Exibe um formato de lista longa com nomes de arquivo na extrema direita


da tela.

/x Exibe os nomes curtos gerados para nomes de arquivo não 8dot3. A


exibição é igual à exibição de /n, mas o nome curto é inserido antes do
nome longo.

/c Exibe o separador de milhar em tamanhos de arquivo. Esse é o


comportamento padrão. Use /-c para ocultar separadores.

/4 Exibe anos no formato de quatro dígitos.

/r Exibir fluxos de dados alternativos do arquivo.

/? Exibe a ajuda no prompt de comando.

Comentários
Para usar vários parâmetros de nome de arquivo, separe cada nome de arquivo
com um espaço, vírgula ou ponto e vírgula.

Use os caracteres curinga (* ou ?), para representar um ou mais caracteres de um


nome de arquivo e para exibir um subconjunto de arquivos ou subdiretórios.

Use o caractere curinga, *, para substituir qualquer cadeia de caracteres, por


exemplo:

dir *.txt lista todos os arquivos no diretório atual com extensões que

começam com .txt, como .txt, .txt1 .txt_old.

dir read *.txt lista todos os arquivos no diretório atual que iniciam com

leitura e com extensões que iniciam com .txt, como .txt, .txt1 .txt_old.

dir read *.* lista todos os arquivos no diretório atual que iniciam com leitura

com qualquer extensão.

O curinga asterisco sempre usa o mapeamento de nome de arquivo curto,


portanto, talvez pode obter resultados inesperados. Por exemplo, o diretório a
seguir contém dois arquivos (t.txt2 e t97.txt):
C:\test>dir /x
Volume in drive C has no label.
Volume Serial Number is B86A-EF32

Directory of C:\test

11/30/2004 01:40 PM <DIR> .


11/30/2004 01:40 PM <DIR> ..
11/30/2004 11:05 AM 0 T97B4~1.TXT t.txt2
11/30/2004 01:16 PM 0 t97.txt

Espere que a digitação dir t97\* retorne o arquivo t97.txt. No entanto, digitar dir
t97\* retorna ambos os arquivos, pois o curinga do asterisco corresponde ao

arquivo t.txt2 para t97.txt usando seu mapa de nome curto T97B4~1.TXT. Da
mesma forma, digitar del t97\* excluiria ambos os arquivos.

Use o ponto de interrogação (?) como um substituto para um único caractere em


um nome. Por exemplo, digitar dir read???.txt lista todos os arquivos no
diretório atual com a extensão .txt que iniciam com leitura e são seguidos por até
três caracteres. Isso inclui Read.txt, Read1.txt, Read12.txt, Read123.txt e
Readme1.txt, mas não Readme12.txt.

Use /a com mais de um valor em atributos, esse comando exibirá os nomes apenas
desses arquivos com todos os atributos especificados. Por exemplo, caso use /a
com atributos r e -h como (usando /a:r-h ou /ar-h ), esse comando exibirá
apenas os nomes dos arquivos somente leitura que não estão ocultos.

Caso especifique mais de um valor de sortorder, esse comando classificará os


nomes de arquivo pelo primeiro critério, depois pelo segundo critério e assim por
diante. Por exemplo, caso use /o com os parâmetros e e -s para sortorder (usando
/o:e-s ou /oe-s ), esse comando classificará os nomes de diretórios e arquivos por

extensão, com o maior primeiro e exibirá o resultado final. A classificação


alfabética por extensão faz com que nomes de arquivo sem extensões apareçam
primeiro, depois nomes de diretório e, em seguida, nomes de arquivo com
extensões.

Caso use o símbolo de redirecionamento ( > ) para enviar a saída desse comando
para um arquivo ou caso use um pipe ( | ) para enviar a saída desse comando para
outro comando, deverá usar /a:-d e /b para listar apenas os nomes de arquivo.
Use o filename com /b e /s para especificar que esse comando é pesquisar o
diretório atual e seus subdiretórios em busca de todos os nomes de arquivo que
correspondam ao nome do arquivo. Esse comando lista apenas a letra da unidade,
o nome do diretório, o nome do arquivo e a extensão de nome de arquivo (um
caminho por linha) para cada nome de arquivo encontrado. Antes de usar um pipe
para enviar a saída desse comando para outro comando, defina a variável de
ambiente TEMP no arquivo Autoexec.nt.

Exemplos
Para exibir todos os diretórios um após o outro, em ordem alfabética, em formato largo
e pausando após cada tela, verifique se o diretório raiz é o diretório atual e digite:

dir /s/w/o/p

A saída lista o diretório raiz, os subdiretórios e os arquivos no diretório raiz, incluindo


extensões. Esse comando também lista os nomes de subdiretório e os nomes de
arquivo em cada subdiretório na árvore.

Para alterar o exemplo anterior para que dir exiba os nomes de arquivo e extensões,
mas omita os nomes de diretório, digite:

dir /s/w/o/p/a:-d

Para imprimir uma listagem de diretório, digite:

dir > prn

Ao especificar prn, a lista de diretórios é enviada para a impressora anexada à porta


LPT1. Se a impressora estiver anexada a uma porta diferente, você deverá substituir prn
pelo nome da porta correta.

Você também pode redirecionar a saída do comando dir para um arquivo substituindo
prn por um nome de arquivo. Você também pode digitar um caminho. Por exemplo,
para direcionar a saída dir para o arquivo dir.doc no diretório Registros, digite:

dir > \records\dir.doc


Se dir.doc não existir, o dir o criará, a menos que o diretório Registros não exista. Nesse
caso, a seguinte mensagem é exibida:

File creation error

Para exibir uma lista de todos os nomes de arquivo com a extensão .txt em todos os
diretórios na unidade C, digite:

dir c:\*.txt /w/o/s/p

O comando dir exibe, em formato largo, uma lista alfabética dos nomes de arquivo
correspondentes em cada diretório e pausa cada vez que a tela é preenchida até que é
pressionado qualquer tecla para continuar.

Links relacionados
Chave da sintaxe de linha de comando
diskcomp
Artigo • 10/04/2023

Compara o conteúdo de dois disquetes. Se usado sem parâmetros, diskcomp usará a


unidade atual para comparar os dois discos.

Sintaxe

diskcomp [<drive1>: [<drive2>:]]

Parâmetros

Parâmetro Descrição

<drive1> Especifica a unidade que contém um dos disquetes.

/? Exibe a ajuda no prompt de comando.

Comentários

O comando diskcomp funciona apenas com disquetes. Não é possível usar


diskcomp com um disco rígido. Caso você especifique uma unidade de disco
rígido para drive1 ou drive2, diskcomp exibirá a seguinte mensagem de erro:

Invalid drive specification


Specified drive does not exist
or is nonremovable

Se todas as faixas nos dois discos que estão sendo comparados forem iguais (ele
ignora o número de volume de um disco), diskcomp exibirá a seguinte mensagem:

Compare OK
Se as faixas não forem iguais, diskcomp exibirá uma mensagem semelhante à
seguinte:

Compare error on
side 1, track 2

Quando diskcomp conclui a comparação, ele exibe a seguinte mensagem:

Compare another diskette (Y/N)?

Se você pressionar Y, diskcomp solicitará que você insira o disco para a próxima
comparação. Se você pressionar N, diskcomp interromperá a comparação.

Se você omitir o parâmetro drive2, diskcomp usará a unidade atual como drive2.
Caso você omita os dois parâmetros de unidade, diskcomp usará a unidade atual
para ambos. Se a unidade atual for a mesma que drive1, diskcomp solicitará que
você troque os discos conforme necessário.

Se você especificar a mesma unidade de disquete para drive1 e drive2, diskcomp


as comparará usando uma unidade e solicitará que você insira os discos conforme
necessário. Talvez seja necessário trocar os discos mais de uma vez dependendo
da capacidade dos discos e da quantidade de memória disponível.

Diskcomp não pode comparar um disco de lado único com um disco de dois lados
nem um disco de alta densidade com um disco de densidade dupla. Se o disco em
drive1 não for do mesmo tipo que o disco em drive2, diskcomp exibirá a seguinte
mensagem:

Drive types or diskette types not compatible

Diskcomp não funciona em uma unidade de rede nem em uma unidade criada
pelo comando subst. Se você tentar usar diskcomp com uma unidade de qualquer
um desses tipos, diskcomp exibirá a seguinte mensagem de erro:

Invalid drive specification


Se você usar diskcomp com um disco que você fez usando copy, diskcomp
poderá exibir uma mensagem semelhante à seguinte:

Compare error on
side 0, track 0

Esse tipo de erro pode ocorrer mesmo que os arquivos nos discos sejam idênticos.
Embora copy duplique informações, ele não necessariamente as coloca no mesmo
local no disco de destino.

Códigos de saída de diskcomp:

Código de saída Descrição

0 Os discos são iguais

1 Diferenças foram encontradas

3 Ocorreu um erro grave

4 Ocorreu um erro de inicialização

Para processar os códigos de saída retornados por diskcomp, use a variável de


ambiente ERRORLEVEL na linha de comando if em um programa de lote.

Exemplos
Se o computador tiver apenas uma unidade de disquete (por exemplo, unidade A) e
você quiser comparar dois discos, digite:

diskcomp a: a:

Diskcomp solicitará que você insira cada disco, conforme necessário.

Para ilustrar como processar um código de saída de diskcomp em um programa de lote


que usa a variável de ambiente ERRORLEVEL na linha de comando if:

rem Checkout.bat compares the disks in drive A and B


echo off
diskcomp a: b:
if errorlevel 4 goto ini_error
if errorlevel 3 goto hard_error
if errorlevel 1 goto no_compare
if errorlevel 0 goto compare_ok
:ini_error
echo ERROR: Insufficient memory or command invalid
goto exit
:hard_error
echo ERROR: An irrecoverable error occurred
goto exit
:break
echo You just pressed CTRL+C to stop the comparison
goto exit
:no_compare
echo Disks are not the same
goto exit
:compare_ok
echo The comparison was successful; the disks are the same
goto exit
:exit

Links relacionados
Chave da sintaxe de linha de comando
diskcopy
Artigo • 12/04/2023

Copia o conteúdo do disquete na unidade de origem para um disquete formatado ou


não formatado na unidade de destino. Se usado sem parâmetros, o diskcopy usa a
unidade atual para o disco de origem e o disco de destino.

Sintaxe

diskcopy [<drive1>: [<drive2>:]] [/v]

Parâmetros

Parâmetro Descrição

<drive1> Especifica a unidade que contém o disco de origem.

/v Verifica se as informações foram copiadas corretamente. Essa opção retarda o


processo de cópia.

/? Exibe a ajuda no prompt de comando.

Comentários
O diskcopy funciona apenas com discos removíveis, como disquetes, que devem
ser do mesmo tipo. Não é possível usar o diskcopy com um disco rígido. Caso
especifique uma unidade de disco rígido para drive1 ou drive2, o diskcopy exibirá
a seguinte mensagem de erro:

Invalid drive specification


Specified drive does not exist or is nonremovable

O comando diskcopy solicita que você insira os discos de origem e destino e


aguarda que você pressione qualquer tecla no teclado antes de continuar.

Depois de copiar o disco, o diskcopy exibe a seguinte mensagem:


Copy another diskette (Y/N)?

Caso pressione Y, o diskcopy solicitará que você insira discos de origem e destino
para a próxima operação de cópia. Para interromper o processo do diskcopy,
pressione N.

Caso esteja copiando para um disquete não formatado na unidade2, o diskcopy


formata o disco com o mesmo número de lados e setores por faixa que estão no
disco na unidade1. O diskcopy exibe a seguinte mensagem enquanto formata o
disco e copia os arquivos:

Formatting while copying

Se o disco de origem tiver um número de série de volume, o diskcopy criará um


novo número de série de volume para o disco de destino e exibirá o número
quando a operação de cópia for concluída.

Caso omita o parâmetro drive2, o diskcopy usará a unidade atual como a unidade
de destino. Caso omita os dois parâmetros de unidade, o diskcopy usará a
unidade atual para ambos. Se a unidade atual for a mesma que drive1, o diskcopy
solicitará que você troque os discos conforme necessário.

Execute o diskcopy de uma unidade diferente da unidade de disquete, por


exemplo, a unidade C. Se a unidade de disquete de drive1 e a unidade de disquete
de drive2 forem iguais, o diskcopy solicitará que você alterne os discos. Se os
discos contiverem mais informações do que a memória disponível pode conter, o
diskcopy não poderá ler todas as informações de uma só vez. O diskcopy lê do
disco de origem, grava no disco de destino e solicita que insira o disco de origem
novamente. Esse processo continua até que você tenha copiado todo o disco.

Fragmentação é a presença de pequenas áreas de espaço em disco não utilizado


entre arquivos existentes em um disco. Um disco de origem fragmentado pode
retardar o processo de localização, leitura ou gravação de arquivos.

Como o diskcopy faz uma cópia exata do disco de origem no disco de destino,
qualquer fragmentação no disco de origem é transferida para o disco de destino.
Para evitar a transferência de fragmentação de um disco para outro, use o
comando copy ou o comando xcopy para copiar o disco. Como copy e xcopy
arquivos de cópia em sequência, o novo disco não é fragmentado.
7 Observação

Não é possível usar xcopy para copiar um disco de inicialização.

Códigos de saída do diskcopy:

Código de saída Descrição

0 A operação de cópia foi realizada com êxito

1 Erro de leitura/gravação não fatal

3 Ocorreu um erro fatal

4 Ocorreu um erro de inicialização

Para processar os códigos de saída retornados pelo diskcomp, use a variável de


ambiente ERRORLEVEL na linha de comando if em um programa em lotes.

Exemplos
Para copiar o disco na unidade B para o disco na unidade A, digite:

diskcopy b: a:

Para usar a unidade de disquete A para copiar um disquete para outro, primeiro alterne
para a unidade C e digite:

diskcopy a: a:

Links relacionados
Chave da sintaxe de linha de comando

Comando xcopy

Comando copy
diskpart
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows 10, Windows 8.1, Windows 8, Windows
7, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows
Server 2012 e Windows Server 2008 R2, Windows Server 2008

O interpretador de comando diskpart ajuda você a gerenciar as unidades do


computador (discos, partições, volumes ou discos rígidos virtuais).

Antes de usar os comandos diskpart, você deve primeiro listar e selecionar um objeto
para focalizar. Depois que um objeto estiver focalizado, todos os comandos diskpart
digitados atuarão nesse objeto.

Determinar o foco
Quando você seleciona um objeto, o foco permanece nesse objeto até que você
selecione um objeto diferente. Por exemplo, se o foco estiver definido no disco 0 e você
selecionar o volume 8 no disco 2, o foco mudará do disco 0 para o disco 2, volume 8.

Alguns comandos alteram o foco automaticamente. Por exemplo, quando você cria uma
nova partição, o foco alterna automaticamente para a nova partição.

Você só pode focalizar uma partição no disco selecionado. Depois que uma partição
estiver focalizada, o volume relacionado (se houver) também será focalizado. Depois
que um volume for focalizado, o disco e a partição relacionados também serão
focalizados se o volume for mapeado para uma única partição específica. Se esse não
for o caso, o foco no disco e na partição será perdido.

Syntax
Para iniciar o interpretador de comando diskpart, no tipo de prompt de comando:

Prompt de comando do Windows

diskpart <parameter>

) Importante
Você deve estar em seu grupo de Administradores local ou em um grupo com
permissões semelhantes para executar o diskpart.

Parâmetros
Você pode executar os seguintes comandos no interpretador de comando Diskpart:

Comando Descrição

active Marca a partição do disco com foco como ativa.

adicionar Espelha o volume simples com foco no disco especificado.

assign Atribui uma letra da unidade ou ponto de montagem ao volume com foco.

attach Anexa (às vezes chamado de montagens ou superfícies) um VHD (disco rígido
vdisk virtual) para que ele apareça no computador host como uma unidade de disco
rígido local.

attributes Exibe, define ou limpa os atributos de um disco ou volume.

automount Habilita ou desabilita o recurso de desmontagem automática.

break Divide o volume espelhado com foco em dois volumes simples.

clean Remove toda e qualquer partição ou formatação de volume do disco com foco.

compact Reduz o tamanho físico de um arquivo VHD (disco rígido virtual) em expansão
vdisk dinâmica.

convert Converte volumes FAT (tabela de alocação de arquivos) e FAT32 para o sistema de
arquivos NTFS, deixando arquivos e diretórios existentes intactos.

create Cria uma partição em um disco, um volume em um ou mais discos ou um VHD


(disco rígido virtual).

delete Exclui uma partição ou um volume.

detach Impede que o VHD (disco rígido virtual) selecionado apareça como uma unidade de
vdisk disco rígido local no computador host.

detail Exibe informações sobre o disco, a partição, o volume ou o VHD (disco rígido
virtual) selecionado.

exit Sai do interpretador de comando diskpart.

expand Expande um VHD (disco rígido virtual) para o tamanho especificado.


vdisk
Comando Descrição

extend Estende o volume ou a partição com foco, juntamente com seu sistema de arquivos,
no espaço livre (não alocado) de um disco.

filesystems Exibe informações sobre o sistema de arquivos atual do volume com foco e lista os
sistemas de arquivos com suporte para formatação do volume.

format Formata um disco para aceitar arquivos.

gpt Aloca os atributos gpt à partição com foco em discos básicos da tabela de partição
GUID (gpt).

help Exibe uma lista dos comandos disponíveis ou informações detalhadas de ajuda em
um comando especificado.

import Importa um grupo de discos estrangeiros para o grupo de discos do computador


local.

inactive Marca a partição do sistema ou a partição de inicialização com foco como inativo
em discos MBR (registro mestre de inicialização) básicos.

list Exibe uma lista de discos, de partições em um disco, de volumes em um disco ou de


VHDs (discos rígidos virtuais).

merge Mescla um VHD (disco rígido virtual) diferente com seu VHD pai correspondente.
vdisk

offline Leva um disco ou volume online para o estado offline.

online Leva um disco ou volume offline para o estado online.

recover Atualiza o estado de todos os discos em um grupo de discos, tenta recuperar discos
em um grupo de disco inválido e ressincroniza volumes espelhados e volumes
RAID-5 com dados obsoletos.

rem Fornece uma maneira de adicionar comentários a um script.

remove Remove uma letra da unidade ou um ponto de montagem de um volume.

repair Repara o volume RAID-5 com foco substituindo a região do disco com falha pelo
disco dinâmico especificado.

rescan Localiza novos discos que podem ter sido adicionados ao computador.

retain Prepara um volume simples dinâmico existente para ser usado como um volume de
inicialização ou sistema.

san Exibe ou define a política de SAN (rede de área de armazenamento) para o sistema
operacional.
Comando Descrição

select Mudam o foco para um disco, uma partição, um volume ou um VHD (disco rígido
virtual).

set id Altera o campo Tipo de partição para a partição com foco.

shrink Reduz o tamanho do volume selecionado pela quantidade especificada.

uniqueid Exibe ou define o identificador da tabela de partição GUID (GPT) ou a assinatura


MBR (registro mestre de inicialização) para o disco com foco.

Listagem de objetos disponíveis


Você pode exibir uma lista de opções associadas a cada comando executando o
comando principal seguido pelo que está disponível para esse comando específico. A
lista em execução só exibirá os quatro parâmetros abaixo:

7 Observação

Depois de executar o comando list, um asterisco (*) aparece ao lado do objeto


focalizado.

Exemplos
Para ver os discos disponíveis, execute list disk:

Prompt de comando do Windows

list disk

Para selecionar um disco, execute select disk seguido pelo número do disco. Por
exemplo:

Prompt de comando do Windows

select disk 1

Antes que o disco 1 possa ser utilizado, uma partição precisará ser criada executando
create partition primary:

Prompt de comando do Windows

create partition primary

Por fim, podemos executar um formato rápido do disco 1 para o NTFS com o rótulo
"Backup" executando format fs=ntfs label=Backup quick, conforme exibido abaixo:

Prompt de comando do Windows

format fs=ntfs label=Backup quick


Links relacionados
Chave da sintaxe de linha de comando

Visão geral do gerenciamento de disco

Cmdlets de armazenamento no Windows PowerShell


diskperf
Artigo • 17/04/2023

O comando diskperf habilita ou desabilita remotamente os contadores de desempenho


de disco físico ou lógico em computadores que executam o Windows.

Syntax

diskperf [-y[d|v] | -n[d|v]] [\\computername]

Opções
Opção Descrição

-y Inicia todos os contadores de desempenho de disco quando o computador é


reiniciado.

-yd Habilita os contadores de desempenho de disco para unidades físicas quando o


computador é reiniciado.

-yv Habilita os contadores de desempenho de disco para unidades lógicas ou


volumes de armazenamento quando o computador é reiniciado.

-n Desabilita todos os contadores de desempenho de disco quando o computador


é reiniciado.

-nd Desabilita os contadores de desempenho de disco para unidades físicas quando


o computador é reiniciado.

-nv Desabilita os contadores de desempenho de disco para unidades lógicas ou


volumes de armazenamento quando o computador é reiniciado.

\\ Especifica o nome do computador no qual você deseja habilitar ou desabilitar


<computername> contadores de desempenho de disco.

-? Exibe uma ajuda contextual.

Links relacionados
Chave da sintaxe de linha de comando
Diskraid
Artigo • 11/04/2023

Diskraid é uma ferramenta de linha de comando que permite configurar e gerenciar a


matriz redundante de subsistemas de armazenamento em disco (RAID) independentes
(ou baratos).

O RAID normalmente é usado em servidores para padronizar e categorizar sistemas de


disco tolerantes a falhas. Os níveis de RAID fornecem várias combinações de
desempenho, confiabilidade e custo. Alguns servidores fornecem três dos níveis RAID:
Nível 0 (distribuição), Nível 1 (espelhamento) e Nível 5 (distribuição com paridade).

Um subsistema RAID de hardware distingue unidades de armazenamento fisicamente


endereçáveis umas das outras usando um LUN (Número de Unidade Lógica). Um objeto
LUN deve ter pelo menos um plex e pode ter qualquer número de plexes adicionais.
Cada plex contém uma cópia dos dados no objeto LUN. Os plexes podem ser
adicionados e removidos de um objeto LUN.

A maioria dos comandos Diskraid opera em uma porta HBA (adaptador de barramento
de host), adaptador iniciador, portal iniciador, provedor, subsistema, controlador, porta,
unidade, LUN, portal de destino, destino ou grupo de portais de destino específico. Use
o comando SELECT para selecionar um objeto. Diz-se que o objeto selecionado tem
foco. O foco simplifica tarefas comuns de configuração, como a criação de vários LUNs
no mesmo subsistema.

7 Observação

A ferramenta de linha de comando Diskraid funciona apenas com subsistemas de


armazenamento que dão suporte ao VDS (Serviço de Disco Virtual).

Comandos Diskraid
Os comandos a seguir estão disponíveis na ferramenta Diskraid.

add
Adiciona um LUN existente ao LUN selecionado no momento ou adiciona um portal de
destino iSCSI ao grupo de portais de destino iSCSI selecionado no momento.
Sintaxe

add plex lun=n [noerr]


add tpgroup tportal=n [noerr]

Parâmetros

Parâmetro Descrição

plex lun= Especifica o número LUN a ser adicionado como um plex ao LUN selecionado no
<n> momento. ATENÇÃO: todos os dados no LUN que estão sendo adicionados como
um plex serão excluídos.

tpgroup Especifica o número do portal de destino iSCSI a ser adicionado ao grupo de


tportal= <n> portais de destino iSCSI selecionado no momento.

noerr Somente para scripts. Quando um erro é encontrado, o Diskraid continua a


processar os comandos como se o erro não tivesse ocorrido.

associate
Define a lista especificada de portas do controlador como ativa para o LUN selecionado
no momento (outras portas do controlador são desativadas) ou adiciona as portas do
controlador especificadas à lista de portas de controlador ativas existentes para o LUN
selecionado no momento ou associa o destino iSCSI especificado para o LUN
selecionado no momento.

Sintaxe

associate controllers [add] <n>[,<n> [,…]]


associate ports [add] <n-m>[,<n-m>[,…]]
associate targets [add] <n>[,<n> [,…]]

Parâmetros

Parâmetro Descrição

controlador Adiciona ou substitui a lista de controladores associados ao LUN selecionado no


momento. Use somente com provedores VDS 1.0.
Parâmetro Descrição

ports Adiciona ou substitui a lista de portas do controlador associadas ao LUN


selecionado no momento. Use somente com provedores VDS 1.1.

destinos Adiciona ou substitui a lista de destinos iSCSI associados ao LUN selecionado no


momento. Use somente com provedores VDS 1.1.

add Se estiver usando provedores VDS 1.0: adiciona os controladores especificados à


lista existente de controladores associados ao LUN. Se esse parâmetro não for
especificado, a lista de controladores substituirá a lista existente de controladores
associados a esse LUN.

Se estiver usando provedores VDS 1.1: adiciona as portas de controlador


especificadas à lista existente de portas de controlador associadas ao LUN. Se esse
parâmetro não for especificado, a lista de portas de controlador substituirá a lista
existente de portas de controlador associadas a esse LUN.

<n>[,<n> Use com o parâmetro controllers ou targets. Especifica os números dos


[, ...]] controladores ou destinos iSCSI a serem definidos como ativos ou associados.

<n-m>[,<n- Use com o parâmetro ports. Especifica as portas do controlador a serem definidas
m>[,…]] como ativas usando um par de números de controlador (n) e porta (m).

Exemplo
Para associar e adicionar portas a um LUN que usa um provedor VDS 1.1:

DISKRAID> SEL LUN 5


LUN 5 is now the selected LUN.

DISKRAID> ASSOCIATE PORTS 0-0,0-1


Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1)

DISKRAID> ASSOCIATE PORTS ADD 1-1


Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1,
Ctlr 1 Port 1)

automagic
Define ou limpa sinalizadores que dão dicas aos provedores sobre como configurar um
LUN. Usada sem parâmetros, a operação automagic exibe uma lista de sinalizadores.
Sintaxe

automagic {set | clear | apply} all <flag=value> [<flag=value> [...]]

Parâmetros

Parâmetro Descrição

set Define os sinalizadores especificados para os valores especificados.

clear Limpa os sinalizadores especificados. A palavra-chave all limpa todos os


sinalizadores automagic.

aplicar Aplica os sinalizadores atuais ao LUN selecionado.

<flag> Os sinalizadores são identificados por acrônimos de três letras, incluindo:


FCR – Recuperação Rápida de Falhas obrigatória
FTL – Tolerante a Falhas
MSR – Principalmente leituras
MXD – Máximo de unidades
MXS – Tamanho máximo esperado
ORA – Alinhamento de leitura ideal
ORS – Tamanho de leitura ideal
OSR – Otimizar para leituras sequenciais
OSR – Otimizar para gravações sequenciais
OWA – Alinhamento de gravação ideal
OWS – Tamanho de gravação ideal
RBP – Prioridade de recompilação
RBV – Verificação de Read Back Habilitada
RMP – Remapeamento Habilitado
STS – Tamanho da distribuição
WTC – cache de Write-Through habilitado
YNK - Removível

break
Remove o plex do LUN selecionado no momento. O plex e os dados contidos não são
retidos e as extensões da unidade podem ser recuperadas.

U Cuidado

Primeiro, você precisa selecionar um LUN espelhado antes de usar esse comando.
Todos os dados no plex serão excluídos. Não há garantia de que todos os dados
contidos no LUN original sejam consistentes.

Sintaxe

break plex=<plex_number> [noerr]

Parâmetros

Parâmetro Descrição

plex Especifica o número do plex a ser removido. O plex e os dados contidos não serão
retidos e os recursos usados por esse plex serão recuperados. Não há garantia de
que os dados contidos no LUN sejam consistentes. Se você quiser manter esse plex,
use o VSS (Serviço de Cópias de Sombra de Volume).

noerr Somente para scripts. Quando um erro é encontrado, o Diskraid continua a


processar os comandos como se o erro não tivesse ocorrido.

chap
Define o segredo compartilhado CHAP (Challenge Handshake Authentication Protocol)
para que os iniciadores iSCSI e os destinos iSCSI possam se comunicar uns com os
outros.

Sintaxe

chap initiator set secret=[<secret>] [target=<target>]


chap initiator remember secret=[<secret>] target=<target>
chap target set secret=[<secret>] [initiator=<initiatorname>]
chap target remember secret=[<secret>] initiator=<initiatorname>

Parâmetros

Parâmetro Descrição

initiator set Define o segredo compartilhado no serviço iniciador iSCSI local usado para
autenticação CHAP mútua quando o iniciador autentica o destino.
Parâmetro Descrição

initiator Comunica o segredo CHAP de um destino iSCSI para o serviço iniciador iSCSI
remember local para que o serviço iniciador possa usar o segredo e se autenticar no destino
durante a autenticação CHAP.

target set Define o segredo compartilhado no destino iSCSI atualmente selecionado usado
para autenticação CHAP quando o destino autentica o iniciador.

target Comunica o segredo CHAP de um iniciador iSCSI para o destino iSCSI em foco
remember atualmente para que o destino possa usar o segredo a fim de se autenticar no
iniciador durante a autenticação chap mútua.

segredo Especifica o segredo a ser usado. Se estiver vazio, o segredo será limpo.

destino Especifica um destino no subsistema selecionado no momento para associar ao


segredo. Isso é opcional durante a definição de um segredo no iniciador e deixá-
lo de fora indica que o segredo será usado em todos os destinos que ainda não
têm um segredo associado.

initiatorname Especifica um nome iSCSI do iniciador a ser associado ao segredo. Isso é opcional
durante a definição de um segredo em um destino e deixá-lo de fora indica que o
segredo será usado em todos os iniciadores que ainda não têm um segredo
associado.

create
Cria um novo destino LUN ou iSCSI no subsistema selecionado no momento ou cria um
grupo de portais de destino no destino selecionado no momento. Você pode exibir a
associação real usando o comando Diskraid list.

Sintaxe

create lun simple [size=<n>] [drives=<n>] [noerr]


create lun stripe [size=<n>] [drives=<n, n> [,...]] [stripesize=<n>]
[noerr]
create lun raid [size=<n>] [drives=<n, n> [,...]] [stripesize=<n>] [noerr]
create lun mirror [size=<n>] [drives=<n, n> [,...]] [stripesize=<n>] [noerr]
create lun automagic size=<n> [noerr]
create target name=<name> [iscsiname=<iscsiname>] [noerr]
create tpgroup [noerr]

Parâmetros
Parâmetro Descrição

simple Cria um LUN simples.

faixa Cria um LUN distribuído.

RAID Cria um LUN distribuído com paridade.

mirror Cria um LUN espelhado.

automagic Cria um LUN usando as dicas automagic atualmente em vigor. Para obter mais
informações, consulte o subcomando automagic neste artigo.

size= Especifica o tamanho total do LUN em megabytes. O parâmetro size= ou drives=


precisa ser especificado. Eles também podem ser usados juntos. Se o parâmetro
size= não for especificado, o LUN criado será o maior tamanho possível permitido
por todas as unidades especificadas.

Um provedor normalmente cria um LUN pelo menos tão grande quanto o tamanho
solicitado, mas o provedor pode ter que arredondar para o maior tamanho seguinte
em alguns casos. Por exemplo, se o tamanho for especificado como 0,99 GB e o
provedor puder alocar apenas extensões de disco GB, o LUN resultante será de 1
GB. Para especificar o tamanho usando outras unidades, use um dos seguintes
sufixos reconhecidos imediatamente após o tamanho:

B – byte
KB – kilobyte
MB – megabyte
GB – gigabyte
TB – terabyte
PB – petabyte.

drives= Especifica o drive_number para as unidades a serem usadas a fim de criar um LUN. O
parâmetro size= ou drives= precisa ser especificado. Eles também podem ser
usados juntos. Se o parâmetro size= não for especificado, o LUN criado será o
maior tamanho possível permitido por todas as unidades especificadas. Se o
parâmetro size= for especificado, os provedores selecionarão unidades na lista de
unidades especificada para criar o LUN. Os provedores tentarão usar as unidades na
ordem especificada sempre que possível.
Parâmetro Descrição

stripesize= Especifica o tamanho em megabytes de um LUN distribuição ou raid. O tamanho da


distribuição não pode ser alterado após a criação do LUN. Para especificar o
tamanho usando outras unidades, use um dos seguintes sufixos reconhecidos
imediatamente após o tamanho:

B – byte
KB – kilobyte
MB – megabyte
GB – gigabyte
TB – terabyte
PB – petabyte.

destino Cria um destino iSCSI no subsistema selecionado no momento.

name Fornece o nome amigável para o destino.

iscsiname Fornece o nome iSCSI para o destino e pode ser omitido para que o provedor gere
um nome.

tpgroup Cria um grupo de portais de destino iSCSI no destino selecionado no momento.

noerr Somente para scripts. Quando um erro é encontrado, o Diskraid continua a


processar os comandos como se o erro não tivesse ocorrido.

excluir
Exclui o LUN selecionado no momento, o destino iSCSI (desde que não haja nenhum
LUN associado ao destino iSCSI) ou o grupo de portais de destino iSCSI.

Sintaxe

delete lun [uninstall] [noerr]


delete target [noerr]
delete tpgroup [noerr]

Parâmetros

Parâmetro Descrição

lun Exclui o LUN selecionado no momento e todos os dados nele.


Parâmetro Descrição

uninstall Especifica que o disco no sistema local associado ao LUN será limpo antes que o
LUN seja excluído.

destino Exclui o destino iSCSI selecionado no momento se nenhum LUN está associado ao
destino.

tpgroup Exclui o grupo de portais de destino iSCSI selecionado no momento.

noerr Somente para scripts. Quando um erro é encontrado, o Diskraid continua a


processar os comandos como se o erro não tivesse ocorrido.

detalhes
Exibe informações detalhadas sobre o objeto selecionado atual do tipo especificado.

Sintaxe

detail {hbaport | iadapter | iportal | provider | subsystem | controller |


port | drive | lun | tportal | target | tpgroup} [verbose]

Parâmetros

Parâmetro Descrição

hbaport Lista informações detalhadas sobre a porta HBA (adaptador de barramento de


host) selecionada no momento.

iadapter Lista informações detalhadas sobre o adaptador do iniciador iSCSI selecionado no


momento.

iportal Lista informações detalhadas sobre o adaptador do iniciador iSCSI selecionado no


portal.

provider Lista informações detalhadas sobre o provedor selecionado no momento.

subsystem Lista informações detalhadas sobre o subsistema selecionado no momento.

controlador Lista informações detalhadas sobre o controlador selecionado no momento.

porta Lista informações detalhadas sobre a porta de controlador selecionada no


momento.
Parâmetro Descrição

unidade Lista informações detalhadas sobre a unidade selecionada no momento, incluindo


os LUNs que a ocupam.

lun Lista informações detalhadas sobre o LUN selecionado no momento, incluindo as


unidades contribuintes. A saída difere ligeiramente dependendo de o LUN fazer
parte de um subsistema Fibre Channel ou iSCSI. Se a lista Hosts Sem Máscara
contiver apenas um asterisco, isso significa que o LUN não tem máscara em todos
os hosts.

tportal Lista informações detalhadas sobre o portal de destino iSCSI selecionado


atualmente.

destino Lista informações detalhadas sobre o destino iSCSI selecionado atualmente.

tpgroup Lista informações detalhadas sobre o grupo de portais de destino iSCSI selecionado
atualmente.

verbose Para uso somente com o parâmetro LUN. Lista informações adicionais, incluindo
seus plexes.

dissociate
Define a lista especificada de portas do controlador como inativas para o LUN
selecionado no momento (outras portas de controlador não são afetadas) ou desassocia
a lista especificada de destinos iSCSI no LUN selecionado no momento.

Syntax

dissociate controllers <n> [,<n> [,...]]


dissociate ports <n-m>[,<n-m>[,…]]
dissociate targets <n> [,<n> [,…]]

Parâmetro

Parâmetro Descrição

controladores Remove controladores da lista de controladores associados ao LUN selecionado


no momento. Use somente com provedores VDS 1.0.

ports Remove portas de controlador da lista de portas de controlador associadas ao


LUN selecionado no momento. Use somente com provedores VDS 1.1.
Parâmetro Descrição

destinos Remove destinos da lista de destinos iSCSI associados ao LUN selecionado no


momento. Use somente com provedores VDS 1.1.

<n> [,<n> Para uso com o parâmetro controllers ou targets. Especifica os números dos
[,…]] controladores ou destinos iSCSI a serem definidos como inativos ou
desassociados.

<n-m>[,<n-m> Para uso com o parâmetro ports. Especifica as portas do controlador a serem
[,…]] definidas como inativas usando um par de números de controlador (n) e porta
(m).

Exemplo

DISKRAID> SEL LUN 5


LUN 5 is now the selected LUN.

DISKRAID> ASSOCIATE PORTS 0-0,0-1


Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1)

DISKRAID> ASSOCIATE PORTS ADD 1-1


Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1,
Ctlr 1 Port 1)

DISKRAID> DISSOCIATE PORTS 0-0,1-1


Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 1)

exit
Sai do Diskraid.

Syntax

exit

extend
Estende o LUN selecionado no momento adicionando setores ao final do LUN. Nem
todos os provedores dão suporte à extensão de LUNs. Não estende nenhum volume ou
sistemas de arquivos contidos no LUN. Depois de estender o LUN, você deve estender
as estruturas em disco associadas usando o comando DiskPart extend.

Sintaxe

extend lun [size=<LUN_size>] [drives=<drive_number>, [<drive_number>, ...]]


[noerr]

Parâmetros

Parâmetro Descrição

tamanho Especifica o tamanho em megabytes para estender o LUN. O parâmetro size= ou


<drive> precisa ser especificado. Eles também podem ser usados juntos. Se o
parâmetro size= não for especificado, o LUN será estendido pelo maior tamanho
possível permitido por todas as unidades especificadas. Se o parâmetro size= for
especificado, os provedores selecionarão unidades na lista especificada pelo
parâmetro drives= para criar o LUN. Para especificar o tamanho usando outras
unidades, use um dos seguintes sufixos reconhecidos imediatamente após o
tamanho:

B – byte
KB – kilobyte
MB – megabyte
GB – gigabyte
TB – terabyte
PB – petabyte.

drives= Especifica o <drive_number> para as unidades a serem usadas durante o uso de um


LUN. O parâmetro size= ou <drive> precisa ser especificado. Eles também podem
ser usados juntos. Se o parâmetro size= não for especificado, o LUN criado será o
maior tamanho possível permitido por todas as unidades especificadas. Os
provedores usam as unidades na ordem especificada sempre que possível.

noerr Somente para scripts. Quando um erro é encontrado, o Diskraid continua a


processar os comandos como se o erro não tivesse ocorrido.

flushcache
Limpa o cache no controlador selecionado no momento.
Syntax

flushcache controller

ajuda
Mostra uma lista de todos os comandos Diskraid.

Syntax

help

importtarget
Recupera ou define o destino de importação do VSS (Serviço de Cópias de Sombra de
Volume) atual definido para o subsistema selecionado no momento.

Syntax

importtarget subsystem [set target]

Parâmetro

Parâmetro Descrição

set target Se especificado, define o destino selecionado no momento como o destino de


importação do VSS para o subsistema selecionado no momento. Se não for
especificado, o comando recuperará o destino de importação do VSS atual definido
para o subsistema selecionado no momento.

initiator
Recupera informações sobre o iniciador iSCSI local.
Syntax

initiator

invalidatecache
Invalida o cache no controlador selecionado no momento.

Syntax

invalidatecache controller

lbpolicy
Define a política de balanceamento de carga no LUN selecionado no momento.

Sintaxe

lbpolicy set lun type=<type> [paths=<path>-{primary | <weight>}[,<path>-


{primary | <weight>}[,…]]]
lbpolicy set lun paths=<path>-{primary | <weight>}[,<path>-{primary |
<weight>}[,…]]

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

type Especifica a política de balanceamento de carga. Se o tipo não for especificado, o


parâmetro path precisará ser especificado. Tipo pode ser um dos seguintes:

FAILOVER: usa um caminho primário; os outros caminhos são caminhos de


backup.
ROUNDROBIN: usa todos os caminhos de forma round robin, que tenta cada
caminho sequencialmente.
SUBSETROUNDROBIN: usa todos os caminhos principais na forma round
robin; os caminhos de backup serão usados somente se todos os caminhos
primários falharem.
DYNLQD: usa o caminho com o menor número de solicitações ativas.

WEIGHTED: usa o caminho com o menor peso (cada caminho precisa receber
um peso).
LEASTBLOCKS: usa o caminho com o mínimo de blocos.
VENDORSPECIFIC: usa uma política específica do fornecedor.

caminho Especifica se um caminho é primário ou tem um <weight> específico. Todos os


caminhos não especificados são definidos implicitamente como backup. Todos os
caminhos listados precisam ser um dos caminhos do LUN selecionado no momento.

list
Mostra uma lista de objetos do tipo especificado.

Sintaxe

list {hbaports | iadapters | iportals | providers | subsystems | controllers


| ports | drives | LUNs | tportals | targets | tpgroups}

Parâmetros

Parâmetro Descrição

hbaports Lista informações resumidas sobre todas as portas HBA conhecidas pelo VDS. A
porta HBA selecionada no momento é marcada por um asterisco (*).

iadapters Lista informações resumidas sobre todos os adaptadores do iniciador iSCSI


conhecidos pelo VDS. O adaptador iniciador selecionado no momento é marcado
por um asterisco (*).
Parâmetro Descrição

iportals Lista informações resumidas sobre todos os portais iniciadores iSCSI no


adaptador iniciador selecionado no momento. O portal iniciador selecionado no
momento é marcado por um asterisco (*).

providers Lista informações resumidas sobre cada provedor conhecido pelo VDS. O
provedor selecionado no momento é marcado por um asterisco (*).

subsistemas Lista informações resumidas sobre cada subsistema no sistema. O subsistema


selecionado no momento é marcado por um asterisco (*).

controladores Lista informações resumidas sobre cada controlador no subsistema selecionado


no momento. O controlador selecionado no momento é marcado por um
asterisco (*).

ports Lista informações resumidas sobre cada porta de controlador no controlador


selecionado no momento. A porta selecionada no momento é marcada por um
asterisco (*).

unidades Lista informações resumidas sobre cada unidade no subsistema selecionado no


momento. A unidade selecionada no momento é marcada por um asterisco (*).

luns Lista informações resumidas sobre cada LUN no subsistema selecionado no


momento. O LUN selecionado no momento é marcado por um asterisco (*).

tportals Lista informações resumidas sobre todos os portais de destino iSCSI no


subsistema selecionado no momento. O portal de destino selecionado no
momento é marcado por um asterisco (*).

destinos Lista informações resumidas sobre todos os destinos iSCSI no subsistema


selecionado no momento. O destino selecionado no momento é marcado por
um asterisco (*).

tpgroups Lista informações resumidas sobre todos os grupos do portal de destino iSCSI no
destino selecionado no momento. O grupo de portais selecionado no momento
é marcado por um asterisco (*).

login
Registra o adaptador do iniciador iSCSI especificado no destino iSCSI selecionado no
momento.

Sintaxe
login target iadapter=<iadapter> [type={manual | persistent | boot}] [chap=
{none | oneway | mutual}] [iportal=<iportal>] [tportal=<tportal>] [<flag>
[<flag> […]]]

Parâmetros

Parâmetro Descrição

type Especifica o tipo de logon a ser executado: manual ou persistente. Se não for
especificado, um logon manual será executado.

manual Faça logon manualmente. Há também uma opção de inicialização que se destina a
desenvolvimento futuro e não é usada no momento.

persistent Use automaticamente o mesmo logon quando o computador for reiniciado.

chap Especifica o tipo de autenticação CHAP a ser usado: nenhum, CHAP único ou CHAP
mútuo; se não for especificado, nenhuma autenticação será usada.

tportal Especifica um portal de destino opcional no subsistema selecionado no momento a


ser usado para o logon.

iportal Especifica um portal de iniciador opcional no adaptador iniciador especificado a ser


usado para o logon.

<flag> Identificado por acrônimos de três letras:


IPS: exige IPsec
EMP: habilita multicaminho
EHD: habilita o resumo do cabeçalho
EDD: habilita o resumo de dados

logout
Registra o adaptador do iniciador iSCSI especificado fora do destino iSCSI selecionado
no momento.

Sintaxe

logout target iadapter= <iadapter>

Parâmetros
Parâmetro Descrição

iadapter Especifica o adaptador iniciador com uma sessão de logon da qual deve fazer
logoff.

manutenção
Executa operações de manutenção do tipo especificado no objeto selecionado no
momento.

Sintaxe

maintenance <object operation> [count=<iteration>]

Parâmetros

Parâmetro Descrição

<object> Especifica o tipo de objeto no qual executar a operação. O tipo objeto pode ser
subsistema, controlador, porta, unidade ou LUN.

<operation> Especifica a operação de manutenção a ser executada. O tipo operação pode ser
spinup, spindown, blink, beep ou ping. Uma operação precisa ser especificada.

count= Especifica o número de vezes que a operação será repetida. Normalmente, isso é
usado com blink, beep ou ping.

name
Define o nome amigável do subsistema, LUN ou iSCSI atualmente selecionado como o
nome especificado.

Syntax

name {subsystem | lun | target} [<name>]

Parâmetro
Parâmetro Descrição

<name> Especifica um nome para o subsistema, LUN ou destino. Seu tamanho precisa ser
menor que 64 caracteres. Se nenhum nome for fornecido, o nome existente, se
houver, será excluído.

offline
Define o estado do objeto do tipo especificado selecionado no momento como offline.

Syntax

offline <object>

Parâmetro

Parâmetro Descrição

<object> Especifica o tipo de objeto no qual executar essa operação. O tipo pode ser:
subsistema, controlador, unidade, LUN ou tportal.

online
Define o estado do objeto do tipo especificado selecionado no momento como offline.
Se o objeto for hbaport, o status dos caminhos para a porta HBA selecionada no
momento será alterado para online.

Syntax

online <object>

Parâmetro

Parâmetro Descrição
Parâmetro Descrição

<object> Especifica o tipo de objeto no qual executar essa operação. O tipo pode ser:
hbaport, subsistema, controlador, unidade, LUN ou tportal.

recover
Executa as operações necessárias, como ressincronização ou moderação frequente, para
reparar o LUN tolerante a falhas selecionado no momento. Por exemplo, RECOVER pode
fazer com que um sobressalente frequente seja associado a um conjunto RAID que
tenha um disco com falha ou outra realocação de extensão de disco.

Syntax

recover <lun>

reenumerate
Renumera objetos do tipo especificado. Se você usar o comando extend LUN, precisará
usar o comando refresh para atualizar o tamanho do disco antes de usar o comando
reenumerate.

Sintaxe

reenumerate {subsystems | drives}

Parâmetros

Parâmetro Descrição

subsistemas Consulta o provedor para descobrir eventuais novos subsistemas que foram
adicionados no provedor selecionado no momento.

unidades Consulta os barramentos de E/S internos para descobrir as novas unidades que
foram adicionadas ao subsistema selecionado no momento.
refresh
Atualiza os dados internos do provedor selecionado no momento.

Syntax

refresh provider

rem
Usado para comentar scripts.

Syntax

Rem <comment>

remove
Remove o portal de destino iSCSI especificado do grupo de portais de destino
selecionado no momento.

Syntax

remove tpgroup tportal=<tportal> [noerr]

Parâmetro

Parâmetro Descrição

tpgroup tportal= Especifica o portal de destino iSCSI a ser removido.


<tportal>

noerr Somente para scripts. Quando um erro é encontrado, o Diskraid continua a


processar os comandos como se o erro não tivesse ocorrido.
substituir
Substitui a unidade especificada pela unidade selecionada no momento. A unidade
especificada pode não ser a unidade selecionada no momento.

Syntax

replace drive=<drive_number>

Parâmetro

Parâmetro Descrição

drive= Especifica o <drive_number> para a unidade a ser substituída.

reset
Redefine o controlador ou a porta selecionados no momento.

Sintaxe

reset {controller | port}

Parâmetros

Parâmetro Descrição

controlador Redefine o controlador.

porta Redefine a porta.

select
Exibe ou altera o objeto selecionado no momento.

Sintaxe
select {hbaport | iadapter | iportal | provider | subsystem | controller |
port | drive | lun | tportal | target | tpgroup } [<n>]

Parâmetros

Parâmetro Descrição

objeto Especifica o tipo de objeto a ser selecionado, incluindo: provedor, subsistema,


controlador, unidade ou LUN.

hbaport Define o foco para a porta HBA local especificada. Se nenhuma porta HBA for
[<n>] especificada, o comando exibirá a porta HBA selecionada no momento (se houver).
A especificação de um índice de porta HBA inválido resulta em nenhuma porta HBA
em foco. A seleção de uma porta HBA desmarca todos os adaptadores iniciadores e
portais iniciadores selecionados.

iadapter Define o foco no adaptador inicial iSCSI local especificado. Se nenhum adaptador
[<n>] iniciador for especificado, o comando exibirá o adaptador iniciador selecionado no
momento (se houver). A especificação de um índice de adaptador iniciador inválido
resulta em nenhum adaptador iniciador em foco. A seleção de um adaptador
iniciador desmarca todas as portas HBA e portais iniciadores selecionados.

iportal Define o foco para o portal do iniciador iSCSI local especificado dentro do
[<n>] adaptador iniciador iSCSI selecionado. Se nenhum portal iniciador for especificado,
o comando exibirá o portal iniciador selecionado no momento (se houver). A
especificação de um índice de portal iniciador inválido resulta em nenhum portal
iniciador selecionado.

provider Define o foco no provedor especificado. Se nenhum provedor for especificado, o


[<n>] comando exibirá o provedor selecionado no momento (se houver). A especificação
de um índice de provedor inválido resulta em nenhum provedor em foco.

subsystem Define o foco no subsistema especificado. Se nenhum subsistema for especificado,


[<n>] o comando exibirá o subsistema com foco (se houver). A especificação de um índice
de subsistema inválido resulta em nenhum subsistema em foco. A seleção de um
subsistema seleciona implicitamente seu provedor associado.

controller Define o foco para o controlador especificado dentro do subsistema selecionado no


[<n>] momento. Se nenhum controlador for especificado, o comando exibirá o
controlador selecionado no momento (se houver). A especificação de um índice de
controlador inválido resulta em nenhum controlador em foco. A seleção de um
controlador desmarca todas as portas, unidades, LUNs, portais de destino, destinos
e grupos de portal de destino selecionados.
Parâmetro Descrição

port [<n>] Define o foco na porta do controlador especificada dentro do controlador


selecionado no momento. Se nenhuma porta for especificada, o comando exibirá a
porta selecionada no momento (se houver). A especificação de um índice de porta
inválido resulta em nenhuma porta selecionada.

drive Define o foco na unidade especificada, ou eixo físico, dentro do subsistema


[<n>] selecionado no momento. Se nenhuma unidade for especificada, o comando exibirá
a unidade selecionada no momento (se houver). A especificação de um índice de
unidade inválido resulta em nenhuma unidade em foco. A seleção de uma unidade
desmarca todos os controladores, portas de controlador, LUNs, portais de destino,
destinos e grupos de portais de destino selecionados.

lun [<n>] Define o foco no LUN especificado dentro do subsistema selecionado no momento.
Se nenhum LUN for especificado, o comando exibirá o LUN selecionado no
momento (se houver). Especificar um índice LUN inválido resulta em nenhum LUN
selecionado. A seleção de um LUN desmarca todos os controladores, portas de
controlador, unidades, portais de destino, destinos e grupos de portais de destino
selecionados.

tportal Define o foco no portal de destino iSCSI especificado no subsistema selecionado no


[<n>] momento. Se nenhum portal de destino for especificado, o comando exibirá o
portal de destino selecionado no momento (se houver). A especificação de um
índice de portal de destino inválido resulta em nenhum portal de destino
selecionado. A seleção de um portal de destino desmarca todos os controladores,
portas do controlador, unidades, LUNs, destinos e grupos de portais de destino.

target Define o foco no destino iSCSI especificado dentro do subsistema selecionado no


[<n>] momento. Se nenhum destino for especificado, o comando exibirá o destino
selecionado no momento (se houver). A especificação de um índice de destino
inválido resulta em nenhum destino selecionado. A seleção de um destino desmarca
todos os controladores, portas do controlador, unidades, LUNs, portais de destino e
grupos de portais de destino.

tpgroup Define o foco no grupo de portais de destino iSCSI especificado dentro do destino
[<n>] iSCSI selecionado no momento. Se nenhum grupo de portais de destino for
especificado, o comando exibirá o grupo de portais de destino selecionado no
momento (se houver). A especificação de um índice de grupo de portais de destino
inválido resulta em nenhum grupo de portais de destino em foco.

[<n>] Especifica o <object number> a ser selecionado. Se o <object number> especificado


não for válido, todas as seleções existentes para objetos do tipo especificado serão
desmarcadas. Se nenhum <object number> for especificado, o objeto atual será
exibido.

setflag
Define a unidade selecionada no momento como um sobressalente de uso frequente.
Os sobressalentes de uso frequente não podem ser usados em operações comuns de
associação LUN. Eles são reservados apenas para tratamento de falhas. A unidade não
poderá estar associada a nenhum LUN existente no momento.

Sintaxe

setflag drive hotspare={true | false}

Parâmetros

Parâmetro Descrição

true Seleciona a unidade selecionada no momento como um sobressalente de uso


frequente.

false Desmarca a unidade selecionada no momento como um sobressalente de uso


frequente.

shrink
Reduz o tamanho do LUN selecionado.

Sintaxe

shrink lun size=<n> [noerr]

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

tamanho Especifica a quantidade desejada de espaço em megabytes (MB) pelo qual reduzir o
tamanho do LUN. Para especificar o tamanho usando outras unidades, use um dos
seguintes sufixos reconhecidos imediatamente após o tamanho:
B – byte
KB – kilobyte
MB – megabyte
GB – gigabyte
TB – terabyte
PB – petabyte.

noerr Somente para scripts. Quando um erro é encontrado, o Diskraid continua a


processar os comandos como se o erro não tivesse ocorrido.

em espera
Altera o status dos caminhos para a porta HBA (adaptador de barramento de host)
selecionada no momento para STANDBY.

Sintaxe

standby hbaport

Parâmetros

Parâmetro Descrição

hbaport Altera o status dos caminhos para a porta HBA (adaptador de barramento de host)
selecionada no momento para STANDBY.

unmask
Torna os LUNs selecionados no momento acessíveis nos hosts especificados.

Sintaxe
unmask lun {all | none | [add] wwn=<hexadecimal_number> [;
<hexadecimal_number> [;…]] | [add] initiator=<initiator>[;<initiator>[;…]]}
[uninstall]

Parâmetros

Parâmetro Descrição

all Especifica que o LUN deve ficar acessível a todos os hosts. No entanto, você não
pode remover a máscara do LUN para todos os destinos em um subsistema iSCSI.
Você precisa fazer logoff do destino antes de executar o comando unmask lun all .

nenhum Especifica que o LUN não deve ficar acessível a nenhum host.
Você precisa fazer logoff do destino antes de executar o comando unmask lun none .

add Especifica que os hosts especificados precisam ser adicionados à lista existente de
hosts aos quais esse LUN está acessível. Se esse parâmetro não for especificado, a
lista de hosts fornecidos substituirá a lista existente de hosts aos quais esse LUN
está acessível.

wwn= Especifica uma lista de números hexadecimais que representam nomes de todo o
mundo nos quais o LUN ou os hosts devem ser disponibilizados para acesso. Para
mascarar/desmascarar um conjunto específico de hosts em um subsistema Fibre
Channel, você pode digitar uma lista separada por ponto e vírgula de WWN para as
portas nos computadores host de interesse.

initiator= Especifica uma lista de iniciadores iSCSI aos quais o LUN selecionado no momento
deve ficar acessível. Para mascarar/desmascarar um conjunto específico de hosts em
um subsistema iSCSI, você pode digitar uma lista separada por ponto e vírgula de
nomes de iniciador iSCSI para os iniciadores nos computadores host de interesse.

uninstall Se especificado, desinstala o disco associado ao LUN no sistema local antes que o
LUN seja mascarado.

Criação de scripts Diskraid


O Diskraid pode ser roteirizado em qualquer computador que execute uma versão com
suporte do Windows Server e com um provedor de hardware VDS associado. Para
invocar um script Diskraid, no tipo de prompt de comando:

diskraid /s <script.txt>
Por padrão, o Diskraid interromperá o processamento de comandos e retorna um
código de erro se houver um problema no script. Para continuar executando o script e
ignorar erros, inclua o parâmetro noerr no comando. Isso permite que práticas úteis
como usar um único script excluam todos os LUNs em um subsistema,
independentemente do número total de LUNs. Nem todos os comandos dão suporte ao
parâmetro noerr. Os erros sempre são retornados em erros de sintaxe de comando,
independentemente de você ter incluído o parâmetro noerr.

Códigos de erro Diskraid


Código Descrição do erro
de erro

0 Não ocorreu nenhum erro. O script inteiro foi executado sem falha.

1 Ocorreu uma exceção fatal.

2 Os argumentos especificados em uma linha de comando Diskraid estavam incorretos.

3 O Diskraid não pôde abrir o script ou o arquivo de saída especificado.

4 Um dos serviços que o Diskraid usa retornou uma falha.

5 Ocorreu um erro de sintaxe de comando. O script falhou porque um objeto foi


selecionado incorretamente ou era inválido para uso com esse comando.

Exemplo
Para exibir o status do subsistema 0 no computador, digite:

diskraid

Pressione ENTER e a saída semelhante à seguinte será exibida:

Microsoft Diskraid version 5.2.xxxx


Copyright (©) 2003 Microsoft Corporation
On computer: COMPUTER_NAME

Para selecionar o subsistema 0, digite o seguinte no prompt do Diskraid:


select subsystem 0

Pressione ENTER e a saída semelhante à seguinte será exibida:

Subsystem 0 is now the selected subsystem.

DISKRAID> list drives

Drive ### Status Health Size Free Bus Slot Flags


--------- ---------- ------------ -------- -------- --- ---- -----
Drive 0 Online Healthy 107 GB 107 GB 0 1
Drive 1 Offline Healthy 29 GB 29 GB 1 0
Drive 2 Online Healthy 107 GB 107 GB 0 2
Drive 3 Not Ready Healthy 19 GB 19 GB 1 1

Para sair do Diskraid, digite o seguinte no prompt do Diskraid:

exit

Links relacionados
Chave da sintaxe de linha de comando
Diskshadow
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

O Diskshadow.exe é uma ferramenta que expõe a funcionalidade oferecida pelo VSS.


Por padrão, o Diskshadow usa um interpretador de comandos interativo semelhante ao
encontrado no Diskraid ou no Diskraid. O Diskshadow também inclui um modo
programável.

7 Observação

A associação no grupo de Administradores local, ou equivalente, é o mínimo


necessário para executar Diskshadow.

Syntax
No modo interativo, digite o seguinte no prompt de comando para iniciar o
interpretador de comando Diskshadow:

diskshadow

No modo de script, digite o seguinte, em que script.txt é um arquivo de script que


contém comandos Diskshadow:

diskshadow -s script.txt

Parâmetros
Você pode executar os comandos a seguir no interpretador de comandos Diskshadow
ou por meio de um arquivo de script. No mínimo, somente adicionar e criar são
necessários para criar uma cópia de sombra. Ainda que isso perca as configurações de
contexto e opção, ele será um backup de cópia e criará uma cópia de sombra sem script
de execução de backup.
Comando Descrição

Comando Define o contexto, as opções, o modo detalhado e o arquivo de metadados para


set criar cópias de sombra.

Comando Carrega um arquivo .cab de metadados antes de importar uma cópia de sombra
load transportável ou carrega os metadados do gravador no caso de uma restauração.
metadata

Comando Verifica se um gravador ou componente está incluído ou exclui um gravador ou


writer componente do procedimento de backup ou restauração.

Comando Adiciona volumes ao conjunto de volumes que devem ser copiados por sombra ou
add adiciona aliases ao ambiente de alias.

Comando Inicia o processo de criação de cópia de sombra, usando as configurações de


create contexto e opção atuais.

Comando Executa um arquivo no computador local.


exec

Comando Inicia uma sessão de backup completa.


begin
backup

Comando Encerra uma sessão de backup completa e emite um evento backupcomplete com
end backup o estado de gravador apropriado, se necessário.

Comando Inicia uma sessão de restauração e emite um evento de prerestore aos gravadores
begin envolvidos.
restore

Comando Encerra uma sessão de restauração e emite um evento de postrestore aos


end restore gravadores envolvidos.

Comando Redefine Diskshadow para o estado padrão.


reset

Comando Lista gravadores, cópias de sombra ou provedores de cópia de sombra registrados


list no momento que estão no sistema.

Comando Exclui cópias de sombra.


delete
shadows

Comando Importa uma cópia de sombra transportável de um arquivo de metadados


import carregado no sistema.

Comando Remove as cópias de sombra de hardware que foram importadas usando o


mask comando import.
Comando Descrição

Comando Expõe uma cópia de sombra persistente como uma letra da unidade,
expose compartilhamento ou ponto de montagem.

Comando Cancela a publicação de uma cópia de sombra que foi exposta usando o comando
unexpose expose.

Comando Desassocia um volume de cópia de sombra do VSS.


break

Comando Reverte um volume de volta para uma cópia de sombra especificada.


revert

Comando Sai do interpretador de comando ou do script.


exit

Exemplos
Esta é uma sequência de exemplos de comandos que criarão uma cópia de sombra para
backup. Ela pode ser salva no arquivo como script.dsh e executada usando diskshadow
/s script.dsh .

Considere o seguinte:

Você tem um diretório existente chamado c:\diskshadowdata.

O volume do sistema é C: e o volume de dados é D:.

Você tem um arquivo backupscript.cmd em c:\diskshadowdata.

O arquivo backupscript.cmd executará a cópia dos dados de sombra p: e q: para a


unidade de backup.

Você pode inserir esses comandos manualmente ou criar um script para eles:

#Diskshadow script file


set context persistent nowriters
set metadata c:\diskshadowdata\example.cab
set verbose on
begin backup
add volume c: alias systemvolumeshadow
add volume d: alias datavolumeshadow

create
expose %systemvolumeshadow% p:
expose %datavolumeshadow% q:
exec c:\diskshadowdata\backupscript.cmd
end backup
#End of script

Links relacionados
Chave da sintaxe de linha de comando
dispdiag
Artigo • 10/04/2023

Os logs exibem informações para um arquivo.

Sintaxe

dispdiag [-testacpi] [-d] [-delay <seconds>] [-out <filepath>]

Parâmetros

Parâmetro Descrição

– testacpi Executa o teste de diagnóstico de tecla de atalho. Exibe o nome da chave, o código
e o código de verificação para qualquer tecla pressionada durante o teste.

-d Gera um arquivo de despejo com resultados de teste.

-atraso Atrasa a coleta de dados pelo tempo especificado em segundos.


<seconds>

-saída Especifica o caminho e o nome do arquivo para salvar os dados coletados. Esse
<filepath> deve ser o último parâmetro.

-? Exibe os parâmetros de comando disponíveis e fornece ajuda para usá-los.

Links relacionados
Chave da sintaxe de linha de comando
Dnscmd
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Uma interface de linha de comando para gerenciar servidores DNS. Este utilitário é útil
na execução de scripts de arquivos em lote para ajudar a automatizar tarefas rotineiras
de gerenciamento de DNS ou para executar uma instalação autônoma simples e a
configuração de novos servidores DNS na rede.

Sintaxe

dnscmd <servername> <command> [<command parameters>]

Parâmetros

Parâmetro Descrição

<servername> O endereço IP ou o nome do host de um servidor DNS remoto ou local.

Comando dnscmd /ageallrecords


Define a hora atual em um carimbo de data/hora em registros de recursos em uma zona
ou nó especificado em um servidor DNS.

Sintaxe

dnscmd [<servername>] /ageallrecords <zonename>[<nodename>] | [/tree]|[/f]

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

<servername> Especifica o servidor DNS que o administrador planeja gerenciar, representado


por endereço IP, FQDN (nome de domínio totalmente qualificado) ou nome do
host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica o FQDN da zona.

<nodename> Especifica um determinado nó ou subárvore na zona, usando o seguinte:


@ para zona raiz ou FQDN
O FQDN de um nó (o nome com um ponto (.) no final)
Um único rótulo para o nome em relação à raiz da zona.

/tree Especifica que todos os nós filho também recebem o carimbo de data/hora.

/f Executa o comando sem solicitar confirmação.

Comentários

O comando ageallrecords serve para compatibilidade com versões anteriores


entre a versão atual do DNS e as versões anteriores do DNS nas quais não havia
suporte para vencimento e limpeza. Ele adiciona um carimbo de data/hora com a
hora atual aos registros de recursos que não têm um carimbo de data/hora e
define a hora atual nos registros de recursos que têm um carimbo de data/hora.

A limpeza de registro não ocorre, a menos que os registros sejam carimbados com
data/hora. Os registros de recursos do NS (servidor de nomes), os registros de
recursos SOA (início de autoridade) e os registros de recursos WINS (Serviço de
Cadastramento na Internet do Windows) não estão incluídos no processo de
limpeza e não têm carimbo de data/hora mesmo quando o comando
ageallrecords é executado.

Esse comando falhará, a menos que a limpeza esteja habilitada para o servidor
DNS e a zona. Para obter informações sobre como habilitar a limpeza para a zona,
consulte o parâmetro aging, dentro da sintaxe do comando dnscmd /config neste
artigo.

A adição de um carimbo de data/hora aos registros de recursos DNS os torna


incompatíveis com servidores DNS executados em sistemas operacionais
diferentes do Windows Server. Um carimbo de data/hora adicionado usando o
comando ageallrecords não pode ser revertido.

Se nenhum dos parâmetros opcionais for especificado, o comando retornará todos


os registros de recurso no nó especificado. Se um valor for especificado para pelo
menos um dos parâmetros opcionais, dnscmd enumera apenas os registros de
recursos que correspondam ao valor ou valores especificados no parâmetro ou
parâmetros opcionais.

Exemplos
Exemplo 1: definir a hora atual em um carimbo de data/hora para registros de recursos

Comando dnscmd /clearcache


Limpa a memória cache do DNS dos registros de recursos no servidor DNS especificado.

Sintaxe

dnscmd [<servername>] /clearcache

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

Exemplo

dnscmd dnssvr1.contoso.com /clearcache

Comando dnscmd /config


Altera os valores no registro para o servidor DNS e as zonas individuais. Esse comando
também modifica a configuração do servidor especificado. Aceita configurações no nível
do servidor e no nível da zona.

U Cuidado
Não edite o registro diretamente, a menos que você não tenha outra alternativa. O
Editor do registro ignora as proteções padrão, permitindo configurações que
podem prejudicar o desempenho, danificar o sistema ou até mesmo exigir que
você reinstale o Windows. É possível alterar com segurança a maioria das
configurações do registro usando os programas no Painel de Controle ou no MMC
(Console de Gerenciamento Microsoft). Se você precisar editar o registro
diretamente, primeiro faça backup dele. Leia a ajuda do Editor do registro para
obter mais informações.

Sintaxe no nível do servidor

dnscmd [<servername>] /config <parameter>

Parâmetros

7 Observação

Este artigo contém referências ao termo "servidor subordinado", um termo que a


Microsoft não usa mais. Quando o termo for removido do software, também o
removeremos deste artigo.

Parâmetros Descrição

<servername> Especifica o servidor DNS que você está planejando gerenciar,


representado pela sintaxe do computador local, endereço IP,
FQDN ou nome do host. Se esse parâmetro for omitido, o
servidor local será usado.

<parameter> Especifique uma configuração e, opcionalmente, um valor. Os


valores de parâmetro usam esta sintaxe: parâmetro [valor].

/addressanswerlimit [0|5-28] Especifica o número máximo de registros de host que um


servidor DNS pode enviar em resposta a uma consulta. O valor
pode ser zero (0) ou pode estar no intervalo de 5 a 28
registros. O valor padrão é zero (0).
Parâmetros Descrição

/bindsecondaries [0|1] Altera o formato da transferência de zona para que ela possa
alcançar a máxima compactação e eficiência. Aceita os valores:
0 – Usa compactação máxima e é compatível somente
com as versões 4.9.4 e posteriores do BIND
1 – Envia apenas um registro de recurso por mensagem
para servidores DNS não Microsoft e é compatível com
versões do BIND anteriores à 4.9.4. Essa é a
configuração padrão.

/bootmethod [0|1|2|3] Determina a origem da qual o servidor DNS obtém suas


informações de configuração. Aceita os valores:
0 – Limpa a origem das informações de configuração.
1 – Carrega do arquivo BIND que está localizado no
diretório DNS, o qual é %systemroot%\System32\DNS por
padrão.
2 – Carrega do registro.
3 – Carrega do AD DS e do registro. Essa é a
configuração padrão.

/defaultagingstate [0|1] Determina se o recurso de limpeza de DNS está habilitado por


padrão em zonas recém-criadas. Aceita os valores:
0 – Desabilita a limpeza. Essa é a configuração padrão.
1 – Habilita a limpeza.

/defaultnorefreshinterval [0x1- Define um período de tempo em que nenhuma atualização é


0xFFFFFFFF|0xA8] aceita para registros atualizados dinamicamente. As zonas no
servidor herdam esse valor automaticamente.
Para alterar o valor padrão, digite um valor no intervalo de
0x1-0xFFFFFFFF. O valor padrão do servidor é 0xA8.

/defaultrefreshinterval [0x1- Define um período de tempo permitido para atualizações


0xFFFFFFFF|0xA8] dinâmicas de registros DNS. As zonas no servidor herdam esse
valor automaticamente.
Para alterar o valor padrão, digite um valor no intervalo de
0x1-0xFFFFFFFF. O valor padrão do servidor é 0xA8.

/disableautoreversezones [0|1] Habilita ou desabilita a criação automática de zonas de


pesquisa inversa. As zonas de pesquisa inversa fornecem
resolução de endereços IP (Protocolo de Internet) para nomes
de domínio DNS. Aceita os valores:
0 – Habilita a criação automática de zonas de pesquisa
inversa. Essa é a configuração padrão.
1 – Desabilita a criação automática de zonas de pesquisa
inversa.
Parâmetros Descrição

/disablensrecordsautocreation Especifica se o servidor DNS cria automaticamente registros


[0|1] de recursos do NS (servidor de nomes) para as zonas que ele
hospeda. Aceita os valores:
0 – Cria automaticamente os registros de recursos do
NS (servidor de nomes) para as zonas que o servidor
DNS hospeda.
1 – Não cria automaticamente os registros de recursos
do NS (servidor de nomes) para as zonas que o servidor
DNS hospeda.

/dspollinginterval [0-30] Especifica com que frequência o servidor DNS pesquisa o AD


DS para alterações em zonas integradas do Active Directory.

/dstombstoneinterval [1-30] A quantidade de tempo em segundos para reter os registros


excluídos no AD DS.

/ednscachetimeout [3600- Especifica o número de segundos em que as informações de


15724800] EDNS (DNS estendido) são armazenadas em cache. O valor
mínimo é 3600 e o valor máximo é 15.724.800. O valor padrão
é 604.800 segundos (uma semana).

/enableednsprobes [0|1] Habilita ou desabilita o servidor para investigar outros


servidores para determinar se eles dão suporte ao EDNS.
Aceita os valores:
0 – Desabilita o suporte ativo para investigações de
EDNS.
1 – Habilita o suporte ativo para investigações de EDNS.

/enablednssec [0|1] Habilita ou desabilita o suporte para DNSSEC (Extensões de


Segurança DNS). Aceita os valores:
0 – Desabilita o DNSSEC.
1 – Habilita o DNSSEC.

/enableglobalnamessupport Habilita ou desabilita o suporte para a zona GlobalNames. A


[0|1] zona GlobalNames dá suporte à resolução de nomes DNS de
rótulo único em uma floresta. Aceita os valores:
0 – Desabilita o suporte para a zona GlobalNames.
Quando você define o valor desse comando como 0, o
serviço servidor DNS não resolve nomes de rótulo único
na zona GlobalNames.
1 – Habilita o suporte para a zona GlobalNames. Quando
você define o valor desse comando como 1, o serviço
servidor DNS resolve nomes de rótulo único na zona
GlobalNames.
Parâmetros Descrição

/enableglobalqueryblocklist Habilita ou desabilita o suporte para a lista de bloqueios de


[0|1] consulta global que bloqueia a resolução de nomes para os
nomes na lista. O serviço do Servidor DNS cria e habilita a lista
de bloqueios de consulta global por padrão quando o serviço
é iniciado pela primeira vez. Para exibir a lista atual de
bloqueios de consulta global, use o comando dnscmd /info
/globalqueryblocklist. Aceita os valores:

0 – Desabilita o suporte para a lista de bloqueios de


consulta global. Quando você define o valor desse
comando como 0, o serviço do Servidor DNS responde a
consultas para nomes na lista de bloqueios.
1 – Habilita o suporte para a lista de bloqueios de
consulta global. Quando você define o valor desse
comando como 1, o serviço do Servidor DNS não
responde a consultas para nomes na lista de bloqueios.

/eventloglevel [0|1|2|4] Determina quais eventos são registrados no log do servidor


DNS no Visualizador de Eventos. Aceita os valores:
0 – Não registra eventos.
1 – Registra apenas erros.
2 – Registra apenas erros e avisos.
4 – Registra erros, avisos e eventos informativos. Essa é
a configuração padrão.

/forwarddelegations [0|1] Determina como o servidor DNS manipula uma consulta para
uma subzona delegada. Essas consultas podem ser enviadas
para a subzona que é referenciada na consulta ou na lista de
encaminhadores nomeados para o servidor DNS. As entradas
na configuração são usadas somente quando o
encaminhamento está habilitado. Aceita os valores:
0 – Envia automaticamente consultas que se referem a
subzonas delegadas para a subzona apropriada. Essa é a
configuração padrão.
1 – Encaminha consultas que se referem à subzona
delegada para os encaminhadores existentes.

/forwardingtimeout [<seconds>] Determina quantos segundos (0x1-0xFFFFFFFF) um servidor


DNS espera até que um encaminhador responda antes de
tentar outro encaminhador. O valor padrão é 0x5, que é 5
segundos.
Parâmetros Descrição

/globalneamesqueryorder [0|1] Especifica se o serviço do Servidor DNS procura primeiro na


zona GlobalNames ou nas zonas locais ao resolver nomes.
Aceita os valores:
0 – O serviço do Servidor DNS tenta resolver nomes
consultando a zona GlobalNames antes de consultar as
zonas para as quais ele é autoritativo.
1 – O serviço do Servidor DNS tenta resolver nomes
consultando as zonas para as quais ele é autoritativo
antes de consultar a zona GlobalNames.

/globalqueryblocklist [[<name> Substitui a lista atual de bloqueios de consulta global por uma
[<name>]...] lista dos nomes especificados por você. Se você não
especificar nomes, esse comando limpará a lista de bloqueios.
Por padrão, a lista de bloqueios de consulta global contém os
seguintes itens:
isatap
wpad

O serviço do Servidor DNS pode remover um ou ambos os


nomes quando for iniciado pela primeira vez, se ele encontrar
esses nomes em uma zona existente.

/isslave [0|1] Determina como o servidor DNS responde quando as


consultas que ele encaminha não recebem resposta. Aceita os
valores:
0 – Especifica que o servidor DNS não é um
subordinado. Se o encaminhador não responder, o
servidor DNS tentará resolver a consulta por conta
própria. Essa é a configuração padrão.
1 – Especifica que o servidor DNS é um subordinado. Se
o encaminhador não responder, o servidor DNS
encerrará a pesquisa e enviará uma mensagem de falha
para o resolvedor.

/localnetpriority [0|1] Determina a ordem na qual os registros de host são


retornados quando o servidor DNS tiver vários registros de
host para o mesmo nome. Aceita os valores:
0 – Retorna os registros na ordem em que estão listados
no banco de dados do DNS.
1 – Retorna primeiro os registros que tenham endereços
IP de rede semelhantes. Essa é a configuração padrão.

/logfilemaxsize [<size>] Especifica o tamanho máximo em bytes (0x10000-0xFFFFFFFF)


do arquivo Dns.log. Quando o arquivo alcança seu tamanho
máximo, o DNS substitui os eventos mais antigos. O tamanho
padrão é 0x400000, que é 4 MB (megabytes).
Parâmetros Descrição

/logfilepath Especifica o caminho do arquivo Dns.log. O caminho padrão é


[<path+logfilename>] %systemroot%\System32\Dns\Dns.log . Você pode especificar um
caminho diferente usando o formato path+logfilename .

/logipfilterlist <IPaddress> [, Especifica quais pacotes são registrados no arquivo de log de


<IPaddress>...] depuração. As entradas são uma lista de endereços IP.
Somente os pacotes que vão de e para os endereços IP na lista
são registrados.

/loglevel [<eventtype>] Determina quais tipos de eventos são registrados no arquivo


Dns.log. Cada tipo de evento é representado por um número
hexadecimal. Se você quiser mais de um evento no log, use a
adição hexadecimal para adicionar os valores e, em seguida,
insira a soma. Aceita os valores:
0x0 – O servidor DNS não cria um log. Essa é a entrada
padrão.
0x10 – Registra consultas e notificações.
0x20 – Registra atualizações.
0xFE – Registra transações sem consultas.
0x100 – Registra transações de perguntas.
0x200 – Registra respostas.
0x1000 – Registra pacotes de envio.
0x2000 – Registra pacotes de recebimento.
0x4000 – Registra pacotes UDP (protocolo de
datagrama do usuário).
0x8000 – Registra pacotes TCP (protocolo de controle
de transmissão).
0xFFFF – Registra todos os pacotes.
0x10000 – Registra transações de gravação do Active
Directory.
0x20000 – Registra transações de atualização do Active
Directory.
0x1000000 – Registra pacotes completos.
0x80000000 – Registra transações write-through.

/maxcachesize Especifica o tamanho máximo, em KB (quilobytes), do cache


de memória do servidor DNS.

/maxcachettl [<seconds>] Determina quantos segundos (0x0-0xFFFFFFFF) um registro


fica salvo no cache. Se a configuração 0x0 for usada, o
servidor DNS não armazenará registros em cache. A
configuração padrão é 0x15180 (86.400 segundos ou 1 dia).
Parâmetros Descrição

/maxnegativecachettl Especifica quantos segundos (0x1-0xFFFFFFFF) uma entrada


[<seconds>] que registra uma resposta negativa a uma consulta permanece
armazenada no cache DNS. A configuração padrão é 0x384
(900 segundos).

/namecheckflag [0|1|2|3] Especifica qual padrão de caractere é usado ao verificar nomes


DNS. Aceita os valores:
0 – Usa caracteres ANSI que estão em conformidade
com as RFCs (Request for Comments) da IETF (Internet
Engineering Task force).
1 – Usa caracteres ANSI que não necessariamente estão
em conformidade com as RFCs da IETF.
2 – Usa caracteres UTF-8 (formato de transformação
UCS 8) multibyte. Essa é a configuração padrão.
3 – Usa todos os caracteres.

/norecursion [0|1] Determina se um servidor DNS executa a resolução de nomes


recursivos. Aceita os valores:
0 – O servidor DNS executa a resolução de nomes
recursivos se isso for solicitado em uma consulta. Essa é
a configuração padrão.
1 – O servidor DNS não executa a resolução de nomes
recursivos.

/notcp Esse parâmetro é obsoleto e não tem efeito nas versões atuais
do Windows Server.

/recursionretry [<seconds>] Determina o número de segundos (0x1-0xFFFFFFFF) que um


servidor DNS aguarda antes de tentar entrar em contato
novamente com um servidor remoto. A configuração padrão é
0x3 (três segundos). Esse valor deve ser aumentado quando a
recursão ocorre em um link de WAN (rede de longa distância)
lento.

/recursiontimeout [<seconds>] Determina o número de segundos (0x1-0xFFFFFFFF) que um


servidor DNS aguarda antes de descontinuar as tentativas de
contato com um servidor remoto. As configurações variam de
0x1 a 0xFFFFFFFF. A configuração padrão é 0xF (15 segundos).
Esse valor deve ser aumentado quando a recursão ocorre em
um link de WAN lento.
Parâmetros Descrição

/roundrobin [0|1] Determina a ordem na qual os registros de host são


retornados quando um servidor tiver vários registros de host
para o mesmo nome. Aceita os valores:
0 – O servidor DNS não usa rodízio. Em vez disso, ele
retorna o primeiro registro para cada consulta.
1 – O servidor DNS gira entre os registros que ela
retorna da parte de cima até a parte de baixo da lista de
registros correspondentes. Essa é a configuração
padrão.

/rpcprotocol Especifica o protocolo que a RPC (chamada de procedimento


[0x0|0x1|0x2|0x4|0xFFFFFFFF] remoto) usa quando faz uma conexão a partir do servidor
DNS. Aceita os valores:
0x0 – Desabilita RPC para DNS.
0x01 – Usa TCP/IP
0x2 – Usa pipes nomeados.
0x4 – usa LPC (chamada de procedimento local).
0xFFFFFFFF – Todos os protocolos. Essa é a configuração
padrão.

/scavenginginterval [<hours>] Determina se o recurso de limpeza do servidor DNS está


habilitado e define o número de horas (0x0-0xFFFFFFFF) entre
os ciclos de limpeza. A configuração padrão é 0x0, o que
desabilita a limpeza do servidor DNS. Uma configuração maior
que 0x0 permite a limpeza do servidor e define o número de
horas entre os ciclos de limpeza.

/secureresponses [0|1] Determina se o DNS filtra os registros salvos em um cache.


Aceita os valores:
0 – Salva todas as respostas em consultas de nome em
um cache. Essa é a configuração padrão.
1 – Salva apenas os registros que pertencem à mesma
subárvore DNS em um cache.

/sendport [<port>] Especifica o número da porta (0x0-0xFFFFFFFF) que o DNS usa


para enviar consultas recursivas a outros servidores DNS. A
configuração padrão é 0x0, significando que o número da
porta é selecionado aleatoriamente.
Parâmetros Descrição

/serverlevelplugindll [<dllpath>] Especifica o caminho de um plug-in personalizado. Quando


Dllpath especifica o nome de caminho totalmente qualificado
de um plug-in de servidor DNS válido, o servidor DNS chama
funções no plug-in para resolver as consultas de nome que
estão fora do escopo de todas as zonas hospedadas
localmente. Se um nome consultado estiver fora do escopo do
plug-in, o servidor DNS executará a resolução de nomes
usando encaminhamento ou recursão, como configurado. Se
Dllpath não for especificado, o servidor DNS deixará de usar
um plug-in personalizado se um tiver sido configurado
anteriormente.

/strictfileparsing [0|1] Determina o comportamento de um servidor DNS quando ele


encontra um registro incorreto ao carregar uma zona. Aceita
os valores:
0 – O servidor DNS continua carregando a zona mesmo
que o servidor encontre um registro incorreto. O erro é
registrado no log DNS. Essa é a configuração padrão.
1 – O servidor DNS para de carregar a zona e registra o
erro no log DNS.
Parâmetros Descrição

/updateoptions <RecordValue> Proíbe atualizações dinâmicas de tipos de registros


especificados. Se você quiser proibir mais de um evento no
log, use a adição hexadecimal para adicionar os valores e, em
seguida, insira a soma. Aceita os valores:
0x0 – Não restringe qualquer tipo de registro.
0x1 – Exclui os registros de recursos SOA (início de
autoridade).
0x2 – Exclui os registros de recursos NS (servidor de
nomes).
0x4 – Exclui a delegação de registros de recursos NS
(servidor de nomes).
0x8 – Exclui os registros de host do servidor.
0x100 – Durante a atualização dinâmica segura, exclui os
registros de recursos SOA (início de autoridade).
0x200 – Durante a atualização dinâmica segura, exclui
os registros de recursos NS (servidor de nomes raiz).
0x30F – Durante a atualização dinâmica padrão, exclui
registros de recursos NS (servidor de nomes), registros
de recursos SOA (início de autoridade) e registros de
host do servidor. Durante a atualização dinâmica segura,
exclui registros de recursos NS (servidor de nomes raiz)
e registros de recursos SOA (início de autoridade).
Permite delegações e atualizações de host do servidor.
0x400 – Durante a atualização dinâmica segura, exclui
os registros de recursos NS (servidor de nomes).
0x800 – Durante a atualização dinâmica segura, exclui
os registros de host do servidor.
0x1000000 – Exclui os registros DS (signatário de
delegação).
0x80000000 – Desabilita a atualização dinâmica de DNS.

/writeauthorityns [0|1] Determina quando o servidor DNS grava registros de recursos


NS (servidor de nomes) na seção Autoridade de uma resposta.
Aceita os valores:
0 – Grava os registros de recursos NS (servidor de
nomes) somente na seção Autoridade de indicações.
Essa configuração está em conformidade com a RFC
1034: Conceitos e instalações de nomes de domínio e
com a RFC 2181: Esclarecimentos sobre a especificação
DNS. Essa é a configuração padrão.
1 – Grava registros de recursos NS (servidor de nomes)
na seção Autoridade de todas as respostas autoritativas
bem-sucedidas.
Parâmetros Descrição

/xfrconnecttimeout [<seconds>] Determina o número de segundos (0x0 0xFFFFFFFF) que um


servidor DNS primário espera por uma resposta de
transferência de seu servidor secundário. O valor padrão é
0x1E (30 segundos). Depois que o valor de tempo limite
expirar, a conexão será encerrada.

Sintaxe no nível da zona


Modifica a configuração da zona especificada. O nome da zona deve ser especificado
apenas para parâmetros no nível da zona.

dnscmd /config <parameters>

Parâmetros

Parâmetros Descrição

<parameter> Especifique uma configuração, um nome de zona e,


opcionalmente, um valor. Os valores de parâmetro usam esta
sintaxe: zonename parameter [value] .

/aging <zonename> Habilita ou desabilita a limpeza em uma zona específica.

/allownsrecordsautocreation Substitui a configuração de criação automática de registro de


<zonename> [value] recurso NS (servidor de nomes) do servidor DNS. Os registros de
recursos NS (servidor de nomes) registrados anteriormente para
essa zona não são afetados. Portanto, você deve removê-los
manualmente se não os quiser.

/allowupdate <zonename> Determina se a zona especificada aceita atualizações dinâmicas.

/forwarderslave <zonename> Substitui a configuração /isslave do servidor DNS.

/forwardertimeout Determina quantos segundos uma zona DNS espera até que um
<zonename> encaminhador responda antes de tentar outro encaminhador. Esse
valor substitui o valor definido no nível do servidor.

/norefreshinterval Define um intervalo de tempo para uma zona durante o qual


<zonename> nenhuma atualização pode renovar dinamicamente registros DNS
em uma zona especificada.
Parâmetros Descrição

/refreshinterval <zonename> Define um intervalo de tempo para uma zona durante o qual
atualizações podem renovar dinamicamente registros DNS em
uma zona especificada.

/securesecondaries Determina quais servidores secundários podem receber


<zonename> atualizações de zona do servidor primário para essa zona.

Comando dnscmd
/createbuiltindirectorypartitions
Cria uma partição de diretório de aplicativos do DNS. Quando o DNS é instalado, uma
partição de diretório de aplicativos para o serviço é criada nos níveis de floresta e
domínio. Use esse comando para criar partições de diretório de aplicativos do DNS que
foram excluídas ou nunca criadas. Sem parâmetro, esse comando cria uma partição
interna de diretório de DNS para o domínio.

Sintaxe

dnscmd [<servername>] /createbuiltindirectorypartitions [/forest]


[/alldomains]

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

/forest Cria uma partição de diretório de DNS para a floresta.

/alldomains Cria partições DNS para todos os domínios na floresta.

Comando dnscmd /createdirectorypartition


Cria uma partição de diretório de aplicativos do DNS. Quando o DNS é instalado, uma
partição de diretório de aplicativos para o serviço é criada nos níveis de floresta e
domínio. Esta operação cria partições de diretório de aplicativos do DNS adicionais.
Sintaxe

dnscmd [<servername>] /createdirectorypartition <partitionFQDN>

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP,
FQDN ou nome do host. Se esse parâmetro for omitido, o servidor local será
usado.

<partitionFQDN> O FQDN da partição de diretório de aplicativos do DNS que será criada.

Comando dnscmd /deletedirectorypartition


Remove uma partição de diretório de aplicativos do DNS existente.

Sintaxe

dnscmd [<servername>] /deletedirectorypartition <partitionFQDN>

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP,
FQDN ou nome do host. Se esse parâmetro for omitido, o servidor local será
usado.

<partitionFQDN> O FQDN da partição de diretório de aplicativos do DNS que será removida.

Comando dnscmd /directorypartitioninfo


Lista as informações sobre uma partição de diretório de aplicativos do DNS
especificada.
Sintaxe

dnscmd [<servername>] /directorypartitioninfo <partitionFQDN> [/detail]

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP,
FQDN ou nome do host. Se esse parâmetro for omitido, o servidor local será
usado.

<partitionFQDN> O FQDN da partição de diretório de aplicativos do DNS.

/detail Lista todas as informações sobre a partição de diretório de aplicativos.

Comando dnscmd /enlistdirectorypartition


Adiciona o servidor DNS ao conjunto de réplicas da partição de diretório especificada.

Sintaxe

dnscmd [<servername>] /enlistdirectorypartition <partitionFQDN>

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP,
FQDN ou nome do host. Se esse parâmetro for omitido, o servidor local será
usado.

<partitionFQDN> O FQDN da partição de diretório de aplicativos do DNS.

Comando dnscmd /enumdirectorypartitions


Lista as partições de diretório de aplicativos do DNS para o servidor especificado.
Sintaxe

dnscmd [<servername>] /enumdirectorypartitions [/custom]

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

/custom Lista apenas as partições de diretório criadas pelo usuário.

Comando dnscmd /enumrecords


Lista os registros de recursos de um nó especificado em uma zona DNS.

Sintaxe

dnscmd [<servername>] /enumrecords <zonename> <nodename> [/type <rrtype>


<rrdata>] [/authority] [/glue] [/additional] [/node | /child |
/startchild<childname>] [/continue | /detail]

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço


IP, FQDN ou nome do host. Se esse parâmetro for omitido, o servidor
local será usado.

/enumrecords Lista os registros de recursos na zona especificada.

<zonename> Especifica o nome da zona à qual pertencem os registros de recurso.

<nodename> Especifica o nome do nó dos registros de recurso.


Parâmetros Descrição

[/type <rrtype> Especifica o tipo de registros de recurso a serem listados e o tipo de


<rrdata>] dados esperado. Aceita os valores:
<rrtype> – Especifica o tipo de registros de recurso a serem
listados.
<rrdata> – Especifica o tipo de dados que é o registro esperado.

/authority Inclui dados autoritativos.

/glue Inclui dados cola.

/additional Inclui todas as informações adicionais sobre os registros de recursos


listados.

/node Lista apenas os registros de recursos do nó especificado.

/child Lista apenas os registros de recursos de um domínio filho especificado.

/startchild <childname> Começa a lista no domínio filho especificado.

/continue Lista apenas os registros de recursos com o tipo e dados.

/detail Lista todas as informações sobre os registros de recursos.

Exemplo

dnscmd /enumrecords test.contoso.com test /additional

Comando dnscmd /enumzones


Lista as zonas que existem no servidor DNS especificado. Os parâmetros enumzones
atuam como filtros na lista de zonas. Se nenhum filtro for especificado, uma lista
completa de zonas será retornada. Quando um filtro for especificado, somente as zonas
que atendem aos critérios desse filtro serão incluídas na lista de zonas retornada.

Sintaxe

dnscmd [<servername>] /enumzones [/primary | /secondary | /forwarder | /stub


| /cache | /auto-created] [/forward | /reverse | /ds | /file]
[/domaindirectorypartition | /forestdirectorypartition |
/customdirectorypartition | /legacydirectorypartition | /directorypartition
<partitionFQDN>]

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por


endereço IP, FQDN ou nome do host. Se esse parâmetro for omitido,
o servidor local será usado.

/primary Lista todas as zonas que são zonas primárias padrão ou zonas
integradas do Active Directory.

/secondary Lista todas as zonas secundárias padrão.

/forwarder Lista as zonas que encaminham consultas não resolvidas para outro
servidor DNS.

/stub Lista todas as zonas de stub.

/cache Lista apenas as zonas carregadas no cache.

/auto-created] Lista as zonas que foram criadas automaticamente durante a


instalação do servidor DNS.

/forward Lista as zonas de pesquisa direta.

/reverse Lista as zonas de pesquisa inversa.

/ds Lista as zonas integradas do Active Directory.

/file Lista as zonas que são têm suporte por arquivos.

/domaindirectorypartition Lista as zonas armazenadas na partição de diretório do domínio.

/forestdirectorypartition Lista as zonas armazenadas na partição de diretório de aplicativo do


DNS da floresta.

/customdirectorypartition Lista todas as zonas armazenadas em uma partição de diretório de


aplicativo definida pelo usuário.

/legacydirectorypartition Lista todas as zonas armazenadas na partição de diretório do


domínio.

/directorypartition Lista todas as zonas armazenadas na partição de diretório


<partitionFQDN> especificada.

Exemplos
Exemplo 2: exibir uma lista completa de zonas em um servidor DNS

Exemplo 3: exibir uma lista de zonas criadas automaticamente em um servidor


DNS

Comando dnscmd /exportsettings


Cria um arquivo de texto que lista os detalhes da configuração de um servidor DNS. O
arquivo de texto é nomeado DnsSettings.txt. Ele fica localizado no diretório
%systemroot%\system32\dns do servidor. É possível usar as informações no arquivo que

dnscmd /exportsettings cria para solucionar problemas de configuração ou para


garantir que você tenha configurado vários servidores de forma idêntica.

Sintaxe

dnscmd [<servername>] /exportsettings

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

Comando dnscmd /info


Exibe as configurações da seção DNS do registro do servidor
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DNS\Parameters especificado.
Para exibir as configurações do registro no nível da zona, use o comando dnscmd
zoneinfo .

Sintaxe

dnscmd [<servername>] /info [<settings>]


Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<settings> Qualquer configuração que o comando info retornar pode ser especificada
individualmente. Se uma configuração não for especificada, um relatório de
configurações comuns será retornado.

Exemplo

Exemplo 4: exibir a configuração IsSlave de um servidor DNS

Exemplo 5: exibir a configuração RecursionTimeout de um servidor DNS

Comando dnscmd /ipvalidate


Testa se um endereço IP identifica um servidor DNS funcional ou se o servidor DNS
pode atuar como um encaminhador, um servidor de dicas de raiz ou um servidor
primário para uma zona específica.

Sintaxe

dnscmd [<servername>] /ipvalidate <context> [<zonename>] [[<IPaddress>]]

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.
Parâmetros Descrição

<context> Especifica o tipo de teste a ser executado. Você pode especificar qualquer um dos
seguintes tipos de teste:
/dnsservers – Testa se os computadores com os endereços especificados
estão operando servidores DNS.
/forwarders – Testa se os endereços especificados identificam servidores
DNS que podem atuar como encaminhadores.
/roothints – Testa se os endereços especificados identificam servidores
DNS que podem atuar como servidores de nomes.
/zonemasters – testa se os endereços especificados identificam os
servidores DNS que são servidores primários para zonename.

<zonename> Identifica a zona. Use este parâmetro com o parâmetro /zonemasters.

<IPaddress> Especifica os endereços IP que o comando testa.

Exemplos

nscmd dnssvr1.contoso.com /ipvalidate /dnsservers 10.0.0.1 10.0.0.2


dnscmd dnssvr1.contoso.com /ipvalidate /zonemasters corp.contoso.com
10.0.0.2

Comando dnscmd /nodedelete


Exclui todos os registros de um host especificado.

Sintaxe

dnscmd [<servername>] /nodedelete <zonename> <nodename> [/tree] [/f]

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.
Parâmetros Descrição

<zonename> Especifica o nome da zona.

<nodename> Especifica o nome do host do nó a ser excluído.

/tree Exclui todos os registros filho.

/f Executa o comando sem solicitar confirmação.

Exemplo

Exemplo 6: excluir os registros de um nó

Comando dnscmd /recordadd


Adiciona um registro a uma zona especificada em um servidor DNS.

Sintaxe

dnscmd [<servername>] /recordadd <zonename> <nodename> <rrtype> <rrdata>

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica a zona na qual o registro reside.

<nodename> Especifica um nó específico na zona.

<rrtype> Especifica o tipo de registro a ser adicionado.

<rrdata> Especifica o tipo de dados esperado.

7 Observação

Após adicionar um registro, certifique-se de usar o tipo de dados e o formato de


dados corretos. Para obter uma lista dos tipos de registros de recursos e os tipos
de dados apropriados, confira Exemplos de Dnscmd.

Exemplos

dnscmd dnssvr1.contoso.com /recordadd test A 10.0.0.5


dnscmd /recordadd test.contoso.com test MX 10 mailserver.test.contoso.com

Comando dnscmd /recorddelete


Exclui um registro de recurso para uma zona especificada.

Sintaxe

dnscmd [<servername>] /recorddelete <zonename> <nodename> <rrtype> <rrdata>


[/f]

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica a zona na qual o registro de recurso reside.

<nodename> Especifica um nome do host.

<rrtype> Especifica o tipo de registro de recurso a ser excluído.

<rrdata> Especifica o tipo de dados esperado.

/f Executa o comando sem solicitar confirmação. Como os nós podem ter mais de
um registro de recurso, esse comando exige que você seja muito específico sobre
o tipo de registro de recurso que deseja excluir. Se você especificar um tipo de
dados e não especificar um tipo de dados de registro de recurso, todos os
registros com esse tipo de dados específico para o nó especificado serão
excluídos.
Exemplos

dnscmd /recorddelete test.contoso.com test MX 10 mailserver.test.contoso.com

Comando dnscmd /resetforwarders


Seleciona ou redefine os endereços IP para os quais o servidor DNS encaminha
consultas DNS quando ele não pode resolvê-las localmente.

Sintaxe

dnscmd [<servername>] /resetforwarders <IPaddress> [,<IPaddress>]...]


[/timeout <timeout>] [/slave | /noslave]

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<IPaddress> Lista os endereços IP para os quais o servidor DNS encaminha as consultas não
resolvidas.

/timeout Define o número de segundos que o servidor DNS espera por uma resposta do
<timeout> encaminhador. Por padrão, esse valor é de cinco segundos.

/slave Impede que o servidor DNS realize suas próprias consultas iterativas se o
encaminhador não resolver uma consulta.

/noslave Permite que o servidor DNS execute suas próprias consultas iterativas se o
encaminhador não resolver uma consulta. Essa é a configuração padrão.

/f Executa o comando sem solicitar confirmação. Como os nós podem ter mais de
um registro de recurso, esse comando exige que você seja muito específico sobre
o tipo de registro de recurso que deseja excluir. Se você especificar um tipo de
dados e não especificar um tipo de dados de registro de recurso, todos os
registros com esse tipo de dados específico para o nó especificado serão
excluídos.
Comentários

Por padrão, um servidor DNS executa consultas iterativas quando não consegue
resolver uma consulta.

Definir endereços IP usando o comando resetforwarders faz com que o servidor


DNS execute consultas recursivas para os servidores DNS nos endereços IP
especificados. Se os encaminhadores não resolverem a consulta, o servidor DNS
poderá executar suas próprias consultas iterativas.

Se o parâmetro /slave for usado, o servidor DNS não executará suas próprias
consultas iterativas. Isso significa que o servidor DNS encaminha consultas não
resolvidas somente para os servidores DNS na lista e não tentará consultas
iterativas se os encaminhadores não as resolverem. É mais eficiente definir um
endereço IP como um encaminhador para um servidor DNS. Você pode usar o
comando resetforwarders para servidores internos em uma rede para encaminhar
suas consultas não resolvidas para um servidor DNS que tenha uma conexão
externa.

Listar o endereço IP de um encaminhador duas vezes faz com que o servidor DNS
tente encaminhar para esse servidor duas vezes.

Exemplos

dnscmd dnssvr1.contoso.com /resetforwarders 10.0.0.1 /timeout 7 /slave


dnscmd dnssvr1.contoso.com /resetforwarders /noslave

Comando dnscmd /resetlistenaddresses


Especifica os endereços IP em um servidor que escuta solicitações de cliente DNS. Por
padrão, todos os endereços IP em um servidor DNS escutam solicitações do cliente
DNS.

Sintaxe

dnscmd [<servername>] /resetlistenaddresses <listenaddress>


Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP,
FQDN ou nome do host. Se esse parâmetro for omitido, o servidor local será
usado.

<listenaddress> Especifica um endereço IP no servidor DNS que escuta solicitações de cliente


DNS. Se nenhum endereço de escuta for especificado, todos os endereços IP
no servidor escutarão as solicitações do cliente.

Exemplos

dnscmd dnssvr1.contoso.com /resetlistenaddresses 10.0.0.1

Comando dnscmd /startscavenging


Instrui um servidor DNS para tentar uma pesquisa imediata de registros de recursos
obsoletos em um servidor DNS especificado.

Sintaxe

dnscmd [<servername>] /startscavenging

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

Comentários

A conclusão bem-sucedida desse comando inicia uma limpeza imediatamente. Se


a limpeza falhar, nenhuma mensagem de aviso será exibida.
Embora o comando para iniciar a limpeza pareça ser concluído com êxito, a
limpeza não será iniciada a menos que as seguintes pré-condições sejam
atendidas:

A limpeza está habilitada para o servidor e para a zona.

A zona foi iniciada.

Os registros de recurso têm um carimbo de data/hora.

Para obter informações sobre como habilitar a limpeza para o servidor, confira o
parâmetro scavenginginterval em Sintaxe no nível do servidor na seção /config.

Para obter informações sobre como habilitar a limpeza para a zona, confira o
parâmetro aging em Sintaxe no nível da zona na seção /config.

Para obter informações sobre como reiniciar uma zona pausada, confira o
parâmetro zoneresume neste artigo.

Para obter informações sobre como verificar registros de recursos para um


carimbo de data/hora, consulte o parâmetro ageallrecords neste artigo.

Exemplos

dnscmd dnssvr1.contoso.com /startscavenging

Comando dnscmd /statistics


Exibe ou limpa os dados de um servidor DNS especificado.

Sintaxe

dnscmd [<servername>] /statistics [<statid>] [/clear]

Parâmetros

Parâmetros Descrição
Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<statid> Especifica qual estatística ou combinação de estatísticas exibir. O comando


statistics exibe contadores que começam no servidor DNS quando ele é iniciado
ou retomado. Um número de identificação é usado para identificar uma
estatística. Se nenhum número de identificação de estatística for especificado,
todas as estatísticas serão exibidas. Os números que podem ser especificados,
juntamente com a estatística correspondente exibida, poderão incluir:

00000001 – Hora
00000002 – Consulta
00000004 – Consulta2
00000008 – Recursão
00000010 – Mestre
00000020 – Secundário
00000040 – WINS
00000100 – Atualização
00000200 – SkwanSec
00000400 – Ds
00010000 – Memória
00100000 – PacketMem
00040000 – Dbase
00080000 – Registros
00200000 – NbstatMem
/clear – Redefine o contador de estatísticas especificado para zero.

Exemplos

Exemplo 7:

Exemplo 8: exibir estatísticas de NbstatMem para um servidor DNS

Comando dnscmd /unenlistdirectorypartition


Adiciona o servidor DNS a partir de conjunto de réplicas da partição de diretório
especificada.

Sintaxe

dnscmd [<servername>] /unenlistdirectorypartition <partitionFQDN>


Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP,
FQDN ou nome do host. Se esse parâmetro for omitido, o servidor local será
usado.

<partitionFQDN> O FQDN da partição de diretório de aplicativos do DNS que será removida.

Comando dnscmd /writebackfiles


Verifica se há alterações na memória do servidor DNS e as grava no armazenamento
persistente. O comando writebackfiles atualiza todas as zonas sujas ou uma zona
especificada. Uma zona fica suja quando há alterações na memória que ainda não foram
gravadas no armazenamento persistente. Essa é uma operação no nível do servidor que
verifica todas as zonas. Você pode especificar uma zona nessa operação ou usar a
operação zonewriteback.

Sintaxe

dnscmd [<servername>] /writebackfiles <zonename>

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica o nome da zona a ser atualizada.

Exemplos

dnscmd dnssvr1.contoso.com /writebackfiles


Comando dnscmd /zoneadd
Adiciona uma zona ao servidor DNS.

Sintaxe

dnscmd [<servername>] /zoneadd <zonename> <zonetype> [/dp <FQDN> | {/domain


| enterprise | legacy}]

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica o nome da zona.

<zonetype> Especifica o tipo da zona a ser criada. Especificar um tipo de zona de /forwarder
ou /dsforwarder cria uma zona que executa o encaminhamento condicional.
Cada tipo de zona tem diferentes parâmetros necessários:

/dsprimary – Cria uma zona integrada do Active Directory.


/primary /file <filename> – Cria uma zona primária padrão e especifica o
nome do arquivo que armazenará as informações sobre a zona.
/secondary <masterIPaddress> [<masterIPaddress>...] – Cria uma zona
secundária padrão.
/stub <masterIPaddress> [<masterIPaddress>...] /file <filename> – Cria
uma zona de stub com suporte de arquivo.
/dsstub <masterIPaddress> [<masterIPaddress>...] – Cria uma zona de
stub integrada do Active Directory.
/forwarder <masterIPaddress> [<masterIPaddress>] ... /file <filename> –
Especifica que a zona criada encaminha as consultas não resolvidas para
outro servidor DNS.
/dsforwarder – Especifica que a zona integrada do Active Directory criada
encaminha as consultas não resolvidas para outro servidor DNS.

<FQDN> Especifica o FQDN da partição de diretório.

/domain Armazena a zona na partição de diretório do domínio.

/enterprise Armazena a zona na partição de diretório corporativo.

/legacy Armazena a zona em uma partição de diretório herdada.


Exemplos

dnscmd dnssvr1.contoso.com /zoneadd test.contoso.com /dsprimary


dnscmd dnssvr1.contoso.com /zoneadd secondtest.contoso.com /secondary
10.0.0.2

Comando dnscmd
/zonechangedirectorypartition
Altera a partição de diretório na qual a zona especificada reside.

Sintaxe

dnscmd [<servername>] /zonechangedirectorypartition <zonename>


{[<newpartitionname>] | [<zonetype>]}

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP,
FQDN ou nome do host. Se esse parâmetro for omitido, o servidor local
será usado.

<zonename> O FQDN da partição de diretório atual na qual a zona reside.

<newpartitionname> O FQDN da partição de diretório para a qual a zona será movida.

<zonetype> Especifica o tipo de partição de diretório para o qual a zona será movida.

/domain Move a zona para a partição de diretório interna do domínio.

/forest Move a zona para a partição de diretório interna da floresta.

/legacy Move a zona para a partição de diretório criada para controladores de


domínio pré-Active Directory. Essas partições de diretório não são
necessárias para o modo nativo.

Comando dnscmd /zonedelete


Exclui uma zona especificada.

Sintaxe

dnscmd [<servername>] /zonedelete <zonename> [/dsdel] [/f]

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica o nome da zona a ser excluída.

/dsdel Exclui a zona do AD DS (Azure Directory Domain Services).

/f Executa o comando sem solicitar confirmação.

Exemplos
Exemplo 9: excluir uma zona de um servidor DNS

Comando dnscmd /zoneexport


Cria um arquivo de texto que lista os registros de recursos de uma zona especificada. A
operação zoneexport cria um arquivo de registros de recursos para uma zona integrada
do Active Directory para fins de solução de problemas. Por padrão, o arquivo que esse
comando cria é colocado no diretório DNS, que é, por padrão, o diretório
%systemroot%/System32/Dns .

Sintaxe

dnscmd [<servername>] /zoneexport <zonename> <zoneexportfile>

Parâmetros
Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP,
FQDN ou nome do host. Se esse parâmetro for omitido, o servidor local será
usado.

<zonename> Especifica o nome da zona.

<zoneexportfile> Especifica o nome do arquivo a ser criado.

Exemplos
Exemplo 10: exportar a lista de registros de recursos da zona para um arquivo

dnscmd /zoneinfo
Exibe as configurações da seção do registro da zona especificada:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DNS\Parameters\Zones\
<zonename>

Sintaxe

dnscmd [<servername>] /zoneinfo <zonename> [<setting>]

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica o nome da zona.

<setting> Você pode especificar individualmente qualquer configuração retornada pelo


comando zoneinfo. Se você não especificar uma configuração, todas as
configurações serão retornadas.

Comentários

Para exibir as configurações do registro no nível do servidor, use o comando /info.


Para ver uma lista de configurações que você pode exibir com esse comando,
confira o comando /config.

Exemplos

Exemplo 11: exibir a configuração RefreshInterval do registro

Exemplo 12: exibir configuração de vencimento do registro

Comando dnscmd /zonepause


Pausa a zona especificada, o que ignora as solicitações de consulta.

Sintaxe

dnscmd [<servername>] /zonepause <zonename>

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica o nome da zona a ser pausada.

Comentários

Para retomar uma zona e disponibilizá-la depois que ela tiver sido pausada, use o
comando /zoneresume.

Exemplos

dnscmd dnssvr1.contoso.com /zonepause test.contoso.com


Comando dnscmd /zoneprint
Lista os registros em uma zona.

Sintaxe

dnscmd [<servername>] /zoneprint <zonename>

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica o nome da zona a ser listada.

Comando dnscmd /zonerefresh


Força uma zona DNS secundária a atualizar da zona mestra.

Sintaxe

dnscmd [<servername>] /zonerefresh <zonename>

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica o nome da zona a ser atualizada.

Comentários
O comando zonerefresh força uma verificação do número de versão no registro de
recurso SOA (início de autoridade) do servidor primário. Se o número de versão no
servidor primário for maior que o número de versão do servidor secundário, será
iniciada uma transferência de zona que atualiza o servidor secundário. Se o
número de versão for o mesmo, nenhuma transferência de zona ocorrerá.

A verificação forçada ocorre por padrão a cada 15 minutos. Para alterar o padrão,
use o comando dnscmd config refreshinterval .

Exemplos

dnscmd dnssvr1.contoso.com /zonerefresh test.contoso.com

Comando dnscmd /zonereload


Copia as informações de zona da sua origem.

Sintaxe

dnscmd [<servername>] /zonereload <zonename>

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica o nome da zona a ser recarregada.

Comentários

Se a zona estiver integrada ao Active Directory, ela será recarregada no AD DS


(Active Directory Domain Services).

Se a zona for uma zona com backup de arquivo padrão, ela será recarregada de
um arquivo.
Exemplos

dnscmd dnssvr1.contoso.com /zonereload test.contoso.com

Comando dnscmd /zoneresetmasters


Redefine os endereços IP do servidor primário que fornece informações de transferência
de zona para uma zona secundária.

Sintaxe

dnscmd [<servername>] /zoneresetmasters <zonename> [/local] [<IPaddress>


[<IPaddress>]...]

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica o nome da zona a ser redefinida.

/local Define uma lista mestre local. Esse parâmetro é usado para zonas integradas do
Active Directory.

<IPaddress> Os endereços IP dos servidores primários da zona secundária.

Comentários

Esse valor é originalmente definido quando a zona secundária é criada. Use o


comando zoneresetmasters no servidor secundário. Esse valor não terá efeito se
estiver definido no servidor DNS mestre.

Exemplos
dnscmd dnssvr1.contoso.com /zoneresetmasters test.contoso.com 10.0.0.1
dnscmd dnssvr1.contoso.com /zoneresetmasters test.contoso.com /local

Comando dnscmd /zoneresetscavengeservers


Altera os endereços IP dos servidores que podem limpar a zona especificada.

Sintaxe

dnscmd [<servername>] /zoneresetscavengeservers <zonename> [/local]


[<IPaddress> [<IPaddress>]...]

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica a zona a ser limpa.

/local Define uma lista mestre local. Esse parâmetro é usado para zonas integradas do
Active Directory.

<IPaddress> Lista os endereços IP dos servidores que podem executar a limpeza. Se esse
parâmetro for omitido, todos os servidores que hospedam essa zona poderão
limpá-la.

Comentários

Por padrão, todos os servidores que hospedam uma zona podem limpar essa
zona.

Se uma zona estiver hospedada em mais de um servidor DNS, você poderá usar
esse comando para reduzir o número de vezes que uma zona é limpa.

A limpeza deve ser habilitada no servidor DNS e na zona afetada por esse
comando.

Exemplos
dnscmd dnssvr1.contoso.com /zoneresetscavengeservers test.contoso.com
10.0.0.1 10.0.0.2

Comando dnscmd /zoneresetsecondaries


Especifica uma lista de endereços IP de servidores secundários aos quais um servidor
primário responde quando uma transferência de zona for solicitada.

Sintaxe

dnscmd [<servername>] /zoneresetsecondaries <zonename> {/noxfr | /nonsecure


| /securens | /securelist <securityIPaddresses>} {/nonotify | /notify |
/notifylist <notifyIPaddresses>}

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço


IP, FQDN ou nome do host. Se esse parâmetro for omitido, o servidor
local será usado.

<zonename> Especifica o nome da zona que terá seus servidores secundários


redefinidos.

/local Define uma lista mestre local. Esse parâmetro é usado para zonas
integradas do Active Directory.

/noxfr Especifica que nenhuma transferência de zona é permitida.

/nonsecure Especifica que todas as solicitações de transferência de zona são


concedidas.

/securens Especifica que somente o servidor listado no registro de recursos NS


(servidor de nomes) para a zona recebe uma transferência.

/securelist Especifica que as transferências de zona são concedidas apenas para a


lista de servidores. Esse parâmetro deve ser seguido por um endereço IP
ou os endereços que o servidor primário usa.
Parâmetros Descrição

<securityIPaddresses> Lista os endereços IP que recebem transferências de zona do servidor


primário. Esse parâmetro é usado somente com o parâmetro /securelist.

/nonotify Especifica que nenhuma notificação de alteração é enviada para


servidores secundários.

/notify Especifica que notificações de alteração são enviadas para todos os


servidores secundários.

/notifylist Especifica que as notificações de alteração são enviadas apenas para a


lista de servidores. Esse comando deve ser seguido por um endereço IP
ou os endereços que o servidor primário usa.

<notifyIPaddresses> Especifica o endereço IP ou os endereços do servidor secundário ou os


servidores para os quais as notificações de alteração são enviadas. Essa
lista é usada apenas com o parâmetro /notifylist.

Comentários

Use o comando zoneresetsecondaries no servidor primário para especificar como


ele responde às solicitações de transferência de zona de servidores secundários.

Exemplos

dnscmd dnssvr1.contoso.com /zoneresetsecondaries test.contoso.com /noxfr


/nonotify
dnscmd dnssvr1.contoso.com /zoneresetsecondaries test.contoso.com
/securelist 11.0.0.2

Comando dnscmd /zoneresettype


Altera o tipo da zona.

Sintaxe

dnscmd [<servername>] /zoneresettype <zonename> <zonetype> [/overwrite_mem |


/overwrite_ds]
Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP,
FQDN ou nome do host. Se esse parâmetro for omitido, o servidor local será
usado.

<zonename> Identifica a zona na qual o tipo será alterado.

<zonetype> Especifica o tipo da zona a ser criada. Cada tipo tem diferentes parâmetros
necessários, incluindo:
/dsprimary – Cria uma zona integrada do Active Directory.
/primary /file <filename> – Cria uma zona primária padrão.
/secondary <masterIPaddress> [,<masterIPaddress>...] – Cria uma zona
secundária padrão.
/stub <masterIPaddress>[,<masterIPaddress>...] /file <filename> – Cria
uma zona de stub com suporte de arquivo.
/dsstub <masterIPaddress>[,<masterIPaddress>...] – Cria uma zona de
stub integrada do Active Directory.
/forwarder <masterIPaddress[,<masterIPaddress>] ... /file <filename> –
Especifica que a zona criada encaminha as consultas não resolvidas para
outro servidor DNS.
/dsforwarder – Especifica que a zona integrada do Active Directory
criada encaminha as consultas não resolvidas para outro servidor DNS.

/overwrite_mem Substitui dados DNS a partir de dados no AD DS.

/overwrite_ds Substitui os dados existentes no AD DS.

Comentários

Definir o tipo de zona como /dsforwarder cria uma zona que executa o
encaminhamento condicional.

Exemplos

dnscmd dnssvr1.contoso.com /zoneresettype test.contoso.com /primary /file


test.contoso.com.dns
dnscmd dnssvr1.contoso.com /zoneresettype second.contoso.com /secondary
10.0.0.2

Comando dnscmd /zoneresume


Inicia uma zona especificada que foi pausada anteriormente.

Sintaxe

dnscmd [<servername>] /zoneresume <zonename>

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica o nome da zona a ser retomada.

Comentários

Você pode usar essa operação para reiniciar a partir da operação /zonepause.

Exemplos

dnscmd dnssvr1.contoso.com /zoneresume test.contoso.com

Comando dnscmd /zoneupdatefromds


Atualiza a zona integrada do Active Directory especificada do AD DS.

Sintaxe

dnscmd [<servername>] /zoneupdatefromds <zonename>

Parâmetros
Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica o nome da zona a ser atualizada.

Comentários

As zonas integradas do Active Directory executam essa atualização por padrão a


cada cinco minutos. Para alterar esse parâmetro, use o comando dnscmd config
dspollinginterval .

Exemplos

dnscmd dnssvr1.contoso.com /zoneupdatefromds

Comando dnscmd /zonewriteback


Verifica a memória do servidor DNS em busca de alterações relevantes para uma zona
especificada e as grava no armazenamento persistente.

Sintaxe

dnscmd [<servername>] /zonewriteback <zonename>

Parâmetros

Parâmetros Descrição

<servername> Especifica o servidor DNS a ser gerenciado, representado por endereço IP, FQDN
ou nome do host. Se esse parâmetro for omitido, o servidor local será usado.

<zonename> Especifica o nome da zona a ser atualizada.

Comentários
Essa é uma operação no nível da zona. É possível atualizar todas as zonas em um
servidor DNS usando a operação /writebackfiles.

Exemplos

dnscmd dnssvr1.contoso.com /zonewriteback test.contoso.com

Links relacionados
Chave da sintaxe de linha de comando
doskey
Artigo • 12/04/2023

Chama o Doskey.exe, que lembra comandos de linha de comando inseridos


anteriormente, edita linhas de comando e cria macros.

Sintaxe

doskey [/reinstall] [/listsize=<size>] [/macros:[all | <exename>] [/history]


[/insert | /overstrike] [/exename=<exename>] [/macrofile=<filename>]
[<macroname>=[<text>]]

Parâmetros

Parâmetro Descrição

Reinstalar Instala uma nova cópia do Doskey.exe e limpa o buffer de histórico de


comandos.

/listsize= <size> Especifica o número máximo de comandos no buffer de histórico.

/macros Exibe uma lista de todas as macros de doskey . Você pode usar o
símbolo de redirecionamento ( > ) com /macros para redirecionar a lista
para um arquivo. Você pode abreviar /macros para /m.

/macros:all Exibe macros doskey para todos os executáveis.

/macros: <exename> Exibe macros doskey para o executável especificado por exename.

/history Exibe todos os comandos armazenados na memória. Você pode usar o


símbolo de redirecionamento ( > ) com /history para redirecionar a lista
para um arquivo. Você pode abreviar /history como /h.

/insert Especifica que o novo texto que você digita é inserido no texto antigo.

/overstrike Especifica que o novo texto substitui o texto antigo.

/exename= <exename> Especifica o programa (ou seja, executável) no qual a macro doskey é
executada.

/macrofile= <filename> Especifica um arquivo que contém as macros que você deseja instalar.
Parâmetro Descrição

<macroname> =[ <text> ] Cria uma macro que executa os comandos especificados por Text.
MacroName especifica o nome que você deseja atribuir à macro. Text
especifica os comandos que você deseja gravar. Se Text for deixado em
branco, MacroName será desmarcado de todos os comandos atribuídos.

/? Exibe a ajuda no prompt de comando.

Comentários

Determinados programas interativos baseados em caracteres, como depuradores


de programas ou FTP (programas de transferência de arquivos), usam
automaticamente Doskey.exe. Para usar Doskey.exe, um programa deve ser um
processo de console e usar entrada em buffer. As atribuições de chave do
programa substituem as atribuições de chave doskey . Por exemplo, se o
programa usar a tecla F7 para uma função, você não poderá obter um histórico de
comandos de doskey em uma janela pop-up.

Você pode usar Doskey.exe para editar a linha de comando atual, mas não pode
usar as opções de linha de comando no prompt de comando de um programa.
Você deve executar opções de linha de comando doskey antes de iniciar um
programa. Se você usar Doskey.exe dentro de um programa, as principais
atribuições desse programa têm precedência e alguns Doskey.exe chaves de
edição podem não funcionar.

Com Doskey.exe, você pode manter um histórico de comandos para cada


programa iniciado ou repetido. Você pode editar comandos anteriores no prompt
do programa e iniciar macros doskey criadas para o programa. Se você sair e
reiniciar um programa na mesma janela do Prompt de Comando, o histórico de
comandos da sessão anterior do programa estará disponível.

Para cancelar um comando, você pode usar qualquer uma das seguintes chaves
depois de iniciar Doskey.exe:

Chave Descrição

SETA PARA CIMA Recall do comando que você usou antes do que é exibido.

SETA PARA BAIXO Recall o comando que você usou antes do que é exibido.

PAGE UP Recall o primeiro comando que você usou na sessão atual.

PAGE DOWN Recalls o primeiro comando que você usou na sessão atual.
A tabela a seguir lista as chaves de edição de doskey e suas funções:

Tecla ou Descrição
combinação
de teclas

SETA PARA A Move o ponto de inserção para trás por caractere.


ESQUERDA

SETA PARA A Move o ponto de inserção para frente por caractere.


DIREITA

CTRL + SETA Move o ponto de inserção para trás por palavra.


PARA A
ESQUERDA

CTRL + SETA Move o ponto de inserção para frente por palavra.


PARA A
DIREITA

HOME Move o ponto de inserção para o início da linha.

END Move o ponto de inserção para o final da linha.

ESC Limpa o comando da exibição.

F1 Copia um caractere de uma coluna no modelo para a mesma coluna na


janela prompt de comando. (O modelo é um buffer de memória que
contém o último comando digitado.)

F2 Pesquisa no modelo a próxima tecla que você digita depois de pressionar


F2. Doskey.exe insere o texto do modelo até, mas não incluindo, o caractere
especificado.

F3 Copia o restante do modelo para a linha de comando. O Doskey.exe


começa a copiar caracteres da posição no modelo que corresponde à
posição indicada pelo ponto de inserção na linha de comando.

F4 Exclui todos os caracteres da posição atual do ponto de inserção até, mas


não incluindo, a próxima ocorrência do caractere que você digita depois de
pressionar F4.

F5 Copia o modelo para a linha de comando atual.

F6 Coloca um caractere de fim de arquivo (CTRL+Z) na posição atual do ponto


de inserção.
Tecla ou Descrição
combinação
de teclas

F7 Exibe (em uma caixa de diálogo) todos os comandos para este programa
armazenados na memória. Use a tecla seta para cima e a tecla seta para
baixo para selecionar o comando desejado e pressione ENTER para executar
o comando. Você também pode anotar o número sequencial na frente do
comando e usar esse número em conjunto 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 no buffer de histórico que começam com os


caracteres no comando atual.

F9 Solicita um número de comando do buffer de histórico e exibe o comando


associado ao número especificado. Pressione Enter para executar o
comando. Para exibir todos os números e seus comandos associados,
pressione F7.

Alt+F10 Imprime todas as definições de macro.

Se você pressionar a tecla INSERT, poderá digitar texto na linha de comando


doskey no meio do texto existente sem substituir o texto. No entanto, depois de
pressionar ENTER, Doskey.exe retorna o teclado para o modo Substituir. Você
deve pressionar INSERT novamente para retornar ao modo Inserir.

O ponto de inserção altera a forma quando você usa a tecla INSERT para alterar de
um modo para o outro.

Se você quiser personalizar como Doskey.exe funciona com um programa e criar


macros doskey para esse programa, poderá criar um programa em lote que
modifique Doskey.exe e inicie o programa.

Você pode usar Doskey.exe para criar macros que executam um ou mais
comandos. A tabela a seguir lista caracteres especiais que você pode usar para
controlar operações de comando ao definir uma macro.

Caractere Descrição

$G ou $g Redireciona a saída. Use um desses caracteres especiais para enviar a saída


para um dispositivo ou um arquivo em vez de para a tela. Esse caractere é
equivalente ao símbolo de redirecionamento para saída ( > ).
Caractere Descrição

$G$G ou Acrescenta a saída ao final de um arquivo. Use um desses caracteres duplos


$g$g para acrescentar a saída a um arquivo existente em vez de substituir os dados
no arquivo. Esses caracteres duplos são equivalentes ao símbolo de
redirecionamento de acréscimo para saída ( >> ).

$L ou $l Redireciona a entrada. Use um desses caracteres especiais para ler a entrada


de um dispositivo ou um arquivo em vez de do teclado. Esse caractere é
equivalente ao símbolo de redirecionamento para entrada ( < ).

$B ou $b Envia a saída da macro para um comando. Esses caracteres especiais são


equivalentes a usar o pipe ( e * .

$T ou $t Separa comandos. Use um desses caracteres especiais para separar comandos


ao criar macros ou digitar comandos na linha de comando doskey. Esses
caracteres especiais são equivalentes a usar o e comercial ( & ) em uma linha de
comando.

$$ Especifica o caractere cifrão ( $ ).

$1 até $9 Represente as informações de linha de comando que você deseja especificar


ao executar a macro. Os caracteres especiais $1 a $9 são parâmetros de lote
que permitem que você use dados diferentes na linha de comando sempre
que executar a macro. O caractere $1 em um comando doskey é semelhante
ao caractere %1 em um programa em lote.

$* Representa todas as informações de 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 $1 de lote por meio de $9 ,
com uma diferença importante: tudo o que você digita na linha de comando
depois que o nome da macro é substituído pelo $* na macro.

Para executar uma macro, digite o nome da macro no prompt de comando,


começando na primeira posição. Se a macro tiver sido definida com $* ou
qualquer um dos parâmetros de lote $1 por meio de $9 , use um espaço para
separar os parâmetros. Não é possível executar uma macro doskey de um
programa em lotes.

Se você sempre usar um comando específico com opções de linha de comando


específicas, poderá criar uma macro que tenha o mesmo nome do comando. Para
especificar se você deseja executar a macro ou o comando, siga estas diretrizes:

Para executar a macro, digite o nome da macro no prompt de comando. Não


adicione um espaço antes do nome da macro.

Para executar o comando, insira um ou mais espaços no prompt de comando e


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

doskey /macros > macinit

Para usar as macros armazenadas no Macinit, digite:

doskey /macrofile=macinit

Para criar um programa em lotes chamado Tmp.bat que contém comandos usados
recentemente, digite:

doskey /history> tmp.bat

Para definir uma macro com vários comandos, use $t para separar comandos, da
seguinte maneira:

doskey tx=cd temp$tdir/w $*

No exemplo anterior, a macro TX altera o diretório atual para Temp e exibe uma
listagem de diretórios em formato de exibição ampla. Você pode usar $* no final da
macro para acrescentar outras opções de linha de comando a dir ao executar a opção
tx.

A macro a seguir usa um parâmetro de lote para um novo nome de diretório:

doskey mc=md $1$tcd $1

A macro cria um novo diretório e, em seguida, muda para o novo diretório do diretório
atual.
Para usar a macro anterior para criar e alterar para um diretório chamado Livros, digite:

mc books

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

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

Para usar a macro anterior, inicie o FTP. No prompt do FTP, digite:

go

O FTP executa os comandos open, mget e bye.

Para criar uma macro que formata de forma rápida e incondicional um disco, digite:

doskey qf=format $1 /q /u

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

qf a:

Para excluir uma macro chamada vlist, digite:

doskey vlist =

Links relacionados
Chave da sintaxe de linha de comando
driverquery
Artigo • 12/04/2023

Permite que um administrador exiba uma lista de drivers de dispositivo instalados e suas
propriedades. Se usado sem parâmetros, a driverquery é executada no computador
local.

Sintaxe

driverquery [/s <system> [/u [<domain>\]<username> [/p <password>]]] [/fo


{table | list | csv}] [/nh] [/v | /si]

Parâmetros

Parâmetro Descrição

/s <system> Especifica o nome ou endereço IP de um computador remoto. Não use barras


invertidas. O padrão é o computador local.

/u Executa o comando com as credenciais da conta de usuário conforme especificado


[<domain>] por usuário ou domínio\usuário. Por padrão, /s usa as credenciais do usuário que
<username> está conectado ao computador que está emitindo o comando. /u não pode ser
usado a menos que /s seja especificado.

/p Especifica a senha da conta de usuário definida no parâmetro /u. /p não pode ser
<password> usado, a menos que /u seja especificado.

/fo tabela Formata a saída como uma tabela. Esse é o padrão.

/fo lista Formata a saída como uma tabela.

/fo csv Formata a saída com valores separados por vírgulas.

/nh Omite a linha de cabeçalho das informações de driver exibidas. Não é válido se o
parâmetro /fo estiver definido como lista.

/v Exibe a saída detalhada. /v não é válido para drivers assinados.

/si Fornece informações sobre drivers assinados.

/? Exibe a ajuda no prompt de comando.


Exemplos
Para exibir uma lista de drivers de dispositivo instalados no computador local, digite:

driverquery

Para exibir a saída em um formato CSV (valores separados por vírgula), digite:

driverquery /fo csv

Para ocultar a linha de cabeçalho na saída, digite:

driverquery /nh

Para usar o comando driverquery em um servidor remoto chamado server1 usando suas
credenciais atuais no computador local, digite:

driverquery /s server1

Para usar o comando driverquery em um servidor remoto chamado server1 usando as


credenciais para user1 no maindom de domínio, digite:

driverquery /s server1 /u maindom\user1 /p p@ssw3d

Links relacionados
Chave da sintaxe de linha de comando
echo
Artigo • 10/04/2023

Exibe mensagens ou liga ou desliga o recurso de eco de comando. Se usado sem


parâmetros, echo exibirá a configuração de eco atual.

Sintaxe

echo [<message>]
echo [on | off]

Parâmetros

Parâmetro Descrição

[on | off] Liga ou desliga o recurso de eco de comando. O eco de comando fica ligado por
padrão.

<message> Especifica o texto a ser exibido na tela.

/? Exibe a ajuda no prompt de comando.

Comentários

O comando echo <message> é particularmente útil quando echo está desligado.


Para exibir uma mensagem com várias linhas sem exibir comandos, você pode
incluir vários comandos echo <message> após o comando echo off em seu
programa de lote.

Após echo ser desligado, o prompt de comando não aparece na janela do Prompt
de Comando. Para exibir o prompt de comando, digite echo on.

Se usado em um arquivo de lote, echo on e echo off não afetam a configuração


no prompt de comando.

Para evitar o eco de um comando específico em um arquivo de lote, insira um sinal


@ na frente do comando. Para evitar o eco de todos os comandos em um arquivo

de lote, inclua o comando echo off no início do arquivo.


Para exibir um ponto de exclamação ( ! ) em scripts de lote, coloque a palavra ou
frase entre aspas duplas seguida por um acento circunflexo antes do ponto de
exclamação ( "Hello World^!" ). Como alternativa, um acento circunflexo duplo ( ^^ )
pode ser usado sem a necessidade de aspas duplas ( Hello World^^! ).

Para exibir uma barra vertical ( | ), um e comercial ( & ) ou um caractere de


redirecionamento ( < ou > ) quando estiver usando echo, use um circunflexo ( ^ )
imediatamente antes desse caractere. Por exemplo: ^| , ^& , ^> ou ^< . Para exibir
um circunflexo, digite dois circunflexos em sucessão ( ^^ ).

Exemplos
Para exibir a configuração de echo atual, digite:

echo

Para ecoar uma linha em branco na tela, digite:

echo.

7 Observação

Não inclua um espaço antes do ponto final. Caso contrário, o ponto final será
exibido em vez de uma linha em branco.

Para evitar o eco de comandos no prompt de comando, digite:

echo off

7 Observação

Quando echo for desligado, o prompt de comando não aparecerá na janela do


Prompt de Comando. Para exibir o prompt de comando novamente, digite echo
on.
Para impedir que todos os comandos em um arquivo de lote (incluindo o comando
echo off) sejam exibidos na tela, na primeira linha do arquivo de lote, digite:

@echo off

Você pode usar o comando echo como parte de uma instrução if. Por exemplo, para
pesquisar qualquer arquivo no diretório atual com a extensão de nome de arquivo .rpt e
ecoar uma mensagem se esse arquivo for encontrado, digite:

if exist *.rpt echo The report has arrived.

O arquivo de lote a seguir pesquisa arquivos no diretório atual com a extensão de nome
de arquivo .txt e exibe uma mensagem indicando os resultados da pesquisa:

@echo off
if not exist *.txt (
echo This directory contains no text files.
) else (
echo This directory contains the following text files:
echo.
dir /b *.txt
)

Se nenhum arquivo .txt for encontrado quando o arquivo de lote for executado, a
seguinte mensagem será exibida:

This directory contains no text files.

Se arquivos .txt forem encontrados quando o arquivo de lote for executado, a seguinte
saída será exibida (por exemplo, suponha que os arquivos File1.txt, File2.txt e File3.txt
existam):

This directory contains the following text files:


File1.txt
File2.txt
File3.txt

Links relacionados
Chave da sintaxe de linha de comando
editar
Artigo • 12/04/2023

Inicia o Editor do MS-DOS, que cria e altera arquivos de texto ASCII.

Sintaxe

edit [/b] [/h] [/r] [/s] [/<nnn>] [[<drive>:][<path>]<filename> [<filename2>


[...]]

Parâmetros

Parâmetro Descrição

[<drive>:] Especifica o local e o nome de um ou mais arquivos de texto ASCII. Se o arquivo


[<path>] não existir, o Editor do MS-DOS o criará. Se o arquivo existir, o Editor do MS-DOS
<filename> o abrirá e exibirá seu conteúdo na tela. A opção filename pode conter caracteres
[<filename2> curinga (* e ?). Separa vários nomes de arquivo com espaços.
[...]]

/b Força o modo monocromático, para que o Editor do MS-DOS seja exibido em


preto e branco.

/h Exibe o número máximo de linhas possíveis para o monitor atual.

/r Carrega arquivos no modo somente leitura.

/s Força o uso de nomes de arquivo curtos.

<nnn> Carrega arquivos binários, encapsulando linhas para caracteres largos nnn.

/? Exibe a ajuda no prompt de comando.

Comentários
Para obter ajuda adicional, abra o Editor do MS-DOS e pressione a tecla F1.

Alguns monitores não dão suporte à exibição de teclas de atalho por padrão. Se o
monitor não exibir teclas de atalho, use /b.

Exemplos
Para abrir o Editor do MS-DOS, digite:

edit

Para criar e editar um arquivo chamado newtextfile.txt no diretório atual, digite:

edit newtextfile.txt

Links relacionados
Chave da sintaxe de linha de comando
endlocal
Artigo • 10/04/2023

Encerra a localização de alterações de ambiente em um arquivo de lote e restaura


variáveis de ambiente para seus valores antes da execução do comando setlocal
correspondente.

Sintaxe

endlocal

Parâmetros

Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Comentários
O comando endlocal não tem efeito fora de um script ou arquivo de lote.

Há um comando endlocal implícito no final de um arquivo de lote.

Se as extensões de comando estiverem habilitadas (elas ficam habilitadas por


padrão), o comando endlocal restaurará o estado das extensões de comando (ou
seja, habilitadas ou desabilitadas) para o que eram antes da execução do comando
setlocal correspondente.

7 Observação

Para obter mais informações sobre como habilitar e desabilitar extensões de


comando, consulte o Comando cmd.

Exemplos
Você pode localizar variáveis de ambiente em um arquivo de lote. Por exemplo, o
programa a seguir inicia o programa de lote superapp na rede, direciona a saída para
um arquivo e exibe o arquivo no Bloco de Notas:

@echo off
setlocal
path=g:\programs\superapp;%path%
call superapp>c:\superapp.out
endlocal
start notepad c:\superapp.out

Links relacionados
Chave da sintaxe de linha de comando
end restore
Artigo • 10/04/2023

Encerra uma sessão de restauração e emite um evento PostRestore aos gravadores


envolvidos.

Syntax

end restore

Links relacionados
Chave da sintaxe de linha de comando
erase
Artigo • 17/04/2023

Exclui um ou mais arquivos. Caso use erase para excluir um arquivo do disco, não
poderá recuperá-lo.

7 Observação

Esse comando é igual ao comando del.

Sintaxe

erase [/p] [/f] [/s] [/q] [/a[:]<attributes>] <names>


del [/p] [/f] [/s] [/q] [/a[:]<attributes>] <names>

Parâmetros

Parâmetro Descrição

<names> Especifica uma lista de um ou mais arquivos ou diretórios. Curingas podem


ser usados para excluir vários arquivos. Se um diretório for especificado,
todos os arquivos dentro do diretório serão excluídos.

/p Solicita uma confirmação antes de excluir o arquivo especificado.

/f Força a exclusão de arquivos somente leitura.

/s Exclui arquivos especificados do diretório atual e de todos os subdiretórios.


Exibe os nomes dos arquivos conforme eles estão sendo excluídos.

/q Especifica o modo silencioso. Não é feita uma solicitação de exclusão.

/a[:] <attributes> Exclui arquivos com base nos seguintes atributos de arquivo:
r Arquivos somente leitura
h Arquivos ocultos
i Arquivos sem conteúdo indexado
s Arquivos do sistema
a Arquivos prontos para arquivamento
l Pontos de nova análise
- Usado como um prefixo que significa 'not'
Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Comentários

Caso use o comando erase /p , você visualizará a seguinte mensagem:

FileName, Delete (Y/N)?

Para confirmar a exclusão, pressione Y. Para cancelar a exclusão e exibir o próximo


nome de arquivo (caso tenha especificado um grupo de arquivos), pressione N.
Para interromper o comando erase, pressione CTRL+C.

Caso desabilite a extensão de comando, o parâmetro /s exibirá os nomes de todos


os arquivos que não foram encontrados, em vez de exibir os nomes dos arquivos
que estão sendo excluídos.

Caso especifique pastas específicas no parâmetro <names> , todos os arquivos


incluídos também serão excluídos. Por exemplo, caso queira excluir todos os
arquivos na pasta \work, digite:

erase \work

Use os curingas (* e ?) para excluir mais de um arquivo por vez. No entanto, para
evitar a exclusão de arquivos involuntariamente, use os curingas com cautela. Por
exemplo, caso digite o seguinte comando:

erase *.*

O comando erase exibe a seguinte solicitação:

Are you sure (Y/N)?

Para excluir todos os arquivos no diretório atual, pressione Y e depois ENTER. Para
cancelar a exclusão, pressione N e depois ENTER.

7 Observação
Antes de usar caracteres curinga com o comando erase, use os mesmos
caracteres curinga com o comando dir para listar todos os arquivos que serão
excluídos.

Exemplos
Para excluir todos os arquivos em uma pasta chamada Teste na unidade C, digite um
dos seguintes:

erase c:\test
erase c:\test\*.*

Para excluir todos os arquivos com a extensão de nome de arquivo .bat do diretório
atual, digite:

erase *.bat

Para excluir todos os arquivos somente leitura no diretório atual, digite:

erase /a:r *.*

Links relacionados
Chave da sintaxe de linha de comando

Comando del
eventcreate
Artigo • 17/04/2023

Permite que um administrador crie um evento personalizado em um log de eventos


especificado.

) Importante

Eventos personalizados não podem ser gravados no log de segurança.

Sintaxe

eventcreate [/s <computer> [/u <domain\user> [/p <password>]] {[/l


{APPLICATION|SYSTEM}]|[/so <srcname>]} /t
{ERROR|WARNING|INFORMATION|SUCCESSAUDIT|FAILUREAUDIT} /id <eventID> /d
<description>

Parâmetros

Parâmetro Descrição

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (não use


barras invertidas). O padrão é o computador local.

/u <domain\user> Executa o comando com as permissões de conta do usuário especificado


por <user> ou <domain\user> . O padrão são as permissões do usuário
conectado atualmente no computador que emite o comando.

/p <password> Especifica a senha da conta de usuário especificada no parâmetro /u.

/l {APPLICATION | Especifica o nome do log de eventos em que o evento será criado. Os


SYSTEM} nomes de log válidos são APPLICATION ou SYSTEM.

/so <srcname> Especifica a origem a ser usada para o evento. Uma fonte válida pode
ser qualquer cadeia de caracteres e deve representar o aplicativo ou
componente que está gerando o evento.

/t {ERROR | WARNING | Especifica o tipo de evento a ser criado. Os tipos válidos são ERROR,
INFORMATION | WARNING, INFORMATION, SUCCESSAUDIT e FAILUREAUDIT.
SUCCESSAUDIT |
FAILUREAUDIT}
Parâmetro Descrição

/id <eventID> Especifica a ID do evento. Uma ID válida é qualquer número de 1 a 1000.

/d <description> Especifica a descrição a ser usada para o evento recém-criado.

/? Exibe a ajuda no prompt de comando.

Exemplos
Os exemplos a seguir mostram como você pode usar o comando eventcreate:

eventcreate /t ERROR /id 100 /l application /d "Create event in application


log"
eventcreate /t INFORMATION /id 1000 /d "Create event in WinMgmt source"
eventcreate /t ERROR /id 201 /so winword /l application /d "New src Winword
in application log"
eventcreate /s server /t ERROR /id 100 /l application /d "Remote machine
without user credentials"
eventcreate /s server /u user /p password /id 100 /t ERROR /l application /d
"Remote machine with user credentials"
eventcreate /s server1 /s server2 /u user /p password /id 100 /t ERROR /d
"Creating events on Multiple remote machines"
eventcreate /s server /u user /id 100 /t WARNING /d "Remote machine with
partial user credentials"

Links relacionados
Chave da sintaxe de linha de comando
evntcmd
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Configura a tradução de eventos para interceptações, destinos de interceptação ou


ambos com base em informações em um arquivo de configuração.

Sintaxe

evntcmd [/s <computername>] [/v <verbositylevel>] [/n] <filename>

Parâmetros

Parâmetro Descrição

/s <computername> Especifica, por nome, o computador no qual queira configurar a tradução de


eventos para interceptações, destinos de interceptação ou ambos. Caso não
especifique um computador, a configuração ocorrerá no computador local.

/v Especifica quais tipos de mensagens de status aparecem como


<verbositylevel> interceptações e destinos de interceptação são configurados. Este parâmetro
deve ser um número inteiro entre 0 e 10. Caso especifique 10, todos os tipos
de mensagens serão exibidos, incluindo mensagens de rastreamento e avisos
sobre se a configuração de interceptação foi bem-sucedida. Caso especifique
0, nenhuma mensagem será exibida.

/n Especifica que o serviço de SNMP não deve ser reiniciado se este


computador receber alterações de configuração de interceptação.

<filename> Especifica, por nome, o arquivo de configuração que contém informações


sobre a tradução de eventos para interceptações e destinos de interceptação
que queira configurar.

/? Exibe a ajuda no prompt de comando.

Comentários
caso queira configurar interceptações, mas não interceptar destinos, poderá criar
um arquivo de configuração válido usando o Tradutor de Evento em Interceptação,
que é um utilitário gráfico. Caso tenha o serviço de SNMP instalado, poderá iniciar
o Tradutor de Evento em Interceptação digitando evntwin em um prompt de
comando. Depois de definir as interceptações desejadas, selecione Exportar para
criar um arquivo adequado para uso com evntcmd. Use o Tradutor de Evento em
Interceptação para criar facilmente um arquivo de configuração e, em seguida, use
o arquivo de configuração com evntcmd no prompt de comando para configurar
rapidamente interceptações em vários computadores.

A sintaxe para configurar uma interceptação é a seguinte:

#pragma add <eventlogfile> <eventsource> <eventID> [<count> [<period>]]

Onde o texto a seguir é verdadeiro:

#pragma deve aparecer no início de cada entrada no arquivo.

O parâmetro adicionar especifica que você deseja adicionar um evento para


interceptar a configuração.

Os parâmetros eventlogfile, eventsource e eventID são necessários e, em que


eventlogfile especifica o arquivo no qual o evento é registrado, eventsource
especifica o aplicativo que gera o evento e eventID especifica o número
exclusivo que identifica cada evento.

Para determinar quais valores correspondem a cada evento, inicie o Tradutor de


Evento em Interceptação digitando evntwin em um prompt de comando.
Selecione Personalizado e, em seguida, selecione editar. Em Origens do Evento,
navegue pelas pastas até localizar o evento que queira configurar, selecione ele e
selecione Adicionar. Informações sobre a origem do evento, o arquivo de log de
eventos e a ID do evento aparecem em Origem, Log e ID específica da
interceptação, respectivamente.

O parâmetro contagem é opcional e especifica quantas vezes o evento deve


ocorrer antes que uma mensagem de interceptação seja enviada. Caso não use
esse parâmetro, a mensagem de interceptação será enviada depois que o
evento ocorrer uma vez.

O parâmetro período é opcional, mas exige que use o parâmetro contagem. O


parâmetro período especifica um período de tempo (em segundos) durante o
qual o evento deve ocorrer o número de vezes especificado com o parâmetro
contagem antes que uma mensagem de interceptação seja enviada. Caso não
use esse parâmetro, uma mensagem de interceptação será enviada depois que
o evento ocorrer o número de vezes especificado com o parâmetro contagem,
independentemente do tempo decorrido entre as ocorrências.

A sintaxe para remover uma interceptação é a seguinte:

#pragma delete <eventlogfile> <eventsource> <eventID>

Onde o texto a seguir é verdadeiro:

#pragma deve aparecer no início de cada entrada no arquivo.

O parâmetro excluir especifica que você deseja excluir um evento para


interceptar a configuração.

Os parâmetros eventlogfile, eventsource e eventID são necessários e, em que


eventlogfile especifica o arquivo no qual o evento é registrado, eventsource
especifica o aplicativo que gera o evento e eventID especifica o número
exclusivo que identifica cada evento.

Para determinar quais valores correspondem a cada evento, inicie o Tradutor de


Evento em Interceptação digitando evntwin em um prompt de comando.
Selecione Personalizado e, em seguida, selecione editar. Em Origens do Evento,
navegue pelas pastas até localizar o evento que queira configurar, selecione ele e
selecione Adicionar. Informações sobre a origem do evento, o arquivo de log de
eventos e a ID do evento aparecem em Origem, Log e ID específica da
interceptação, respectivamente.

A sintaxe para configurar um destino de interceptação é a seguinte:

#pragma add_TRAP_DEST <communityname> <hostID>

Onde o texto a seguir é verdadeiro:

#pragma deve aparecer no início de cada entrada no arquivo.

O parâmetro add_TRAP_DEST especifica que você deseja que mensagens de


interceptação sejam enviadas para um host especificado em uma comunidade.
O parâmetro communityname especifica, por nome, a comunidade na qual as
mensagens de interceptação são enviadas.

O parâmetro hostID especifica, por nome ou endereço IP, o host para o qual
queira que as mensagens de interceptação sejam enviadas.

A sintaxe para remover um destino de interceptação é a seguinte:

#pragma delete_TRAP_DEST <communityname> <hostID>

Onde o texto a seguir é verdadeiro:

#pragma deve aparecer no início de cada entrada no arquivo.

O parâmetro delete_TRAP_DEST especifica que você não deseja que


mensagens de interceptação sejam enviadas para um host especificado em uma
comunidade.

O parâmetro communityname especifica, por nome, a comunidade na qual as


mensagens de interceptação não devem ser enviadas.

O parâmetro hostID especifica, por nome ou endereço IP, o host para o qual
você não deseja que as mensagens de interceptação sejam enviadas.

Exemplos
Os exemplos a seguir ilustram entradas no arquivo de configuração para o comando
evntcmd. Eles não foram projetados para serem digitado em um prompt de comando.

Para enviar uma mensagem de interceptação se o serviço de Log de Eventos for


reiniciado, digite:

#pragma add System Eventlog 2147489653

Para enviar uma mensagem de interceptação se o serviço de Log de Eventos for


reiniciado duas vezes em três minutos, digite:

#pragma add System Eventlog 2147489653 2 180


Para parar de enviar uma mensagem de interceptação sempre que o serviço de Log de
Eventos for reiniciado, digite:

#pragma delete System Eventlog 2147489653

Para enviar mensagens de interceptação dentro da comunidade denominada Público


para o host com o endereço IP 192.168.100.100, digite:

#pragma add_TRAP_DEST public 192.168.100.100

Para enviar mensagens de interceptação dentro da comunidade denominada Privada


para o host denominada Host1, digite:

#pragma add_TRAP_DEST private Host1

Para parar de enviar mensagens de interceptação dentro da comunidade denominada


Privada para o mesmo computador no qual está configurando destinos de
interceptação, digite:

#pragma delete_TRAP_DEST private localhost

Links relacionados
Chave da sintaxe de linha de comando
exec
Artigo • 11/04/2023

Executa um arquivo de script no computador local. Esse comando também duplica ou


restaura os dados como parte de uma sequência de backup ou restauração. Se o script
falhar, um erro será retornado e DiskShadow será encerrado.

O arquivo pode ser um script cmd.

Sintaxe

exec <scriptfile.cmd>

Parâmetros

Parâmetro Descrição

<scriptfile.cmd> Especifica o arquivo de script a ser executado.

Links relacionados
Chave da sintaxe de linha de comando

comando diskshadow
exit
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Sai do interpretador de comando ou do script em lote atual.

Sintaxe

exit [/b] [<exitcode>]

Parâmetros

Parâmetro Descrição

/b Sai do script em lote atual em vez de sair do Cmd.exe. Se executado de fora de um


script em lote, sai do Cmd.exe.

<exitcode> Especifica um valor numérico. Se /b for especificado, a variável de ambiente


ERRORLEVEL será definida para esse número. Se você estiver saindo do
interpretador de comando, o código de saída do processo será definido para esse
número.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para fechar o interpretador de comando, digite:

exit

Links relacionados
Chave da sintaxe de linha de comando
expand
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Expande um ou mais arquivos compactados. Você também pode usar esse comando
para recuperar arquivos compactados de discos de distribuição.

O comando expand também pode ser executado no Console de Recuperação do


Windows usando parâmetros diferentes. Para obter mais informações, consulte WinRE
(Ambiente de Recuperação do Windows).

Sintaxe

expand [-r] <source> <destination>


expand -r <source> [<destination>]
expand -i <source> [<destination>]
expand -d <source>.cab [-f:<files>]
expand <source>.cab -f:<files> <destination>

Parâmetros

Parâmetro Descrição

-r Renomeia arquivos expandidos.

source Especifica os arquivos a serem expandidos. Source pode incluir uma letra de unidade
e dois-pontos, um nome de diretório, um nome de arquivo ou uma combinação
deles. Você pode usar curingas (* ou ?).

destino Especifica onde os arquivos devem ser expandidos.


Se source consistir em vários arquivos e você não especificar -r, destination deverá
ser um diretório que já existe. Destination pode incluir uma letra de unidade e dois-
pontos, um nome de diretório, um nome de arquivo ou uma combinação deles.
Especificação de file \| path de destino.

-i Renomeia arquivos expandidos, mas ignora a estrutura de diretórios.

-d Exibe uma lista de arquivos no local de origem. Não expande nem extrai os
arquivos.
Parâmetro Descrição

-f: <files> Especifica os arquivos em um arquivo cabinet (.cab) que você deseja expandir. Você
pode usar curingas (* ou ?).

/? Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
expand vdisk
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Expande um VHD (disco rígido virtual) para um tamanho especificado.

Um VHD deve ser selecionado e desanexado para que essa operação seja bem-
sucedida. Use o comando select vdisk para selecionar um volume e mudar o foco para
ele.

Sintaxe

expand vdisk maximum=<n>

Parâmetros

Parâmetro Descrição

maximum= <n> Especifica o novo tamanho para o VHD em megabytes (MB).

Exemplos
Para expandir o VHD selecionado para 20 GB, digite:

expand vdisk maximum=20000

Links relacionados
Chave da sintaxe de linha de comando

comando select vdisk

comando attach vdisk


comando compact vdisk

comando detach vdisk

comando detail vdisk

comando merge vdisk

Comando list
expose
Artigo • 12/04/2023

Expõe uma cópia de sombra persistente como uma letra da unidade, compartilhamento
ou ponto de montagem.

Sintaxe

expose <shadowID> {<drive:> | <share> | <mountpoint>}

Parâmetros

Parâmetro Descrição

shadowID Especifica a ID de sombra da cópia de sombra que você deseja expor. Você
também pode usar um alias existente ou uma variável de ambiente no lugar de
shadowID. Use add sem parâmetros para ver os aliases existentes.

<drive:> Expõe a cópia de sombra especificada como uma letra da unidade (por exemplo,
p: ).

<share> Expõe a cópia de sombra especificada em um compartilhamento (por exemplo,


\\machinename ).

<mountpoint> Expõe a cópia de sombra especificada para um ponto de montagem (por


exemplo, C:\shadowcopy ).

Exemplos
Para expor a cópia de sombra persistente associada à variável de ambiente
VSS_SHADOW_1 como unidade X, digite:

expose %vss_shadow_1% x:

Links relacionados
Chave da sintaxe de linha de comando
comando diskshadow
extend
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Estende o volume ou a partição com foco e seu sistema de arquivos em espaço livre
(não alocado) de um disco.

Sintaxe

extend [size=<n>] [disk=<n>] [noerr]


extend filesystem [noerr]

Parâmetros

Parâmetro Descrição

size= <n> Especifica a quantidade de espaço em MB (megabytes), para adicionar ao volume


ou partição atual. Se nenhum tamanho for dado, todo o espaço livre contíguo
disponível no disco será usado.

disk= <n> Especifica o disco no qual o volume ou partição é estendido. Se nenhum disco for
especificado, o volume ou partição será estendido no disco atual.

filesystem Estende o sistema de arquivos do volume com foco. Para uso somente em discos
em que o sistema de arquivos não foi estendido com o volume.

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Comentários
Em discos básicos, o espaço livre deve estar no mesmo disco que o volume ou
partição com foco. Ele também deve seguir imediatamente o volume ou a partição
com foco (ou seja, ele deve começar no próximo deslocamento do setor).

Em discos dinâmicos com volumes simples ou estendidos, um volume pode ser


estendido para qualquer espaço livre em qualquer disco dinâmico. Usando esse
comando, você pode converter um volume dinâmico simples em um volume
dinâmico estendido. Volumes espelhados, RAID-5 e distribuídos não podem ser
estendidos.

Se a partição foi previamente formatada com o sistema de arquivos NTFS, o


sistema de arquivos é estendido automaticamente para preencher a partição maior
e não ocorrerá nenhuma perda de dados.

Se a partição foi previamente formatada com um sistema de arquivos diferente de


NTFS, ocorre falha de comando sem alteração na partição.

Se a partição não foi formatada anteriormente com um sistema de arquivos, a


partição ainda será estendida.

A partição deve ter um volume associado antes de ser estendida.

Exemplos
Para estender o volume ou a partição com foco em 500 megabytes, no disco 3, digite:

extend size=500 disk=3

Para estender o sistema de arquivos de um volume depois que ele foi estendido, digite:

extend filesystem

Links relacionados
Chave da sintaxe de linha de comando
extract / extrac32
Artigo • 12/04/2023

Extrai arquivos de um gabinete ou fonte.

7 Observação

Em Windows Server 2016 e mais recentes e em Windows 10, o arquivo de


programa Extract.exe não é fornecido ou dá suporte. Ele é substituído por
Extrac32.exe, originalmente parte do Internet Explorer, agora faz parte do sistema
operacional.

Syntax

Extract.exe

extract [/y] [/a] [/d | /e] [/l dir] cabinet [filename ...]
extract [/y] source [newname]
extract [/y] /c source destination

Parâmetros

Parâmetro Descrição

gabinete Use se quiser extrair dois ou mais arquivos.

filename Nome do arquivo a ser extraído do gabinete. Curingas e vários nomes de arquivo
(separados por espaços em branco) podem ser usados.

source Arquivo compactado (um gabinete com apenas um arquivo).

novonome Novo nome de arquivo para fornecer o arquivo extraído. Se não for fornecido, o
nome original será usado.

/a Processe TODOS os gabinetes. Segue a cadeia de gabinetes começando no primeiro


gabinete mencionado.

/c Copie o arquivo de origem para o destino (para copiar de discos DMF).

/d Exibir diretório de gabinete (use com nome de arquivo para evitar a extração).
Parâmetro Descrição

/e Extraia (use em vez de . para extrair todos os arquivos).

/l dir Local para colocar arquivos extraídos (o padrão é o diretório atual).

/y Não solicite antes de substituir um arquivo existente.

Extrac32.exe

7 Observação

Extrac32.exe pode ser usado na linha de comando, mas não exibe nenhuma saída
no console. Redirecione a saída da ajuda por meio do comando more, desta forma:
extrac32.exe /? | more

Extrac32 [/Y] [/A] [/D | /E] [/L dir] cabinet [filename ...]
Extrac32 [/Y] source [newname]
Extrac32 [/Y] /C source destination

Parâmetros

Parâmetro Descrição

gabinete Arquivo de gabinete (contém dois ou mais arquivos).

filename Nome do arquivo a ser extraído do gabinete. Curingas e vários nomes de arquivo
(separados por espaços em branco) podem ser usados.

source Arquivo compactado (um gabinete com apenas um arquivo).

novonome Novo nome de arquivo para fornecer o arquivo extraído. Se não for fornecido, o
nome original será usado.

/A Processe TODOS os gabinetes. Segue a cadeia de gabinetes começando no primeiro


gabinete mencionado.

/C Copie o arquivo de origem para o destino (para copiar de discos DMF).

/D Exibir diretório de gabinete (use com nome de arquivo para evitar a extração).

/E Extraia (use em vez de . para extrair todos os arquivos).


Parâmetro Descrição

/L dir Local para colocar arquivos extraídos (o padrão é o diretório atual).

/Y Não solicite antes de substituir um arquivo existente.

Links relacionados
Chave da sintaxe de linha de comando
fc
Artigo • 12/04/2023

Compara dois arquivos ou conjuntos de arquivos e exibe as diferenças entre eles.

Sintaxe

fc /a [/c] [/l] [/lb<n>] [/n] [/off[line]] [/t] [/u] [/w] [/<nnnn>]


[<drive1>:][<path1>]<filename1> [<drive2>:][<path2>]<filename2>
fc /b [<drive1:>][<path1>]<filename1> [<drive2:>][<path2>]<filename2>

Parâmetros

Parâmetro Descrição

/a Abrevia a saída de uma comparação ASCII. Em vez de exibir todas as linhas


diferentes, fc exibe apenas a primeira e a última linha para cada conjunto de
diferenças.

/b Compara os dois arquivos no modo binário, byte por byte e não tenta
ressincronizar os arquivos depois de encontrar uma incompatibilidade. Esse é o
modo padrão para comparar arquivos que têm as seguintes extensões de arquivo:
.exe, .com, .sys, .obj, .lib ou .bin.

/c Ignora a letra maiúscula.

/l Compara os arquivos no modo ASCII, linha por linha e tenta ressincronizar os


arquivos depois de encontrar uma incompatibilidade. Esse é o modo padrão para
comparar arquivos, exceto arquivos com as seguintes extensões: .exe, .com, .sys,
.obj, .lib ou .bin.

/lb <n> Define o número de linhas do buffer de linha interno como N. O comprimento
padrão do buffer de linha é de 100 linhas. Se os arquivos que está comparando
tiverem mais de 100 linhas diferentes consecutivas, o fc cancelará a comparação.

/n Exibe os números de linha durante uma comparação ASCII.

/off[line] Não ignora arquivos que têm o atributo offline definido.

/t Impede que o fc converta guias em espaços. O comportamento padrão é tratar as


tabulações como espaços, com paradas em cada posição de oitavo caractere.

/u Compara arquivos como arquivos de texto Unicode.


Parâmetro Descrição

/w Compacta o espaço em branco (ou seja, tabulações e espaços) durante a


comparação. Se uma linha contiver muitos espaços ou tabulações consecutivos, o
/w tratará esses caracteres como um único espaço. Quando usado com /w, fc
ignora o espaço em branco no início e no final de uma linha.

/ <nnnn> Especifica o número de linhas consecutivas que devem corresponder após uma
incompatibilidade, antes que o fc considere os arquivos a serem ressincronizados.
Se o número de linhas correspondentes nos arquivos for menor que nnnn, fc
exibirá as linhas correspondentes como diferenças. O valor padrão é 2.

[<drive1>:] Especifica o local e o nome do primeiro arquivo ou conjunto de arquivos a serem


[<path1>] comparados. filename1 é necessário.
<filename1>

[<drive2>:] Especifica o local e o nome do segundo arquivo ou conjunto de arquivos a serem


[<path2>] comparados. filename2 é necessário.
<filename2>

/? Exibe a ajuda no prompt de comando.

Comentários
Esse comando é implementado por c:\WINDOWS\fc.exe. Use esse comando no
PowerShell, mas certifique-se de soletrar o executável completo (fc.exe), pois 'fc'
também é um alias para Format-Custom.

Ao usar o fc para uma comparação ASCII, o fc exibe as diferenças entre dois


arquivos na seguinte ordem:

Nome do primeiro arquivo

Linhas de filename1 que diferem entre os arquivos

Primeira linha a ser correspondida em ambos os arquivos

Nome do segundo arquivo

Linhas de filename2 que diferem

Primeira linha a ser correspondida

/b exibe incompatibilidades encontradas durante uma comparação binária na


seguinte sintaxe:

\<XXXXXXXX: YY ZZ>
O valor de XXXXXXXX especifica o endereço hexadecimal relativo para o par de
bytes, medido desde o início do arquivo. Os endereços começam em 00000000. Os
valores hexadecimal para YY e ZZ representam os bytes incompatíveis de
filename1 e filename2, respectivamente.

Use caracteres curinga (* e ?) em filename1 e filename2. Caso use um curinga em


filename1, o fc comparará todos os arquivos especificados com o arquivo ou
conjunto de arquivos especificados por filename2. Caso use um curinga em
filename2, o fc usará o valor correspondente de filename1.

Ao comparar arquivos ASCII, fc usa um buffer interno (grande o suficiente para


manter 100 linhas) como armazenamento. Se os arquivos forem maiores que o
buffer, o fc comparará o que ele pode carregar no buffer. Se o fc não encontrar
uma correspondência nas partes carregadas dos arquivos, ele será interrompido e
exibirá a seguinte mensagem:

Resynch failed. Files are too different.

Ao comparar arquivos binários maiores que a memória disponível, o fc compara os


dois arquivos completamente, sobrepondo as partes na memória com as próximas
partes do disco. A saída é a mesma para arquivos que se encaixam completamente
na memória.

Exemplos
Para fazer uma comparação ASCII de dois arquivos de texto, monthly.rpt e sales.rpt, e
exibir os resultados em formato abreviado, digite:

fc /a monthly.rpt sales.rpt

Para fazer uma comparação binária de dois arquivos em lote, profits.bat e earnings.bat,
digite:

fc /b profits.bat earnings.bat

Aparecem resultados semelhantes aos seguintes:


00000002: 72 43
00000004: 65 3A
0000000E: 56 92
000005E8: 00 6E
FC: earnings.bat longer than profits.bat

Se os arquivos profits.bat e earnings.bat forem idênticos, o fc exibirá a seguinte


mensagem:

Comparing files profits.bat and earnings.bat


FC: no differences encountered

Para comparar cada arquivo .bat no diretório atual com o arquivo new.bat, digite:

fc *.bat new.bat

Para comparar o arquivo new.bat na unidade C com o arquivo new.bat na unidade D,


digite:

fc c:new.bat d:*.bat

Para comparar cada arquivo em lote no diretório raiz na unidade C com o arquivo com
o mesmo nome no diretório raiz na unidade D, digite:

fc c:*.bat d:*.bat

Links relacionados
Chave da sintaxe de linha de comando
filesystems
Artigo • 12/04/2023

Exibe informações sobre o sistema de arquivos atual do volume com foco e lista os
sistemas de arquivos com suporte para formatação do volume.

Um volume deve ser selecionado para que essa operação seja bem-sucedida. Use o
comando select volume para selecionar um volume e mudar o foco para ele.

Syntax

filesystems

Links relacionados
Chave da sintaxe de linha de comando
localizar
Artigo • 11/04/2023

Pesquisa uma cadeia de caracteres de texto em um arquivo ou arquivos e exibe linhas


de texto que contêm a cadeia de caracteres especificada.

Sintaxe

find [/v] [/c] [/n] [/i] [/off[line]] <"string"> [[<drive>:][<path>]


<filename>[...]]

Parâmetros

Parâmetro Descrição

/v Exibe todas as linhas que não contêm o <string> especificado.

/c Conta as linhas que contêm o <string> especificado e exibe o total.

/n Precede cada linha com o número de linha do arquivo.

/i Especifica que a pesquisa não diferencia maiúsculas de minúsculas.

[/off[line]] Não ignora arquivos que têm o atributo offline definido.

<"string"> Obrigatórios. Especifica o grupo de caracteres (entre aspas) que você


deseja pesquisar.

[<drive>:][<path>] Especifica o local e o nome do arquivo pelos quais pesquisar a cadeia de


<filename> caracteres especificada.

/? Exibe a ajuda no prompt de comando.

Códigos de saída

Código de Descrição
saída

0 A cadeia de caracteres pesquisada foi encontrada

1 Cadeia de caracteres pesquisada não encontrada


Código de Descrição
saída

2 O arquivo pesquisado não encontrado ou o comutador de linha de comando


inválido foi dado

Comentários

Se você não usar /i, esse comando procurará exatamente o que você especificar
para a cadeia de caracteres. Por exemplo, esse comando trata os caracteres a e A
de maneira diferente. No entanto, se você usar /i, a pesquisa não diferencia
maiúsculas de minúsculas e ela tratará a e A como o mesmo caractere.

Se a cadeia de caracteres que você deseja pesquisar contiver aspas, você deverá
usar aspas duplas para cada aspa contida na cadeia de caracteres (por exemplo,
""Esta cadeia de caracteres contém aspas""").

Se você omitir um nome de arquivo, esse comando atuará como um filtro,


recebendo a entrada da fonte de entrada padrão (geralmente o teclado, um pipe
(|) ou um arquivo redirecionado) e, em seguida, exibirá todas as linhas que
contenham uma cadeia de caracteres.

Para sair da pesquisa do console, use CTRL-X ou CTRL-z .

Você pode digitar parâmetros e opções de linha de comando para o comando find
em qualquer ordem.

Você não pode usar curingas (* e ?) na cadeia de caracteres pesquisada. Para


pesquisar uma cadeia de caracteres com curingas e padrões regex, você pode usar
o comando FINDSTR.

Se você usar /c e /v na mesma linha de comando, esse comando exibirá uma


contagem das linhas que não contêm a cadeia de caracteres especificada. Se você
especificar /c e /n na mesma linha de comando, find ignorará /n.

Esse comando não reconhece retornos de carro. Ao usar esse comando para
pesquisar texto em um arquivo que inclui retornos de carro, você deve limitar a
cadeia de caracteres de pesquisa ao texto que pode ser encontrado entre retornos
de carro (ou seja, uma cadeia de caracteres que provavelmente não será
interrompida por um retorno de carro). Por exemplo, esse comando não relatará
uma correspondência para o arquivo de imposto de cadeia de caracteres se
ocorrer uma devolução de carro entre as palavras tax e file.
O comando aceita curingas para nomes de arquivo. Ao pesquisar no arquivo (ou
arquivos), ele imprimirá o arquivo do arquivo processado precedido por dez
traços.

O comando find não pode ler fluxos de dados alternativos. Para pesquisar em
fluxos de dados alternativos, use os comandos findstr, more ou for /f.

Exemplos
Para exibir todas as linhas de pencil.md que contêm a cadeia de caracteres apontador de
lápis, digite:

find "pencil sharpener" pencil.md

Para encontrar o texto, "Os cientistas rotularam seu artigo apenas para discussão. Não é
um relatório final." (incluindo as aspas) no arquivo report.txt, digite:

find """The scientists labeled their paper for discussion only. It is not a
final report.""" < report.txt

Para pesquisar um conjunto de arquivos, você pode usar curingas. Para pesquisar no
diretório atual arquivos que têm a extensão .bat e que contêm a cadeia de caracteres
PROMPT ignorando o caso, digite:

find /i "PROMPT" *.bat

Para localizar nomes de arquivos em um diretório que contém a cadeia de caracteres


CPU, use o pipe (|) para direcionar a saída do comando dir para o comando find da
seguinte maneira:

dir c:\temp /s /b | find "CPU"

Localize todos os processos em execução que NÃO contêm o agente:


tasklist | find /v /i "agent"

Verifique se um serviço está em execução:

sc query Winmgmt | find "RUNNING" >nul 2>&1 && (echo service is started) ||
(echo service is stopped)

Links relacionados
Chave da sintaxe de linha de comando

comando findstr
findstr
Artigo • 11/04/2023

Pesquisa padrões de texto em arquivos.

Sintaxe

findstr [/b] [/e] [/l | /r] [/s] [/i] [/x] [/v] [/n] [/m] [/o] [/p] [/f:
<file>] [/c:<string>] [/g:<file>] [/d:<dirlist>] [/a:<colorattribute>]
[/off[line]] <strings> [<drive>:][<path>]<filename>[ ...]

Parâmetros

Parâmetro Descrição

/b Corresponde ao padrão de texto se ele estiver no início de uma linha.

/e Corresponde ao padrão de texto se ele estiver no final de uma linha.

/l Processa cadeias de caracteres de pesquisa literalmente.

/r Processa cadeias de caracteres de pesquisa como expressões regulares.


Essa é a configuração padrão.

/s Pesquisa o diretório atual e todos os subdiretórios.

/i Ignora o caso dos caracteres ao pesquisar a cadeia de caracteres.

/x Imprime linhas que correspondem exatamente.

/v Imprime apenas linhas que não contêm uma correspondência.

/n Imprime o número de linha de cada linha correspondente.

/m Imprime apenas o nome do arquivo se um arquivo contiver uma


correspondência.

/o Imprime o deslocamento de caractere antes de cada linha correspondente.

/p Ignora arquivos com caracteres não imprimíveis.

/off[line] Não ignora arquivos que têm o atributo offline definido.

/f: <file> Obtém uma lista de arquivos do arquivo especificado.


Parâmetro Descrição

/c: <string> Usa o texto especificado como uma cadeia de caracteres de pesquisa
literal.

/g: <file> Obtém cadeias de caracteres de pesquisa do arquivo especificado.

/d: <dirlist> Pesquisa a lista especificada de diretórios. Cada diretório deve ser
separado com um ponto e vírgula (;), por exemplo dir1;dir2;dir3 .

/a: <colorattribute> Especifica atributos de cor com dois dígitos hexadecimais. Digite color /?
para obter informações adicionais.

<strings> Especifica o texto a ser pesquisado no nome do arquivo. Obrigatórios.

[\<drive>:] Especifica o local e o arquivo ou arquivos a serem pesquisados. É


[<path>]<filename> necessário pelo menos um nome de arquivo.
[...]

/? Exibe a ajuda no prompt de comando.

Comentários
Todas as opções de linha de comando findstr devem preceder cadeias de
caracteres e nome de arquivo na cadeia de caracteres de comando.

Expressões regulares usam caracteres literais e meta-caracteres para encontrar


padrões de texto, em vez de cadeias de caracteres exatas.

Um caractere literal é um caractere que não tem um significado especial na


sintaxe de expressão regular; em vez disso, corresponde a uma ocorrência desse
caractere. Por exemplo, letras e números são caracteres literais.

Um meta-caractere é um símbolo com significado especial (um operador ou


delimitador) na sintaxe de expressão regular.

Os meta-caracteres aceitos são:

Meta-caractere Valor

. Curinga – qualquer caractere

* Repetir – zero ou mais ocorrências do caractere ou classe anterior.

^ Posição inicial da linha – início da linha.

$ Posição final da linha – fim da linha.


Meta-caractere Valor

[class] Classe de caractere – qualquer caractere em um conjunto.

[^class] Classe inversa – qualquer caractere que não esteja em um conjunto.

[x-y] Intervalo – todos os caracteres dentro do intervalo especificado.

\x Escape – uso literal de um meta-caractere.

\<string Posição inicial da palavra – início da palavra.

string\> Posição final da palavra – fim da palavra.

Os caracteres especiais na sintaxe de expressão regular têm mais poder quando


você os usa juntos. Por exemplo, use a combinação do caractere curinga ( . ) e
repita ( * ) para corresponder a qualquer cadeia de caracteres: .*

Use a expressão a seguir como parte de uma expressão maior para


corresponder a qualquer cadeia de caracteres que começa com b e termina com
ing: b.*ing

Para pesquisar várias cadeias de caracteres em um conjunto de arquivos, você


deve criar um arquivo de texto que contenha cada critério de pesquisa em uma
linha separada.

Use espaços para separar várias cadeias de caracteres de pesquisa, a menos que o
argumento seja prefixado com /c.

Exemplos
Para pesquisar hello ou there arquivo x.y, digite:

findstr hello there x.y

Para pesquisar hello there no arquivo x.y, digite:

findstr /c:"hello there" x.y

Para localizar todas as ocorrências da palavra Windows (com uma letra maiúscula inicial
W) no arquivo proposal.txt, digite:
findstr Windows proposal.txt

Para pesquisar todos os arquivos no diretório atual e todos os subdiretórios que


continham a palavra Windows, independentemente de a letra ser maiúscula ou
minúscula, digite:

findstr /s /i Windows *.*

Para localizar todas as ocorrências de linhas que começam com FOR e são precedidas
por zero ou mais espaços (como em um loop de programa de computador) e para
exibir o número de linha em que cada ocorrência é encontrada, digite:

findstr /b /n /r /c:^ *FOR *.bas

Para listar os arquivos exatos que você deseja pesquisar em um arquivo de texto, use os
critérios de pesquisa no arquivo stringlist.txt, para pesquisar os arquivos listados em
filelist.txt e, em seguida, para armazenar os resultados no arquivo results.out, digite:

findstr /g:stringlist.txt /f:filelist.txt > results.out

Para listar todos os arquivos que contêm a palavra computer no diretório atual e todos
os subdireários, independentemente do caso, digite:

findstr /s /i /m \<computer\> *.*

Para listar todos os arquivos que contêm a palavra computador e quaisquer outras
palavras que comecem com comp, (como complementar e competir), digite:

findstr /s /i /m \<comp.* *.*


Links relacionados
Chave da sintaxe de linha de comando
finger
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe as informações sobre usuários em um computador remoto especificado


(normalmente um computador com UNIX) que está executando o serviço de fazer um
finger ou daemon. O computador remoto especifica o formato e a saída da exibição de
informações do usuário. Usado sem parâmetros, o finger exibe a ajuda.

) Importante

Esse comando só estará disponível se o protocolo TCP/IP (Protocolo de Internet)


estiver instalado como um componente nas propriedades de um adaptador de
rede em Conexões de Rede.

Sintaxe

finger [-l] [<user>] [@<host>] [...]

Parâmetros

Parâmetro Descrição

-l Exibe as informações do usuário em formato de lista longa.

<user> Especifica o usuário sobre o qual você deseja obter informações. Se você omitir o
parâmetro user, esse comando exibirá as informações sobre todos os usuários no
computador especificado.

@<host> Especifica o computador remoto que executa o serviço de fazer um finger em que
você está procurando as informações do usuário. Você pode especificar um nome
de computador ou endereço IP.

/? Exibe a ajuda no prompt de comando.

Comentários
Você deve prefixar os parâmetros do finger com um hífen (-), em vez de uma barra
(/).

É possível especificar várias parâmetros user@host .

Exemplos
Para exibir as informações para user1 no computador users.microsoft.com, digite:

finger user1@users.microsoft.com

Para exibir as informações para all users no computador users.microsoft.com, digite:

finger @users.microsoft.com

Links relacionados
Chave da sintaxe de linha de comando
flattemp
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Habilita ou desabilita as pastas temporárias simples. Você precisa ter as credenciais


administrativas para executar esse comando.

7 Observação

Esse comando só estará disponível se você tiver instalado o serviço de função Host
da Sessão da Área de Trabalho Remota.

Sintaxe

flattemp {/query | /enable | /disable}

Parâmetros

Parâmetro Descrição

/Query Consulta a configuração atual.

/enable Habilita as pastas temporárias simples. Os usuários compartilharão a pasta


temporária, a menos que a pasta temporária resida na pasta inicial do usuário.

/disable Desabilita as pastas temporárias simples. A pasta temporária de cada usuário


residirá em uma pasta separada (determinada pela ID de Sessão do usuário).

/? Exibe a ajuda no prompt de comando.

Comentários

Depois que cada usuário tiver uma pasta temporária exclusiva, use flattemp
/enable para habilitar as pastas temporárias simples.
O método padrão para criar pastas temporárias para vários usuários (geralmente
apontados pelas variáveis de ambiente TEMP e TMP) é criar subpastas na pasta
\Temp, usando o logonID como o nome da subpasta. Por exemplo, se a variável de
ambiente TEMP apontar para C:\Temp, a pasta temporária atribuída ao logonID 4
do usuário será C:\Temp\4.

Usando o flattemp, você pode apontar diretamente para a pasta \Temp e impedir
a formação de subpastas. Isso é útil quando você deseja que as pastas temporárias
do usuário estejam contidas em pastas base, seja em uma unidade local do
servidor Host da Sessão da Área de Trabalho Remota ou em uma unidade de rede
compartilhada. Você deve usar o comando flattemp /enable* somente quando
cada usuário tiver uma pasta temporária separada.

Você poderá encontrar erros de aplicativo se a pasta temporária do usuário estiver


em uma unidade de rede. Isso ocorre quando a unidade de rede compartilhada se
torna inacessível momentaneamente na rede. Como os arquivos temporários do
aplicativo estão inacessíveis ou fora de sincronização, ele responde como se o
disco tivesse parado. Não é recomendável mover a pasta temporária para uma
unidade de rede. O padrão é manter as pastas temporárias no disco rígido local.
Se você se deparar com um comportamento inesperado ou erros de disco
corrompido com determinados aplicativos, estabilize sua rede ou mova as pastas
temporárias novamente para o disco rígido local.

Se você desabilitar o uso de pastas temporárias separadas por sessão, as


configurações de flattemp serão ignoradas. Essa opção é definida na ferramenta
Configuração de Serviços de Área de Trabalho Remota.

Exemplos
Para exibir a configuração atual para as pastas temporárias simples, digite:

flattemp /query

Para habilitar as pastas temporárias simples, digite:

flattemp /enable

Para desabilitar as pastas temporárias simples, digite:


flattemp /disable

Links relacionados
Chave da sintaxe de linha de comando
fondue
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Habilita os recursos opcionais do Windows baixando arquivos necessários do Windows


Update ou de outra fonte especificada pela Política de Grupo. O arquivo de manifesto
do recurso já deve estar instalado em sua imagem do Windows.

Sintaxe

fondue.exe /enable-feature:<feature_name> [/caller-name:<program_name>]


[/hide-ux:{all | rebootrequest}]

Parâmetros

Parâmetro Descrição

/enable-feature: Especifica o nome do recurso opcional do Windows que você deseja


<feature_name> habilitar. Você só pode habilitar um recurso por linha de comando. Para
habilitar vários recursos, use fondue.exe para cada recurso.

/caller-name: Especifica o nome do programa ou do processo quando você chama


<program_name> fondue.exe de um script ou arquivo em lote. Você pode usar essa opção
para adicionar o nome do programa ao relatório SQM se houver um
erro.

/hide-ux: {all | Use tudo para ocultar todas as mensagens do usuário, incluindo
rebootrequest} solicitações de progresso e permissão para acessar o Windows Update.
Se a permissão for necessária, a operação falhará.

Use rebootrequest para ocultar apenas mensagens de usuário


solicitando permissão para reinicializar o computador. Use essa opção
se você tiver um script que controle solicitações de reinicialização.

Exemplos
Para habilitar o Microsoft .NET Framework 4.8, digite:
fondue.exe /enable-feature:NETFX4

Para habilitar o Microsoft .NET Framework 4.8, adicione o nome do programa ao


relatório SQM e não exiba mensagens ao usuário, digite:

fondue.exe /enable-feature:NETFX4 /caller-name:Admin.bat /hide-ux:all

Links relacionados
Chave da sintaxe de linha de comando

Download do Microsoft .NET Framework 4.8


para
Artigo • 12/04/2023

Executa um comando especificado para cada arquivo, dentro de um conjunto de


arquivos.

Sintaxe

for {%% | %}<variable> in (<set>) do <command> [<commandlineoptions>]

Parâmetros

Parâmetro Descrição

{%% \| %}<variable> Obrigatórios. Representa um parâmetro substituível. Use um único sinal


de porcentagem ( % ) para executar o comando for no prompt de
comando. Use sinais de porcentagem dupla ( %% ) para executar o
comando for em um arquivo em lote. As variáveis diferenciam
maiúsculas de minúsculas e devem ser representadas com um valor
alfabético como %a, %b ou %c.

( <set> ) Obrigatórios. Especifica um ou mais arquivos, diretórios ou cadeias de


texto ou um intervalo de valores nos quais executar o comando. Os
parênteses são necessários.

<command> Obrigatórios. Especifica o comando que queira executar em cada arquivo,


diretório ou cadeia de caracteres de texto ou no intervalo de valores
incluídos no conjunto.

<commandlineoptions> Especifica as opções de linha de comando que queira usar com o


comando especificado.

/? Exibe a ajuda no prompt de comando.

Comentários

Use esse comando em um arquivo em lote ou diretamente no prompt de


comando.

Os seguintes atributos se aplicam ao comando for:


Esse comando substitui % variable ou %% variable por cada cadeia de
caracteres de texto no conjunto especificado até que o comando especificado
processe todos os arquivos.

Os nomes de variáveis diferenciam maiúsculas de minúsculas e são globais. Não


é possível ter mais de 52 nomes de variáveis ativos por vez.

Para evitar confusão com os parâmetros do lote, %0 por meio de %9 , use


qualquer caractere para variável, exceto os numerais de 0 a 9. Para arquivos em
lotes simples, um único caractere como %%f funcionará.

Use os vários valores para variáveis em arquivos em lotes complexos para


distinguir diferentes variáveis substituíveis.

O parâmetro conjunto pode representar um único grupo de arquivos ou vários


grupos de arquivos. Use os caracteres curinga (* e ?) para especificar um conjunto
de arquivos. Os seguintes conjuntos de arquivos são válidos:

(*.doc)
(*.doc *.txt *.me)
(jan*.doc jan*.rpt feb*.doc feb*.rpt)
(ar??1991.* ap??1991.*)

Ao usar esse comando, o primeiro valor no conjunto substitui % variable ou %%


variable e, em seguida, o comando especificado processa esse valor. Isso

continuará até que todos os arquivos (ou grupos de arquivos) que correspondem
ao valor conjunto sejam processados.

Em e fazer não são parâmetros, mas você deve usá-los com este comando. Se
você omitir qualquer uma dessas palavras-chave, uma mensagem de erro será
exibida.

Se as extensões de comando estiverem habilitadas (esse é o padrão), as seguintes


formas adicionais de para têm suporte:

Somente diretórios: se conjunto contiver caracteres curinga (* ou ?), o comando


determinado será executado para cada diretório (em vez de um conjunto de
arquivos em um diretório especificado) que corresponde ao conjunto. A sintaxe
do é:
for /d {%%|%}<Variable> in (<Set>) do <Command>
[<CommandLineOptions>]

Recursiva: percorre a árvore de diretório com raiz em unidade:caminho e


executa a instrução para em cada diretório da árvore. Se nenhum diretório for
determinado após /r, o diretório atual será usado como o diretório raiz. Se
conjunto for apenas um único período (.), ele só enumera a árvore de diretório.
A sintaxe do é:

for /r [[<drive>:]<path>] {%%|%}<variable> in (<set>) do <command>


[<commandlinepptions>]

Iterando um intervalo de valores: use uma variável iterativa para definir o valor
inicial (início#) e, em seguida, percorra um intervalo definido de valores até que
o valor exceda o valor final definido (fim#). /l executará o iterativo comparando
início# com fim#. Se início# for menor que fim#, o comando será executado.
Quando a variável iterativa excede fim#, o shell de comando sai do loop. Você
também pode usar uma etapa# negativa para percorrer um intervalo em valores
decrescentes. Por exemplo, (1,1,5) gera a sequência 1 2 3 4 5 e (5,-1,1) gera a
sequência 5 4 3 2 1. A sintaxe do é:

for /l {%%|%}<variable> in (<start#>,<step#>,<end#>) do <command>


[<commandlinepptions>]

Iteração e análise de arquivos: use a análise de arquivos para processar a saída


do comando, as cadeias de caracteres e o conteúdo do arquivo. Use variáveis
iterativas para definir o conteúdo ou as cadeias de caracteres que queira
examinar e use as várias opções de parsingkeywords para modificar ainda mais a
análise. Use a opção de token de parsingkeywords para especificar quais tokens
devem ser passados como variáveis iterativas. Quando usado sem a opção de
token, /f examinará apenas o primeiro token.

A análise de arquivos consiste em ler a saída, a cadeia de caracteres ou o


conteúdo do arquivo e, em seguida, dividi-lo em linhas individuais de texto e
analisar cada linha em zero ou mais tokens. Em seguida, o loop para é chamado
com o valor da variável iterativa definido como o token. Por padrão, /f passa o
primeiro token separado em branco de cada linha de cada arquivo. As linhas em
branco são ignoradas.
As sintaxes são:

for /f [<parsingkeywords>] {%%|%}<variable> in (<set>) do <command>


[<commandlinepptions>]
for /f [<parsingkeywords>] {%%|%}<variable> in (<literalstring>) do
<command> [<commandlinepptions>]
for /f [<parsingkeywords>] {%%|%}<variable> in ('<command>') do
<command> [<commandlinepptions>]

O argumento conjunto especifica um ou mais nomes de arquivo. Cada arquivo é


aberto, lido e processado antes de passar para o próximo arquivo no conjunto.
Para substituir o comportamento de análise padrão, especifique
parsingkeywords. Essa é uma cadeia de caracteres entre aspas que contém uma
ou mais palavras-chave para especificar diferentes opções de análise.

Caso use a opção usebackq, use uma das seguintes sintaxes:

for /f [usebackq <parsingkeywords>] {%%|%}<variable> in (<Set>) do


<command> [<commandlinepptions>]
for /f [usebackq <parsingkeywords>] {%%|%}<variable> in
('<LiteralString>') do <command> [<commandlinepptions>]
for /f [usebackq <parsingkeywords>] {%%|%}<variable> in
(`<command>`) do <command> [<commandlinepptions>]

A tabela a seguir lista as palavras-chave de análise que é possível usar para


parsingkeywords.

Palavra-chave Descrição

eol= <c> Especifica um fim de caractere de linha (apenas um caractere).

skip= <n> Especifica o número de linhas a serem ignoradas no início do arquivo.

delims= <xxx> Especifica um conjunto de delimitadores. Isso substitui o conjunto de


delimitador padrão de espaço e guia.

tokens= <x,y,m– Especifica quais tokens de cada linha devem ser passados para o loop
n> para em cada iteração. Como resultado, nomes de variáveis adicionais
são alocados. m-n especifica um intervalo, do mth até os tokens nth.
Se o último caractere na cadeia de caracteres tokens= for um
asterisco (*), uma variável adicional será alocada e receberá o texto
restante na linha após o último token analisado.
Palavra-chave Descrição

usebackq Especifica executar uma cadeia de caracteres com aspas inativas


como um comando, usar uma cadeia de caracteres de aspas simples
como uma cadeia de caracteres literal ou, para nomes de arquivo
longos que contenham espaços, permitir que os nomes de arquivo no
<set> , sejam colocados entre aspas duplas.

Substituição de variável: a tabela a seguir lista a sintaxe opcional (para


qualquer variável I):

Variável Descrição
com
modificador

%~I Expande %I , o que remove as aspas ao redor.

%~fI Expande %I , para um nome de caminho totalmente qualificado.

%~dI Expande %I , apenas para uma letra de unidade.

%~pI Expande %I , para apenas um caminho.

%~nI Expande %I , apenas para um nome de arquivo.

%~xI Expande %I , apenas para uma extensão de nome de arquivo.

%~sI Expande o caminho para conter apenas nomes curtos.

%~aI Expande %I , para os atributos de arquivo do arquivo.

%~tI Expande %I , para a data e hora do arquivo.

%~zI Expande %I , para o tamanho do arquivo.

%~$PATH:I Pesquisa os diretórios listados na variável de ambiente CAMINHO e se


expande %I , para o nome totalmente qualificado do primeiro diretório
encontrado. Se o nome da variável de ambiente não estiver definido ou
o arquivo não for encontrado pela pesquisa, esse modificador se
expandirá para a cadeia de caracteres vazia.

A tabela a seguir lista as combinações de modificador que é possível usar para


obter resultados compostos.

Variável com Descrição


modificadores
combinados

%~dpI Expande %I , para uma letra de unidade e somente caminho.


Variável com Descrição
modificadores
combinados

%~nxI Expande %I , apenas para um nome de arquivo e extensão.

%~fsI Expande %I , para um nome de caminho completo com apenas


nomes curtos.

%~dp$PATH:I Pesquisa os diretórios listados na variável de ambiente CAMINHO


e %I expande para a letra da unidade e o caminho do primeiro
encontrado.

%~ftzaI Expande %I , para uma linha de saída que é como dir.

Nos exemplos acima, é possível substituir %I e CAMINHO por outros valores


válidos. Um válido para o nome da variável encerra a sintaxe %~.

Usando nomes de variáveis maiúsculas, como %I , torne seu código mais legível
e evite confusão com os modificadores, que não diferenciam maiúsculas de
minúsculas.

Analisando uma cadeia de caracteres: use a for /f lógica de análise em uma


cadeia de caracteres imediata encapsulando <literalstring> em: aspas duplas
(sem usebackq) ou entre aspas simples (com usebackq), por exemplo, (MyString)
ou ('MyString'). <literalstring> é tratado como uma única linha de entrada de
um arquivo. Ao analisar aspas <literalstring> duplas, símbolos de comando
como ( \ & | > < ^ ) são tratados como caracteres comuns.

Saída de análise: use o comando for /f para analisar a saída de um comando


colocando uma aspas invertidas <command> entre os parênteses. Ele é tratado como
uma linha de comando, que é passada para um Cmd.exe filho. A saída é capturada
na memória e analisada como se fosse um arquivo.

Exemplos
Para usar para um arquivo em lote, use a seguinte sintaxe:

for {%%|%}<variable> in (<set>) do <command> [<commandlineoptions>]

Para exibir o conteúdo de todos os arquivos no diretório atual que têm a extensão .doc
ou .txt usando a variável substituível %f, digite:
for %f in (*.doc *.txt) do type %f

No exemplo anterior, cada arquivo que tem a extensão .doc ou .txt no diretório atual é
substituído pela variável %f até que o conteúdo de cada arquivo seja exibido. Para usar
esse comando em um arquivo em lote, substitua todas as ocorrências de %f por %%f.
Caso contrário, a variável será ignorada e uma mensagem de erro será exibida.

Para analisar um arquivo, ignorando linhas comentadas, digite:

for /f eol=; tokens=2,3* delims=, %i in (myfile.txt) do @echo %i %j %k

Esse comando analisa cada linha no myfile.txt. Ele ignora linhas que começam com um
ponto e vírgula e passa o segundo e o terceiro token de cada linha para o corpo do
para (os tokens são delimitados por vírgulas ou espaços). O corpo da instrução para faz
referência a %i para obter o segundo token, %j para obter o terceiro token e %k para
obter todos os tokens restantes. Se os nomes de arquivo fornecidos contiverem
espaços, use aspas ao redor do texto (por exemplo, Nome do Arquivo). Para usar aspas,
use usebackq. Caso contrário, as aspas serão interpretadas como definindo uma cadeia
de caracteres literal a ser analisada.

%i é declarado explicitamente na instrução para. %j e %k são declarados implicitamente


usando tokens=. Use tokens= para especificar até 26 tokens, desde que não cause uma
tentativa de declarar uma variável maior que a letra z ou Z.

Para analisar a saída de um comando colocando oconjunto entre os parênteses, digite:

for /f "usebackq delims==" %i in (`set`) do @echo %i

Links relacionados
Chave da sintaxe de linha de comando
forfiles
Artigo • 17/04/2023

Seleciona e executa um comando em um arquivo ou conjunto de arquivos. Esse


comando é mais comumente usado em arquivos em lote.

Sintaxe

forfiles [/P pathname] [/M searchmask] [/S] [/C command] [/D [+ | -]


[{<date> | <days>}]]

Parâmetros

Parâmetro Descrição

/P Especifica o caminho do qual iniciar a pesquisa. Por padrão, a pesquisa começa


<pathname> no diretório de trabalho atual.

/M Pesquisa arquivos de acordo com a máscara de pesquisa especificada. A máscara


<searchmask> de pesquisa padrão é * .

/S Instrui o comando forfiles a pesquisar em subdiretórios recursivamente.

/C <command> Executa o comando especificado em cada arquivo. As cadeias de caracteres de


comando devem ser encapsuladas entre aspas duplas. O comando padrão é "cmd
/c echo @file" .

/D [{+\|-}] Seleciona arquivos com uma data da última modificação dentro do período de
[{<date> | tempo especificado:
<days>}] Seleciona arquivos com uma data da última modificação posterior ou igual
a (+) ou anterior ou igual a (-) a data especificada, em que date está no
formato MM/DD/AAAA.
Seleciona arquivos com uma data da última modificação posterior ou igual
(+) à data atual mais o número de dias especificado ou anterior ou igual (-)
à data atual menos o número de dias especificado.
Os valores válidos para dias incluem qualquer número no intervalo de 0 a
32.768. Se nenhum sinal for especificado, + será usado por padrão.

/? Exibe o texto de ajuda na janela cmd.

Comentários
O comando forfiles /S é semelhante a dir /S .

Você pode usar as seguintes variáveis na cadeia de caracteres de comando,


conforme especificado pela opção de linha de comando /C:

Variável Descrição

@FILE Nome do arquivo.

@FNAME Nome do arquivo sem extensão.

@EXT Extensão de nome de arquivo.

@PATH Caminho completo do arquivo.

@RELPATH Caminho relativo do arquivo.

@ISDIR Avaliará como TRUE se um tipo de arquivo for um diretório. Caso contrário,
essa variável será avaliada como FALSE.

@FSIZE Tamanho do arquivo, em bytes.

@FDATE Carimbo de data da última modificação no arquivo.

@FTIME Carimbo de data/hora da última modificação no arquivo.

O comando forfiles permite executar um comando em ou passar argumentos para


vários arquivos. Por exemplo, você pode executar o comando type em todos os
arquivos em uma árvore com a extensão de nome de arquivo .txt. Você também
pode executar cada arquivo em lote (*.bat) na unidade C, com o nome do arquivo
Myinput.txt como o primeiro argumento.

Esse comando pode:

Selecione arquivos por uma data absoluta ou uma data relativa usando o
parâmetro /d.

Crie uma árvore de arquivos usando variáveis como @FSIZE e @FDATE.

Diferencie arquivos de diretórios usando a variável @ISDIR.

Inclua caracteres especiais na linha de comando usando o código hexadecimal


para o caractere, no formato 0xHH (por exemplo, 0x09 para uma guia).

Esse comando funciona implementando o sinalizador recurse subdirectories em


ferramentas projetadas para processar apenas um único arquivo.

Exemplos
Para listar todos os arquivos em lote na unidade C, digite:

forfiles /P c:\ /S /M *.bat /C "cmd /c echo @file is a batch file"

Para listar todos os diretórios na unidade C, digite:

forfiles /P c:\ /S /M * /C "cmd /c if @isdir==TRUE echo @file is a


directory"

Para listar todos os arquivos no diretório atual com pelo menos um ano de idade, digite:

forfiles /S /M *.* /D -365 /C "cmd /c echo @file is at least one year old."

Para mostrar que o arquivo de texto está desatualizado para cada um dos arquivos no
diretório atual anterior a 1º de janeiro de 2007, digite:

forfiles /S /M *.* /D -01/01/2007 /C "cmd /c echo @file is outdated."

Para listar as extensões de nome de arquivo de todos os arquivos no diretório atual no


formato de coluna e adicionar uma guia antes da extensão, digite:

forfiles /S /M *.* /C "cmd /c echo The extension of @file is 0x09@ext"

Links relacionados
Chave da sintaxe de linha de comando
Formatar
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows 10 e Windows Server 2019

O comando format formata uma unidade para aceitar arquivos do Windows. Você deve
ser membro do grupo Administradores para formatar um disco rígido.

7 Observação

O comando format também pode ser usado com parâmetros diferentes no


Console de Recuperação. Para obter mais informações sobre o console de
recuperação, confira Windows RE (Ambiente de Recuperação do Windows).

Sintaxe

format volume [/FS:file-system] [/V:label] [/Q] [/L[:state]] [/A:size] [/C]


[/I:state] [/X] [/P:passes] [/S:state]
format volume [/V:label] [/Q] [/F:size] [/P:passes]
format volume [/V:label] [/Q] [/T:tracks /N:sectors] [/P:passes]
format volume [/V:label] [/Q] [/P:passes]
format volume [/Q]

Parâmetros

Parâmetro Descrição

<volume> Especifica o ponto de montagem, nome do volume ou letra da unidade


(seguido por dois-pontos) da unidade que você deseja formatar. Se você não
especificar nenhuma das opções de linha de comando a seguir, format usará
o tipo de volume para determinar o formato padrão do disco.

/FS: <filesystem> Especifica o tipo do sistema de arquivos (FAT, FAT32, NTFS, exFAT, ReFS ou
UDF).
Parâmetro Descrição

/V: <label> Especifica o rótulo do volume. Se você omitir a opção de linha de comando
/V ou usá-la sem especificar um rótulo de volume, format solicitará o rótulo
do volume após a formatação ser concluída. Use a sintaxe /V: para impedir o
prompt para um rótulo de volume. Se você usar um único comando format
para formatar mais de um disco, todos os discos receberão o mesmo rótulo
de volume.

/A: <size> Especifica o tamanho da unidade de alocação para usar em volumes FAT,
FAT32, NTFS, exFAT ou ReFS. Se você não especificar o tamanho da unidade,
ele será escolhido com base no tamanho do volume. As configurações padrão
são recomendadas para uso geral. A lista a seguir apresenta valores válidos
para cada tipo de tamanho de unidade do sistema de arquivos:

FAT e FAT32: 512 , 1024 , 2048 , 4096 , 8192 , 16K , 32K , 64K . Além de 128K
e 256K para um tamanho de setor maior que 512 bytes.
NTFS: 512 , 1024 , 2048 , 4096 , 8192 , 16K , 32K , 64K , 128K , 256K , 512K ,
1M , 2M
exFAT: 12 , 1024 , 2048 , 4096 , 8192 , 16K , 32K , 64K , 128K , 256K , 512K ,
1M , 2M , 4M , 8M , 16M , 32M
ReFS: 4096 , 64K

/Q Executa uma formatação rápida. Exclui a tabela de arquivos e o diretório raiz


de um volume formatado anteriormente, mas não executa uma varredura
setor por setor em busca de áreas defeituosas. Você deve usar a opção de
linha de comando /Q para formatar apenas volumes formatados
anteriormente que você sabe que estão em boas condições. Observe que /Q
substitui /Q.

/F: <size> Especifica o tamanho do disquete a ser formatado. Quando possível, use esta
opção de linha de comando em vez de /T e /T. O Windows aceita os
seguintes valores de tamanho:

1440 ou 1440k ou 1440kb


1.44 ou 1.44m ou 1.44mb
1.44-MB , double-sided , quadruple-density , 3.5-inch disk

/T: <tracks> Especifica o número de trilhas no disco. Quando possível, use a opção de
linha de comando /F. Se você usar a opção /T, também deverá usar a opção
/N. Essas opções juntas fornecem um método alternativo de especificar o
tamanho do disco que está sendo formatado. Essa opção não é válida com a
opção /F.
Parâmetro Descrição

/N: <sectors> Especifica o número de setores por faixa. Quando possível, use a opção de
linha de comando /F em vez de /N. Se usar /N, também deverá usar /T.
Juntas, essas duas opções fornecem um método alternativo de especificar o
tamanho do disco que está sendo formatado. Essa opção não é válida com a
opção /F.

/P: <count> Zero a cada setor no volume. Depois disso, o volume será substituído count
vezes usando um número aleatório diferente cada vez. Se count for zero,
nenhuma substituição adicional será feita depois de zerar todos os setores.
Essa opção é ignorada quando /Q é especificado.

/C Apenas NTFS. Os arquivos criados no novo volume serão compactados por


padrão.

/X Força o volume ser desmontado, se necessário, antes de ser formatado.


Quaisquer identificadores abertos para o volume não serão mais válidos.

/R Apenas NTFS. Os arquivos criados no novo volume serão compactados por


padrão.

/D Somente UDF 2.50. Os metadados são duplicados.

/L: <state> Apenas NTFS. Substitui o tamanho padrão do registro de arquivo. Por padrão,
um volume sem camadas é formatado com registros de arquivo de tamanho
pequeno e um volume com camadas é formatado com registros de arquivo
de tamanho grande. /L e /L:enable força o formato a usar registros de
arquivo grandes e /L:disable força o formato a usar registros de arquivo
pequenos.

/S: <state> Especifica o suporte para nomes de arquivo curtos. O estado é habilitar ou
desabilitar. Os nomes curtos são desabilitados por padrão.

/TXF: <state> Especifica se TxF está habilitado/desabilitado. O estado é habilitar ou


desabilitar. TxF é habilitado por padrão

/I: <state> Apenas ReFS. Especifica se a integridade deve ser habilitada no novo volume.
O estado é habilitar ou desabilitar. A integridade é habilitada no
armazenamento que dá suporte à redundância de dados por padrão.

/DAX: <state> Apenas NTFS. Habilite o modo de armazenamento de acesso direto (DAX)
para esse volume. No modo DAX, o volume é acessado por meio do
barramento de memória, aumentando o desempenho de E/S. Um volume só
poderá ser formatado com o modo DAX se o hardware for compatível com
DAX. O estado é habilitar ou desabilitar. /DAX é considerado o mesmo que
/DAX:enable.
Parâmetro Descrição

/LogSize:: <size> NTFS especifica apenas o tamanho do arquivo de log NTFS em quilobytes. O
tamanho mínimo suportado é de 2 MB, portanto, especificar um tamanho
menor que 2 MB resultará em um arquivo de log de 2 MB. Zero indica o valor
padrão. O valor padrão geralmente depende do tamanho do volume.

/NoRepairLogs Apenas NTFS. Desabilita os logs de reparo do NTFS. Se o sinalizador spotfix


para chkdsk for especificado (por exemplo, chkdsk /spotfix), o parâmetro
/NoReairLogs não funcionará.

/? Exibe a ajuda no prompt de comando.

Comentários
O comando format cria um novo diretório raiz e um sistema de arquivos para o
disco. Ele também procurar áreas danificadas no disco e pode excluir todos os
dados no disco. Para poder usar um novo disco, primeiro você deve usar esse
comando para formatar o disco.

Depois de formatar um disquete, format exibe a seguinte mensagem:

Volume label (11 characters, ENTER for none)?

Para adicionar um rótulo de volume, digite até 11 caracteres (incluindo espaços).


Se não quiser adicionar um rótulo de volume ao disco, pressione ENTER.

Quando você usa o comando format para formatar um disco rígido, uma
mensagem de aviso semelhante à seguinte é exibida:

WARNING, ALL DATA ON NON-REMOVABLE DISK


DRIVE x: WILL BE LOST!
Proceed with Format (Y/N)? _

Para formatar o disco rígido, pressione Y. Se você não quiser formatar o disco,
pressione N.

Os sistemas de arquivos FAT restringem o número de clusters a até 65526. Os


sistemas de arquivos FAT32 restringem o número de clusters de 65527 a 4177917.

Não há suporte para compactação NTFS para tamanhos de unidade de alocação


acima de 4096.
7 Observação

A formatação imediatamente parará o processamento se decidir que os


requisitos acima não podem ser atendidos usando o tamanho de cluster
especificado.

Quando a formatação for concluída, format exibirá mensagens que mostram o


espaço total em disco, os espaços marcados como defeituosos e o espaço
disponível para seus arquivos.

Você pode acelerar o processo de formatação utilizando a opção de linha de


comando /q. Use esta opção somente se não houver nenhum setor inválido no
disco rígido.

Você não deve usar o comando format em uma unidade que tenha sido preparada
usando o comando subst. Você não pode formatar discos através de uma rede.

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

Código Descrição
de saída

0 A operação de formatação foi bem-sucedida.

1 Os parâmetros incorretos foram fornecidos.

4 Ocorreu um erro fatal (que é qualquer erro diferente de 0, 1 ou 5).

5 O usuário pressionou N em resposta à mensagem "Prosseguir com a


formatação (Y/N)?" para interromper o processo.

Você pode verificar esses códigos de saída usando a variável de ambiente


ERRORLEVEL com o comando em lote if.

Exemplos
Para formatar um novo disquete na unidade A utilizando o tamanho padrão, digite:

format a:
Para executar uma operação de formatação rápida em um disquete formatado
anteriormente na unidade A, digite:

format a: /q

Para formatar um disquete na unidade A e atribuir a ele o rótulo de volume DATA,


digite:

format a: /v:DATA

Links relacionados
Chave da sintaxe de linha de comando
freedisk
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Verifica se a quantidade especificada de espaço em disco está disponível antes de


continuar com um processo de instalação.

Sintaxe

freedisk [/s <computer> [/u [<domain>\]<user> [/p [<password>]]]] [/d


<drive>] [<value>]

Parâmetros

Parâmetro Descrição

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (não use


barras invertidas). O padrão é o computador local. Esse parâmetro se aplica
a todos os arquivos e pastas especificados no comando.

/u [ <domain> \] Executa o script com as permissões da conta de usuário especificada. O


<user> padrão são as permissões do sistema.

/p [ <password> ] Especifica a senha da conta de usuário especificada no /u.

/d <drive> Especifica a unidade para a qual queira descobrir a disponibilidade de


espaço livre. Especifique <drive> para um computador remoto.

<value> Verifica se há uma quantidade específica de espaço livre em disco.


Especifique <value> em bytes, KB, MB, GB, TB, PB, EB, ZB ou YB.

Comentários
O uso das opções de linha de comando /s, /u e /p estão disponível somente ao
usar /s. Use /p com /u para fornecer a senha do usuário.

Para instalações autônomas, use o freedisk em arquivos de lote de instalação para


verificar o espaço livre de quantidade de pré-requisitos antes de continuar com a
instalação.

Ao usar o freedisk em um arquivo em lote, ele retorna um 0 se houver espaço


suficiente e um 1 se não houver espaço suficiente.

Exemplos
Para determinar se há pelo menos 50 MB de espaço livre disponível na unidade C,
digite:

freedisk 50mb

Uma saída semelhante ao exemplo a seguir aparece na tela:

INFO: The specified 52,428,800 byte(s) of free space is available on current


drive.

Links relacionados
Chave da sintaxe de linha de comando
fsutil
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8, Windows Server 2008 R2, Windows 7

Executa tarefas relacionadas aos sistemas de arquivos FAT (tabela de alocação de


arquivos) e NTFS, como gerenciar pontos de nova análise, gerenciar arquivos esparsos
ou desmontar um volume. Se for usado sem parâmetros, fsutil exibirá uma lista de
subcomandos com suporte.

7 Observação

Você precisa estar conectado como administrador ou membro do grupo


Administradores para usar fsutil. Esse comando é bastante avançado e deve ser
usado apenas por usuários avançados que têm conhecimento completo dos
sistemas operacionais Windows.

Parâmetros
Subcomando Descrição

fsutil Consulta ou altera as configurações de comportamento de nome abreviado no


8dot3name sistema, por exemplo, gera nomes de arquivo de 8,3 caracteres. Remove os
nomes abreviados de todos os arquivos em um diretório. Examina um diretório e
identifica as chaves do registro que poderão ser afetadas se nomes abreviados
forem removidos dos arquivos no diretório.

fsutil dirty Consulta se o bit sujo do volume está definido ou define o bit sujo de um
volume. Quando o bit sujo de um volume é definido, autochk verifica
automaticamente se há erros no volume na próxima vez que o computador é
reiniciado.

fsutil file Localiza um arquivo por nome de usuário (se as Cotas de Disco estiverem
habilitadas), consulta os intervalos alocados para um arquivo, define o nome
abreviado de um arquivo, define o comprimento de dados válido de um arquivo,
define zero dados para um arquivo, cria um arquivo de um tamanho
especificado, localiza uma ID de arquivo se recebe o nome ou encontra um nome
de link de arquivo para uma ID de arquivo especificada.
Subcomando Descrição

fsutil fsinfo Lista todas as unidades e consulta o tipo de unidade, informações de volume,
informações de volume específicas do NTFS ou estatísticas do sistema de
arquivos.

fsutil hardlink Lista links rígidos para um arquivo ou cria um link rígido (uma entrada de
diretório para um arquivo). Cada arquivo pode ser considerado como tendo pelo
menos um link rígido. Em volumes NTFS, cada arquivo pode ter vários links
rígidos, portanto, um arquivo pode aparecer em muitos diretórios (ou até mesmo
no mesmo diretório, com nomes diferentes). Como todos os links fazem
referência ao mesmo arquivo, os programas podem abrir qualquer um dos links
e modificar o arquivo. Um arquivo é excluído do sistema de arquivos somente
depois que todos os links para ele são excluídos. Após você criar um link rígido,
os programas podem usá-lo como qualquer outro nome de arquivo.

fsutil objectid Gerencia identificadores de objeto, que são usados pelo sistema operacional
Windows para rastrear objetos como arquivos e diretórios.

fsutil quota Gerencia cotas de disco em volumes NTFS para fornecer um controle mais
preciso do armazenamento baseado em rede. As cotas de disco são
implementadas por volume e permitem que limites de armazenamento rígidos e
flexíveis sejam implementados por usuário.

fsutil repair Consulta ou define o estado de autorrecuperação do volume. O NTFS com


autorrecuperação tenta corrigir corrupções do sistema de arquivos NTFS online
sem exigir que Chkdsk.exe seja executado. Inclui iniciar a verificação em disco e
aguardar a conclusão do reparo.

fsutil Consulta ou exclui pontos de nova análise (objetos do sistema de arquivos NTFS
reparsepoint que têm um atributo definível que contém dados controlados pelo usuário).
Pontos de nova análise são usados para estender a funcionalidade no subsistema
de E/S (entrada/saída). Eles são usados como pontos de junção de diretório e
pontos de montagem de volume. Também são usados por drivers de filtro do
sistema de arquivos para marcar determinados arquivos como especiais para
esse driver.

fsutil resource Cria um Gerenciador de Recursos Transacionais Secundário, inicia ou interrompe


um Gerenciador de Recursos Transacionais, exibe informações sobre um
Gerenciador de Recursos Transacionais ou modifica seu comportamento.
Subcomando Descrição

fsutil sparse Gerencia arquivos esparsos. Um arquivo esparso é um arquivo com uma ou mais
regiões de dados não alocados nele. Um programa verá essas regiões não
alocadas como contendo bytes com valor de zero, mas nenhum espaço em disco
é usado para representar esses zeros. Todos os dados significativos ou diferentes
de zero são alocados, enquanto todos os dados não significativos (cadeias de
caracteres grandes de dados compostas por zeros) não são alocados. Quando
um arquivo esparso é lido, os dados alocados são retornados como armazenados
e os dados não alocados são retornados como zeros (por padrão, de acordo com
a especificação do requisito de segurança C2). O suporte para arquivos esparsos
permite que os dados sejam desalocados de qualquer lugar no arquivo.

fsutil tiering Habilita o gerenciamento de funções da camada de armazenamento, como


definir e desabilitar sinalizadores e listar camadas.

fsutil Confirma uma transação especificada, reverte uma transação especificada ou


transaction exibe informações sobre a transação.

fsutil usn Gerencia o diário de alterações de USN (números de sequência de atualização),


que fornece um log persistente de todas as alterações feitas nos arquivos no
volume.

fsutil volume Gerencia um volume. Desmonta um volume, consulta para ver quanto espaço
livre está disponível em um disco ou localiza um arquivo que está usando um
cluster especificado.

fsutil wim Fornece funções para descobrir e gerenciar arquivos com suporte de WIM.

Links relacionados
Chave da sintaxe de linha de comando
fsutil 8dot3name
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows
10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8

Consulta ou altera as configurações de comportamento de nome curto (nome 8dot3), que


inclui:

Consultar a configuração atual para o comportamento de nome curto.

Verificar o caminho de diretório especificado em busca de chaves do Registro que podem


ser afetadas se nomes curtos forem retirados do caminho de diretório especificado.

Alterar a configuração que controla o comportamento do nome curto. Essa configuração


pode ser aplicada a um volume especificado ou à configuração de volume padrão.

Remover os nomes curtos de todos os arquivos em um diretório.

) Importante

Remover permanentemente nomes de arquivo 8dot3 e não modificar chaves do Registro


que apontam para os nomes de arquivo 8dot3 pode levar a falhas inesperadas do
aplicativo, incluindo a impossibilidade de desinstalar um aplicativo. É recomendável fazer
backup do diretório ou do volume antes de tentar remover nomes de arquivo 8dot3.

Sintaxe

fsutil 8dot3name [query] [<volumepath>]


fsutil 8dot3name [scan] [/s] [/l [<log file>] ] [/v] <directorypath>
fsutil 8dot3name [set] { <defaultvalue> | <volumepath> {1|0}}
fsutil 8dot3name [strip] [/t] [/s] [/f] [/l [<log file.] ] [/v] <directorypath>

Parâmetros

Parâmetro Descrição

consulta Consulta o sistema de arquivos para o estado do comportamento de criação de nome curto
[<volumepath>] 8dot3.
Se um volumepath não for especificado como um parâmetro, a configuração padrão de
comportamento de criação de 8dot3name para todos os volumes será exibida.
Parâmetro Descrição

Verificação Examina os arquivos localizados no directorypath especificado em busca de chaves do Registro


<directorypath> que podem ser afetadas se nomes curtos 8dot3 forem removidos dos nomes de arquivo.

definir Altera o comportamento do sistema de arquivos para a criação de nome 8dot3 nas seguintes
{ <defaultvalue> instâncias:
\| Quando defaultvalue é especificado, a chave do Registro,
<volumepath>} HKLM\System\CurrentControlSet\Control\FileSystem\NtfsDisable8dot3NameCreation,
é definida como o valor padrão.

O DefaultValue pode ter os seguintes valores:


0: habilita a criação de nome 8dot3 para todos os volumes no sistema.
1: desabilita a criação de nome 8dot3 para todos os volumes no sistema.
2: define a criação de nome 8dot3 por volume.
3: desabilita a criação de nome 8dot3 para todos os volumes, exceto o volume do
sistema.
Quando um volumepath é especificado, os volumes especificados nas propriedades do
sinalizador de disco 8dot3name são definidos para habilitar a criação de nome 8dot3
para um volume especificado (0) ou definido para desabilitar a criação de nome 8dot3
no volume especificado (1).

Defina o comportamento padrão do sistema de arquivos para a criação de nome 8dot3


para o valor 2 antes de habilitar ou desabilitar a criação de nome 8dot3 para um volume
especificado.

remove Remove os nomes de arquivo 8dot3 para todos os arquivos localizados no directorypath
<directorypath> especificado. O nome do arquivo 8dot3 não é removido para nenhum arquivo em que o
directorypath combinado com o nome do arquivo contenha mais de 260 caracteres.

Esse comando lista, mas não modifica as chaves do Registro que apontam para os arquivos
que tiveram nomes de arquivo 8dot3 permanentemente removidos.

<volumepath> Especifica o nome da unidade seguido de dois-pontos ou o GUID no formato volume{GUID} .

/f Especifica que todos os arquivos localizados no directorypath especificado tenham os nomes


de arquivo 8dot3 removidos mesmo se houver chaves do Registro que apontam para arquivos
usando o nome do arquivo 8dot3. Nesse caso, a operação remove os nomes de arquivo 8dot3,
mas não modifica nenhuma chave do Registro que aponte para os arquivos que estão usando
os nomes de arquivo 8dot3. Aviso: é recomendável que faça backup do diretório ou volume
antes de usar o parâmetro /f, pois isso pode levar a falhas inesperadas do aplicativo, incluindo
a impossibilidade de desinstalar programas.

/l [<log file>] Especifica um arquivo de log em que as informações são gravadas.


Se o parâmetro /l não for especificado, todas as informações serão gravadas no arquivo de log
padrão: %temp%\8dot3_removal_log@(GMT YYYY-MM-DD HH-MM-SS) .log**

/s Especifica que a operação deve ser aplicada aos subdiretórios do directorypath especificado.

/t Especifica que a remoção de nomes de arquivo 8dot3 deve ser executada no modo de teste.
Todas as operações, exceto a remoção real dos nomes de arquivo 8dot3, são executadas. Use
o modo de teste para descobrir quais chaves do Registro apontam para arquivos que usam os
nomes de arquivo 8dot3.
Parâmetro Descrição

/v Especifica que todas as informações gravadas no arquivo de log também são exibidas na linha
de comando.

Exemplos
Para consultar o comportamento de nome 8dot3 desabilitado para um volume de disco
especificado com o GUID, {928842df-5a01-11de-a85c-806e6f6e6963}, digite:

fsutil 8dot3name query volume{928842df-5a01-11de-a85c-806e6f6e6963}

Você também pode consultar o comportamento do nome 8dot3 usando o subcomando de


comportamento.

Para remover nomes de arquivo 8dot3 no diretório D:\MyData e todos os subdiretórios, ao


gravar as informações no arquivo de log especificado como mylogfile.log, digite:

fsutil 8dot3name strip /l mylogfile.log /s d:\MyData

Links relacionados
Chave da sintaxe de linha de comando

fsutil

fsutil behavior
fsutil behavior
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8

Consulta ou define o comportamento do volume do NTFS, que inclui:

Criar os nomes de arquivo de comprimento de 8,3 caracteres.

Estender o uso de caracteres em nomes de arquivo curtos de comprimento de 8,3


caracteres em volumes do NTFS.

Atualização do carimbo de Hora do último acesso quando os diretórios são


listados em volumes do NTFS.

A frequência com que os eventos de cota são gravados no log do sistema e no


pool paginado do NTFS e nos níveis de cache de memória do pool não paginado
do NTFS.

O tamanho da zona da tabela de arquivos mestre (Zona MFT).

Exclusão silenciosa de dados quando o sistema encontra corrupção em um volume


do NTFS.

Notificação de exclusão de arquivo (também conhecida como cortar ou cancelar o


mapa).

Sintaxe

fsutil behavior query {allowextchar | bugcheckoncorrupt | disable8dot3


[<volumepath>] | disablecompression | disablecompressionlimit |
disableencryption | disablefilemetadataoptimization | disablelastaccess |
disablespotcorruptionhandling | disabletxf | disablewriteautotiering |
encryptpagingfile | mftzone | memoryusage | quotanotify | symlinkevaluation
| disabledeletenotify}

fsutil behavior set {allowextchar {1|0} | bugcheckoncorrupt {1|0} |


disable8dot3 [ <value> | [<volumepath> {1|0}] ] | disablecompression {1|0} |
disablecompressionlimit {1|0} | disableencryption {1|0} |
disablefilemetadataoptimization {1|0} | disablelastaccess {1|0} |
disablespotcorruptionhandling {1|0} | disabletxf {1|0} |
disablewriteautotiering {1|0} | encryptpagingfile {1|0} | mftzone <Value> |
memoryusage <Value> | quotanotify <frequency> | symlinkevaluation
<symboliclinktype> | disabledeletenotify {1|0}}

Parâmetros

Parâmetro Descrição

Consulta Consulta os parâmetros de comportamento do sistema de


arquivos.

set Altera os parâmetros de comportamento do sistema de


arquivos.

allowextchar {1|0} Permite que (1) ou não (0) caracteres do conjunto de caracteres
estendido (incluindo caracteres diacríticos) sejam usados em
nomes de arquivo curtos de comprimento de 8,3 caracteres em
volumes do NTFS.

Reinicie o computador para que esse parâmetro entre em


vigor.

Bugcheckoncorrupt {1|0} Permite (1) ou não a geração (0) de uma verificação de bug
quando há corrupção em um volume do NTFS. Esse recurso
pode ser usado para impedir que o NTFS exclua dados
silenciosamente quando usado com o recurso de Auto-
recuperação do NTFS.

Reinicie o computador para que esse parâmetro entre em


vigor.

disable8dot3 [ <volumepath> ] Desabilita (1) ou habilita (0) a criação de nomes de arquivo de


{1|0} 8,3 caracteres em volumes formatados em FAT e NTFS.
Opcionalmente, prefixo com o volumepath especificado como
um nome de unidade seguido por dois-pontos ou GUID.

disablecompression {1|0} Desabilita (1) ou habilita (0) a compactação do NTFS.

Reinicie o computador para que esse parâmetro entre em


vigor.
Parâmetro Descrição

disablecompressionlimit {1|0} Desabilita (1) ou habilita (0) o limite de compactação do NTFS


no volume do NTFS. Quando um arquivo compactado atinge
um determinado nível de fragmentação, em vez de não
estender o arquivo, o NTFS para de compactar extensões
adicionais do arquivo. Isso foi feito para permitir que os
arquivos compactados fossem maiores do que normalmente
seriam. Definir esse valor como TRUE desabilita esse recurso
que limita o tamanho dos arquivos compactados no sistema.
Não recomendamos desabilitar esse recurso.

Reinicie o computador para que esse parâmetro entre em


vigor.

disableencryption {1|0} Desabilita (1) ou habilita (0) a criptografia de pastas e arquivos


em volumes do NTFS.

Reinicie o computador para que esse parâmetro entre em


vigor.

disablefilemetadataoptimization Desabilita (1) ou habilita (0) a otimização de metadados de


{1|0} arquivo. O NTFS tem um limite de quantas extensões um
determinado arquivo pode ter. Arquivos compactados e
esparsos podem se tornar muito fragmentados. Por padrão, o
NTFS compacta periodicamente suas estruturas de metadados
internos para permitir arquivos mais fragmentados. Definir
esse valor como TRUE desabilita essa otimização interna. Não
recomendamos desabilitar esse recurso.

Reinicie o computador para que esse parâmetro entre em


vigor.

disablelastaccess {1|0} Desabilita (1) ou habilita (0) atualizações para o carimbo da


Hora do Último Acesso em cada diretório quando os diretórios
são listados em um volume do NTFS.

Reinicie o computador para que esse parâmetro entre em


vigor.

disablespotcorruptionhandling Desabilita (1) ou habilita (0) o tratamento de corrupção spot.


{1|0} Também permite que os administradores do sistema executem
o CHKDSK para analisar o estado de um volume sem deixá-lo
offline. Não recomendamos desabilitar esse recurso.

Reinicie o computador para que esse parâmetro entre em


vigor.
Parâmetro Descrição

disabletxf {1|0} Desabilita (1) ou habilita (0) txf no volume do NTFS


determinado. O TxF é um recurso do NTFS que fornece
transação como semântica para operações do sistema de
arquivos. O TxF está preterido no momento, mas a
funcionalidade ainda está disponível. Não recomendamos
desabilitar esse recurso no volume C:.

Reinicie o computador para que esse parâmetro entre em


vigor.

disablewriteautotiering {1|0} Desabilita a lógica de camada automática do ReFS v2 para


volumes em camadas.
Reinicie o computador para que esse parâmetro entre em
vigor.

encryptpagingfile {1|0} Criptografa (1) ou não (0) o arquivo de paginação de memória


no sistema operacional do Windows.

Reinicie o computador para que esse parâmetro entre em


vigor.

mftzone <value> Define o tamanho da Zona MFT e é expresso como um


múltiplo de unidades de 200 MB. Defina o valor como um
número de 1 (o padrão é 200 MB) para 4 (o máximo é 800 MB).

Reinicie o computador para que esse parâmetro entre em


vigor.

memoryusage <value> Configura os níveis de cache interno de memória de pool


paginado do NTFS e memória de pool não paginado do NTFS.
Defina como 1 ou 2. Quando definido como 1 (o padrão), o
NTFS usa a quantidade padrão de memória de pool paginado.
Quando definido como 2, o NTFS aumenta o tamanho de suas
listas lookaside e limites de memória. (Uma lista lookaside é
um pool de buffers de memória de tamanho fixo que os
drivers de kernel e de dispositivo criam como caches de
memória privada para operações do sistema de arquivos,
como a leitura de um arquivo.)

Reinicie o computador para que esse parâmetro entre em


vigor.

quotanotify <frequency> Configura com que frequência as violações de cota do NTFS


são relatadas no log do sistema. Os valores válidos para estão
no intervalo 0 – 4294967295. A frequência padrão é de 3.600
segundos (uma hora).

Reinicie o computador para que esse parâmetro entre em


vigor.
Parâmetro Descrição

symlinkevaluation Controla o tipo de links simbólicos que podem ser criados em


<symboliclinktype> um computador. As opções válidas são:
1 – Links simbólicos locais para locais, L2L:{0|1}
2 – Links simbólicos locais para remotos, L2R:{1|0}
3 – Links simbólicos remotos para locais, R2L:{1|0}
4 – Links simbólicos remotos para remotos, R2R:{1|0}

disabledeletenotify Desabilita (1) ou habilita (0) notificações de exclusão. As


notificações de exclusão (também conhecidas como cortar ou
cancelar o mapa) são um recurso que notifica o dispositivo de
armazenamento subjacente de clusters que foram liberados
devido a uma operação de exclusão de arquivo. Além disso:

Para sistemas que usam ReFS v2, o corte é desabilitado


por padrão.
Para sistemas que usam ReFS v1, o corte é habilitado por
padrão.
Para sistemas que usam o NTFS, o corte é habilitado por
padrão, a menos que um administrador o desabilite.
Se a unidade de disco rígido ou a SAN informar que ela
não dá suporte ao corte, a unidade de disco rígido e as
SANs não receberão notificações de corte.
Habilitar ou desabilitar não requer uma reinicialização.
O corte é eficaz quando o próximo comando cancelar o
mapa é emitido.
A E/S de bordo existente não é afetada pela alteração do
Registro.
Não requer nenhuma reinicialização de serviço ao
habilitar ou desabilitar o corte.

Comentários
A Zona MFT é uma área reservada que permite que a tabela de arquivos mestre
(MFT) se expanda conforme necessário para evitar a fragmentação de MFT. Se o
tamanho médio do arquivo no volume for de 2 KB ou menos, poderá ser benéfico
definir o valor mftzone como 2. Se o tamanho médio do arquivo no volume for de
1 KB ou menos, poderá ser benéfico definir o valor mftzone como 4.

Quando disable8dot3 é definido como 0, sempre que criar um arquivo com um


nome de arquivo longo, o NTFS cria uma segunda entrada de arquivo que tem um
nome de arquivo de 8,3 caracteres. Quando o NTFS cria arquivos em um diretório,
ele deve pesquisar os nomes de arquivo de 8,3 caracteres associados aos nomes
de arquivo longos. Esse parâmetro atualiza a chave do Registro
HKLM\SYSTEM\CurrentControlSet\Control\FileSystem\NtfsDisable8dot3NameCr
eation.

O parâmetro allowextchar atualiza a chave do registro


HKLM\SYSTEM\CurrentControlSet\Control\FileSystem\NtfsAllowExtendedCharac
terIn8dot3Name.

O parâmetro disablelastaccess reduz o impacto das atualizações de registro em


log para o carimbo da Hora do Último Acesso em arquivos e diretórios. Desabilitar
o recurso Hora do Último Acesso melhora a velocidade do acesso ao arquivo e ao
diretório. Esse parâmetro atualiza a chave do Registro
HKLM\SYSTEM\CurrentControlSet\Control\FileSystem\NtfsDisableLastAccessUp
date.

Observações:

As consultas de Hora do Último Acesso baseadas em arquivo são precisas


mesmo se todos os valores em disco não forem atuais. O NTFS retorna o valor
correto em consultas porque o valor preciso é armazenado na memória.

Uma hora é a quantidade máxima de tempo que o NTFS pode adiar a


atualização da Hora do Último Acesso no disco. Se o NTFS atualizar outros
atributos de arquivo, como Hora da Última Modificação, e uma atualização da
Hora do Último Acesso estiver pendente, o NTFS atualizará a Hora do Último
Acesso com as outras atualizações sem impacto adicional no desempenho.

O parâmetro disablelastaccess pode afetar programas como Backup e


Armazenamento Remoto, que dependem desse recurso.

Aumentar a memória física nem sempre aumenta a quantidade de memória do


pool de páginas disponível para o NTFS. Definir memoryusage como 2 eleva o
limite de memória do pool de páginas. Isso poderá melhorar o desempenho se o
sistema estiver abrindo e fechando muitos arquivos no mesmo conjunto de
arquivos e ainda não estiver usando grandes quantidades de memória do sistema
para outros aplicativos ou para memória de cache. Se o computador já estiver
usando grandes quantidades de memória do sistema para outros aplicativos ou
para memória de cache, aumentar o limite de memória de pool paginada e não
paginada do NTFS reduzirá a memória do pool disponível para outros processos.
Isso pode reduzir o desempenho geral do sistema. Esse parâmetro atualiza a chave
do Registro
HKLM\SYSTEM\CurrentControlSet\Control\FileSystem\NtfsMemoryUsage.
O valor especificado no parâmetro mftzone é uma aproximação do tamanho
inicial do MFT mais a Zona do MFT em um novo volume e é definido no momento
da montagem para cada sistema de arquivos. À medida que o espaço no volume é
usado, o NTFS ajusta o espaço reservado para o crescimento futuro do MFT. Se a
Zona do MFT já for grande, o tamanho completo da Zona do MFT não será
reservado novamente. Como a Zona do MFT é baseada no intervalo contíguo após
o final do MFT, ela é reduzida à medida que o espaço é usado.

O sistema de arquivos não determina o novo local da Zona do MFT até que a zona
do MFT atual seja completamente usada. Observe que isso nunca ocorre em um
sistema típico.

Alguns dispositivos podem enfrentar degradação de desempenho quando o


recurso de notificação de exclusão estiver ativado. Nesse caso, use a opção
desabilitadaeletenotify para desativar o recurso de notificação.

Exemplos
Para consultar o comportamento de nome 8dot3 desabilitado para um volume de disco
especificado com o GUID, {928842df-5a01-11de-a85c-806e6f6e6963}, digite:

fsutil behavior query disable8dot3 volume{928842df-5a01-11de-a85c-


806e6f6e6963}

Você também pode consultar o comportamento do nome 8dot3 usando o subcomando


de 8dot3name.

Para consultar o sistema para visualizar se o TRIM está habilitado ou não, digite:

fsutil behavior query DisableDeleteNotify

Isso gera uma saída semelhante a esta:

NTFS DisableDeleteNotify = 1
ReFS DisableDeleteNotify is not currently set
Para substituir o comportamento padrão para o TRIM (disabledeletenotify) para o ReFS
v2, digite:

fsutil behavior set disabledeletenotify ReFS 0

Para substituir o comportamento padrão para o TRIM (disabledeletenotify) para o NTFS


e o ReFS v1, digite:

fsutil behavior set disabledeletenotify 1

Links relacionados
Chave da sintaxe de linha de comando

fsutil

fsutil 8dot3name
fsutil dirty
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8

Consulta ou define o bit sujo de um volume. Quando o bit sujo de um volume é


definido, o autochk verifica automaticamente se há erros no volume na próxima vez que
o computador é reiniciado.

Sintaxe

fsutil dirty {query | set} <volumepath>

Parâmetros

Parâmetro Descrição

Consulta Consulta o bit sujo do volume especificado.

set Define o bit sujo do volume especificado.

<volumepath> Especifica o nome da unidade seguido de dois-pontos ou GUID no seguinte


formato: volume{GUID} .

Comentários
O bit sujo de um volume indica que o sistema de arquivos pode estar em um
estado inconsistente. O bit sujo pode ser definido porque:

O volume está online e tem alterações pendentes.

Foram feitas alterações no volume e o computador foi desligado antes que as


alterações fossem confirmadas no disco.

A corrupção foi detectada no volume.


Se o bit sujo for definido quando o computador for reiniciado, o chkdsk será
executado para verificar a integridade do sistema de arquivos e tentar corrigir
quaisquer problemas com o volume.

Exemplos
Para consultar o bit sujo na unidade C, digite:

fsutil dirty query c:

Se o volume estiver sujo, a seguinte saída será exibida: Volume C: is dirty

Se o volume não estiver sujo, a seguinte saída será exibida: Volume C: is not
dirty

Para definir o bit sujo na unidade C, digite:

fsutil dirty set C:

Links relacionados
Chave da sintaxe de linha de comando

fsutil
fsutil file
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8

Localiza um arquivo por nome de usuário (se as Cotas de Disco estiverem habilitadas),
consulta intervalos alocados para um arquivo, define o nome curto de um arquivo,
define o comprimento de dados válido de um arquivo, define zero dados para um
arquivo ou cria um arquivo.

Sintaxe

fsutil file [createnew] <filename> <length>


fsutil file [findbysid] <username> <directory>
fsutil file [optimizemetadata] [/A] <filename>
fsutil file [queryallocranges] offset=<offset> length=<length> <filename>
fsutil file [queryextents] [/R] <filename> [<startingvcn> [<numvcns>]]
fsutil file [queryfileid] <filename>
fsutil file [queryfilenamebyid] <volume> <fileid>
fsutil file [queryoptimizemetadata] <filename>
fsutil file [queryvaliddata] [/R] [/D] <filename>
fsutil file [seteof] <filename> <length>
fsutil file [setshortname] <filename> <shortname>
fsutil file [setvaliddata] <filename> <datalength>
fsutil file [setzerodata] offset=<offset> length=<length> <filename>

Parâmetros

Parâmetro Descrição

createnew Cria um arquivo com o nome e o tamanho especificados, com


conteúdo que consiste em zeros.

<length> Especifica o comprimento de dados válido do arquivo.

findbysid Localiza arquivos que pertencem a um usuário especificado em


volumes NTFS em que as Cotas de Disco estão habilitadas.

<username> Especifica o nome de usuário ou o nome de logon do usuário.


Parâmetro Descrição

<directory> Especifica o caminho completo para o diretório, por exemplo, C:\users.

optimizemetadata Executa uma compactação imediata dos metadados para um


determinado arquivo.

/a Analise os metadados do arquivo antes e depois da otimização.

queryallocranges Consulta os intervalos alocados para um arquivo em um volume NTFS.


Útil para determinar se um arquivo tem regiões esparsas.

offset= <offset> Especifica o início do intervalo que deve ser definido como zeros.

length= <length> Especifica o comprimento do intervalo (em bytes).

queryextents Consulta as extensões de um arquivo.

/r Se <filename> for um ponto de nova análise, abra-o em vez de seu


destino.

<startingvcn> Especifica o primeiro VCN a ser consultado. Se omitido, comece no


VCN 0.

<numvcns> Número de VCNs a serem consultados. Se omitido ou 0, consulte até


EOF.

queryfileid Consulta a ID de um arquivo em um volume NTFS.

<volume> Especifica o volume como o nome da unidade, seguido de dois-pontos.

queryfilenamebyid Exibe um nome de link aleatório para uma ID de arquivo especificada


em um volume NTFS. Como um arquivo pode ter mais de um nome de
link apontando para esse arquivo, não é garantido qual link de arquivo
será fornecido como resultado da consulta para o nome do arquivo.

<fileid> Especifica a ID do arquivo em um volume NTFS.

queryoptimizemetadata Consulta o estado de metadados de um arquivo.

queryvaliddata Consulta o comprimento de dados válido de um arquivo.

/d Exibe informações detalhadas de dados válidos.

seteof Define o EOF do arquivo especificado.

setshortname Define o nome abreviado (nome de arquivo de 8,3 caracteres) para um


arquivo em um volume NTFS.

<shortname> Especifica o nome abreviado do arquivo.


Parâmetro Descrição

setvaliddata Define o comprimento de dados válido para um arquivo em um


volume NTFS.

<datalength> Especifica o comprimento do tamanho em bytes.

setzerodata Define um intervalo (especificado por deslocamento e comprimento) do


arquivo como zeros, o que esvazia o arquivo. Se o arquivo for um
arquivo esparso, as unidades de alocação subjacentes serão
descompactadas.

Comentários

No NTFS, há dois conceitos importantes de comprimento de arquivo: o marcador


EOF (fim do arquivo) e o VDL (Comprimento de dados válido). EOF indica o
comprimento real do arquivo. VDL identifica o comprimento dos dados válidos no
disco. Qualquer leitura entre VDL e EOF retorna automaticamente 0 para preservar
o requisito de reutilização de objeto C2.

O parâmetro setvaliddata só está disponível para administradores porque requer o


privilégio Executar tarefas de manutenção de volume (SeManageVolumePrivilege).
Esse recurso só é necessário para cenários avançados de multimídia e de rede de
área do sistema. O parâmetro setvaliddata precisa ser um valor positivo maior que
o VDL atual, mas menor que o tamanho do arquivo atual.

É útil para os programas definir um VDL ao:

Gravar clusters brutos diretamente no disco por meio de um canal de hardware.


Isso permite que o programa informe ao sistema de arquivos que esse intervalo
contém dados válidos que podem ser retornados ao usuário.

Criar arquivos grandes quando o desempenho é um problema. Isso evita o


tempo necessário para preencher o arquivo com zeros quando o arquivo é
criado ou estendido.

Exemplos
Para localizar arquivos que pertencem a scottb na unidade C, digite:

fsutil file findbysid scottb c:\users


Para consultar os intervalos alocados para um arquivo em um volume NTFS, digite:

fsutil file queryallocranges offset=1024 length=64 c:\temp\sample.txt

Para otimizar os metadados para um arquivo, digite:

fsutil file optimizemetadata C:\largefragmentedfile.txt

Para consultar as extensões de um arquivo, digite:

fsutil file queryextents C:\Temp\sample.txt

Para definir o EOF de um arquivo, digite:

fsutil file seteof C:\testfile.txt 1000

Para definir o nome abreviado do arquivo, longfilename.txt na unidade C como


longfile.txt, digite:

fsutil file setshortname c:\longfilename.txt longfile.txt

Para definir o comprimento de dados válido como 4096 bytes para um arquivo chamado
testfile.txt em um volume NTFS, digite:

fsutil file setvaliddata c:\testfile.txt 4096

Para definir um intervalo de um arquivo em um volume NTFS como zeros para esvaziá-
lo, digite:

fsutil file setzerodata offset=100 length=150 c:\temp\sample.txt


Links relacionados
Chave da sintaxe de linha de comando

fsutil
fsutil fsinfo
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8

Lista todas as unidades e consulta o tipo de unidade, informações de volume,


informações de volume específicas do NTFS ou estatísticas do sistema de arquivos.

Sintaxe

fsutil fsinfo [drives]


fsutil fsinfo [drivetype] <volumepath>
fsutil fsinfo [ntfsinfo] <rootpath>
fsutil fsinfo [statistics] <volumepath>
fsutil fsinfo [volumeinfo] <rootpath>

Parâmetros

Parâmetro Descrição

unidades Lista todas as unidades no computador.

drivetype Consulta uma unidade e lista seu tipo, por exemplo, unidade CD-ROM.

ntfsinfo Lista informações de volume específicas do NTFS para o volume especificado,


como o número de setores, o total de clusters, clusters livres e o início e o fim da
Zona MFT.

sectorinfo Lista informações sobre o tamanho e o alinhamento do setor do hardware.

estatísticas Lista estatísticas do sistema de arquivos para o volume especificado, como


metadados, arquivo de log e leituras e gravações do MFT.

volumeinfo Lista informações sobre o volume especificado, como o sistema de arquivos, e se


o volume dá suporte a nomes de arquivo que diferenciam maiúsculas de
minúsculas, Unicode em nomes de arquivo, cotas de disco ou se é um volume
DAX (DirectAccess).

<volumepath>: Especifica a letra da unidade (seguida de dois-pontos).


Parâmetro Descrição

<rootpath>: Especifica a letra da unidade (seguida de dois-pontos) da unidade raiz.

Exemplos
Para listar todas as unidades no computador, digite:

fsutil fsinfo drives

Uma saída semelhante a esta será exibida:

Drives: A:\ C:\ D:\ E:\

Para consultar o tipo de unidade da unidade C, digite:

fsutil fsinfo drivetype c:

Os possíveis resultados da consulta incluem:

Unknown Drive
No such Root Directory
Removable Drive, for example floppy
Fixed Drive
Remote/Network Drive
CD-ROM Drive
Ram Disk

Para consultar as informações de volume do volume E, digite:

fsutil fsinfo volumeinfo e:

Uma saída semelhante a esta será exibida:


Volume Name : Volume
Serial Number : 0xd0b634d9
Max Component Length : 255
File System Name : NTFS
Supports Named Streams
Is DAX Volume

Para consultar a unidade F para obter informações de volume específicas do NTFS,


digite:

fsutil fsinfo ntfsinfo f:

Uma saída semelhante a esta será exibida:

NTFS Volume Serial Number : 0xe660d46a60d442cb


Number Sectors : 0x00000000010ea04f
Total Clusters : 0x000000000021d409
Mft Zone End : 0x0000000000004700

Para consultar o hardware subjacente do sistema de arquivos para obter informações do


setor, digite:

fsutil fsinfo sectorinfo d:

Uma saída semelhante a esta será exibida:

D:\>fsutil fsinfo sectorinfo d:


LogicalBytesPerSector : 4096
PhysicalBytesPerSectorForAtomicity : 4096
Trim Not Supported
DAX capable

Para consultar as estatísticas do sistema de arquivos para a unidade E, digite:

fsutil fsinfo statistics e:


Uma saída semelhante a esta será exibida:

File System Type : NTFS


Version : 1
UserFileReads : 75021
UserFileReadBytes : 1305244512
LogFileWriteBytes : 180936704

Links relacionados
Chave da sintaxe de linha de comando

fsutil
fsutil hardlink
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8

Cria um link rígido entre um arquivo existente e um novo arquivo. Um link rígido é uma
entrada de diretório para um arquivo. Cada arquivo pode ser considerado como tendo
pelo menos um link rígido.

Em volumes NTFS, cada arquivo pode ter vários links rígidos, portanto, um arquivo pode
aparecer em muitos diretórios (ou até mesmo no mesmo diretório, com nomes
diferentes). Como todos os links fazem referência ao mesmo arquivo, os programas
podem abrir qualquer um dos links e modificar o arquivo. Um arquivo é excluído do
sistema de arquivos somente depois que todos os links para ele tiverem sido excluídos.
Depois de criar um link rígido, os programas poderão usá-lo como qualquer outro
nome de arquivo.

Sintaxe

fsutil hardlink create <newfilename> <existingfilename>


fsutil hardlink list <filename>

Parâmetros

Parâmetro Descrição

create Estabelece um link rígido NTFS entre um arquivo existente e um novo


arquivo. (Um link rígido NTFS é semelhante a um link rígido POSIX.)

<newfilename> Especifica o arquivo para o qual você deseja criar um link rígido.

<existingfilename> Especifica o arquivo do qual você deseja criar um link rígido.

list Lista os links rígidos para filename.

Links relacionados
Chave da sintaxe de linha de comando

fsutil
fsutil objectid
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8

Gerencia identificadores de objeto (OIDs), que são objetos internos usados pelo serviço
cliente DLT (Controle de Link Distribuído) e FRS (Serviço de Replicação de Arquivos),
para rastrear outros objetos, como arquivos, diretórios e links. Os identificadores de
objeto são invisíveis para a maioria dos programas e nunca devem ser modificados.

2 Aviso

Não exclua, defina ou modifique um identificador de objeto. Excluir ou definir um


identificador de objeto pode resultar na perda de dados de partes de um arquivo,
até e incluindo volumes inteiros de dados. Além disso, você pode causar um
comportamento adverso no serviço cliente DLT (Controle de Link Distribuído) e no
FRS (Serviço de Replicação de Arquivos).

Sintaxe

fsutil objectid [create] <filename>


fsutil objectid [delete] <filename>
fsutil objectid [query] <filename>
fsutil objectid [set] <objectID> <birthvolumeID> <birthobjectID> <domainID>
<filename>

Parâmetros

Parâmetro Descrição

create Cria um identificador de objeto se o arquivo especificado ainda não tiver um.
Se o arquivo já tiver um identificador de objeto, esse subcomando será
equivalente ao subcomando de consulta.

excluir Exclui um identificador de objeto.


Parâmetro Descrição

Consulta Consulta um identificador de objeto.

set Define um identificador de objeto.

<objectID> Define um identificador hexadecimal de 16 bytes específico do arquivo que


tem a garantia de ser exclusivo dentro de um volume. O identificador de
objeto é usado pelo serviço cliente DLT (Controle de Link Distribuído) e pelo
FRS (Serviço de Replicação de Arquivos) para identificar arquivos.

<birthvolumeID> Indica o volume no qual o arquivo foi localizado quando obteve um


identificador de objeto pela primeira vez. Esse valor é um identificador
hexadecimal de 16 bytes usado pelo serviço de cliente DLT.

<birthobjectID> Indica o identificador de objeto original do arquivo (o objectID pode ser


alterado quando um arquivo é movido). Esse valor é um identificador
hexadecimal de 16 bytes usado pelo serviço de cliente DLT.

<domainID> Identificador de domínio hexadecimal de 16 bytes. Esse valor não é usado no


momento e deve ser definido para todos os zeros.

<filename> Especifica o caminho completo para o arquivo, incluindo o nome do arquivo e


a extensão, por exemplo C:\documents\filename.txt.

Comentários
Qualquer arquivo que tenha um identificador de objeto também tem um
identificador de volume de criação, um identificador de objeto de criação e um
identificador de domínio. Ao mover um arquivo, o identificador de objeto pode
mudar, mas os identificadores do volume de criação e do objeto de criação
permanecem os mesmos. Esse comportamento permite que o sistema operacional
do Windows sempre encontre um arquivo, independentemente de onde ele tenha
sido movido.

Exemplos
Para criar um identificador de objeto, digite:

fsutil objectid create c:\temp\sample.txt

Para excluir um identificador de objeto, digite:

fsutil objectid delete c:\temp\sample.txt

Para consultar um identificador de objeto, digite:


fsutil objectid query c:\temp\sample.txt

Para definir um identificador de objeto, digite:

fsutil objectid set 40dff02fc9b4d4118f120090273fa9fc

f86ad6865fe8d21183910008c709d19e 40dff02fc9b4d4118f120090273fa9fc
00000000000000000000000000000000 c:\temp\sample.txt

Links relacionados
Chave da sintaxe de linha de comando

fsutil
fsutil quota
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8

Gerencia cotas de disco em volumes do NTFS para fornecer um controle mais preciso
do armazenamento baseado em rede.

Sintaxe

fsutil quota [disable] <volumepath>


fsutil quota [enforce] <volumepath>
fsutil quota [modify] <volumepath> <threshold> <limit> <username>
fsutil quota [query] <volumepath>
fsutil quota [track] <volumepath>
fsutil quota [violations]

Parâmetros

Parâmetro Descrição

disable Desabilita o controle de cota e a imposição no volume especificado.

impor Impõe o uso de cota no volume especificado.

modify Modifica uma cota de disco existente ou cria uma nova cota.

Consulta Lista cotas de disco existentes.

rastrear Controla o uso de disco no volume especificado.

violações Pesquisa os logs do sistema e do aplicativo e exibe uma mensagem para indicar
que violações de cota foram detectadas ou que um usuário atingiu um limite de
cota ou cota.

<volumepath> Obrigatórios. Especifica o nome da unidade seguido de dois pontos (:) ou o GUID
no formato volume{GUID} .

<threshold> Define o limite (em bytes) no qual os avisos são emitidos. Esse parâmetro é
necessário para o comando fsutil quota modify .
Parâmetro Descrição

<limit> Define o uso máximo de disco permitido (em bytes). Esse parâmetro é necessário
para o comando fsutil quota modify .

<username> Especifica o nome de usuário ou domínio. Esse parâmetro é necessário para o


comando fsutil quota modify .

Comentários

As cotas de disco são implementadas por volume e permitem que os limites de


armazenamento rígido e flexível sejam implementados por usuário.

Use os scripts de gravação que usam a cota fsutil para definir os limites de cota
sempre que adicionar um novo usuário ou para controlar automaticamente os
limites de cota, compilá-los em um relatório e enviá-los automaticamente para o
administrador do sistema por email.

Exemplos
Para listar cotas de disco existentes para um volume de disco especificado com o GUID,
{928842df-5a01-11de-a85c-806e6f6e6963}, digite:

fsutil quota query volume{928842df-5a01-11de-a85c-806e6f6e6963}

Para listar cotas de disco existentes para um volume de disco especificado com a letra
da unidade, C:, digite:

fsutil quota query C:

Links relacionados
Chave da sintaxe de linha de comando

fsutil
fsutil repair
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8

Administra e monitora operações de reparo de autorrecuperação do NTFS. O NTFS de


autorrecuperação tenta corrigir corrupção do sistema de arquivos NTFS online, sem
exigir que Chkdsk.exe seja executado. Para obter mais informações, confira NTFS de
autorrecuperação.

Sintaxe

fsutil repair [enumerate] <volumepath> [<logname>]


fsutil repair [initiate] <volumepath> <filereference>
fsutil repair [query] <volumepath>
fsutil repair [set] <volumepath> <flags>
fsutil repair [wait][<waittype>] <volumepath>

Parâmetros

Parâmetro Descrição

enumerate Enumera os inteiros do log de corrupção de um volume.

<logname> Pode ser $corrupt , o conjunto de corrupções confirmadas no volume ou


$verify , um conjunto de possíveis corrupções não verificadas no volume.

initiate Inicia a autorrecuperação do NTFS.

<filereference> Especifica a ID de arquivo específica ao volume NTFS (número de referência de


arquivo). A referência de arquivo inclui o número do segmento do arquivo.

Consulta Consulta o estado de autorrecuperação do volume do NTFS.

set Define o estado de autorrecuperação do volume.


Parâmetro Descrição

<flags> Especifica o método de reparo a ser usado ao definir o estado de


autorrecuperação do volume.
Esse parâmetro pode ser definido como três valores:

0x01 – Habilita o reparo geral.


0x09 – Alerta sobre a possível perda de dados sem reparo.
0x00 – Desabilita as operações de reparo de autorrecuperação do NTFS.

state Consulta o estado de corrupção do sistema ou para um determinado volume.

wait Aguarda a conclusão dos reparos. Se o NTFS tiver detectado um problema em


um volume no qual está executando reparos, essa opção permite que o
sistema aguarde até que o reparo seja concluído antes de executar scripts
pendentes.

[waittype Indica se é necessário aguardar a conclusão do reparo atual ou aguardar a


{0|1}] conclusão de todos os reparos. O parâmetro waittype pode ser definido como
os valores a seguir:

0 – Aguarda a conclusão de todos os reparos. (valor padrão)


1 – Aguarda a conclusão do reparo atual.

Exemplos
Para enumerar as corrupções confirmadas de um volume, digite:

fsutil repair enumerate C: $Corrupt

Para habilitar o reparo de autorrecuperação na unidade C, digite:

fsutil repair set c: 1

Para desabilitar o reparo de autorrecuperação na unidade C, digite:

fsutil repair set c: 0


Links relacionados
Chave da sintaxe de linha de comando

fsutil

NTFS de autorrecuperação
fsutil reparsepoint
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8

Consulta ou exclui pontos de nova análise. O comando fsutil reparsepoint normalmente


é usado por profissionais de suporte.

Pontos de nova análise são objetos do sistema de arquivos NTFS que têm um atributo
definível, que contém dados definidos pelo usuário. Eles estão acostumados a:

Estender a funcionalidade no subsistema de entrada/saída (E/S).

Atuar como pontos de junção de diretório e pontos de montagem de volume.

Marque determinados arquivos como especiais para um driver de filtro do sistema


de arquivos.

Sintaxe

fsutil reparsepoint [query] <filename>


fsutil reparsepoint [delete] <filename>

Parâmetros

Parâmetro Descrição

Consulta Recupera os dados do ponto de nova análise associados ao arquivo ou diretório


identificado pelo identificador especificado.

excluir Exclui um ponto de nova análise do arquivo ou diretório identificado pelo


identificador especificado, mas não exclui o arquivo ou diretório.

<filename> Especifica o caminho completo para o arquivo, incluindo o nome do arquivo e a


extensão, por exemplo C:\documents\filename.txt.

Comentários
Quando um programa define um ponto de nova análise, ele armazena esses
dados, além de uma marca de nova análise, que identifica exclusivamente os
dados que ele está armazenando. Quando o sistema de arquivos abre um arquivo
com um ponto de nova análise, ele tenta localizar o filtro do sistema de arquivos
associado. Se o filtro do sistema de arquivos for encontrado, o filtro processará o
arquivo conforme direcionado pelos dados de nova análise. Se nenhum filtro do
sistema de arquivos for encontrado, a operação Abrir arquivo falhará.

Exemplos
Para recuperar dados de ponto de nova análise associados a c:\server, digite:

fsutil reparsepoint query c:\server

Para excluir um ponto de nova análise de um arquivo ou diretório especificado, use o


seguinte formato:

fsutil reparsepoint delete c:\server

Links relacionados
Chave da sintaxe de linha de comando

fsutil
fsutil resource
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8

Cria um Gerenciador de recursos transacional secundário, inicia ou interrompe um


Gerenciador de recursos transacional, exibe informações sobre um Gerenciador de
recursos transacional ou modifica seu comportamento:

Se um Gerenciador de recursos transacional padrão limpa seus metadados


transacionais na próxima montagem.

O Gerenciador de recursos transacional especificado dá preferência à consistência


em vez de à disponibilidade.

O Gerenciador de recursos transacional especificado dá preferência à


disponibilidade em vez de à consistência.

As características de um Gerenciador de recursos transacional em execução.

Sintaxe

fsutil resource [create] <rmrootpathname>


fsutil resource [info] <rmrootpathname>
fsutil resource [setautoreset] {true|false} <Defaultrmrootpathname>
fsutil resource [setavailable] <rmrootpathname>
fsutil resource [setconsistent] <rmrootpathname>
fsutil resource [setlog] [growth {<containers> containers|<percent> percent}
<rmrootpathname>] [maxextents <containers> <rmrootpathname>] [minextents
<containers> <rmrootpathname>] [mode {full|undo} <rmrootpathname>] [rename
<rmrootpathname>] [shrink <percent> <rmrootpathname>] [size <containers>
<rmrootpathname>]
fsutil resource [start] <rmrootpathname> [<rmlogpathname> <tmlogpathname>
fsutil resource [stop] <rmrootpathname>

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

create Cria uma Gerenciador de recursos transacional secundário.

<rmrootpathname> Especifica o caminho completo de um diretório raiz do Gerenciador


de recursos transacional.

informações Exibe as informações do Gerenciador de recursos transacional


especificado.

setautoreset Especifica se um Gerenciador de recursos transacional padrão limpará


os metadados transacionais na próxima montagem.
true: especifica que o Gerenciador de recursos transacional
limpará os metadados transacionais na próxima montagem, por
padrão.
false: especifica que o Gerenciador de recursos transacional não
limpará os metadados transacionais na próxima montagem, por
padrão.

<defaultrmrootpathname> Especifica o nome da unidade, seguido de dois-pontos.

setavailable Especifica que um Gerenciador de recursos transacional dará


preferência à disponibilidade em vez de à consistência.

setconsistent Especifica que um Gerenciador de recursos transacional dará


preferência à consistência em vez de à disponibilidade.

setlog Altera as características de um Gerenciador de recursos transacional


que já está em execução.

growth Especifica em que proporção o log do Gerenciador de recursos


Transacional pode crescer.
O parâmetro de crescimento pode ser especificado da seguinte
maneira:

Número de contêineres, usando o formato: <containers>


containers
Porcentagem, usando o formato: <percent> percent

<containers> Especifica os objetos de dados usados pelo Gerenciador de recursos


transacional.

maxextent Especifica o número máximo de contêineres do Gerenciador de


recursos transacional especificado.

minextent Especifica o número mínimo de contêineres do Gerenciador de


recursos transacional especificado.

mode {full|undo} Especifica se todas as transações são registradas (full) ou apenas os


eventos revertidos (undo).
Parâmetro Descrição

renomear Altera o GUID do Gerenciador de recursos transacional.

shrink Especifica o percentual pelo qual o log do Gerenciador de recursos


transacional pode diminuir automaticamente.

tamanho Especifica o tamanho do Gerenciador de recursos transacional como


um número especificado de contêineres.

iniciar Inicia o Gerenciador de recursos transacional especificado.

parar Interrompe o Gerenciador de recursos transacional especificado.

Exemplos
Para definir o log do Gerenciador de recursos transacional especificado por c:\test, para
ter um crescimento automático de cinco contêineres, digite:

fsutil resource setlog growth 5 containers c:test

Para definir o log do Gerenciador de recursos transacional especificado por c:\test, para
ter um crescimento automático de dois por cento, digite:

fsutil resource setlog growth 2 percent c:test

Para especificar que o Gerenciador de recursos transacional padrão limpará os


metadados transacionais na próxima montagem na unidade C, digite:

fsutil resource setautoreset true c:\

Links relacionados
Chave da sintaxe de linha de comando

fsutil

NTFS transacional
fsutil sparse
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8

Gerencia arquivos esparsos. Um arquivo esparso é um arquivo com uma ou mais


regiões de dados não alocados nele.

Um programa visualiza essas regiões não alocadas como contendo bytes com um valor
zero e que não há espaço em disco representando esses zeros. Quando um arquivo
esparso é lido, os dados alocados são retornados como armazenados e os dados não
alocados são retornados, por padrão, como zeros, de acordo com a especificação de
requisito de segurança C2. O suporte a arquivos esparsos permite que os dados sejam
desalocados de qualquer lugar no arquivo.

Sintaxe

fsutil sparse [queryflag] <filename>


fsutil sparse [queryrange] <filename>
fsutil sparse [setflag] <filename>
fsutil sparse [setrange] <filename> <beginningoffset> <length>

Parâmetros

Parâmetro Descrição

queryflag Consultas esparsas.

queryrange Examina um arquivo e pesquisa intervalos que podem conter dados


diferentes de zero.

setflag Marca o arquivo indicado como esparso.

setrange Preenche um intervalo especificado de um arquivo com zeros.

<filename> Especifica o caminho completo para o arquivo, incluindo o nome do arquivo


e a extensão, por exemplo C:\documents\filename.txt.
Parâmetro Descrição

<beginningoffset> Especifica o deslocamento dentro do arquivo a ser marcado como esparso.

<length> Especifica o comprimento da região no arquivo a ser marcado como esparso


(em bytes).

Comentários
Todos os dados significativos ou não zero são alocados, enquanto todos os dados
não significativos (cadeias de caracteres grandes de dados compostas por zeros)
não são alocados.

Em um arquivo esparso, grandes intervalos de zeros podem não exigir alocação de


disco. O espaço para dados não zero é alocado conforme necessário quando o
arquivo é gravado.

Somente arquivos compactados ou esparsos podem ter intervalos zerados


conhecidos pelo sistema operacional.

Se o arquivo for esparso ou compactado, o NTFS poderá desalocar o espaço em


disco dentro do arquivo. Isso define o intervalo de bytes como zeros sem estender
o tamanho do arquivo.

Exemplos
Para marcar um arquivo chamado sample.txt no diretório c:\temp como esparso, digite:

fsutil sparse setflag c:\temp\sample.txt

Links relacionados
Chave da sintaxe de linha de comando

fsutil
fsutil tiering
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016 e
Windows 10

Habilita o gerenciamento de funções da camada de armazenamento, como definir e


desabilitar sinalizadores e listar camadas.

Sintaxe

fsutil tiering [clearflags] <volume> <flags>


fsutil tiering [queryflags] <volume>
fsutil tiering [regionlist] <volume>
fsutil tiering [setflags] <volume> <flags>
fsutil tiering [tierlist] <volume>

Parâmetros

Parâmetro Descrição

clearflags Desabilita os sinalizadores de comportamento de camada de um volume.

<volume> Especifica o volume.

/trnh Para volumes com armazenamento em camadas, faz com que a coleta de calor seja
desabilitada.
Aplica-se somente a NTFS e ReFS.

queryflags Consulta os sinalizadores de comportamento de camada de um volume.

regionlist Lista as regiões em camadas de um volume e suas respectivas camadas de


armazenamento.

setflags Habilita os sinalizadores de comportamento de camada de um volume.

tierlist Lista as camadas de armazenamento associadas a um volume.

Exemplos
Para consultar os sinalizadores no volume C, digite:
fsutil tiering queryflags C:

Para definir os sinalizadores no volume C, digite:

fsutil tiering setflags C: /trnh

Para limpar os sinalizadores no volume C, digite:

fsutil tiering clearflags C: /trnh

Para listar as regiões do volume C e suas respectivas camadas de armazenamento,


digite:

fsutil tiering regionlist C:

Para listar as camadas do volume C, digite:

fsutil tiering tierlist C:

Links relacionados
Chave da sintaxe de linha de comando

fsutil
fsutil transaction
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8

Gerencia transações de NTFS.

Sintaxe

fsutil transaction [commit] <GUID>


fsutil transaction [fileinfo] <filename>
fsutil transaction [list]
fsutil transaction [query] [{files | all}] <GUID>
fsutil transaction [rollback] <GUID>

Parâmetros

Parâmetro Descrição

confirmar Marca o fim de uma transação especificada implícita ou explícita bem-sucedida.

<GUID> Especifica o valor GUID que representa uma transação.

FileInfo Exibe informações de transação para o arquivo especificado.

<filename> Especifica o caminho completo e nome de arquivo.

list Exibe uma lista de transações em execução.

Consulta Exibe informações para a transação especificada.


Se fsutil transaction query files for especificado, as informações do
arquivo serão exibidas somente para a transação especificada.
Se fsutil transaction query all for especificado, todas as informações da
transação serão exibidas.

reversão Reverte uma transação especificada para o início.

Exemplos
Para exibir as informações da transação para o arquivo c:\test.txt, digite:

fsutil transaction fileinfo c:\test.txt

Links relacionados
Chave da sintaxe de linha de comando

fsutil

NTFS transacional
fsutil usn
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8

Gerencia o diário de alterações de USN (números de sequência de atualização). O diário


de alterações de USN fornece um log persistente de todas as alterações feitas nos
arquivos de um volume. À medida que arquivos, diretórios e outros objetos NTFS são
adicionados, excluídos e modificados, o NTFS insere registros no diário de alterações de
USN, um para cada volume no computador. Cada registro indica o tipo de alteração e o
objeto alterado. Novos registros são acrescentados ao final do fluxo.

Sintaxe

fsutil usn [createjournal] m=<maxsize> a=<allocationdelta> <volumepath>


fsutil usn [deletejournal] {/d | /n} <volumepath>
fsutil usn [enablerangetracking] <volumepath> [options]
fsutil usn [enumdata] <fileref> <lowUSN> <highUSN> <volumepath>
fsutil usn [queryjournal] <volumepath>
fsutil usn [readdata] <filename>
fsutil usn [readjournal] [c= <chunk-size> s=<file-size-threshold>]
<volumepath>

Parâmetros

Parâmetro Descrição

createjournal Cria um diário de alterações de USN.

m= <maxsize> Especifica o tamanho máximo, em bytes, que o NTFS aloca para o diário
de alterações.

a= <allocationdelta> Especifica o tamanho, em bytes, da alocação de memória adicionada ao


final e removida do início do diário de alterações.

<volumepath> Especifica a letra da unidade (seguida de dois-pontos).


Parâmetro Descrição

deletejournal Exclui ou desabilita um diário de alterações de USN ativo.


CUIDADO: a exclusão do diário de alterações afeta o FRS (Serviço de
Replicação de Arquivos) e o Serviço de Indexação, pois exige que esses
serviços executem uma verificação completa (e demorada) do volume.
Isso, por sua vez, afeta negativamente a replicação de FRS SYSVOL e a
replicação entre alternativas de link do DFS enquanto o volume está
sendo verificado novamente.

/d Desabilita um diário de alterações de USN ativo e retorna o controle de


E/S (entrada/saída) enquanto o diário de alterações está sendo
desabilitado.

/n Desabilita um diário de alterações de USN ativo e retorna o controle de


E/S somente após a desabilitação do diário de alterações.

enablerangetracking Habilita o rastreamento de intervalo de gravação da USN para um


volume.

c= <chunk-size> Especifica o tamanho da parte a ser rastreada em um volume.

s= <file-size- Especifica o limite de tamanho do arquivo para rastreamento de intervalo.


threshold>

enumdata Enumera e lista as entradas do diário de alterações entre dois limites


especificados.

<fileref> Especifica a posição ordinal dentro dos arquivos no volume no qual a


enumeração deve começar.

<lowUSN> Especifica o limite inferior do intervalo de valores USN usados para filtrar
os registros retornados. Somente os registros cujo último USN do diário
de alterações que estejam entre os valores de membro lowUSN e
highUSN ou que forem iguais a eles retornarão.

<highUSN> Especifica o limite superior do intervalo de valores USN usados para filtrar
os arquivos retornados.

queryjournal Consulta os dados USN do volume para coletar informações sobre o


diário de alterações atual, seus registros e sua capacidade.

readdata Lê os dados de USN de um arquivo.

<filename> Especifica o caminho completo para o arquivo, incluindo o nome do


arquivo e a extensão, por exemplo C:\documents\filename.txt.

readjournal Lê os registros de USN no diário de USN.

minver= <number> A versão principal mínima de USN_RECORD a ser retornada. Padrão=2.


Parâmetro Descrição

maxver= <number> A versão principal máxima de USN_RECORD a ser retornada. Padrão=4.

startusn= <USN USN de qual começar a ler o diário de USN. Padrão = 0.


number>

Comentários

Os programas podem consultar o diário de alterações de USN para determinar


todas as modificações feitas em um conjunto de arquivos. O diário de alterações
de USN é muito mais eficiente do que verificar carimbos de data/hora ou registrar-
se para receber notificações de arquivo. O diário de alterações de USN é habilitado
e usado pelo Serviço de Indexação, FRS (Serviço de Replicação de Arquivos), RIS
(Serviços de Instalação Remota) e Armazenamento Remoto.

Se já existir um diário de alterações em um volume, o parâmetro createjournal


atualizará os parâmetros maxsize e allocationdelta do diário de alterações. Isso
permite expandir o número de registros que um diário ativo mantém sem precisar
desabilitá-lo.

O diário de alterações pode ultrapassar esse valor de destino, mas o diário de


alterações é truncado no próximo ponto de verificação de NTFS como inferior a
esse valor. O NTFS examina o diário de alterações e o corta quando o tamanho
excede o valor de maxsize mais o valor de allocationdelta. Em pontos de
verificação de NTFS, o sistema operacional grava registros no arquivo de log de
NTFS que permitem que o NTFS determine qual processamento é necessário para
se recuperar de uma falha.

O diário de alterações pode ultrapassar a soma dos valores de maxsize e


allocationdelta antes de ser cortado.

Excluir ou desabilitar um diário de alterações ativo é muito demorado, pois o


sistema deve acessar todos os registros na MFT (tabela de arquivos mestre) e
definir o último atributo de USN como 0 (zero). Esse processo pode levar vários
minutos e pode continuar após a reinicialização do sistema, se uma reinicialização
for necessária. Durante esse processo, o diário de alterações não é considerado
ativo nem está desabilitado. Embora o sistema esteja desabilitando o diário, ele
não pode ser acessado e todas as operações do diário retornam erros. Você deve
tomar cuidados extremos ao desabilitar um diário ativo, pois isso afeta
negativamente outros aplicativos que estão usando esse diário.
Exemplos
Para criar um diário de alterações de USN na unidade C, digite:

fsutil usn createjournal m=1000 a=100 c:

Para excluir um diário de alterações de USN ativo da unidade C, digite:

fsutil usn deletejournal /d c:

Para habilitar o rastreamento de intervalo com um tamanho de parte especificado e um


limite de tamanho de arquivo, digite:

fsutil usn enablerangetracking c=16384 s=67108864 C:

Para enumerar e listar as entradas do diário de alterações entre dois limites


especificados na unidade C, digite:

fsutil usn enumdata 1 0 1 c:

Para consultar dados de USN de um volume na unidade C, digite:

fsutil usn queryjournal c:

Para ler os dados de USN de um arquivo na pasta \Temp na unidade C, digite:

fsutil usn readdata c:\temp\sample.txt

Para ler o diário de USN com um USN inicial específico, digite:


fsutil usn readjournal startusn=0xF00

Links relacionados
Chave da sintaxe de linha de comando

fsutil
fsutil volume
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012,
Windows 8

Desmonta um volume, ou consulta a unidade de disco rígido para determinar quanto


espaço livre está disponível atualmente na unidade de disco rígido ou qual arquivo está
usando um cluster específico.

Sintaxe

fsutil volume [allocationreport] <volumepath>


fsutil volume [diskfree] <volumepath>
fsutil volume [dismount] <volumepath>
fsutil volume [filelayout] <volumepath> <fileID>
fsutil volume [list]
fsutil volume [querycluster] <volumepath> <cluster> [<cluster>] … …

Parâmetros

Parâmetro Descrição

allocationreport Exibe informações sobre como o armazenamento é usado em um determinado


volume.

<volumepath> Especifica a letra da unidade (seguida de dois-pontos).

diskfree Consulta a unidade de disco rígido para determinar a quantidade de espaço


livre nela.

desmontagem Desmonta um volume.

filelayout Exibe metadados de NTFS para o arquivo determinado.

<fileID> Especifica a ID do arquivo.

list Lista todos os volumes no sistema.

querycluster Localiza qual arquivo está usando um cluster especificado. É possível


especificar vários clusters com o parâmetro querycluster.
Parâmetro Descrição

<cluster> Especifica o LCN (número do cluster lógico).

Exemplos
Para exibir um relatório de clusters alocados, digite:

fsutil volume allocationreport C:

Para desmontar um volume na unidade C, digite:

fsutil volume dismount c:

Para consultar a quantidade de espaço livre de um volume na unidade C, digite:

fsutil volume diskfree c:

Para exibir todas as informações sobre os arquivos especificados, digite:

fsutil volume C: *
fsutil volume C:\Windows
fsutil volume C: 0x00040000000001bf

Para listar os volumes no disco, digite:

fsutil volume list

Para localizar os arquivos que estão usando os clusters, especificados pelos números de
cluster lógico 50 e 0x2000, na unidade C, digite:

fsutil volume querycluster C: 50 0x2000


Links relacionados
Chave da sintaxe de linha de comando

fsutil

Como o NTFS funciona


fsutil wim
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016 e
Windows 10

Fornece funções para descobrir e gerenciar arquivos com backup de WIM (Imagem do
Windows).

Sintaxe

fsutil wim [enumfiles] <drive name> <data source>


fsutil wim [enumwims] <drive name>
fsutil wim [queryfile] <filename>
fsutil wim [removewim] <drive name> <data source>

Parâmetros

Parâmetro Descrição

enumfiles Enumera arquivos com backup de WIM.

<drive Especifica a nome da unidade.


name>

<data Especifica a fonte de dados.


source>

enumwims Enumera arquivos da WIM de suporte.

queryfile Consulta se o arquivo é apoiado pela WIM e, em caso afirmativo, exibe detalhes
sobre o arquivo da WIM.

<filename> Especifica o filename.

removewim Remove uma WIM de arquivos de backup.

Exemplos
Para enumerar os arquivos da unidade C: da fonte de dados 0, digite:
fsutil wim enumfiles C: 0

Para enumerar arquivos da WIM de suporte para a unidade C:, digite:

fsutil wim enumwims C:

Para visualizar se um arquivo é apoiado pela WIM, digite:

fsutil wim queryFile C:\Windows\Notepad.exe

Para remover a WIM dos arquivos de backup para o volume C: e a fonte de dados 2,
digite:

fsutil wim removewims C: 2

Links relacionados
Chave da sintaxe de linha de comando

fsutil
FTP
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Transfere arquivos de e para um computador executando um serviço de servidor FTP.


Esse comando pode ser usado interativamente ou no modo de lote processando
arquivos de texto ASCII.

Sintaxe

ftp [-v] [-d] [-i] [-n] [-g] [-s:<filename>] [-a] [-A] [-x:<sendbuffer>] [-
r:<recvbuffer>] [-b:<asyncbuffers>][-w:<windowssize>][<host>] [-?]

Parâmetros

Parâmetro Descrição

-v Suprime a exibição de respostas de servidor remoto.

-d Habilita a depuração, exibindo todos os comandos passados entre o cliente


FTP e o servidor FTP.

-i Desabilita a solicitação interativa durante várias transferências de arquivo.

-n Suprime o logon automático após a conexão inicial.

-g Desabilita o recurso de curinga do nome de arquivo. O glob permite o uso do


asterisco (*) e do ponto de interrogação (?) como caracteres curinga em
nomes de arquivo e caminho locais.

-s: <filename> Especifica um arquivo de texto que contém comandos FTP. Esses comandos
são executados automaticamente após o início do FTP. Esse parâmetro não
permite espaços. Use esse parâmetro em vez de redirecionamento ( < ).
Observação: no Windows 8 e Windows Server 2012 ou sistemas operacionais
posteriores, o arquivo de texto deve ser escrito em UTF-8.

-a Especifica que qualquer interface local pode ser usada ao associar a conexão
de dados FTP.

-A Faz logon no servidor FTP como anônimo.


Parâmetro Descrição

-x: <sendbuffer> Substitui o tamanho de SO_SNDBUF padrão de 8192.

-r: <recvbuffer> Substitui o tamanho de SO_RCVBUF padrão de 8192.

-b: Substitui a contagem de buffers assíncrona padrão de 3.


<asyncbuffers>

-w: <windowssize> Especifica o tamanho do buffer de transferência. O tamanho de janela padrão


é de 4096 bytes.

<host> Especifica o nome do computador, o endereço IP ou o endereço IPv6 do


servidor FTP ao qual se conectar. O nome ou endereço do host, se
especificado, deve ser o último parâmetro na linha.

-? Exibe a ajuda no prompt de comando.

Comentários

Os parâmetros de linha de comando ftp diferenciam maiúsculas de minúsculas.

Esse comando só estará disponível se o protocolo TCP/IP (Protocolo de Internet)


estiver instalado como um componente nas propriedades de um adaptador de
rede em Conexões de Rede.

O comando ftp pode ser usado interativamente. Depois de iniciado, o FTP cria um
sub-ambiente no qual você pode usar comandos ftp. Você pode retornar ao
prompt de comandos digitando o comando quit. Quando o subconjunto ftp está
em execução, ele é indicado pelo prompt de comando ftp > . Para obter mais
informações, consulte os comandos ftp.

O comando ftp dá suporte ao uso de IPv6 quando o protocolo IPv6 é instalado.

Exemplos
Para fazer logon no servidor FTP chamado ftp.example.microsoft.com , digite:

ftp ftp.example.microsoft.com

Para fazer logon no servidor FTP chamado ftp.example.microsoft.com e executar os


comandos ftp contidos em um arquivo chamado resync.txt, digite:
ftp -s:resync.txt ftp.example.microsoft.com

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP

Versão 6 do IP

Aplicativos IPv6
ftp append
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Acrescenta um arquivo local a um arquivo no computador remoto usando a


configuração de tipo de arquivo atual.

Sintaxe

append <localfile> [remotefile]

Parâmetros

Parâmetro Descrição

<localfile> Especifica o arquivo local a ser adicionado.

[remotefile] Especifica o arquivo no computador remoto ao qual <localfile> é adicionado.


Caso não use esse parâmetro, o nome <localfile> será usado no lugar do nome
do arquivo remoto.

Exemplos
Para acrescentar file1.txt a file2.txt no computador remoto, digite:

append file1.txt file2.txt

Para acrescentar o file1.txt local a um arquivo chamado file1.txt no computador remoto.

append file1.txt
Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp ascii
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Define o tipo de transferência de arquivo como ASCII. O comando ftp dá suporte a tipos
de transferência de arquivo de imagem binário e ASCII (padrão), mas é recomendável
usar ASCII ao transferir arquivos de texto. No modo ASCII, as conversões de caracteres
de e para o conjunto de caracteres padrão de rede são executadas. Por exemplo, os
caracteres de fim de linha são convertidos conforme necessário, com base no sistema
operacional de destino.

Sintaxe

ascii

Exemplos
Para definir o tipo de transferência de arquivo como ASCII, digite:

ascii

Links relacionados
Chave da sintaxe de linha de comando

Comando ftp binary

Diretrizes adicionais de FTP


ftp bell
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Alterna a ocorrência de um som audível após a conclusão de cada comando de


transferência de arquivo. Por padrão, esse comando está desativado.

Sintaxe

bell

Exemplos
Para alternar a ocorrência de um som audível após a conclusão de cada comando de
transferência de arquivo, digite:

bell

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais do FTP


ftp binary
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Define o tipo de transferência de arquivo como binário. O comando ftp dá suporte a


tipos de transferência de arquivo ASCII (padrão) e de imagem binária, mas é
recomendável usar o tipo binário ao transferir arquivos executáveis. No modo binário,
os arquivos são transferidos em unidades de um byte.

Sintaxe

binary

Exemplos
Para definir o tipo de transferência de arquivo como binário, digite:

binary

Links relacionados
Chave da sintaxe de linha de comando

Comando ftp ascii

Diretrizes adicionais de FTP


ftp bye
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Encerra a sessão ftp no computador remoto e, em seguida, sai.

7 Observação

Esse comando é igual ao comando ftp quit.

Sintaxe

bye

Exemplos
Para encerrar a sessão ftp com o computador remoto e sair, digite:

bye

Links relacionados
Chave da sintaxe de linha de comando

Comando ftp quit

Diretrizes adicionais de FTP


ftp cd
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o diretório de trabalho no computador remoto.

Sintaxe

cd <remotedirectory>

Parâmetros

Parâmetro Descrição

<remotedirectory> Especifica o diretório no computador remoto para o qual você deseja alterar.

Exemplos
Para alterar o diretório no computador remoto para Docs, digite:

cd Docs

Para alterar o diretório no computador remoto para May Videos, digite:

cd May Videos

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais do FTP


ftp close
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Encerra a sessão ftp com o servidor remoto e permanece no prompt ftp> .

Sintaxe

close

Exemplos
Para encerrar a sessão ftp com o servidor remoto e permanecer no prompt ftp> , digite:

close

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp debug
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Alterna o modo de Depuração. Por padrão, o modo de Depuração está desativado. Se o


modo de Depuração estiver ativado, você verá cada comando enviado para o
computador remoto, precedido pelo caractere > .

Sintaxe

debug

Exemplos
Para ativar e desativar o modo de depuração, digite:

debug

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais do FTP


ftp delete
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exclui arquivos em computadores remotos.

Sintaxe

delete <remotefile>

Parâmetros

Parâmetro Descrição

<remotefile> Especifica o arquivo a ser excluído.

Exemplos
Para excluir o arquivo test.txt no computador remoto, digite:

delete test.txt

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp dir
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe uma lista de arquivos de diretório e subdiretórios em um computador remoto.

Sintaxe

dir [<remotedirectory>] [<localfile>]

Parâmetros

Parâmetro Descrição

[<remotedirectory>] Especifica o diretório para o qual você deseja ver uma listagem. Se
nenhum diretório for especificado, será usado o diretório de trabalho
atual no computador remoto.

[<localfile>] Especifica um arquivo local no qual armazenar a listagem do diretório. Se


um arquivo local não for especificado, os resultados serão exibidos na
tela.

Exemplos
Para exibir uma listagem de diretório para dir1 no computador remoto, digite:

dir dir1

Para salvar uma lista do diretório atual no computador remoto no arquivo local
dirlist.txt, digite:

dir . dirlist.txt
Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp disconnect
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Desconecta-se do computador remoto e permanece no prompt ftp> .

Sintaxe

disconnect

Exemplos
Para desconectar do computador do computador remoto e permanecer no prompt
ftp> , digite:

disconnect

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp get
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Copia um arquivo remoto para o computador local usando o tipo da transferência de


arquivo atual.

7 Observação

Esse comando é igual ao comando ftp recv.

Sintaxe

get <remotefile> [<localfile>]

Parâmetros

Parâmetro Descrição

<remotefile> Especifica o arquivo remoto a ser copiado.

[<localfile>] Especifica o nome do arquivo a ser usado no computador local. Se localfile não
for especificado, o arquivo receberá o nome do arquivo remoto.

Exemplos
Para copiar test.txt para o computador local usando a transferência de arquivo atual,
digite:

get test.txt

Para copiar test.txt para o computador local como test1.txt usando a transferência de
arquivo atual, digite:
get test.txt test1.txt

Links relacionados
Chave da sintaxe de linha de comando

comando ftp recv

comando ftp ascii

comando ftp binary

Diretrizes adicionais do FTP


ftp glob
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Alterna permitindo a expansão curinga para os nomes de arquivos locais. Por padrão,
globbing (expansão curinga) está ativada. Se a globbing estiver ativada, você poderá
usar o asterisco (*) e o ponto de interrogação (?) como caracteres curinga em nomes de
arquivo ou do caminho local.

Sintaxe

glob

Exemplos
Para alternar se deseja permitir a expansão curinga dos nomes de arquivos locais, digite:

glob

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais do FTP


ftp hash
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Alterna a impressão de sinal numérico (#) para cada bloco de dados transferido. Por
padrão, o comando hash está desativado. O tamanho de um bloco de dados é de 2048
bytes.

Sintaxe

hash

Exemplos
Para alternar a impressão de sinal numérico (#) para cada bloco de dados transferido,
digite:

hash

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais do FTP


ftp lcd
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o diretório de trabalho no computador local. Por padrão, o diretório de trabalho é


o diretório no qual o comando ftp foi iniciado.

Sintaxe

lcd [<directory>]

Parâmetros

Parâmetro Descrição

[<directory>] Especifica o diretório no computador local para o qual deve ser alterado. Se o
diretório não for especificado, o diretório de trabalho atual será alterado para o
diretório padrão.

Exemplos
Para alterar o diretório de trabalho no computador local para c:\dir1, digite:

lcd c:\dir1

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais do FTP


ftp literal
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Envia argumentos textuais para o servidor ftp remoto. Um único código de resposta ftp
é retornado.

7 Observação

Esse comando é igual ao comando ftp quote.

Sintaxe

literal <argument> [ ]

Parâmetros

Parâmetro Descrição

<argument> Especifica o argumento a ser enviado para o servidor ftp.

Exemplos
Para enviar um comando quit para o servidor ftp remoto, digite:

literal quit

Links relacionados
Chave da sintaxe de linha de comando

comando ftp quote


Diretrizes adicionais do FTP
ftp ls
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe uma lista abreviada de arquivos e subdiretórios do computador remoto.

Sintaxe

ls [<remotedirectory>] [<localfile>]

Parâmetros

Parâmetro Descrição

[<remotedirectory>] Especifica o diretório para o qual você deseja ver uma listagem. Se
nenhum diretório for especificado, será usado o diretório de trabalho
atual no computador remoto.

[<localfile>] Especifica um arquivo local no qual armazenar a listagem. Se um arquivo


local não for especificado, os resultados serão exibidos na tela.

Exemplos
Para exibir uma lista abreviada de arquivos e subdiretórios do computador remoto,
digite:

ls

Para obter uma listagem de diretórios abreviada de dir1 no computador remoto e salvá-
la em um arquivo local chamado dirlist.txt, digite:

ls dir1 dirlist.txt
Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp mget
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Copia os arquivos remotos para o computador local usando o tipo de transferência do


arquivo atual.

Sintaxe

mget <remotefile>[ ]

Parâmetros

Parâmetro Descrição

<remotefile> Especifica os arquivos remotos a serem copiados para o computador local.

Exemplos
Para copiar os arquivos remotos a.exe e b.exe para o computador local usando o tipo de
transferência do arquivo atual, digite:

mget a.exe b.exe

Links relacionados
Chave da sintaxe de linha de comando

comando ftp ascii

comando ftp binary

Diretrizes adicionais do FTP


ftp mkdir
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria um diretório no computador remoto.

Sintaxe

mkdir <directory>

Parâmetros

Parâmetro Descrição

<directory> Especifica o nome do novo diretório remoto.

Exemplos
Para criar um diretório chamado dir1 no computador remoto, digite:

mkdir dir1

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp mls
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe uma lista resumida de arquivos e subdiretórios em um diretório remoto.

Sintaxe

mls <remotefile>[ ] <localfile>

Parâmetros

Parâmetro Descrição

<remotefile> Especifica o arquivo para o qual você deseja ver uma listagem. Ao especificar
arquivos remotos, use um hífen para representar o diretório de trabalho atual no
computador remoto.

<localfile> Especifica um arquivo local no qual armazenar a listagem. Ao especificar o


localfile, use um hífen para exibir a listagem na tela.

Exemplos
Para exibir uma lista resumida de arquivos e subdiretórios para dir1 e dir2, digite:

mls dir1 dir2 -

Para salvar uma lista resumida de arquivos e subdiretórios para dir1 e dir2 no arquivo
local dirlist.txt, digite:

mls dir1 dir2 dirlist.txt


Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp mput
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Copia os arquivos locais para o computador remoto usando o tipo da transferência de


arquivo atual.

Sintaxe

mput <localfile>[ ]

Parâmetros

Parâmetro Descrição

<localfile> Especifica o arquivo local a ser copiado para o computador remoto.

Exemplos
Para copiar Program1.exe e Program2.exe para o computador remoto usando o tipo da
transferência de arquivo atual, digite:

mput Program1.exe Program2.exe

Links relacionados
Chave da sintaxe de linha de comando

comando ftp ascii

comando ftp binary

Diretrizes adicionais do FTP


ftp open
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Conecta-se ao servidor ftp especificado.

Sintaxe

open <computer> [<port>]

Parâmetros

Parâmetro Descrição

<computer> Especifica o computador remoto ao qual você está tentando se conectar. Você pode
usar um endereço IP ou o nome do computador (nesse caso, um servidor DNS ou
um arquivo Hosts deve estar disponível).

[<port>] Especifica um número de porta TCP a ser usado para se conectar a um servidor ftp.
Por padrão, é usada a porta TCP 21.

Exemplos
Para se conectar ao servidor ftp em ftp.microsoft.com, digite:

open ftp.microsoft.com

Para se conectar ao servidor ftp em ftp.microsoft.com que esteja escutando na porta TCP
755, digite:

open ftp.microsoft.com 755


Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp prompt
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Ativa e desativa o modo prompt. O modo prompt fica ativado por padrão. Se o modo
prompt estiver ativado, o comando ftp fará solicitações durante várias transferências de
arquivo para permitir que você recupere ou armazene arquivos seletivamente.

7 Observação

Você pode usar os comandos ftp mget e ftp mput para transferir todos os arquivos
quando o modo prompt estiver desativado.

Sintaxe

prompt

Exemplos
Para ativar e desativar o modo prompt, digite:

prompt

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp put
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Copia um arquivo local para o computador remoto usando o tipo de transferência de


arquivo atual.

7 Observação

Esse comando é igual ao comando ftp send.

Sintaxe

put <localfile> [<remotefile>]

Parâmetros

Parâmetro Descrição

<localfile> Especifica o arquivo local a ser copiado.

[<remotefile>] Especifica o nome a ser usado no computador remoto. Se você não especificar
um arquivo remoto, o arquivo dará o nome localfile.

Exemplos
Para copiar o arquivo local test.txt e nomeá-lo test1.txt no computador remoto, digite:

put test.txt test1.txt

Para copiar o arquivo local program.exe no computador remoto, digite:


put program.exe

Links relacionados
Chave da sintaxe de linha de comando

Comando ftp ascii

Comando ftp binary

Diretrizes adicionais de FTP


ftp pwd
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe o diretório do computador remoto atual.

Sintaxe

pwd

Exemplos
Para exibir o diretório do computador remoto atual, digite:

pwd

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais do FTP


ftp quit
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Encerra a sessão ftp com o computador remoto e, em seguida, sai.

7 Observação

Esse comando é igual ao comando ftp bye.

Sintaxe

quit

Exemplos
Para encerrar a sessão ftp com o computador remoto e retornar ao prompt de comando
do sistema operacional, digite:

quit

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp quote
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Envia argumentos textuais para o servidor ftp remoto. Um único código de resposta ftp
é retornado.

7 Observação

Esse comando é igual ao comando ftp literal.

Sintaxe

quote <argument>[ ]

Parâmetros

Parâmetro Descrição

<argument> Especifica o argumento a ser enviado para o servidor ftp.

Exemplos
Para enviar um comando quit para o servidor ftp remoto, digite:

quote quit

Links relacionados
Chave da sintaxe de linha de comando

Comando ftp literal


Diretrizes adicionais de FTP
ftp recv
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Copia um arquivo remoto para o computador local usando o tipo da transferência de


arquivo atual.

7 Observação

Esse comando é igual ao comando ftp get.

Sintaxe

recv <remotefile> [<localfile>]

Parâmetros

Parâmetro Descrição

<remotefile> Especifica o arquivo remoto a ser copiado.

[<localfile>] Especifica o nome do arquivo a ser usado no computador local. Se localfile não
for especificado, o arquivo receberá o nome do arquivo remoto.

Exemplos
Para copiar test.txt para o computador local usando a transferência de arquivo atual,
digite:

recv test.txt

Para copiar test.txt para o computador local como test1.txt usando a transferência de
arquivo atual, digite:
recv test.txt test1.txt

Links relacionados
Chave da sintaxe de linha de comando

comando ftp get

comando ftp ascii

comando ftp binary

Diretrizes adicionais do FTP


ftp remotehelp
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe a ajuda para os comandos remotos.

Sintaxe

remotehelp [<command>]

Parâmetros

Parâmetro Descrição

[<command>] Especifica o nome do comando sobre o qual você deseja ajuda. Se <command> não
for especificado, esse comando exibirá uma lista de todos os comandos remotos.
Você também pode executar os comandos remotos usando ftp quote ou ftp literal.

Exemplos
Para exibir uma lista de comandos remotos, digite:

remotehelp

Para exibir a sintaxe do comando remoto feat, digite:

remotehelp feat

Links relacionados
Chave da sintaxe de linha de comando
ftp quote

ftp literal

Diretrizes adicionais do FTP


ftp rename
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Renomeia os arquivos remotos.

Sintaxe

rename <filename> <newfilename>

Parâmetros

Parâmetro Descrição

<filename> Especifica o arquivo que você deseja renomear.

<newfilename> Especifica o novo nome de arquivo.

Exemplos
Para renomear o arquivo remoto example.txt como example1.txt, digite:

rename example.txt example1.txt

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais do FTP


ftp rmdir
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exclui um diretório remoto.

Sintaxe

rmdir <directory>

Parâmetros

Parâmetro Descrição

<directory> Especifica o nome do diretório remoto a ser excluído.

Exemplos
Para excluir o diretório remoto pictures, digite:

rmdir pictures

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais do FTP


ftp send
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Copia um arquivo local para o computador remoto usando o tipo de transferência de


arquivo atual.

7 Observação

Esse comando é igual ao comando ftp bye.

Sintaxe

send <localfile> [<remotefile>]

Parâmetros

Parâmetro Descrição

<localfile> Especifica o arquivo local a ser copiado.

<remotefile> Especifica o nome a ser usado no computador remoto. Se você não especificar
um remotefile, o arquivo obterá o nome localfile.

Exemplos
Para copiar o arquivo local test.txt e nomeá-lo como test1.txt no computador remoto,
digite:

send test.txt test1.txt

Para copiar o arquivo local program.exe no computador remoto, digite:


send program.exe

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp status
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe o status atual das conexões ftp.

Sintaxe

status

Exemplos
Para exibir o status atual das conexões ftp, digite:

status

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais do FTP


ftp trace
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Alterna o rastreamento de pacotes. Esse comando também exibe a série de chamadas


de função FTP internas ao executar um comando ftp.

Sintaxe

trace

Exemplos
Ative e desative o rastreamento digitando:

trace

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais do FTP


ftp type
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Define ou exibe o tipo de transferência de arquivo. O comando ftp dá suporte aos tipos
de transferência de arquivo de imagem ASCII (padrão) e binário:

É recomendável usar o ASCII ao transferir arquivos de texto. No modo ASCII, são


executadas as conversões de caracteres de e para o conjunto de caracteres padrão
de rede. Por exemplo, os caracteres de fim de linha são convertidos conforme
necessário, com base no sistema operacional de destino.

É recomendável usar o modo binário ao transferir arquivos executáveis. No modo


binário, os arquivos são transferidos em unidades de um byte.

Sintaxe

type [<typename>]

Parâmetros

Parâmetro Descrição

[<typename>] Especifica o tipo de transferência de arquivo. Se esse parâmetro não estiver


especificado, será exibido o tipo atual.

Exemplos
Para definir o tipo de transferência de arquivo como ASCII, digite:

type ascii

Para definir o tipo de transferência de arquivo como binário, digite:


type binary

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp user
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Especifica um usuário para o computador remoto.

Sintaxe

user <username> [<password>] [<account>]

Parâmetros

Parâmetro Descrição

<username> Especifica um nome de usuário com o qual fazer logon no computador remoto.

[<password>] Especifica a senha do nome de usuário. Se uma senha não for especificada, mas
for necessária, o comando ftp a solicitará.

[<account>] Especifica uma conta com a qual fazer logon no computador remoto. Se uma
conta não for especificada, mas for necessária, o comando ftp a solicitará.

Exemplos
Para especificar o User1 com a senha Password1, digite:

user User1 Password1

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp verbose
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Alterna o modo detalhado. O modo detalhado está ativado por padrão. Quando o
modo detalhado está ativado, todas as respostas do comando ftp são exibidas. Quando
uma transferência de arquivo é concluída, estatísticas sobre a eficiência da transferência
também são exibidas.

Sintaxe

verbose

Exemplos
Para ativar e desativar o modo detalhado, digite:

verbose

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp mdelete
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exclui arquivos no computador remoto.

Sintaxe

mdelete <remotefile>[...]

Parâmetros

Parâmetro Descrição

<remotefile> Especifica o arquivo remoto a ser excluído.

Exemplos
Para excluir os arquivos remotos a.exe e b.exe, digite:

mdelete a.exe b.exe

Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftp mdir
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe uma lista de diretórios de arquivos e subdiretórios em um diretório remoto.

Sintaxe

mdir <remotefile>[...] <localfile>

Parâmetros

Parâmetro Descrição

<remotefile> Especifica o diretório ou arquivo do qual você deseja ver uma listagem. Você
pode especificar vários remotefiles. Digite um hífen (-) para usar o diretório de
trabalho atual no computador remoto.

<localfile> Especifica um arquivo local para armazenar a listagem. Este parâmetro é


necessário. Digite um hífen (-) para exibir a listagem na tela.

Exemplos
Para exibir uma listagem de diretórios de dir1 e dir2 na tela, digite:

mdir dir1 dir2 -

Para salvar a listagem de diretório combinada de dir1 e dir2 em um arquivo local


chamado dirlist.txt, digite:

mdir dir1 dir2 dirlist.txt


Links relacionados
Chave da sintaxe de linha de comando

Diretrizes adicionais de FTP


ftype
Artigo • 06/04/2023

Exibe ou modifica tipos de arquivo usados em associações de extensão de nome de


arquivo. Se usado sem um operador de atribuição (=), esse comando exibirá a cadeia de
caracteres de comando aberta atual para o tipo de arquivo especificado. Se usado sem
parâmetros, esse comando exibirá os tipos de arquivo que têm cadeias de caracteres de
comando abertas definidas.

7 Observação

Há suporte para esse comando somente no cmd.exe e ele não está disponível no
PowerShell. Ainda assim, você possa usar cmd /c ftype como uma solução
alternativa.

Sintaxe

ftype [<filetype>[=[<opencommandstring>]]]

Parâmetros

Parâmetro Descrição

<filetype> Especifica o tipo de arquivo a ser exibido ou alterado.

<opencommandstring> Especifica a cadeia de caracteres de comando aberta a ser usada ao abrir


arquivos do tipo de arquivo especificado.

/? Exibe a ajuda no prompt de comando.

Comentários

A tabela a seguir descreve como ftype substitui variáveis dentro de uma cadeia de
caracteres de comando aberta:

Variável Valor de substituição


Variável Valor de substituição

%0 ou É substituído pelo nome do arquivo que está sendo iniciado por meio da associação.
%1

%* Obtém todos os parâmetros.

%2 , %3 , Obtém o primeiro parâmetro ( %2 ), o segundo parâmetro ( %3 ) e assim por diante.


...

%~<n> Obtém todos os parâmetros restantes começando com o parâmetro nth, em que n
pode ser qualquer número de 2 a 9.

Exemplos
Para exibir os tipos de arquivo atuais que têm cadeias de caracteres de comando
abertas definidas, digite:

ftype

Para exibir a cadeia de caracteres de comando aberta no momento para o tipo de


arquivo txtfile, digite:

ftype txtfile

Esse comando gera uma saída semelhante à seguinte:

txtfile=%SystemRoot%\system32\NOTEPAD.EXE %1

Para excluir a cadeia de caracteres de comando aberta de um tipo de arquivo chamado


exemplo, digite:

ftype example=

Para associar a extensão de nome de arquivo .pl ao tipo de arquivo PerlScript e habilitar
o tipo de arquivo PerlScript para executar PERL.EXE, digite os seguintes comandos:
assoc .pl=PerlScript
ftype PerlScript=perl.exe %1 %*

Para eliminar a necessidade de digitar a extensão de nome de arquivo .pl ao invocar um


script Perl, digite:

set PATHEXT=.pl;%PATHEXT%

Links relacionados
Chave da sintaxe de linha de comando
fveupdate
Artigo • 11/04/2023

FveUpdate é uma ferramenta interna, usada pelo programa de instalação quando um


computador é atualizado. Ele atualiza os metadados associados ao BitLocker com a
versão mais recente. Essa ferramenta não pode ser executada de forma independente.

Links relacionados
Chave da sintaxe de linha de comando
getmac
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Retorna o endereço MAC (controle de acesso à mídia) e a lista de protocolos de rede


associados a cada endereço para todos os cartões de rede em cada computador, seja
localmente, seja em uma rede. Esse comando é bastante útil quando você desejar inserir
o endereço MAC em um analisador de rede ou quando precisa saber quais protocolos
estão sendo usados atualmente em cada adaptador de rede em um computador.

Sintaxe

getmac[.exe][/s <computer> [/u <domain\<user> [/p <password>]]][/fo {table |


list | csv}][/nh][/v]

Parâmetros

Parâmetro Descrição

/s Especifica o nome ou o endereço IP de um computador remoto (não use barras


<computer> invertidas). O padrão é o computador local.

/u Executa o comando com as permissões de conta do usuário especificado por user


<domain>\ ou domain\user. O padrão são as permissões do usuário conectado atualmente no
<user> computador que emite o comando.

/p Especifica a senha da conta de usuário especificada no parâmetro /u.


<password>

/fo {table | Especifica o formato a ser usado para a saída da consulta. Os valores válidos são
list | csv} table, list e csv. O formato padrão para saída é table.

/nh Suprime o cabeçalho da coluna na saída. Válido quando o parâmetro /fo é definido
como table ou csv.

/v Especifica que a saída exibe informações detalhadas.

/? Exibe a ajuda no prompt de comando.


Exemplos
Os exemplos a seguir mostram como você pode usar o comando getmac:

getmac /fo table /nh /v

getmac /s srvmain

getmac /s srvmain /u maindom\hiropln

getmac /s srvmain /u maindom\hiropln /p p@ssW23

getmac /s srvmain /u maindom\hiropln /p p@ssW23 /fo list /v

getmac /s srvmain /u maindom\hiropln /p p@ssW23 /fo table /nh

Links relacionados
Chave da sintaxe de linha de comando
gettype
Artigo • 06/04/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O comando gettype foi preterido e não haverá suporte para ele nas versões futuras do
Windows.

gettype está incluído no Windows Server 2003. Para obter mais informações, consulte

gettype.

Links relacionados
Chave da sintaxe de linha de comando
goto
Artigo • 06/04/2023

Direciona cmd.exe para uma linha rotulada em um programa em lote. Em um programa


em lotes, esse comando direciona o processamento de comando para uma linha
identificada por um rótulo. Quando o rótulo é encontrado, o processamento continua
começando com os comandos que começam na próxima linha.

Sintaxe

goto <label>

Parâmetros

Parâmetro Descrição

<label> Especifica uma cadeia de caracteres de texto que é usada como um rótulo no
programa em lote.

/? Exibe a ajuda no prompt de comando.

Comentários

Se as extensões de comando estiverem habilitadas (o padrão) e você usar o


comando goto com um rótulo de destino de :EOF, você transferirá o controle para
o final do arquivo de script em lote atual e sairá do arquivo de script em lote sem
definir um rótulo. Ao usar esse comando com o rótulo :EOF, você deve inserir dois-
pontos antes do rótulo. Por exemplo: goto:EOF .

Você pode usar espaços no parâmetro label, mas não pode incluir outros
separadores (por exemplo, sinais de ponto e vírgula (;) ou de igual (=)).

O valor do rótulo que você especificar deve corresponder a um rótulo no


programa em lote. O rótulo dentro do programa em lotes deve começar com dois-
pontos (:). Se uma linha começar com dois-pontos, ela será tratada como um
rótulo e todos os comandos nessa linha serão ignorados. Se o programa em lotes
não tiver o rótulo especificado no parâmetro label, o programa em lote será
interrompido e exibirá a seguinte mensagem: Label not found .
Você pode usar goto com outros comandos para executar operações condicionais.
Para obter mais informações sobre como usar goto em operações condicionais,
consulte o comando if.

Exemplos
O programa em lote a seguir formata um disco na unidade A como um disco do
sistema. Se a operação for bem-sucedida, o comando goto direcionará o
processamento para o rótulo :end:

echo off
format a: /s
if not errorlevel 1 goto end
echo An error occurred during formatting.
:end
echo End of batch program.

Links relacionados
Chave da sintaxe de linha de comando

Comando cmd

Comando if
gpfixup
Artigo • 17/04/2023

Corrige dependências de nome de domínio em objetos de Política de Grupo e links de


Política de Grupo após uma operação de renomeação de domínio. Para usar esse
comando, instale o Gerenciamento de Política de Grupo como um recurso por meio do
Gerenciador de Servidor.

Sintaxe

gpfixup [/v]
[/olddns:<olddnsname> /newdns:<newdnsname>]
[/oldnb:<oldflatname> /newnb:<newflatname>]
[/dc:<dcname>] [/sionly]
[/user:<username> [/pwd:{<password>|*}]] [/?]

Parâmetros

Parâmetro Descrição

/v Exibe mensagens de status detalhadas. Se esse parâmetro não for usado,


somente mensagens de erro ou uma mensagem de status de resumo
informando SUCCESS ou FAILURE será exibida.

/olddns: <olddnsname> Especifica o nome DNS antigo do domínio renomeado como


<olddnsname> quando a operação de renomeação de domínio alterar o
nome DNS de um domínio. Você só poderá usar esse parâmetro se
também usar o parâmetro /newdns para especificar um novo nome DNS
de domínio.

/newdns: <newdnsname> Especifica o novo nome DNS do domínio renomeado como


<newdnsname> quando a operação de renomeação de domínio alterar o
nome DNS de um domínio. Você só poderá usar esse parâmetro se
também usar o parâmetro /olddns para especificar o nome DNS do
domínio antigo.

/oldnb: <oldflatname> Especifica o nome NetBIOS antigo do domínio renomeado como


<oldflatname> quando a operação de renomeação de domínio alterar o
nome NetBIOS de um domínio. Você só poderá usar esse parâmetro se
também usar o parâmetro /newnb para especificar um novo nome
NetBIOS de domínio.
Parâmetro Descrição

/newnb: <newflatname> Especifica o novo nome NetBIOS do domínio renomeado como


<newflatname> quando a operação de renomeação de domínio alterar o
nome NetBIOS de um domínio. Você só poderá usar esse parâmetro se
também usar o parâmetro /oldnb para especificar o nome NetBIOS do
domínio antigo.

/dc: <dcname> Conecte-se ao controlador de domínio chamado <dcname> (um nome


DNS ou um nome NetBIOS). <dcname> deve hospedar uma réplica
gravável da partição de diretório de domínio, conforme indicado por um
dos seguintes:

O nome DNS <newdnsname> usando /newdns


O nome NetBIOS <newflatname> usando /newnb
Se esse parâmetro não for usado, você poderá se conectar a
qualquer controlador de domínio no domínio renomeado
indicado por <newdnsname> ou <newflatname> .

/sionly Executa apenas a correção da Política de Grupo relacionada à instalação


de software gerenciado (a extensão de Instalação de Software para
Política de Grupo). Ignore as ações que corrigem os links da Política de
Grupo e os caminhos SYSVOL em GPOs.

/user: <username> Executa esse comando no contexto de segurança do usuário


<username> , em que <username> está no formato domínio\usuário. Se
esse parâmetro não for usado, esse comando será executado como o
usuário conectado.

/pwd: {<password> | Especifica a senha do usuário.


*}

/? Exibe a ajuda no prompt de comando.

Exemplos
Este exemplo pressupõe que você já executou uma operação de renomeação de
domínio na qual alterou o nome DNS de MyOldDnsName para MyNewDnsName, e o
nome NetBIOS de MyOldNetBIOSName para MyNewNetBIOSName.

Neste exemplo, você usa o comando gpfixup para se conectar ao controlador de


domínio chamado MyDcDnsName e reparar GPOs e links de Política de Grupo
atualizando o nome de domínio antigo inserido nos GPOs e links. O status e a saída de
erro são salvos em um arquivo chamado gpfixup.log.
gpfixup /olddns: MyOldDnsName /newdns:MyNewDnsName /oldnb:MyOldNetBIOSName
/newnb:MyNewNetBIOSName /dc:MyDcDnsName 2>&1 >gpfixup.log

Este exemplo é o mesmo que o anterior, exceto pelo fato de que pressupõe que o nome
NetBIOS do domínio não foi alterado durante a operação de renomeação de domínio.

gpfixup /olddns: MyOldDnsName /newdns:MyNewDnsName /dc:MyDcDnsName 2>&1


>gpfixup.log

Links relacionados
Chave da sintaxe de linha de comando

Administração de renomeação do Domínio do Active Directory


gpresult
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe informações do RSoP (Conjunto de políticas resultante) para um usuário e


computador remotos. Para usar relatórios do RSoP em computadores direcionados
remotamente por meio do firewall, você deve ter regras de firewall que permitam o
tráfego de rede de entrada nas portas.

Syntax

gpresult [/s <system> [/u <username> [/p [<password>]]]] [/user


[<targetdomain>\]<targetuser>] [/scope {user | computer}] {/r | /v | /z |
[/x | /h] <filename> [/f] | /?}

7 Observação

Exceto ao usar /?, você deve incluir uma opção de saída /r, /v, /z, /x ou /h.

Parâmetros

Parâmetro Descrição

/s <system> Especifica o nome ou endereço IP de um computador remoto. Não use


barras invertidas. O padrão é o computador local.

/u <username> Usa as credenciais do usuário especificado para executar o comando. O


usuário padrão é aquele que está conectado ao computador que emite o
comando.

/p [<password>] Especifica a senha da conta de usuário fornecida no parâmetro /u. Se /p for


omitido, gpresult solicitará a senha. O parâmetro /p não pode ser usado
com /x ou /h.

/user Especifica o usuário remoto de quem os dados do RSoP devem ser exibidos.
[<targetdomain>\]
<targetuser>]
Parâmetro Descrição

/scope {user | Exibe dados do RSoP para o usuário ou para o computador. Se /scope for
computer} omitido, gpresult exibirá dados do RSoP para o usuário e o computador.

[/x | /h] Salva o relatório em formato XML (/x) ou HTML (/h) no local e com o nome
<filename> do arquivo especificado pelo parâmetro filename. Não pode ser usado com
/u, /p, /r, /v ou /z.

/f Força o gpresult a substituir o nome do arquivo especificado na opção /x ou


/h.

/r Exibe dados de resumo do RSoP.

/v Exibe informações detalhadas da política. Isso inclui configurações


detalhadas que foram aplicadas com uma precedência de 1.

/z Exibe todas as informações disponíveis sobre a Política de Grupo. Isso inclui


configurações detalhadas que foram aplicadas com uma precedência de 1 e
superior.

/? Exibe a ajuda no prompt de comando.

Comentários
A Política de Grupo é a principal ferramenta administrativa para definir e controlar
a forma de operação de programas, recursos de rede e sistema operacional para
usuários e computadores em uma organização. Em um ambiente de diretório
ativo, a Política de Grupo é aplicada a usuários ou computadores com base em sua
associação em sites, domínios ou unidades organizacionais.

Como é possível aplicar configurações de política sobrepostas a qualquer


computador ou usuário, o recurso Política de Grupo gera um conjunto resultante
de configurações de política quando o usuário faz logon. O comando gpresult
exibe o conjunto resultante de configurações de política que foram impostas no
computador para o usuário especificado ao fazer logon.

Como /v e /z produzem muitas informações, é útil redirecionar a saída para um


arquivo de texto (por exemplo, gpresult/z >policy.txt ).

Nas versões ARM64 do Windows, somente o gpresult no SysWow64 funciona


com o parâmetro /h .

Exemplos
Para recuperar dados do RSoP apenas para o usuário remoto, maindom\hiropln com a
senha p@ssW23, que está no computador srvmain, digite:

gpresult /s srvmain /u maindom\hiropln /p p@ssW23 /user targetusername


/scope user /r

Para salvar todas as informações disponíveis sobre a Política de Grupo em um arquivo


chamado policy.txt apenas para o usuário remoto maindom\hiropln com a senha
p@ssW23, no computador srvmain, digite:

gpresult /s srvmain /u maindom\hiropln /p p@ssW23 /user targetusername /z >


policy.txt

Para exibir dados do RSoP para o usuário conectado, maindom\hiropln com a senha
p@ssW23, para o computador srvmain, digite:

gpresult /s srvmain /u maindom\hiropln /p p@ssW23 /r

Links relacionados
Chave da sintaxe de linha de comando
gpt
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Em discos gpt (tabela de partição de GUID) básicos, esse comando atribui os atributos
gpt à partição com foco. Os atributos de partição gpt fornecem informações adicionais
sobre o uso da partição. Alguns atributos são específicos ao GUID do tipo de partição.

Você deve escolher uma partição gpt básica para que essa operação seja bem-sucedida.
Use o comando select partition para selecionar uma partição gpt básica e deslocar o
foco para ela.

U Cuidado

A alteração dos atributos gpt pode fazer com que os volumes de dados básicos
não sejam atribuídos a letras de unidade ou pode impedir que o sistema de
arquivos seja montado. Recomendamos que você não altere os atributos gpt, a
menos que seja um OEM (fabricante de equipamento original) ou um profissional
de TI que tenha experiência com discos gpt.

Sintaxe

gpt attributes=<n>

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

attributes= <n> Especifica o valor do atributo que você deseja aplicar à partição com foco. O
campo de atributo gpt é um campo de 64 bits que contém dois subcampos. O
campo superior é interpretado apenas no contexto da ID da partição, enquanto
o campo inferior é comum a todas as IDs de partição. Os valores aceitos
incluem:
0x0000000000000001 – especifica que a partição é exigida pelo
computador para funcionar corretamente.
0x8000000000000000 - especifica que a partição não receberá uma letra
da unidade por padrão quando o disco for movido para outro
computador ou quando o disco for visto pela primeira vez por um
computador.
0x4000000000000000 - oculta o volume de uma partição para que ele
não seja detectado pelo gerenciador de montagem.
0x2000000000000000 - especifica que a partição é uma cópia de sombra
de outra partição.
0x1000000000000000 – especifica que a partição é somente leitura. Esse
atributo impede que gravem no volume.

Para saber mais sobre esses atributos, confira a seção atributos em Estrutura
create_PARTITION_PARAMETERS.

Comentários
A partição do Sistema EFI contém apenas os binários necessários para iniciar o
sistema operacional. Isso facilita que binários OEM ou binários específicos a um
sistema operacional sejam colocados em outras partições.

Exemplos
Para impedir que o computador atribua automaticamente uma letra da unidade à
partição com foco, ao mover um disco gpt, digite:

gpt attributes=0x8000000000000000

Links relacionados
Chave da sintaxe de linha de comando

comando select partition


Estrutura create_PARTITION_PARAMETERS
gpupdate
Artigo • 17/04/2023

Atualiza as configurações da Política de Grupo.

Sintaxe

gpupdate [/target:{computer | user}] [/force] [/wait:<VALUE>] [/logoff]


[/boot] [/sync] [/?]

Parâmetros

Parâmetro Descrição

/target: {computer|user} Especifica que somente as configurações de política de Usuário ou de


Computador são atualizadas. Por padrão, as configurações de política
do Usuário e do Computador são atualizadas.

/force Reaplica todas as configurações de política. Por padrão, somente as


configurações de política que foram alteradas são aplicadas.

/wait: <VALUE> Define a quantidade de segundos a aguardar a conclusão do


processamento de política antes de retornar a solicitação de comando.
Quando o limite de tempo é excedido, a solicitação de comando é
exibida, mas o processamento de política continua. O valor padrão é
de 600 segundos. O valor 0 significa que não é necessário esperar. O
valor -1 significa esperar indefinidamente.

Em um script, ao usar esse comando com um limite de tempo


especificado, você pode executar gpupdate e continuar com
comandos que não dependem da conclusão de gpupdate. Como
alternativa, você pode usar esse comando sem nenhum limite de
tempo especificado para permitir que gpupdate termine a execução
antes que outros comandos que dependem dele sejam executados.

/logoff Faz logoff após a atualização das configurações de Política de Grupo.


Isso é necessário para as extensões do lado do cliente da Política de
Grupo que não processam a política em um ciclo de atualização em
segundo plano, mas processam a política quando um usuário faz
logon. Os exemplos incluem a Instalação de Software direcionada ao
usuário e o Redirecionamento de Pastas. Essa opção não terá efeito se
não houver extensões chamadas que exijam um logoff.
Parâmetro Descrição

/boot Causa uma reinicialização do computador após a aplicação das


configurações da Política de Grupo. Isso é necessário para as extensões
do lado do cliente da Política de Grupo que não processam a política
em um ciclo de atualização em segundo plano, mas processam a
política na inicialização do computador. Os exemplos incluem a
Instalação de Software direcionada ao computador. Essa opção não
terá efeito se não houver extensões chamadas que exijam uma
reinicialização.

/sync Faz com que o próximo aplicativo de política em primeiro plano seja
feito de forma síncrona. A política de primeiro plano é aplicada na
inicialização do computador e no logon do usuário. Você pode
especificar isso para o usuário, computador ou ambos, usando o
parâmetro /target. Os parâmetros /force e /wait serão ignorados se
você especificá-los.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para forçar uma atualização em segundo plano de todas as configurações de Política de
Grupo, independentemente de terem sido alteradas, digite:

gpupdate /force

Links relacionados
Chave da sintaxe de linha de comando
graftabl
Artigo • 06/04/2023

Permite aos sistemas operacionais do Windows exibir um conjunto de caracteres


estendido no modo gráfico. Se usado sem parâmetros, o graftabl exibe a página de
código anterior e a atual.

) Importante

O comando graftabl é um comando herdado e, portanto, está desatualizado.


Normalmente, ele não está instalado nas versões modernas do Windows. Consulte
a página chcp para tratamento da página de códigos.

Sintaxe

graftabl <codepage>
graftabl /status

Parâmetros

Parâmetro Descrição

<codepage> Especifica uma página de códigos para definir a aparência de caracteres estendidos
no modo gráfico. Os números de identificação da página de códigos válidos são:
437 – Estados Unidos
850 – Multilíngue (Latino I)
852 – Eslavo (Latino II)
855 – Cirílico (russo)
857 – Turco
860 – Português
861 – Islandês
863 – Francês canadense
865 – Nórdico
866 - Russo
869 - Grego Moderno

/status Exibe a página de códigos atual que está sendo usada por este comando.

/? Exibe a ajuda no prompt de comando.


Comentários
O comando graftabl afeta apenas a exibição do monitor de caracteres estendidos
da página de códigos que você especificar. Ele não altera a página de códigos de
entrada do console atual. Para alterar a página de códigos de entrada do console,
use o comando mode ou chcp.

Cada código de saída e uma breve descrição sobre ele:

Código de Descrição
saída

0 O conjunto de caracteres foi carregado com êxito. Nenhuma página de


códigos anterior foi carregada.

1 Um parâmetro incorreto foi especificado. Nenhuma ação executada.

2 Ocorreu um erro de arquivo.

Você pode usar a variável de ambiente ERRORLEVEL em um programa em lotes


para processar códigos de saída retornados pelo graftabl.

Exemplos
Para exibir a página de códigos atual usada pelo graftabl, digite:

graftabl /status

Para carregar o conjunto de caracteres gráficos para a página de códigos 437 (Estados
Unidos) na memória, digite:

graftabl 437

Para carregar o conjunto de caracteres gráficos para a página de códigos 850


(Multilíngue) na memória, digite:

graftabl 850
Links relacionados
Chave da sintaxe de linha de comando

Comando freedisk

Comando mode

Comando chcp
ajuda
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe uma lista dos comandos disponíveis ou informações detalhadas de ajuda em um


comando especificado. Se usado sem parâmetros, help lista e descreve brevemente
todos os comandos do sistema.

Sintaxe

help [<command>]

Parâmetros

Parâmetro Descrição

<command> Especifica o comando para o qual exibir informações detalhadas de ajuda.

Exemplos
Para exibir informações sobre o comando robocopy, digite:

help robocopy

Para exibir uma lista de todos os comandos disponíveis no DiskPart, digite:

help

Para exibir informações detalhadas de ajuda sobre como usar o comando create
partition primary em DiskPart, digite:
help create partition primary

Links relacionados
Chave da sintaxe de linha de comando
helpctr
Artigo • 12/04/2023

O comando helpctr foi preterido e não há garantia de que tenha suporte no Windows.

Essa ferramenta está incluída no Windows Server 2003. Para obter mais informações,
confira Helpctr.
hostname
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe a parte do nome do host do nome completo do computador.

) Importante

Esse comando estará disponível somente se o Protocolo de Internet (TCP/IP) estiver


instalado como um componente nas propriedades de um adaptador de rede na
Rede.

Sintaxe

hostname

Parâmetros

Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Todo parâmetro diferente de /? produz uma mensagem de erro e define o nível de erro
como 1.

Observações
A variável de ambiente %COMPUTERNAME% geralmente imprimirá a mesma cadeia de
caracteres que hostname , mas em letras maiúsculas.
Se a variável de ambiente _CLUSTER_NETWORK_NAME_ for definida, hostname imprimirá
o valor dele.

Exemplos
Para exibir o nome do computador, digite:

shell

hostname

Para exibir o nome do computador em letras maiúsculas:

shell

echo %COMPUTERNAME%

Para alterar a saída do nome do host:

shell

set "_CLUSTER_NETWORK_NAME_=Altered Computer Name"


hostname

Links relacionados
Chave da sintaxe de linha de comando
icacls
Artigo • 17/04/2023

Exibe ou modifica DACLs (listas de controle de acesso condicional) em arquivos


especificados e aplica a DACLs armazenadas a arquivos nos diretórios especificados.

7 Observação

Esse comando substitui o comando cacls preterido.

Sintaxe

icacls <filename> [/grant[:r] <sid>:<perm>[...]] [/deny <sid>:<perm>[...]]


[/remove[:g|:d]] <sid>[...]] [/t] [/c] [/l] [/q] [/setintegritylevel
<Level>:<policy>[...]]
icacls <directory> [/substitute <sidold> <sidnew> [...]] [/restore <aclfile>
[/c] [/l] [/q]]

Parâmetros

Parâmetro Descrição

<filename> Especifica o arquivo do qual exibir ou modificar DACLs.

<diretório> Especifica o diretório do qual exibir ou modificar DACLs.

/t Executa a operação em todos os arquivos especificados no diretório atual e


em seus subdiretórios.

/c Continua a operação, apesar de quaisquer erros de arquivo. As mensagens de


erro ainda serão exibidas.

/l Executa a operação em um link simbólico em vez de seu destino.

/q Suprime as mensagens de sucesso.

[/save <ACLfile> Armazena DACLs para todos os arquivos correspondentes em um arquivo de


[/t] [/c] [/l] [/q]] ACL (lista de controle de acesso) para uso posterior com /restore.

[/setowner Altera o proprietário de todos os arquivos correspondentes para o usuário


<username> [/t] especificado.
[/c] [/l] [/q]]
Parâmetro Descrição

[/findsid <sid> Localiza todos os arquivos correspondentes que contêm uma DACL
[/t] [/c] [/l] [/q]] mencionando explicitamente o SID (identificador de segurança) especificado.

[/verify [/t] [/c] Localiza todos os arquivos com ACLs que não são canônicas ou têm
[/l] [/q]] comprimentos inconsistentes com contagens de ACE (entrada de controle de
acesso).

[/reset [/t] [/c] [/l] Substitui ACLs por ACLs herdadas padrão para todos os arquivos
[/q]] correspondentes.

[/grant[:r] <sid>: Concede direitos de acesso de usuário especificados. As permissões


<perm>[...]] substituem as permissões explícitas concedidas anteriormente.
Não adicionar o :r significa que as permissões são adicionadas a quaisquer
permissões explícitas concedidas anteriormente.

[/deny <sid>: Nega explicitamente os direitos de acesso do usuário especificado. Uma ACE
<perm>[...]] de negação explícita é adicionada para as permissões declaradas e as mesmas
permissões em qualquer concessão explícita são removidas.

[/remove[:g | :d]] Remove todas as ocorrências das SID especificada da DACL. Esse comando
<sid>[...] [/t] [/c] também pode usar:
[/l] [/q] :g - remove todas as ocorrências de direitos concedidos à SID
especificada.
:d - remove todas as ocorrências de direitos negados à SID
especificada.

[/setintegritylevel Adiciona explicitamente uma ACE de integridade a todos os arquivos


[(CI)(OI)] correspondentes. O nível pode ser especificado como:
<Level>: l - Baixo
<Policy>[...]] m- Médio
h - Alto

As opções de herança para a ACE de integridade podem preceder o nível e


são aplicadas somente a diretórios.

[/substitute Substitui uma SID existente (sidold) por uma nova SID (sidnew). Requer o uso
<sidold> com o parâmetro <directory> .
<sidnew> [...]]

/restore Aplica DACLs armazenadas de <ACLfile> a arquivos no diretório especificado.


<ACLfile> [/c] [/l] Requer o uso com o parâmetro <directory> .
[/q]

/inheritancelevel: Define o nível de herança, que pode ser:


[e | d | r] e - habilita a herança
d - desabilita a herança e copia os ACEs
r - desabilita a herança e remove somente ACEs herdadas
Comentários
As SIDs podem estar no formato numérico ou de nome amigável. Se você usar um
formato numérico, afixe o caractere curinga * no início da SID.

Esse comando preserva a ordem canônica das entradas de ACE como:

Negações explícitas

Concessões explícitas

Negações herdadas

Concessões herdadas

A opção <perm> é uma máscara de permissão que pode ser especificada em uma
das seguintes formas:

Uma sequência de direitos simples (permissões básicas):

F - acesso completo

M - modificar o acesso

RX - acesso de leitura e execução

R - acesso somente leitura

W - acesso somente gravação

Uma lista separada por vírgulas entre parênteses de direitos específicos


(permissões avançadas):

D - exclusão

RC - controle de leitura (permissões de leitura)

WDAC - gravar DAC (permissões de alteração)

WO - proprietário da gravação (assumir a propriedade)

S - sincronizar

AS - segurança do sistema de acesso

MA - máximo Permitido

GR - leitura genérica
GW - gravação genérica

GE - execução genérica

GA - todos genéricos

RD - ler dados/listar diretório

WD - gravar dados/adicionar arquivo

AD - acrescentar dados/adicionar subdiretório

REA - ler atributos estendidos

WEA - atributos estendidos de gravação

X - executar/percorrer

DC - excluir filho

RA - atributos de leitura

WA - atributos de gravação

Os direitos de herança podem preceder qualquer forma de <perm> :

(I) - herança. ACE herdada do contêiner pai.

(OI) - herança de objeto. Os objetos nesse contêiner herdarão essa ACE.


Aplica-se apenas a diretórios.

(CI) - herança de contêiner. Os contêineres nesse contêiner pai herdarão essa


ACE. Aplica-se apenas a diretórios.

(IO) - somente herança. ACE herdada do contêiner pai, mas não se aplica ao
objeto em si. Aplica-se apenas a diretórios.

(NP) - não propagar herança. ACE herdada por contêineres e objetos do


contêiner pai, mas que não se propaga para contêineres aninhados. Aplica-se
apenas a diretórios.

Exemplos
Para salvar as DACLs de todos os arquivos no diretório C:\Windows e seus subdiretórios
no arquivo ACLFile, digite:
icacls c:\windows\* /save aclfile /t

Para restaurar os DACLs de cada arquivo no ACLFile que existe no diretório C:\Windows
e seus subdiretórios, digite:

icacls c:\windows\ /restore aclfile

Para conceder ao User1 as permissões de exclusão e gravação de DAC para um arquivo


chamado Test1, digite:

icacls test1 /grant User1:(d,wdac)

Para conceder ao usuário definido pela SID S-1-1-0 as permissões de exclusão e


gravação de DAC para um arquivo chamado Test2, digite:

icacls test2 /grant *S-1-1-0:(d,wdac)

Links relacionados
Chave da sintaxe de linha de comando
if
Artigo • 11/04/2023

Executa o processamento condicional em programas em lote.

Syntax

if [not] ERRORLEVEL <number> <command> [else <expression>]


if [not] <string1>==<string2> <command> [else <expression>]
if [not] exist <filename> <command> [else <expression>]

Se as extensões de comando estiverem habilitadas, use a seguinte sintaxe:

if [/i] <string1> <compareop> <string2> <command> [else <expression>]


if cmdextversion <number> <command> [else <expression>]
if defined <variable> <command> [else <expression>]

Parâmetros

Parâmetro Descrição

não Especifica que o comando deve ser executado somente se a condição for falsa.

errorlevel Especifica uma condição verdadeira somente se o programa anterior executado


<number> por Cmd.exe retornou um código de saída igual ou maior que o número.

<command> Especifica o comando que deve ser executado se a condição anterior for
atendida.

<string1>== Especifica uma condição verdadeira somente se string1 e string2 forem iguais.
<string2> Esses valores podem ser cadeias de caracteres literais ou variáveis de lote (por
exemplo, %1 ). Você não precisa colocar cadeias de caracteres literais entre aspas.

existe Especifica uma condição verdadeira se o nome do arquivo especificado existir.


<filename>
Parâmetro Descrição

<compareop> Especifica um operador de comparação de três letras, incluindo:


EQU - Igual a
NEQ - Não é igual a
LSS - Menor que
LEQ - Menor ou igual a
GTR - Maior que
GEQ - Maior ou igual a

/i Força comparações de cadeia de caracteres a ignorar maiúsculas e minúsculas.


Você pode usar /i na forma string1==string2 de if. Essas comparações são
genéricas, porque se string1 e string2 forem compostas apenas por dígitos
numéricos, as cadeias de caracteres serão convertidas em números e uma
comparação numérica será executada.

cmdextversion Especifica uma condição verdadeira somente se o número de versão interno


<number> associado ao recurso de extensões de comando do Cmd.exe for igual ou maior
que o número especificado. A primeira versão é 1. Ele aumenta por incrementos
de um quando aprimoramentos significativos são adicionados às extensões de
comando. A condição cmdextversion nunca é verdadeira quando as extensões
de comando são desabilitadas (por padrão, as extensões de comando estão
habilitadas).

defined Especifica uma condição verdadeira se a variável for definida.


<variable>

<expression> Especifica um comando de linha de comando e todos os parâmetros a serem


passados para o comando em uma cláusula else.

/? Exibe a ajuda no prompt de comando.

Comentários

Se a condição especificada em uma cláusula if for true, o comando que segue a


condição será executado. Se a condição for false, o comando na cláusula if será
ignorado e o comando executará qualquer comando especificado na cláusula else.

Quando um programa é interrompido, ele retorna um código de saída. Para usar


códigos de saída como condições, use o parâmetro errorlevel.

Se você usar definido, as três variáveis a seguir serão adicionadas ao ambiente:


%errorlevel%, %cmdcmdline% e %cmdextversion%.

%errorlevel%: expande para uma representação de cadeia de caracteres do


valor atual da variável de ambiente ERRORLEVEL. Essa variável pressupõe que
ainda não haja uma variável de ambiente existente com o nome ERRORLEVEL.
Se houver, você obterá esse valor ERRORLEVEL.

%cmdcmdline%: expande para a linha de comando original que foi passada


para o Cmd.exe antes de qualquer processamento pelo Cmd.exe. Isso
pressupõe que ainda não haja uma variável de ambiente existente com o nome
CMDCMDLINE. Se houver, você obterá esse valor CMDCMDLINE.

%cmdextversion%: expande para a representação de cadeia de caracteres do


valor atual de cmdextversion. Isso pressupõe que ainda não haja uma variável
de ambiente existente com o nome CMDEXTVERSION. Se houver, você obterá
esse valor CMDEXTVERSION.

Você deve usar a cláusula else na mesma linha que o comando após if.

Exemplos
Para exibir a mensagem Não é possível localizar o arquivo de dados se o arquivo
Product.dat não puder ser encontrado, digite:

if not exist product.dat echo Cannot find data file

Para formatar um disco na unidade A e exibir uma mensagem de erro se ocorrer um


erro durante o processo de formatação, digite as seguintes linhas em um arquivo em
lote:

:begin
@echo off
format a: /s
if not errorlevel 1 goto end
echo An error occurred during formatting.
:end
echo End of batch program.

Para excluir o arquivo Product.dat do diretório atual ou exibir uma mensagem se


Product.dat não for encontrado, digite as seguintes linhas em um arquivo em lote:

IF EXIST Product.dat (
del Product.dat
) ELSE (
echo The Product.dat file is missing.
)

7 Observação

Essas linhas podem ser combinadas em uma única linha da seguinte maneira:

IF EXIST Product.dat (del Product.dat) ELSE (echo The Product.dat file


is missing.)

Para ecoar o valor da variável de ambiente ERRORLEVEL depois de executar um arquivo


em lote, digite as seguintes linhas no arquivo em lote:

goto answer%errorlevel%
:answer1
echo The program returned error level 1
goto end
:answer0
echo The program returned error level 0
goto end
:end
echo Done!

Para ir para o rótulo Ok se o valor da variável de ambiente ERRORLEVEL for menor ou


igual a 1, digite:

if %errorlevel% LEQ 1 goto okay

Links relacionados
Chave da sintaxe de linha de comando

comando goto
import (diskshadow)
Artigo • 06/04/2023

Importa uma cópia de sombra transportável de um arquivo de metadados carregado no


sistema.

[IMPORTANTE] Antes de usar esse comando, você deve usar o comando load
metadata para carregar um arquivo de metadados DiskShadow.

Sintaxe

import

Comentários
Cópias de sombra transportáveis não são armazenadas no sistema imediatamente.
Seus detalhes são armazenados em um arquivo XML do Documento de
componentes de Backup, que o DiskShadow solicita e salva automaticamente em
um arquivo de metadados .cab no diretório de trabalho. Use o comando set
metadata para alterar o caminho e o nome desse arquivo XML.

Exemplos
Confira a seguir um script DiskShadow de exemplo que demonstra o uso do comando
import:

#Sample DiskShadow script demonstrating IMPORT


SET CONTEXT PERSISTENT
SET CONTEXT TRANSPORTABLE
SET METADATA transHWshadow_p.cab
#P: is the volume supported by the Hardware Shadow Copy provider
ADD VOLUME P:
CREATE
END BACKUP
#The (transportable) shadow copy is not in the system yet.
#You can reset or exit now if you wish.

LOAD METADATA transHWshadow_p.cab


IMPORT
#The shadow copy will now be loaded into the system.

Links relacionados
Chave da sintaxe de linha de comando

Comando diskshadow
import (diskpart)
Artigo • 17/04/2023

Importa um grupo de discos estrangeiros para o grupo de discos do computador local.


Esse comando importa todos os discos que estão no mesmo grupo que o disco com
foco.

[IMPORTANTE] Antes de usar esse comando, você deve usar o comando select disk
para selecionar um disco dinâmico em um grupo de discos estrangeiros e mudar o
foco para ele.

Sintaxe

import [noerr]

Parâmetros

Parâmetro Descrição

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Exemplos
Para importar todos os discos que estão no mesmo grupo de discos que o disco com
foco no grupo de discos do computador local, digite:

import

Links relacionados
Chave da sintaxe de linha de comando

Comando diskpart
inativos
Artigo • 17/04/2023

Marca a partição do sistema ou a partição de inicialização com foco como inativo em


discos MBR (registro mestre de inicialização) básicos.

Um sistema ativo ou partição de inicialização deve ser selecionado para que essa
operação tenha êxito. Use o comando select partition command para selecionar a
partição ativa e deslocar o foco para ela.

U Cuidado

Pode ser que seu computador não inicie sem uma partição ativa. Não marque um
sistema ou uma partição de inicialização como inativa, a menos que você seja um
usuário experiente com uma compreensão completa da família de sistemas
operacionais Windows.

Se não for possível iniciar o computador depois de marcar a partição de


inicialização ou do sistema como inativa, insira o CD de Instalação do Windows na
unidade CD-ROM, reinicie o computador e, em seguida, repare a partição usando
os comandos fixmbr e fixboot no Console de Recuperação.

Depois de marcar a partição do sistema ou a partição de inicialização como inativa,


o computador começará na próxima opção especificada no BIOS, como a unidade
CD-ROM ou um PXE (Ambiente de Execução de Pré-Inicialização).

Sintaxe

inactive

Exemplos

inactive
Links relacionados
Chave da sintaxe de linha de comando

Comando select partition

Solução de problemas avançada para erros de inicialização do Windows


ipconfig
Artigo • 11/04/2023

Exibe todos os valores atuais de configuração de rede TCP/IP e atualiza as configurações


do DHCP (Dynamic Host Configuration Protocol) e do DNS (Sistema de Nomes de
Domínio). Usado sem parâmetros, o ipconfig exibe endereços IPv4 (Protocolo de
Internet versão 4) e IPv6, máscara de sub-rede e gateway padrão para todos os
adaptadores.

Sintaxe

ipconfig [/allcompartments] [/all] [/renew [<adapter>]] [/release


[<adapter>]] [/renew6[<adapter>]] [/release6 [<adapter>]] [/flushdns]
[/displaydns] [/registerdns] [/showclassid <adapter>] [/setclassid <adapter>
[<classID>]]

Parâmetros

Parâmetro Descrição

/all Exibe a configuração de TCP/IP completa para todos os adaptadores. Os


adaptadores podem representar interfaces físicas, como adaptadores de
rede instalados, ou interfaces lógicas, como conexões dial-up.

/displaydns Exibe o conteúdo do cache do resolvedor de cliente DNS, que inclui as


entradas pré-carregadas do arquivo de hosts local e os registros de
recursos obtidos recentemente para consultas de nome resolvidas pelo
computador. O serviço do cliente DNS usa essas informações para
resolver nomes consultados com frequência rapidamente, antes de
consultar seus servidores DNS configurados.

/flushdns Libera e redefine o conteúdo do cache do resolvedor de cliente DNS.


Durante a solução de problemas de DNS, você pode usar esse
procedimento para descartar entradas de cache negativas do cache, bem
como quaisquer outras entradas que tenham sido adicionadas
dinamicamente.
Parâmetro Descrição

/registerdns Inicia o registro dinâmico manual para os nomes DNS e endereços IP


configurados em um computador. Você pode usar esse parâmetro para
solucionar problemas de um registro de nome DNS com falha ou resolver
um problema de atualização dinâmica entre um cliente e o servidor DNS
sem reinicializar o computador cliente. As configurações de DNS nas
propriedades avançadas do protocolo TCP/IP determinam quais nomes
estão registrados no DNS.

/release [<adapter>] Envia uma mensagem DHCPRELEASE para o servidor DHCP para liberar a
configuração DHCP atual e descartar a configuração de endereço IP para
todos os adaptadores (se um adaptador não for especificado) ou para um
adaptador específico se o parâmetro do adaptador estiver incluído. Esse
parâmetro desabilita o TCP/IP para adaptadores configurados para obter
um endereço IP automaticamente. Para especificar um nome do
adaptador, digite o nome do adaptador que aparece quando você usa
ipconfig sem parâmetros.

/release6 [<adapter>] Envia uma mensagem DHCPRELEASE para o servidor DHCPv6 para liberar
a configuração DHCP atual e descartar a configuração de endereço IPv6
para todos os adaptadores (se um adaptador não for especificado) ou
para um adaptador específico se o parâmetro do adaptador estiver
incluído. Esse parâmetro desabilita o TCP/IP para adaptadores
configurados para obter um endereço IP automaticamente. Para
especificar um nome do adaptador, digite o nome do adaptador que
aparece quando você usa ipconfig sem parâmetros.

/renew [<adapter>] Renova a configuração do DHCP para todos os adaptadores (se um


adaptador não for especificado) ou para um adaptador específico se o
parâmetro do adaptador estiver incluído. Esse parâmetro só está
disponível em computadores com adaptadores configurados para obter
um endereço IP automaticamente. Para especificar um nome do
adaptador, digite o nome do adaptador que aparece quando você usa
ipconfig sem parâmetros.

/renew6 [<adapter>] Renova a configuração do DHCPv6 para todos os adaptadores (se um


adaptador não for especificado) ou para um adaptador específico se o
parâmetro do adaptador estiver incluído. Esse parâmetro só está
disponível em computadores com adaptadores configurados para obter
um endereço IPv6 automaticamente. Para especificar um nome do
adaptador, digite o nome do adaptador que aparece quando você usa
ipconfig sem parâmetros.

/setclassid <adapter> Configura a ID da classe DHCP para um adaptador especificado. Para


[<classID>] definir a ID da classe DHCP para todos os adaptadores, use o caractere
curinga asterisco (*) no lugar do adaptador. Esse parâmetro só está
disponível em computadores com adaptadores configurados para obter
um endereço IP automaticamente. Se uma ID de classe DHCP não for
especificada, a ID da classe atual será removida.
Parâmetro Descrição

/showclassid Exibe a ID da classe DHCP para um adaptador especificado. Para ver a ID


<adapter> da classe DHCP para todos os adaptadores, use o caractere curinga
asterisco (*) no lugar do adaptador. Esse parâmetro só está disponível em
computadores com adaptadores configurados para obter um endereço IP
automaticamente.

/? Exibe a ajuda no prompt de comando.

Comentários
Esse comando é mais útil em computadores configurados para obter um endereço
IP automaticamente. Isso permite que os usuários determinem quais valores de
configuração de TCP/IP foram configurados por DHCP, APIPA (Endereçamento IP
Privado Automático) ou uma configuração alternativa.

Se o nome fornecido para o adaptador contiver espaços, use aspas ao redor do


nome do adaptador (por exemplo, “nome do adaptador”).

Para nomes de adaptador, ipconfig dá suporte ao uso do caractere curinga


asterisco (*) para especificar adaptadores com nomes que começam com uma
cadeia de caracteres ou adaptadores especificados com nomes que contêm uma
cadeia de caracteres especificada. Por exemplo, Local* corresponde a todos os
adaptadores que começam com a cadeia de caracteres Local e *Con* corresponde
a todos os adaptadores que contêm a cadeia de caracteres Con.

Exemplos
Para exibir a configuração básica de TCP/IP para todos os adaptadores, digite:

ipconfig

Para exibir a configuração completa de TCP/IP para todos os adaptadores, digite:

ipconfig /all

Para renovar uma configuração de endereço IP atribuída por DHCP apenas para o
adaptador de Conexão de Área Local, digite:
ipconfig /renew Local Area Connection

Para liberar o cache do resolvedor de DNS ao solucionar problemas do nome DNS,


digite:

ipconfig /flushdns

Para exibir a ID da classe DHCP para todos os adaptadores com nomes que começam
com Local, digite:

ipconfig /showclassid Local*

Para definir a ID da classe DHCP para o adaptador de conexão de área local como TEST,
digite:

ipconfig /setclassid Local Area Connection TEST

Links relacionados
Chave da sintaxe de linha de comando
ipxroute
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe e modifica informações sobre as tabelas de roteamento usadas pelo protocolo


IPX. Usado sem parâmetros, o ipxroute exibe as configurações padrão para pacotes que
são enviados para endereços desconhecidos, de difusão e multicast.

Sintaxe

ipxroute servers [/type=x]


ipxroute ripout <network>
ipxroute resolve {guid | name} {GUID | <adaptername>}
ipxroute board= N [def] [gbr] [mbr] [remove=xxxxxxxxxxxx]
ipxroute config

Parâmetros

Parâmetro Descrição

servidores [/type=x] Exibe a tabela de SAP (Ponto de Acesso a Serviços) para o tipo de
servidor especificado. x deve ser um inteiro. Por exemplo, /type=4 exibe
todos os servidores de arquivos. Se você não especificar /type, ipxroute
servers exibirá todos os tipos de servidores, listando-os pelo nome do
servidor.

resolve {GUID | Resolve o nome do GUID para seu nome amigável ou o nome amigável
name} {GUID | para seu GUID.
adaptername}

board= n Especifica o adaptador de rede para o qual consultar ou definir


parâmetros.

def Envia pacotes para a difusão ALL ROUTES. Se um pacote for transmitido
para um endereço MAC exclusivo que não esteja na tabela de roteamento
de origem, o ipxroute enviará o pacote para a difusão SINGLE ROUTES
por padrão.
Parâmetro Descrição

gbr Envia pacotes para a difusão ALL ROUTES. Se um pacote for transmitido
para o endereço de difusão (FFFFFFFFFFFF), o ipxroute enviará o pacote
para a difusão SINGLE ROUTES por padrão.

mbr Envia pacotes para a difusão ALL ROUTES. Se um pacote for transmitido
para o endereço de multicast (C000xxxxxxxx), o ipxroute enviará o pacote
para a difusão SINGLE ROUTES por padrão.

remove=xxxxxxxxxxxx Remove o endereço do nó especificado da tabela de roteamento de


origem.

config Exibe informações sobre todas as associações para as quais o IPX está
configurado.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para exibir os segmentos de rede aos quais a estação de trabalho está anexada, o
endereço do nó da estação de trabalho e o tipo de quadro que está sendo usado,
digite:

ipxroute config

Links relacionados
Chave da sintaxe de linha de comando
irftp
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Envia arquivos por um link infravermelho.

) Importante

Verifique se os dispositivos destinados a se comunicar por meio de um link


infravermelho têm a funcionalidade infravermelha habilitada e estão funcionando
corretamente. Verifique também se um link infravermelho está estabelecido entre
os dispositivos.

Sintaxe

irftp [<drive>:\] [[<path>] <filename>] [/h][/s]

Parâmetros

Parâmetro Descrição

<drive>:\ Especifica a unidade que contém os arquivos que você deseja enviar por meio de
um link infravermelho.

[path] Especifica o local e o nome do arquivo ou o conjunto de arquivos que você deseja
<filename> enviar por meio de um link infravermelho. Se você especificar um conjunto de
arquivos, deverá especificar o caminho completo para cada arquivo.

/h Especifica o modo oculto. Quando o modo oculto é usado, os arquivos são enviados
sem exibir a caixa de diálogo Link Sem Fio.

/s Abre a caixa de diálogo Link Sem Fio para que você possa selecionar o arquivo ou o
conjunto de arquivos que deseja enviar sem usar a linha de comando para
especificar a unidade, o caminho e os nomes de arquivo. A caixa de diálogo Link
Sem Fio também será aberta se você usar esse comando sem parâmetros.
Exemplos
Para enviar c:\example.txt pelo link infravermelho, digite:

irftp c:\example.txt

Links relacionados
Chave da sintaxe de linha de comando
jetpack
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Compacta um banco de dados WINS ou DHCP. É recomendável que você compacte o


banco de dados WINS sempre que ele se aproximar de 30 MB.

O jetpack.exe compacta o banco de dados ao:

1. Copiar as informações do banco de dados para um arquivo de banco de dados


temporário.

2. Excluir o arquivo de banco de dados original, WINS ou DHCP.

3. Renomear os arquivos de banco de dados temporários para o nome de arquivo


original.

Sintaxe

jetpack.exe <database_name> <temp_database_name>

Parâmetros

Parâmetro Descrição

<database_name> Especificar o nome do arquivo de banco de dados original.

<temp_database_name> Especificar o nome do arquivo de banco de dados temporário a ser


criado pelo jetpack.exe.
Observação: esse arquivo temporário é removido quando o processo
compacto é concluído. Para que esse comando funcione corretamente,
você deve verificar se o nome do arquivo temporário é exclusivo e se um
arquivo com esse nome ainda não existe.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para compactar o banco de dados WINS, em que Tmp.mdb é um banco de dados
temporário e Wins.mdb é o banco de dados WINS, digite:

cd %SYSTEMROOT%\SYSTEM32\WINS
NET STOP WINS
jetpack Wins.mdb Tmp.mdb
NET start WINS

Para compactar o banco de dados DHCP, em que Tmp.mdb é um banco de dados


temporário e Dhcp.mdb é o banco de dados DHCP, digite:

cd %SYSTEMROOT%\SYSTEM32\DHCP
NET STOP DHCPSERVER
jetpack Dhcp.mdb Tmp.mdb
NET start DHCPSERVER

Links relacionados
Chave da sintaxe de linha de comando
klist
Artigo • 12/04/2023

Exibe uma lista de tíquetes Kerberos armazenados em cache no momento.

) Importante

Você deve ser pelo menos um Administrador de domínio ou equivalente para


executar todos os parâmetros desse comando.

Sintaxe

klist [-lh <logonID.highpart>] [-li <logonID.lowpart>] tickets | tgt | purge


| sessions | kcd_cache | get | add_bind | query_bind | purge_bind

Parâmetros

Parâmetro Descrição

-lh Indica a parte alta do LUID (identificador local exclusivo) do usuário, expresso em
hexadecimal. Se –lh ou –li não estiverem presentes, o comando usará como padrão
o LUID do usuário que está conectado no momento.

-li Indica a parte baixa do LUID (identificador local exclusivo) do usuário, expresso em
hexadecimal. Se –lh ou –li não estiverem presentes, o comando usará como padrão
o LUID do usuário que está conectado no momento.

tíquetes Lista os TGTs (tíquetes de concessão de tíquetes) em cache no momento e os


tíquetes de serviço da sessão de logon especificada. Essa é a opção padrão.

tgt Exibe o TGT inicial do Kerberos.

purge Permite excluir todos os tíquetes da sessão de logon especificada.

sessões Exibe uma lista de sessões de logon neste computador.

kcd_cache Exibe as informações de cache de delegação restrita de Kerberos.

get Permite solicitar um tíquete para o computador de destino especificado pelo SPN
(nome da entidade de serviço).
Parâmetro Descrição

add_bind Permite que você especifique um controlador de domínio preferencial para


autenticação Kerberos.

query_bind Exibe uma lista de controladores de domínio preferenciais armazenados em cache


para cada domínio que o Kerberos contatou.

purge_bind Remove os controladores de domínio preferenciais armazenados em cache para os


domínios especificados.

kdcoptions Exibe as opções do KDC (Centro de Distribuição de Chaves) especificadas no RFC


4120.

/? Exibe a Ajuda para esse comando.

Comentários

Se nenhum parâmetro for fornecido, o klist recuperará todos os tíquetes para o


usuário conectado no momento.

Os parâmetros exibem as seguintes informações:

tíquetes: lista os tíquetes de serviços atualmente armazenados em cache nos


quais você se autenticou desde o logon. Exibe os seguintes atributos de todos
os tíquetes armazenados em cache:

LogonID: o LUID.

Cliente: a concatenação do nome do cliente e o nome de domínio do cliente.

Servidor: a concatenação do nome do serviço e o nome de domínio do


serviço.

Tipo de Criptografia KerbTicket: o tipo de criptografia usado para


criptografar o tíquete Kerberos.

Sinalizadores de tíquete: os sinalizadores de tíquete Kerberos.

Hora de Início: a hora de início da validade do tíquete.

Hora de Término: a hora do fim da validade do tíquete. Quando um tíquete


passa desse prazo, ele não pode mais ser usado para autenticação em um
serviço ou para renovação.

Hora de Renovação: a hora em que uma nova autenticação inicial é


necessária.
Tipo de Chave da Sessão: o algoritmo de criptografia usado para a chave da
sessão.

tgt: lista o TGT inicial do Kerberos e os seguintes atributos do tíquete


armazenado em cache no momento:

LogonID: identificado em hexadecimal.

ServiceName: krbtgt

TargetName <SPN> : krbtgt

Domainname: nome do domínio que emite o TGT.

Targetdomainname: domínio para o qual o TGT é emitido.

AltTargetDomainName: domínio para o qual o TGT é emitido.

Sinalizadores de Tíquete: ações e tipo de endereço e destino.

Chave da Sessão: comprimento da chave e algoritmo de criptografia.

StartTime: hora do computador local em que o tíquete foi solicitado.

EndTime: hora do fim da validade do tíquete. Quando um tíquete passa


desse prazo, ele não pode mais ser usado para autenticação em um serviço.

RenewUntil: prazo para renovação de tíquetes.

TimeSkew: diferença de tempo com o KDC (Centro de Distribuição de


Chaves).

EncodedTicket: tíquete codificado.

purge: permite a exclusão de um tíquete específico. A limpeza de tíquetes


destrói todos os tíquetes que você armazenou em cache, portanto, use esse
atributo com cuidado. Isso pode impedir que você se autentique nos recursos.
Se isso acontecer, você precisará fazer logoff e logon novamente.
LogonID: identificado em hexadecimal.

sessões: permite listar e exibir as informações de todas as sessões de logon


neste computador.
LogonID: se especificado, exibe a sessão de logon somente no valor
fornecido. Se não for especificado, todas as sessões de logon neste
computador serão exibidas.
kcd_cache: permite exibir as informações de cache de delegação restrita do
Kerberos.
LogonID: se especificado, exibe as informações de cache da sessão de logon
no valor fornecido. Se não for especificado, exibe as informações de cache da
sessão de logon do usuário atual.

get: permite a solicitação de um tíquete para o destino especificado pelo SPN.

LogonID: se especificado, solicita um tíquete usando a sessão de logon pelo


valor fornecido. Se não especificado, solicita um tíquete usando a sessão de
logon do usuário atual.

kdcoptions: solicita um tíquete com as opções de KDC fornecidas

add_bind: permite que você especifique um controlador de domínio


preferencial para autenticação Kerberos.

query_bind: permite a exibição de controladores de domínio preferenciais


armazenados em cache para os domínios.

purge_bind: permite a remoção de controladores de domínio preferenciais


armazenados em cache para os domínios.

kdcoptions: para obter a lista atual de opções e suas explicações, consulte RFC
4120 .

Exemplos
Para consultar o cache de tíquetes Kerberos para determinar se há tíquetes ausentes, se
o servidor ou a conta de destino está com erro ou se não há suporte para o tipo de
criptografia devido a um erro de ID de Evento 27, digite:

klist

klist –li 0x3e7

Para saber mais sobre as especificidades de cada tíquete de concessão de tíquete


armazenado em cache no computador para uma sessão de logon, digite:
klist tgt

Para limpar o cache de tíquetes Kerberos e fazer logoff e logon novamente, digite:

klist purge

klist purge –li 0x3e7

Para diagnosticar uma sessão de logon e localizar um logonID para um usuário ou


serviço, digite:

klist sessions

Para diagnosticar a falha de delegação restrita do Kerberos e localizar o último erro


encontrado, digite:

klist kcd_cache

Para diagnosticar se um usuário ou um serviço pode obter um tíquete para um servidor


ou solicitar um tíquete para um SPN específico, digite:

klist get host/%computername%

Para diagnosticar problemas de replicação entre controladores de domínio, você


normalmente precisa do computador cliente para direcionar um controlador de
domínio específico. Para direcionar o computador cliente para o controlador de domínio
específico, digite:

klist add_bind CONTOSO KDC.CONTOSO.COM


klist add_bind CONTOSO.COM KDC.CONTOSO.COM

Para consultar quais controladores de domínio foram contatados recentemente por este
computador, digite:

klist query_bind

Para redescobrir controladores de domínio ou liberar o cache antes de criar novas


associações de controlador de domínio com klist add_bind , digite:

klist purge_bind

Links relacionados
Chave da sintaxe de linha de comando
ksetup
Artigo • 12/04/2023

Executa tarefas relacionadas à configuração e manutenção do protocolo Kerberos e ao


KDC (Centro de Distribuição de Chaves) para dar suporte aos territórios Kerberos.
Especificamente, esse comando é usado para:

Altere as configurações do computador para localizar os territórios Kerberos. Em


implementações baseadas em Kerberos que não sejam da Microsoft, essas
informações geralmente são mantidas no arquivo Krb5.conf. Nos sistemas
operacionais do Windows Server, ele é mantido no registro. Use esta ferramenta
para modificar essas configurações. Essas configurações são usadas por estações
de trabalho para localizar os territórios Kerberos e por controladores de domínio
para localizar os territórios Kerberos para relações de confiança entre os territórios.

Inicialize as chaves do Registro que o SSP (Provedor de Suporte de Segurança) do


Kerberos usa para localizar um KDC para o território Kerberos, se o computador
não for membro de um domínio do Windows. Após a configuração, o usuário de
um computador cliente que executa o sistema operacional do Windows pode fazer
logon em contas no território Kerberos.

Pesquise no Registro o nome de domínio do território do usuário e resolva o nome


para um endereço IP consultando um servidor DNS. O protocolo Kerberos pode
usar o DNS para localizar KDCs usando apenas o nome do território mas ele deve
ser configurado especialmente para fazer isso.

Sintaxe

ksetup
[/setrealm <DNSdomainname>]
[/mapuser <principal> <account>]
[/addkdc <realmname> <KDCname>]
[/delkdc <realmname> <KDCname>]
[/addkpasswd <realmname> <KDCPasswordName>]
[/delkpasswd <realmname> <KDCPasswordName>]
[/server <servername>]
[/setcomputerpassword <password>]
[/removerealm <realmname>]
[/domain <domainname>]
[/changepassword <oldpassword> <newpassword>]
[/listrealmflags]
[/setrealmflags <realmname> [sendaddress] [tcpsupported] [delegate]
[ncsupported] [rc4]]
[/addrealmflags <realmname> [sendaddress] [tcpsupported] [delegate]
[ncsupported] [rc4]]
[/delrealmflags [sendaddress] [tcpsupported] [delegate] [ncsupported] [rc4]]
[/dumpstate]
[/addhosttorealmmap] <hostname> <realmname>]
[/delhosttorealmmap] <hostname> <realmname>]
[/setenctypeattr] <domainname> {DES-CBC-CRC | DES-CBC-MD5 | RC4-HMAC-MD5 |
AES128-CTS-HMAC-SHA1-96 | AES256-CTS-HMAC-SHA1-96}
[/getenctypeattr] <domainname>
[/addenctypeattr] <domainname> {DES-CBC-CRC | DES-CBC-MD5 | RC4-HMAC-MD5 |
AES128-CTS-HMAC-SHA1-96 | AES256-CTS-HMAC-SHA1-96}
[/delenctypeattr] <domainname>

Parâmetros

Parâmetro Descrição

ksetup setrealm Faz deste computador um membro de um território Kerberos.

ksetup addkdc Define uma entrada KDC para o território especificado.

ksetup delkdc Exclui uma entrada KDC para o território.

ksetup addkpasswd Adiciona um endereço de servidor kpasswd para um território.

ksetup delkpasswd Exclui um endereço de servidor kpasswd para um território.

ksetup server Permite especificar o nome de um computador do Windows no qual


aplicar as alterações.

ksetup Define a senha da conta de domínio do computador (ou entidade de


setcomputerpassword host).

ksetup removerealm Exclui todas as informações do território especificado do registro.

ksetup domain Permite especificar um domínio (se o <domainname> ainda não tiver sido
definido pelo parâmetro /domain).

ksetup Permite usar o kpasswd para alterar a senha do usuário conectado.


changepassword

ksetup listrealmflags Lista os sinalizadores de território disponíveis que ksetup pode detectar.

ksetup setrealmflags Define sinalizadores de território para um território específico.

ksetup addrealmflags Adiciona sinalizadores de território adicionais a um território.

ksetup delrealmflags Exclui sinalizadores de território de um território.


Parâmetro Descrição

ksetup dumpstate Analisa a configuração do Kerberos no computador especificado.


Adiciona um host ao mapeamento de território ao registro.

ksetup Adiciona um valor do Registro para mapear o host para o território


addhosttorealmmap Kerberos.

ksetup Exclui o valor do Registro que mapeou o computador host para o


delhosttorealmmap território Kerberos.

ksetup setenctypeattr Define um ou mais atributos de confiança de tipos de criptografia para o


domínio.

ksetup getenctypeattr Obtém o atributo de confiança de tipos de criptografia para o domínio.

ksetup Adiciona tipos de criptografia ao atributo de confiança de tipos de


addenctypeattr criptografia para o domínio.

ksetup delenctypeattr Exclui o atributo de confiança de tipos de criptografia para o domínio.

/? Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
ksetup addenctypeattr
Artigo • 12/04/2023

Adiciona o atributo de tipo de criptografia à lista de tipos possíveis do domínio. Uma


mensagem de status é exibida após a conclusão bem-sucedida ou com falha.

Sintaxe

ksetup /addenctypeattr <domainname> {DES-CBC-CRC | DES-CBC-MD5 | RC4-HMAC-


MD5 | AES128-CTS-HMAC-SHA1-96 | AES256-CTS-HMAC-SHA1-96}

Parâmetros

Parâmetro Descrição

<domainname> Nome do domínio ao qual você deseja estabelecer uma conexão. Use o nome do
domínio totalmente qualificado ou uma forma simples do nome, como
corp.contoso.com ou contoso.

encryption Deve ser um dos seguintes tipos de criptografia com suporte:


type DES-CBC-CRC
DES-CBC-MD5
RC4-HMAC-MD5
AES128-CTS-HMAC-SHA1-96
AES256-CTS-HMAC-SHA1-96

Comentários

Você pode definir ou adicionar vários tipos de criptografia separando os tipos de


criptografia no comando com um espaço. No entanto, você só pode fazer isso
para um domínio por vez.

Exemplos
Para exibir o tipo de criptografia para o TGT (tíquete de concessão de tíquete) do
Kerberos e a chave de sessão, digite:
klist

Para definir o domínio como corp.contoso.com, digite:

ksetup /domain corp.contoso.com

Para adicionar o tipo de criptografia AES-256-CTS-HMAC-SHA1-96 à lista de tipos


possíveis do domínio corp.contoso.com, digite:

ksetup /addenctypeattr corp.contoso.com AES-256-CTS-HMAC-SHA1-96

Para definir o atributo de tipo de criptografia como AES-256-CTS-HMAC-SHA1-96 para


o corp.contoso.com de domínio, digite:

ksetup /setenctypeattr corp.contoso.com AES-256-CTS-HMAC-SHA1-96

Para verificar se o atributo de tipo de criptografia foi definido conforme o esperado para
o domínio, digite:

ksetup /getenctypeattr corp.contoso.com

Links relacionados
Chave da sintaxe de linha de comando

comando klist

comando ksetup

comando ksetup domain

comando ksetup setenctypeattr

comando ksetup getenctypeattr


comando ksetup delenctypeattr
ksetup addhosttorealmmap
Artigo • 06/04/2023

Adiciona um mapeamento de SPN entre o host declarado e o realm. Esse comando


também permite mapear um host ou vários hosts que estão compartilhando o mesmo
sufixo DNS com o realm.

O mapeamento é armazenado no registro, em


HKEY_LOCAL_MACHINE\SYSTEM\CurrentContolSet\Control\Lsa\Kerberos\HostToReal
m.

Sintaxe

ksetup /addhosttorealmmap <hostname> <realmname>

Parâmetros

Parâmetro Descrição

<hostname> O nome do host é o nome do computador e pode ser declarado como o nome de
domínio totalmente qualificado do computador.

<realmname> O nome do realm é declarado como um nome DNS em letra maiúscula, como
CORP. CONTOSO.COM.

Exemplos
Para mapear o computador host IPops897 para o realm CONTOSO, digite:

ksetup /addhosttorealmmap IPops897 CONTOSO

Verifique o registro se o mapeamento ocorreu conforme planejado.

Links relacionados
Chave da sintaxe de linha de comando
Comando ksetup

Comando ksetup delhosttorealmmap


ksetup addkdc
Artigo • 06/04/2023

Adiciona um endereço do KDC no realm do Kerberos especificado

O mapeamento é armazenado no registro, em


HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\Kerberos\Domains e
o computador deve ser reiniciado antes que a nova configuração do realm seja usada.

7 Observação

Para implantar dados de configuração de realm do Kerberos em vários


computadores, você deve usar o snap-in do Modelo de configuração de
segurança e a distribuição de políticas, explicitamente em computadores
individuais. Você não pode usar este comando.

Sintaxe

ksetup /addkdc <realmname> [<KDCname>]

Parâmetros

Parâmetro Descrição

<realmname> Especifica o nome DNS em letra maiúscula, como CORP. CONTOSO.COM. Esse
valor também é exibido como o realm padrão quando ksetup é executado e é o
realm ao qual você deseja adicionar o outro KDC.

<KDCname> Especifica o nome de domínio totalmente qualificado e sem diferenciação entre


maiúsculas de minúsculas, como mitkdc.contoso.com. Se o nome do KDC for
omitido, o DNS localizará os KDCs.

Exemplos
Para configurar um servidor do KDC não Windows e o realm que a estação de trabalho
deve usar, digite:
ksetup /addkdc CORP.CONTOSO.COM mitkdc.contoso.com

Para definir a senha da conta do computador local como p@sswrd1% no mesmo


computador do exemplo anterior e, em seguida, reiniciar o computador, digite:

ksetup /setcomputerpassword p@sswrd1%

Para verificar o nome de realm padrão do computador ou verificar se esse comando


funcionou conforme planejado, digite:

ksetup

Verifique o registro se o mapeamento ocorreu conforme planejado.

Links relacionados
Chave da sintaxe de linha de comando

Comando ksetup

Comando ksetup setcomputerpassword


ksetup addkpasswd
Artigo • 12/04/2023

Adiciona um endereço de servidor de senha (kpasswd) do Kerberos para um realm.

Sintaxe

ksetup /addkpasswd <realmname> [<kpasswdname>]

Parâmetros

Parâmetro Descrição

<realmname> Especifica o nome DNS em letra maiúscula, como CORP.CONTOSO.COM, e é


listado como o realm padrão ou Realm= quando ksetup é executado.

<kpasswdname> Especifica o servidor de senha do Kerberos. É declarado como um nome de


domínio totalmente qualificado e que não diferencia maiúsculas de minúsculas,
como mitkdc.contoso.com. Se o nome do KDC for omitido, o DNS poderá ser
usado para localizar os KDCs.

Comentários
Se o realm do Kerberos no qual a estação de trabalho será autenticada oferecer
suporte ao protocolo de alteração de senha do Kerberos, você poderá configurar
um computador cliente com o sistema operacional Windows para usar um servidor
de senha do Kerberos.

Você pode adicionar nomes de KDC adicionais, um de cada vez.

Exemplos
Para configurar o realm CORP.CONTOSO.COM para usar o servidor do KDC não
Windows mitkdc.contoso.com como o servidor de senha, digite:

ksetup /addkpasswd CORP.CONTOSO.COM mitkdc.contoso.com


Para verificar se o nome do KDC está definido, digite ksetup e veja a saída, procurando
o texto kpasswd =. Se você não vir o texto, isso significa que o mapeamento não foi
configurado.

Links relacionados
Chave da sintaxe de linha de comando

comando ksetup

comando ksetup delkpasswd


ksetup addrealmflags
Artigo • 08/05/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O comando ksetup addrealmflags adiciona outros sinalizadores de realm a um realm


especificado.

Sintaxe

ksetup /addrealmflags <realmname> [sendaddress] [tcpsupported] [delegate]


[ncsupported] [rc4]

Parâmetros

Parâmetro Descrição

<realmname> Especifica o nome DNS em letra maiúscula, como CORP.CONTOSO.COM .

Comentários
Os sinalizadores de realm são armazenados no registro em
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\Kerberos\Domains\
<realmname> . Essa entrada não existe no registro por padrão. Você pode usar o

comando ksetup addrealmflags para preencher o registro.

Os sinalizadores de realm especificam outros recursos de um realm do Kerberos


que não são baseados no sistema operacional do Windows Server. Os
computadores que executam o Windows Server podem usar um servidor do
Kerberos para administrar a autenticação no realm do Kerberos, em vez de usar
um domínio que executa um sistema operacional do Windows Server. Essa entrada
de Registro estabelece os recursos do realm e são os seguintes:

Valor Sinalizador Descrição


de realm

0xF All Todos os sinalizadores de realm estão definidos.


Valor Sinalizador Descrição
de realm

0x00 None Nenhum sinalizador de realm está definido, e não há outros recursos
habilitados.

0x01 sendaddress O endereço IP é incluído nos tíquetes de concessão de tíquetes.

0x02 tcpsupported Há suporte nesse realm para o protocolo TCP e o protocolo UDP.

0x04 delegate Todos nesse realm são confiáveis para delegação.

0x08 ncsupported Esse realm dá suporte à canonicalização de nomes, o que permite


padrões de nomenclatura DNS e realm.

0x80 rc4 Esse realm dá suporte à criptografia RC4 para habilitar a confiança entre
realms, o que permite o uso do TLS.

Você pode conferir os sinalizadores de realm disponíveis e definidos exibindo a


saída de ksetup ou ksetup /dumpstate .

Exemplos
Para listar os sinalizadores de realm disponíveis para o realm CONTOSO, digite:

ksetup /listrealmflags

Para definir dois sinalizadores para o realm CONTOSO, digite:

ksetup /setrealmflags CONTOSO ncsupported delegate

Para adicionar mais um sinalizador que não está no conjunto no momento, digite:

ksetup /addrealmflags CONTOSO SendAddress

Para verificar se o sinalizador realm está definido, digite ksetup e exiba a saída,
procurando o texto Sinalizadores de realm =. Se o texto não for exibido, significa que o
sinalizador não foi definido.
Links relacionados
Chave da sintaxe de linha de comando

Comando ksetup

Comando ksetup listrealmflags

Comando ksetup setrealmflags

Comando ksetup delrealmflags

comando ksetup dumpstate


ksetup changepassword
Artigo • 12/04/2023

Usa o valor de senha KDC (Centro de Distribuição de Chaves) (kpasswd) para alterar a
senha do usuário conectado. A saída do comando informa o status de êxito ou falha.

Você pode verificar se o kpasswd foi definido, executando o comando ksetup


/dumpstate e exibindo a saída.

Sintaxe

ksetup /changepassword <oldpassword> <newpassword>

Parâmetros

Parâmetro Descrição

<oldpassword> Especifica a senha existente do usuário conectado.

<newpassword> Especifica a nova senha do usuário conectado. Essa senha deve atender a todos
os requisitos de senha definidos neste computador.

Comentários

Se a conta de usuário não for encontrada no domínio atual, o sistema solicitará


que você forneça o nome de domínio em que reside a conta de usuário.

Se você quiser forçar uma alteração de senha no próximo logon, esse comando
permitirá o uso do asterisco (*) para que o usuário seja solicitado a fornecer uma
nova senha.

Exemplos
Para alterar a senha de um usuário que está conectado atualmente a este computador
neste domínio, digite:
ksetup /changepassword Pas$w0rd Pa$$w0rd

Para alterar a senha de um usuário que está conectado atualmente no domínio Contoso,
digite:

ksetup /domain CONTOSO /changepassword Pas$w0rd Pa$$w0rd

Para forçar o usuário conectado atualmente a alterar a senha no próximo logon, digite:

ksetup /changepassword Pas$w0rd *

Links relacionados
Chave da sintaxe de linha de comando

comando ksetup

comando ksetup dumpstate

comando ksetup addkpasswd

comando ksetup delkpasswd

comando ksetup dumpstate


ksetup delenctypeattr
Artigo • 12/04/2023

Remove o atributo de tipo de criptografia do domínio. Uma mensagem de status é


exibida após a conclusão bem-sucedida ou com falha.

Você pode exibir o tipo de criptografia para o TGT (tíquete de concessão de tíquete)
Kerberos e a chave da sessão executando o comando klist e exibindo a saída. É possível
definir o domínio ao qual se conectar e usar executando o comando ksetup /domain
<domainname> .

Sintaxe

ksetup /delenctypeattr <domainname>

Parâmetros

Parâmetro Descrição

<domainname> Nome do domínio ao qual você deseja estabelecer uma conexão. Você pode usar
o nome do domínio totalmente qualificado ou uma forma simples do nome,
como corp.contoso.com ou contoso.

Exemplos
Para determinar os tipos de criptografia atuais definidos neste computador, digite:

klist

Para definir o domínio como mit.contoso.com, digite:

ksetup /domain mit.contoso.com

Para verificar qual é o atributo de tipo de criptografia do domínio, digite:


ksetup /getenctypeattr mit.contoso.com

Para remover o atributo de tipo de criptografia definido do domínio mit.contoso.com,


digite:

ksetup /delenctypeattr mit.contoso.com

Links relacionados
Chave da sintaxe de linha de comando

comando klist

comando ksetup

comando ksetup domain

comando ksetup addenctypeattr

comando ksetup setenctypeattr


ksetup delhosttorealmmap
Artigo • 06/04/2023

Remove um mapeamento de SPN entre o host declarado e o realm. Esse comando


também remove todo mapeamento entre um host para o realm (ou de vários hosts para
o realm).

O mapeamento é armazenado no registro, em


HKEY_LOCAL_MACHINE\SYSTEM\CurrentContolSet\Control\Lsa\Kerberos\HostToRealm . Depois

de executar esse comando, é recomendável verificar se o mapeamento aparece no


registro.

Sintaxe

ksetup /delhosttorealmmap <hostname> <realmname>

Parâmetros

Parâmetro Descrição

<hostname> Especifica o nome de domínio totalmente qualificado do computador.

<realmname> Especifica o nome DNS em letra maiúscula, como CORP. CONTOSO.COM.

Exemplos
Para alterar a configuração do realm CONTOSO e excluir o mapeamento do computador
host IPops897 para o realm, digite:

ksetup /delhosttorealmmap IPops897 CONTOSO

Links relacionados
Chave da sintaxe de linha de comando
Comando ksetup

Comando ksetup addhosttorealmmap


ksetup delkdc
Artigo • 17/04/2023

Exclui instâncias de nomes do KDC (Centro de distribuição de chaves) para o realm


Kerberos.

O mapeamento é armazenado no registro, em


HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\Kerberos\Domains . Depois de

executar esse comando, é recomendável verificar se o KDC foi removido e não aparece
mais na lista.

7 Observação

Para remover dados de configuração do realm de vários computadores, use o


snap-in Modelo de configuração de segurança com distribuição de política em vez
de usar o comando ksetup explicitamente em computadores individuais.

Sintaxe

ksetup /delkdc <realmname> <KDCname>

Parâmetros

Parâmetro Descrição

<realmname> Especifica o nome DNS em letra maiúscula, como CORP. CONTOSO.COM. Esse é o
realm padrão que aparece quando ao executar o comando ksetup e é o realm do
qual você deseja excluir o KDC.

<KDCname> Especifica o nome de domínio totalmente qualificado e com diferenciação entre


maiúsculas de minúsculas, como mitkdc.contoso.com.

Exemplos
Para exibir todas as associações entre o realm do Windows e o realm não associado a
Windows e determinar quais remover, digite:
ksetup

Para remover a associação, digite:

ksetup /delkdc CORP.CONTOSO.COM mitkdc.contoso.com

Links relacionados
Chave da sintaxe de linha de comando

Comando ksetup

Comando ksetup addkdc


ksetup delkpasswd
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Remove um servidor de senha do Kerberos (kpasswd) para um realm.

Sintaxe

ksetup /delkpasswd <realmname> <kpasswdname>

Parâmetros

Parâmetro Descrição

<realmname> Especifica o nome DNS em letra maiúscula, como CORP.CONTOSO.COM, e é


listado como o realm padrão ou Realm= quando ksetup é executado.

<kpasswdname> Especifica o servidor de senha do Kerberos. É declarado como um nome de


domínio totalmente qualificado e que não diferencia maiúsculas de minúsculas,
como mitkdc.contoso.com. Se o nome do KDC for omitido, o DNS poderá ser
usado para localizar os KDCs.

Exemplos
Para garantir que o realm CORP.CONTOSO.COM use o servidor do KDC não Windows
mitkdc.contoso.com como o servidor de senha, digite:

ksetup /delkpasswd CORP.CONTOSO.COM mitkdc.contoso.com

Para garantir que o realm CORP.CONTOSO.COM não seja mapeado para um servidor de
senha do Kerberos (o nome do KDC), digite ksetup no computador Windows e exiba a
saída.
Links relacionados
Chave da sintaxe de linha de comando

Comando ksetup

Comando ksetup delkpasswd


ksetup delrealmflags
Artigo • 06/04/2023

Remove sinalizadores de realm do realm especificado.

Sintaxe

ksetup /delrealmflags <realmname> [sendaddress] [tcpsupported] [delegate]


[ncsupported] [rc4]

Parâmetros

Parâmetro Descrição

<realmname> Especifica o nome DNS em letra maiúscula, como CORP.CONTOSO.COM, e é


listado como o realm padrão ou Realm= quando ksetup é executado.

Comentários
Os sinalizadores de realm especificam recursos adicionais de um realm do
Kerberos que não são baseados no sistema operacional do Windows Server. Os
computadores que executam o Windows Server podem usar um servidor do
Kerberos para administrar a autenticação no realm do Kerberos, em vez de usar
um domínio que executa um sistema operacional do Windows Server. Essa entrada
estabelece os recursos do realm e são os seguintes:

Valor Sinalizador Descrição


de realm

0xF Tudo Todos os sinalizadores de realm estão definidos.

0x00 Nenhum Nenhum sinalizador de realm está definido e não há recursos adicionais
habilitados.

0x01 sendaddress O endereço IP será incluído nos tíquetes de concessão de tíquetes.

0x02 tcpsupported Há suporte nesse realm para o TCP (protocolo TCP) e o UDP (protocolo
UDP).

0x04 delegado Todos neste realm são confiáveis para delegação.


Valor Sinalizador Descrição
de realm

0x08 ncsupported Esse realm dá suporte à canonicalização de nomes, o que permite


padrões de nomenclatura DNS e realm.

0x80 rc4 Esse realm dá suporte à criptografia RC4 para habilitar a confiança entre
realms, o que permite o uso do TLS.

Os sinalizadores de realm são armazenados no registro em


HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\Kerberos\Domains\

<realmname> . Essa entrada não existe no registro por padrão. Você pode usar o
comando ksetup addrealmflags para preencher o registro.

Você pode conferir os sinalizadores de realm disponíveis e definidos exibindo a


saída de ksetup ou ksetup /dumpstate .

Exemplos
Para listar os sinalizadores de realm disponíveis para o realm CONTOSO, digite:

ksetup /listrealmflags

Para remover dois sinalizadores atualmente no conjunto, digite:

ksetup /delrealmflags CONTOSO ncsupported delegate

Para verificar se os sinalizadores de realm foram removidos, digite ksetup e exiba a


saída, procurando o texto Sinalizadores de realm =.

Links relacionados
Chave da sintaxe de linha de comando

Comando ksetup

Comando ksetup listrealmflags

Comando ksetup setrealmflags


Comando ksetup addrealmflags

Comando ksetup dumpstate


ksetup domain
Artigo • 06/04/2023

Define o nome de domínio para todas as operações do Kerberos.

Sintaxe

ksetup /domain <domainname>

Parâmetros

Parâmetro Descrição

<domainname> Nome do domínio ao qual você deseja estabelecer uma conexão. Use o nome do
domínio totalmente qualificado ou uma forma simples do nome, como
contoso.com ou contoso.

Exemplos
Para estabelecer uma conexão com um domínio válido, como a Microsoft, usando o
subcomando ksetup /mapuser , digite:

ksetup /mapuser principal@realm domain-user /domain domain-name

Após uma conexão bem-sucedida, você receberá um novo TGT ou um TGT existente
será atualizado.

Links relacionados
Chave da sintaxe de linha de comando

Comando ksetup

Comando ksetup mapuser


ksetup dumpstate
Artigo • 11/04/2023

Exibe o estado atual das configurações de realm para todos os realms definidos no
computador. Esse comando exibe a mesma saída do comando ksetup.

Sintaxe

ksetup /dumpstate

Comentários
A saída desse comando inclui o realm padrão (o domínio do qual o computador é
membro) e todos os realms definidos no computador. O seguinte é incluído para
cada realm:

Todos os KDCs (Centros de Distribuição de Chaves) associados a esse realm.

Todos os sinalizadores dorealm definidos para esse realm.

A senha KDC.

Esse comando não exibe o nome de domínio especificado pela detecção de DNS
ou pelo comando ksetup /domain .

Esse comando não exibe a senha do computador definida usando o comando


ksetup /setcomputerpassword .

Exemplos
Para localizar as configurações de realm Kerberos em um computador, digite:

ksetup /dumpstate

Links relacionados
Chave da sintaxe de linha de comando

comando ksetup
ksetup getenctypeattr
Artigo • 11/04/2023

Recupera o atributo do tipo de criptografia para o domínio. Uma mensagem de status é


exibida após a conclusão bem-sucedida ou com falha.

Você pode exibir o tipo de criptografia para o TGT (tíquete de concessão de tíquete)
Kerberos e a chave da sessão executando o comando klist e exibindo a saída. É possível
definir o domínio ao qual se conectar e usar executando o comando ksetup /domain
<domainname> .

Sintaxe

ksetup /getenctypeattr <domainname>

Parâmetros

Parâmetro Descrição

<domainname> Nome do domínio ao qual você deseja estabelecer uma conexão. Use o nome do
domínio totalmente qualificado ou uma forma simples do nome, como
corp.contoso.com ou contoso.

Exemplos
Para verificar o atributo do tipo de criptografia para o domínio, digite:

ksetup /getenctypeattr mit.contoso.com

Links relacionados
Chave da sintaxe de linha de comando

comando klist

comando ksetup
comando ksetup domain

comando ksetup addenctypeattr

comando ksetup setenctypeattr

comando ksetup delenctypeattr


ksetup listrealmflags
Artigo • 17/04/2023

Lista os sinalizadores de realm disponíveis que podem ser relatados pelo ksetup.

Sintaxe

ksetup /listrealmflags

Comentários
Os sinalizadores de realm especificam recursos adicionais de um realm do
Kerberos que não são baseados no sistema operacional do Windows Server. Os
computadores que executam o Windows Server podem usar um servidor do
Kerberos para administrar a autenticação no realm do Kerberos, em vez de usar
um domínio que executa um sistema operacional do Windows Server. Essa entrada
estabelece os recursos do realm e são os seguintes:

Valor Sinalizador Descrição


de realm

0xF Tudo Todos os sinalizadores de realm estão definidos.

0x00 Nenhum Nenhum sinalizador de realm está definido, e não há recursos adicionais
habilitados.

0x01 sendaddress O endereço IP será incluído nos tíquetes de concessão de tíquetes.

0x02 tcpsupported Há suporte nesse realm para o protocolo TCP e o protocolo UDP.

0x04 delegado Todos nesse realm são confiáveis para delegação.

0x08 ncsupported Esse realm dá suporte à canonicalização de nomes, o que permite


padrões de nomenclatura DNS e realm.

0x80 rc4 Esse realm dá suporte à criptografia RC4 para habilitar a confiança entre
realms, o que permite o uso do TLS.

Os sinalizadores de realm são armazenados no registro em


HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\Kerberos\Domains\
<realmname> . Essa entrada não existe no registro por padrão. Você pode usar o

comando ksetup addrealmflags para preencher o registro.

Exemplos
Para listar os sinalizadores de realm conhecidos nesse computador, digite:

ksetup /listrealmflags

Para definir os sinalizadores de realm disponíveis que o ksetup não conhece, digite:

ksetup /setrealmflags CORP.CONTOSO.COM sendaddress tcpsupported delete


ncsupported

-OU-

ksetup /setrealmflags CORP.CONTOSO.COM 0xF

Links relacionados
Chave da sintaxe de linha de comando

Comando ksetup

Comando ksetup addrealmflags

Comando ksetup setrealmflags

Comando ksetup delrealmflags


ksetup mapuser
Artigo • 11/04/2023

Mapeia o nome de uma entidade de segurança Kerberos para uma conta.

Sintaxe

ksetup /mapuser <principal> <account>

Parâmetros

Parâmetro Descrição

<principal> Especifica o nome de domínio totalmente qualificado de qualquer usuário da


entidade de segurança. Por exemplo, mike@corp.CONTOSO.COM. Se você não
especificar um parâmetro de conta, o mapeamento será excluído para a entidade
de segurança especificada.

<account> Especifica qualquer nome de conta ou grupo de segurança existente neste


computador, como Convidado, Usuários de Domínio ou Administrador. Se esse
parâmetro for omitido, o mapeamento será excluído para a entidade de segurança
especificada.

Comentários
Uma conta pode ser identificada especificamente, como Convidados do Domínio,
ou você pode usar um caractere curinga (*) para incluir todas as contas.

O computador autentica apenas as entidades de segurança do realm especificado


se eles apresentarem tíquetes Kerberos válidos.

Sempre que forem feitas alterações no KDC (Centro de Distribuição de Chaves)


externo e na configuração do realm, será necessária uma reinicialização do
computador em que a configuração foi alterada.

Exemplos
Para ver as configurações mapeadas atuais e o realm padrão, digite:
ksetup

Para mapear a conta de Mike Danseglio no realm CONTOSO do Kerberos para a conta
de convidado neste computador, concedendo a ele todos os privilégios de um membro
da conta de convidado interna sem precisar se autenticar neste computador, digite:

ksetup /mapuser mike@corp.CONTOSO.COM guest

Para remover o mapeamento da conta de Mike Danseglio para a conta de convidado


neste computador para impedir que ele se autentique neste computador com suas
credenciais da CONTOSO, digite:

ksetup /mapuser mike@corp.CONTOSO.COM

Para mapear a conta de Mike Danseglio dentro do realm Kerberos CONTOSO para
qualquer conta existente neste computador, digite:

ksetup /mapuser mike@corp.CONTOSO.COM *

7 Observação

Se apenas as contas de Usuário Padrão e Convidado estiverem ativas neste


computador, os privilégios de Mike serão definidos para elas.

Para mapear todas as contas dentro do realm Kerberos CONTOSO para qualquer conta
existente com o mesmo nome neste computador, digite:

ksetup /mapuser * *

Links relacionados
Chave da sintaxe de linha de comando
comando ksetup
ksetup removerealm
Artigo • 17/04/2023

Exclui todas as informações do realm especificado a partir do registro.

O nome de realm é armazenado no registro em


HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\Kerberos e
HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\Lsa\Kerberos . Essa entrada não

existe no registro por padrão. Você pode usar o comando ksetup addrealmflags para
preencher o registro.

) Importante

Você não pode remover o nome de realm padrão do controlador de domínio


porque isso redefine suas informações de DNS e porque o remover pode tornar o
controlador de domínio inutilizável.

Sintaxe

ksetup /removerealm <realmname>

Parâmetros

Parâmetro Descrição

<realmname> Especifica o nome DNS em letra maiúscula, como CORP.CONTOSO.COM e é listado


como o realm padrão ou Realm= quando ksetup for executado.

Exemplos
Para remover um nome de realm incorreto (.CON em vez de .COM) do computador
local, digite:

ksetup /removerealm CORP.CONTOSO.CON


Para verificar a remoção, você pode executar o comando ksetup e analisar a saída.

Links relacionados
Chave da sintaxe de linha de comando

Comando ksetup

Comando ksetup setrealm


ksetup server
Artigo • 12/04/2023

Permite especificar um nome para um computador que executa o sistema operacional


Windows. Portanto, as alterações feitas pelo comando ksetup atualizam o computador
de destino.

O nome do servidor de destino é armazenado no registro em


HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\LSA\Kerberos . Essa entrada não é

relatada quando você executa o comando ksetup.

) Importante

Não é possível remover o nome do servidor de destino. Em vez disso, você pode
alterá-lo novamente para o nome do computador local, que é o padrão.

Sintaxe

ksetup /server <servername>

Parâmetros

Parâmetro Descrição

<servername> Especifica o nome completo do computador no qual a configuração será


implementada, como IPops897.corp.contoso.com.

Se um nome de computador de domínio totalmente qualificado incompleto for


especificado, o comando falhará.

Exemplos
Para que as configurações do ksetup sejam implementadas no computador IPops897,
que está conectado no domínio contoso, digite:

ksetup /server IPops897.corp.contoso.com


Links relacionados
Chave da sintaxe de linha de comando

comando ksetup
ksetup setcomputerpassword
Artigo • 17/04/2023

Define a senha do computador local. Esse comando afeta apenas a conta do


computador e requer uma reinicialização para que a alteração de senha entre em vigor.

) Importante

A senha da conta de computador não é exibida no Registro ou como saída do


comando ksetup.

Sintaxe

ksetup /setcomputerpassword <password>

Parâmetros

Parâmetro Descrição

<password> Especifica a senha fornecida para definir a conta do computador no computador


local. A senha só pode ser definida usando uma conta com privilégios
administrativos, e a senha deve ser de 1 a 156 caracteres alfanuméricos ou
especiais.

Exemplos
Para alterar a senha da conta de computador no computador local de IPops897 para
IPop$897!, digite:

ksetup /setcomputerpassword IPop$897!

Links relacionados
Chave da sintaxe de linha de comando
comando ksetup
ksetup setenctypeattr
Artigo • 17/04/2023

Remove o atributo de tipo de criptografia do domínio. Uma mensagem de status é


exibida após a conclusão bem-sucedida ou com falha.

Você pode exibir o tipo de criptografia para o TGT (tíquete de concessão de tíquete)
Kerberos e a chave da sessão executando o comando klist e exibindo a saída. É possível
definir o domínio ao qual se conectar e usar executando o comando ksetup /domain
<domainname> .

Sintaxe

ksetup /setenctypeattr <domainname> {DES-CBC-CRC | DES-CBC-MD5 | RC4-HMAC-


MD5 | AES128-CTS-HMAC-SHA1-96 | AES256-CTS-HMAC-SHA1-96}

Parâmetros

Parâmetro Descrição

<domainname> Nome do domínio ao qual você deseja estabelecer uma conexão. Use o nome do
domínio totalmente qualificado ou uma forma simples do nome, como
corp.contoso.com ou contoso.

encryption Deve ser um dos seguintes tipos de criptografia com suporte:


type DES-CBC-CRC
DES-CBC-MD5
RC4-HMAC-MD5
AES128-CTS-HMAC-SHA1-96
AES256-CTS-HMAC-SHA1-96

Comentários
Você pode definir ou adicionar vários tipos de criptografia separando os tipos de
criptografia no comando com um espaço. No entanto, você só pode fazer isso
para um domínio por vez.

Exemplos
Para exibir o tipo de criptografia para o TGT (tíquete de concessão de tíquete) do
Kerberos e a chave de sessão, digite:

klist

Para definir o domínio como corp.contoso.com, digite:

ksetup /domain corp.contoso.com

Para definir o atributo de tipo de criptografia como AES-256-CTS-HMAC-SHA1-96 para


o corp.contoso.com de domínio, digite:

ksetup /setenctypeattr corp.contoso.com AES-256-CTS-HMAC-SHA1-96

Para verificar se o atributo de tipo de criptografia foi definido conforme o esperado para
o domínio, digite:

ksetup /getenctypeattr corp.contoso.com

Links relacionados
Chave da sintaxe de linha de comando

comando klist

Comando ksetup

comando ksetup domain

comando ksetup addenctypeattr

comando ksetup getenctypeattr

comando ksetup delenctypeattr


ksetup setrealm
Artigo • 17/04/2023

Define o nome de um realm Kerberos.

) Importante

Não há suporte para a configuração do realm Kerberos em um controlador de


domínio. Tentar fazer isso causa um aviso e uma falha de comando.

Sintaxe

ksetup /setrealm <DNSdomainname>

Parâmetros

Parâmetro Descrição

<DNSdomainname> Especifica o nome DNS em letra maiúscula, como CORP. CONTOSO.COM. Você
pode usar o nome de domínio totalmente qualificado ou uma forma simples
do nome. Se você não usar maiúsculas para o nome DNS, receberá uma
solicitação para a continuação da verificação.

Exemplos
Para definir o realm deste computador a um nome de domínio específico e restringir o
acesso por um controlador que não seja de domínio apenas para o realm Kerberos
CONTOSO, digite:

ksetup /setrealm CONTOSO

Links relacionados
Chave da sintaxe de linha de comando
comando ksetup

ksetup removerealm
ksetup setrealmflags
Artigo • 12/04/2023

Define os sinalizadores do realm especificado.

Sintaxe

ksetup /setrealmflags <realmname> [sendaddress] [tcpsupported] [delegate]


[ncsupported] [rc4]

Parâmetros

Parâmetro Descrição

<realmname> Especifica o nome DNS em letra maiúscula, como CORP. CONTOSO.COM.

Comentários
Os sinalizadores de realm especificam recursos adicionais de um realm do
Kerberos que não são baseados no sistema operacional do Windows Server. Os
computadores que executam o Windows Server podem usar um servidor do
Kerberos para administrar a autenticação no realm do Kerberos, em vez de usar
um domínio que executa um sistema operacional do Windows Server. Essa entrada
estabelece os recursos do realm e são os seguintes:

Valor Sinalizador Descrição


de realm

0xF Tudo Todos os sinalizadores de realm estão definidos.

0x00 Nenhum Nenhum sinalizador de realm está definido e não há recursos adicionais
habilitados.

0x01 sendaddress O endereço IP será incluído nos tíquetes de concessão de tíquetes.

0x02 tcpsupported Há suporte nesse realm para o TCP (protocolo TCP) e o UDP (protocolo
UDP).

0x04 delegado Todos neste realm são confiáveis para delegação.


Valor Sinalizador Descrição
de realm

0x08 ncsupported Esse realm dá suporte à canonicalização de nomes, o que permite


padrões de nomenclatura DNS e realm.

0x80 rc4 Esse realm dá suporte à criptografia RC4 para habilitar a confiança entre
realms, o que permite o uso do TLS.

Os sinalizadores de realm são armazenados no registro em


HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\Kerberos\Domains\

<realmname> . Essa entrada não existe no registro por padrão. Você pode usar o
comando ksetup addrealmflags para preencher o registro.

Você pode conferir os sinalizadores de realm disponíveis e definidos exibindo a


saída de ksetup ou ksetup /dumpstate .

Exemplos
Para listar os sinalizadores de realm disponíveis e defini-los para o realm CONTOSO,
digite:

ksetup

Para definir dois sinalizadores que não estão definidos no momento, digite:

ksetup /setrealmflags CONTOSO ncsupported delegate

Para verificar se o sinalizador realm está definido, digite ksetup e exiba a saída,
procurando o texto Sinalizadores de realm =. Se o texto não for exibido, significa que o
sinalizador não foi definido.

Links relacionados
Chave da sintaxe de linha de comando

comando ksetup

comando ksetup listrealmflags


comando ksetup addrealmflags

comando ksetup delrealmflags

comando ksetup dumpstate


ktmutil
Artigo • 06/04/2023

Inicia o utilitário Gerenciador de transação do Kernel. Se for usado sem parâmetros,


ktmutil exibirá os subcomandos disponíveis.

Sintaxe

ktmutil list tms


ktmutil list transactions [{TmGUID}]
ktmutil resolve complete {TmGUID} {RmGUID} {EnGUID}
ktmutil resolve commit {TxGUID}
ktmutil resolve rollback {TxGUID}
ktmutil force commit {GUID}
ktmutil force rollback {GUID}
ktmutil forget

Exemplos
Para forçar uma transação Indoubt com GUID 311a9209-03f4-11dc-918f-00188b8f707b
para confirmar, digite:

ktmutil force commit {311a9209-03f4-11dc-918f-00188b8f707b}

Links relacionados
Chave da sintaxe de linha de comando
ktpass
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Configura o nome da entidade do servidor para o host ou serviço nos AD DS (Serviços


de Domínio do Active Directory) e gera um arquivo .keytab que contém a chave secreta
compartilhada do serviço. O arquivo .keytab baseia-se na implementação do protocolo
de autenticação Kerberos pelo MIT (Massachusetts Institute of Technology). A
ferramenta de linha de comando ktpass permite que serviços não Windows que dão
suporte à autenticação Kerberos usem os recursos de interoperabilidade fornecidos pelo
serviço do KDC (Centro de Distribuição de Chaves) Kerberos.

Sintaxe

ktpass
[/out <filename>]
[/princ <principalname>]
[/mapuser <useraccount>]
[/mapop {add|set}] [{-|+}desonly] [/in <filename>]
[/pass {password|*|{-|+}rndpass}]
[/minpass]
[/maxpass]
[/crypto {DES-CBC-CRC|DES-CBC-MD5|RC4-HMAC-NT|AES256-SHA1|AES128-SHA1|All}]
[/itercount]
[/ptype {KRB5_NT_PRINCIPAL|KRB5_NT_SRV_INST|KRB5_NT_SRV_HST}]
[/kvno <keyversionnum>]
[/answer {-|+}]
[/target]
[/rawsalt] [{-|+}dumpsalt] [{-|+}setupn] [{-|+}setpass <password>] [/?
|/h|/help]

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

/out <filename> Especifica o nome do arquivo .keytab da


versão 5 do Kerberos a ser gerado.
Observação: esse é o arquivo .keytab que você
transfere para um computador que não está
executando o sistema operacional Windows e,
em seguida, substitui ou mescla com o arquivo
.keytab existente, /Etc/Krb5.keytab.

/princ <principalname> Especifica o nome da entidade de segurança


no formato
host/computer.contoso.com@CONTOSO.COM.
Aviso: este parâmetro diferencia maiúsculas e
minúsculas.

/mapuser <useraccount> Mapeia o nome da entidade de segurança


Kerberos, que é especificada pelo parâmetro
princ, para a conta de domínio especificada.

/mapop {add|set} Especifica como o atributo de mapeamento é


definido.
Add – adiciona o valor do nome de
usuário local especificado. Esse é o
padrão.
Set – define o valor de criptografia
somente DES (Data Encryption Standard)
para o nome de usuário local
especificado.

{-|+} desonly A criptografia somente DES é definida por


padrão.
+ Define uma conta para criptografia
somente DES.
- Libera a restrição em uma conta para
criptografia somente DES. Importante: o
Windows não dá suporte a DES por
padrão.

/in <filename> Especifica o arquivo .keytab a ser lido de um


computador host que não está executando o
sistema operacional Windows.

/pass {password|*|{-|+}rndpass} Especifica uma senha para o nome da


entidade do usuário especificado pelo
parâmetro princ. Use * para solicitar uma
senha.
Parâmetro Descrição

/minpass Define o comprimento mínimo da senha


aleatória como 15 caracteres.

/maxpass Define o comprimento máximo da senha


aleatória como 256 caracteres.

/crypto {DES-CBC-CRC|DES-CBC-MD5|RC4-HMAC-NT|AES256- Especifica as chaves geradas no arquivo


SHA1|AES128-SHA1|All} keytab:
DES-CBC-CRC – usado para
compatibilidade.
DES-CBC-MD5 – adere mais de perto à
implementação do MIT e é usado para
compatibilidade.
RC4-HMAC-NT – emprega criptografia
de 128 bits.
AES256-SHA1 – emprega criptografia
AES256-CTS-HMAC-SHA1-96.
AES128-SHA1 – emprega criptografia
AES128-CTS-HMAC-SHA1-96.
All – afirma que todos os tipos
criptográficos com suporte podem ser
usados.

Observação: como as configurações padrão


são baseadas em versões mais antigas do MIT,
você sempre deve usar o parâmetro /crypto .

/itercount Especifica a contagem de iteração usada para


a criptografia AES. O padrão ignora itercount
para a criptografia não AES e define a
criptografia AES como 4.096.

/ptype Especifica o tipo de entidade.


{KRB5_NT_PRINCIPAL|KRB5_NT_SRV_INST|KRB5_NT_SRV_HST} KRB5_NT_PRINCIPAL – o tipo de
entidade de segurança geral
(recomendado).
KRB5_NT_SRV_INST – a instância de
serviço do usuário
KRB5_NT_SRV_HST – a instância do
serviço host

/kvno <keyversionnum> Especifica o número da versão da chave. O


valor padrão é 1.
Parâmetro Descrição

/answer {-|+} Define o modo de resposta em segundo


plano:
-As respostas redefinem prompts de
senha automaticamente com NÃO.
+As respostas redefinem prompts de
senha automaticamente com SIM.

/target Define qual controlador de domínio usar. O


padrão é que o controlador de domínio seja
detectado com base no nome da entidade de
segurança. Se o nome do controlador de
domínio não for resolvido, uma caixa de
diálogo solicitará um controlador de domínio
válido.

/rawsalt força ktpass a usar o algoritmo rawsalt ao


gerar a chave. Esse parâmetro é opcional.

{-|+}dumpsalt A saída desse parâmetro mostra o algoritmo


de sal MIT que está sendo usado para gerar a
chave.

{-|+}setupn Define o nome UPN (nome da entidade de


usuário) além do SPN (nome da entidade de
serviço). O padrão é definir ambos no arquivo
.keytab.

{-|+}setpass <password> Define a senha do usuário, quando fornecida.


Se rndpass for usado, uma senha aleatória será
gerada.

/? Exibe a Ajuda para esse comando.

Comentários

Os serviços em execução em sistemas que não estão executando o sistema


operacional Windows podem ser configurados com contas de instância de serviço
no AD DS. Isso permite que qualquer cliente Kerberos se autentique em serviços
que não estão executando o sistema operacional Windows usando KDCs do
Windows.

O parâmetro /princ não é avaliado pelo ktpass e é usado conforme fornecido. Não
há nenhuma verificação para ver se o parâmetro corresponde ao caso exato do
valor do atributo userPrincipalName ao gerar o arquivo Keytab. Distribuições
Kerberos que diferenciam maiúsculas de minúsculas usando esse arquivo Keytab
poderão ter problemas se não houver correspondência de caso exata e podem até
falhar durante a pré-autenticação. Para verificar e recuperar o valor correto do
atributo userPrincipalName de um arquivo de exportação LDifDE. Por exemplo:

ldifde /f keytab_user.ldf /d CN=Keytab


User,OU=UserAccounts,DC=contoso,DC=corp,DC=microsoft,DC=com /p base /l
samaccountname,userprincipalname

Exemplos
Para criar um arquivo .keytab Kerberos para um computador host que não esteja
executando o sistema operacional Windows, mapeie a entidade de segurança para a
conta e defina a senha da entidade de segurança do host.

1. Use o suplemento Usuário e computadores do Active Directory para criar uma


conta de usuário para um serviço em um computador que não esteja executando
o sistema operacional Windows. Por exemplo, crie uma conta com o nome User1.

2. Use o comando ktpass para configurar um mapeamento de identidade para a


conta de usuário digitando:

ktpass /princ host/User1.contoso.com@CONTOSO.COM /mapuser User1 /pass


MyPas$w0rd /out machine.keytab /crypto all /ptype KRB5_NT_PRINCIPAL
/mapop set

7 Observação

Não é possível mapear várias instâncias de serviço para a mesma conta de


usuário.

3. Mescle o arquivo .keytab com o arquivo /Etc/Krb5.keytab em um computador host


que não esteja executando o sistema operacional Windows.

Links relacionados
Chave da sintaxe de linha de comando
label
Artigo • 17/04/2023

Cria, altera ou exclui o rótulo de volume (ou seja, o nome) de um disco. Se for usado
sem parâmetros, o comando label alterará o rótulo de volume atual ou excluirá o rótulo
existente.

Sintaxe

label [/mp] [<volume>] [<label>]

Parâmetros

Parâmetro Descrição

/mp Especifica que o volume deve ser tratado como um ponto de montagem ou como
um nome de volume.

<volume> Especifica uma letra de unidade (seguida por dois-pontos), um ponto de montagem
ou um nome do volume. Se um nome de volume estiver especificado, o parâmetro
/mp será desnecessário.

<label> Especifica o rótulo do volume.

/? Exibe a ajuda no prompt de comando.

Comentários
O Windows exibe o rótulo de volume e o número de série (se houver um) como
parte da listagem de diretórios.

Um rótulo de volume NTFS pode ter até 32 caracteres de comprimento, incluindo


espaços. Os rótulos de volume NTFS retêm e exibem o caso que foi usado na
criação do rótulo.

Exemplos
Para rotular um disco na unidade A que contém informações de vendas de julho, digite:
label a:sales-july

Para exibir e excluir o rótulo atual da unidade C, siga estas etapas:

1. No prompt de comando, digite:

label

Saídas semelhantes à seguinte devem ser exibidas:

Volume in drive C: is Main Disk


Volume Serial Number is 6789-ABCD
Volume label (32 characters, ENTER for none)?

2. Pressione ENTER. A seguinte solicitação deve ser exibida:

Delete current volume label (Y/N)?

3. Pressione Y para excluir o rótulo atual ou N caso queira manter o rótulo existente.

Links relacionados
Chave da sintaxe de linha de comando
list
Artigo • 06/04/2023

Exibe uma lista de discos, de partições em um disco, de volumes em um disco ou de


VHDs.

Sintaxe

list { disk | partition | volume | vdisk }

Parâmetros

Parâmetro Descrição

disk Exibe uma lista de discos e informações sobre eles, como o tamanho, a quantidade
de espaço livre disponível, se o disco é básico ou dinâmico e se o disco usa o estilo
de partição MBR (registro mestre de inicialização) ou GPT (Tabela de partição GUID).

partition Exibe as partições listadas na tabela de partição do disco atual.

volume Exibe uma lista dos volumes básicos e dinâmicos em todos os discos.

vdisk Exibe uma lista dos VHDs anexados e/ou selecionados. Esse comando lista os VHDs
desanexados se eles estiverem selecionados no momento; no entanto, o tipo de
disco é definido como Desconhecido até que o VHD seja anexado. O VHD marcado
com um asterisco (*) tem foco.

Comentários

Ao listar partições em um disco dinâmico, as partições podem não corresponder


aos volumes dinâmicos no disco. Essa discrepância ocorre porque os discos
dinâmicos contêm entradas na tabela de partição para o volume do sistema ou o
volume de inicialização (se houver no disco). Eles também contêm uma partição
que ocupa o restante do disco para reservar o espaço para uso por volumes
dinâmicos.

O objeto marcado com um asterisco (*) tem foco.

Ao listar discos, se um disco estiver ausente, seu número de disco será prefixado
com M. Por exemplo, o primeiro disco ausente é numerado como M0.
Exemplos

list disk
list partition
list volume
list vdisk

Links relacionados
Chave da sintaxe de linha de comando
list providers
Artigo • 11/04/2023

Lista os provedores de cópia de sombra que estão registrados atualmente no sistema.

Sintaxe

list providers

Exemplos
Para listar os provedores de cópia de sombra registrados no momento, digite:

list providers

A saída semelhante às seguintes exibições:

* ProviderID: {b5946137-7b9f-4925-af80-51abd60b20d5}
Type: [1] VSS_PROV_SYSTEM
Name: Microsoft Software Shadow Copy provider 1.0
Version: 1.0.0.7
CLSID: {65ee1dba-8ff4-4a58-ac1c-3470ee2f376a}
1 provider registered.

Links relacionados
Chave da sintaxe de linha de comando
list shadows
Artigo • 11/04/2023

Lista as cópias de sombra persistentes e não persistentes existentes que estão no


sistema.

Sintaxe

list shadows {all | set <setID> | id <shadowID>}

Parâmetros

Parâmetro Descrição

all Lista todas as cópias de sombra.

set <setID> Lista as cópias de sombra que pertencem à ID do Conjunto de Cópias de Sombra
especificada.

id Lista qualquer cópia de sombra com a ID de cópia de sombra especificada.


<shadowID>

Links relacionados
Chave da sintaxe de linha de comando
list writers
Artigo • 17/04/2023

Lista os gravadores que estão no sistema. Se usado sem parâmetros, list exibirá a saída
para list metadata por padrão.

Sintaxe

list writers [metadata | detailed | status]

Parâmetros

Parâmetro Descrição

metadata Lista a identidade e o status dos gravadores e exibe metadados, como detalhes do
componente e arquivos excluídos. Esse é o parâmetro padrão.

detalhado Lista as mesmas informações que metadata, mas também inclui a lista completa de
arquivos para todos os componentes.

status Lista apenas a identidade e o status dos gravadores registrados.

Exemplos
Para listar apenas a identidade e o status dos gravadores, digite:

list writers status

A saída semelhante às seguintes exibições:

Listing writer status ...


* WRITER System Writer
- Status: 5 (VSS_WS_WAITING_FOR_BACKUP_COMPLETE)
- Writer Failure code: 0x00000000 (S_OK)
- Writer ID: {e8132975-6f93-4464-a53e-1050253ae220}
- Instance ID: {7e631031-c695-4229-9da1-a7de057e64cb}
* WRITER Shadow Copy Optimization Writer
- Status: 1 (VSS_WS_STABLE)
- Writer Failure code: 0x00000000 (S_OK)
- Writer ID: {4dc3bdd4-ab48-4d07-adb0-3bee2926fd7f}
- Instance ID: {9e362607-9794-4dd4-a7cd-b3d5de0aad20}
* WRITER Registry Writer
- Status: 1 (VSS_WS_STABLE)
- Writer Failure code: 0x00000000 (S_OK)
- Writer ID: {afbab4a2-367d-4d15-a586-71dbb18f8485}
- Instance ID: {e87ba7e3-f8d8-42d8-b2ee-c76ae26b98e8}
8 writers listed.

Links relacionados
Chave da sintaxe de linha de comando
Carregar metadados
Artigo • 12/04/2023

Carrega um arquivo .cab de metadados antes de importar uma cópia de sombra


transportável ou carrega os metadados do gravador no caso de uma restauração. Se
usado sem parâmetros, o carregar metadados exibe a ajuda no prompt de comando.

Sintaxe

load metadata [<drive>:][<path>]<metadata.cab>

Parâmetros

Parâmetro Descrição

[<drive>:][<path>] Especifica o local do arquivo de metadados.

metadata.cab Especifica o arquivo .cab de metadados a ser carregado.

Comentários
Use o comando import para importar uma cópia de sombra transportável com
base nos metadados especificados por carregar metadados.

Execute esse comando antes do comando begin restore, para carregar os


gravadores e componentes selecionados para a restauração.

Exemplos
Para carregar um arquivo de metadados chamado metafile.cab do local padrão, digite:

load metadata metafile.cab

Links relacionados
Chave da sintaxe de linha de comando

Comando import diskshadow

Comando begin restore


lodctr
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Permite registrar ou salvar o nome do contador de desempenho e as configurações do


registro em um arquivo e designar serviços confiáveis.

Sintaxe

lodctr <filename> [/s:<filename>] [/r:<filename>] [/t:<servicename>]

Parâmetros

Parâmetro Descrição

<filename> Especifica o nome do arquivo de inicialização que registra as configurações de


nome do contador de desempenho e o texto explicativo.

/s: <filename> Especifica o nome do arquivo no qual as configurações do registro do


contador de desempenho e o texto explicativo são salvos.

/r Restaura as configurações do registro de contador e o texto explicativo das


configurações atuais do registro e dos arquivos de desempenho armazenados
em cache relacionados ao registro.

/r: <filename> Especifica o nome do arquivo que restaura as configurações do registro do


contador de desempenho e o texto explicativo.
Aviso: Se você usar esse comando, substituirá todas as configurações do
registro do contador de desempenho e o texto explicativo, substituindo-os
pela configuração definida no arquivo especificado.

/t: <servicename> Indica que o serviço <servicename> é confiável.

/? Exibe a ajuda no prompt de comando.

Comentários
Se as informações fornecidas contiverem espaços, use o texto entre aspas (por
exemplo, “nome do arquivo 1”).

Exemplos
Para salvar as configurações atuais do registro de desempenho e o texto explicativo no
arquivo “perf backup1.txt”, digite:

lodctr /s:"perf backup1.txt"

Links relacionados
Chave da sintaxe de linha de comando
logman
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria e gerencia os logs de Sessão de Rastreamento de Eventos e de Desempenho e dá


suporte a várias funções do Monitor de Desempenho na linha de comando.

Sintaxe

logman [create | query | start | stop | delete| update | import | export |


/?] [options]

Parâmetros

Parâmetro Descrição

logman create Cria um contador, rastreamento, coletor de dados de configuração ou API.

logman query Consulta as propriedades do coletor de dados.

iniciar | Inicia ou interrompe a coleta de dados.


interromper
logman

logman delete Exclui um coletor de dados existente.

logman update Atualiza as propriedades de um coletor de dados existente.

importar | Importa um conjunto de coletores de dados de um arquivo XML ou o exporta


exporta um conjunto de coletores de dados para um arquivo XML.
logman

Links relacionados
Chave da sintaxe de linha de comando
logman create
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria um contador, rastreamento, coletor de dados de configuração ou API.

Sintaxe

logman create <counter | trace | alert | cfg | api> <[-n] <name>> [options]

Parâmetros

Parâmetro Descrição

logman create counter Cria um coletor de dados de contador.

logman create trace Cria um coletor de dados de rastreamento.

logman create alert Cria um coletor de dados de alerta.

logman create cfg Cria um coletor de dados de configuração.

logman create api Cria um coletor de dados de rastreamento de API.

Links relacionados
Chave da sintaxe de linha de comando

Comando logman
logman create alert
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria um coletor de dados de alerta.

Sintaxe

logman create alert <[-n] <name>> [options]

Parâmetros

Parâmetro Descrição

-s <computer name> Execute o comando no computador remoto especificado.

-config <value> Especifica o arquivo de configurações que contém as opções de comando.

[-n] <name> O nome do objeto de destino.

-[-]u <user Especifica o usuário para Executar como. Inserir um * na senha produz um
[password]> prompt para a senha. A senha não é exibida quando você a digita no
prompt de senha.

-m <[start] Muda para iniciar ou parar manualmente em vez de um horário de início ou


[stop] [[start] encerramento agendado.
[stop] [...]]>

-rf <[[hh:]mm:]ss> Executa o coletor de dados no período de tempo especificado.

-b <M/d/yyyy Inicia a coleta de dados no momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Encerra a coleta de dados no momento especificado.


h:mm:ss[AM|PM]>

-si <[[hh:]mm:]ss> Especifica o intervalo de exemplo para os coletores de dados do contador


de desempenho.
Parâmetro Descrição

-o <path|dsn!log> Especifica o arquivo de log de saída ou o DSN e o nome do conjunto de


logs em um banco de dados SQL.

-[-]r Repete o coletor de dados diariamente nos horários de início e


encerramento especificados.

-[-]a Acrescenta um arquivo de log existente.

-[-]ow Substitui um arquivo de log existente.

-[-]v Anexa informações de controle de versão do arquivo ao final do nome do


<nnnnnn|mmddhhmm> arquivo de log.

-[-]rc <task> Executa o comando especificado sempre que o log é fechado.

-[-]max <value> O tamanho máximo do arquivo de log em MB ou o número máximo de


registros para os logs SQL.

-[-]cnf Quando o tempo for especificado, ele cria um arquivo quando esse tempo
<[[hh:]mm:]ss> especificado tiver transcorrido. Quando o tempo não for especificado, ele
cria um arquivo quando o tamanho máximo for excedido.

-y Responde sim a todas as perguntas sem solicitar.

-cf <filename> Especifica os contadores de desempenho da listagem de arquivos a serem


coletados. O arquivo deve conter um nome do contador de desempenho
por linha.

-[-]el Habilita ou desabilita o relatório do Log de Eventos.

-th <threshold Especifica os contadores e seus valores de limite para um alerta.


[threshold
[...]]>

-[-]rdcs <name> Especifica o conjunto de coletores de dados a ser iniciado quando um alerta
é acionado.

-[-]tn <task> Especifica a tarefa a ser executada quando um alerta é acionado.

-[-]targ Especifica os argumentos de tarefa a serem usados com a tarefa


<argument> especificada usando -tn.

/? Exibe uma ajuda contextual.

Comentários
Onde [-] está listado, adicionar um hífen extra (-) nega a opção.
Exemplos
Para criar um novo alerta chamado new_alert, que é acionado quando o contador de
desempenho % Tempo do processador no grupo de contadores Processador(_Total)
excede o valor do contador de 50, digite:

logman create alert new_alert -th \Processor(_Total)\% Processor time>50

7 Observação

O valor de limite definido baseia-se no valor coletado pelo contador, portanto,


neste exemplo, o valor de 50 equivale a 50% de tempo do processador.

Links relacionados
Chave da sintaxe de linha de comando

Comando logman update alert

Comando logman
logman create api
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria um coletor de dados de rastreamento de API.

Sintaxe

logman create api <[-n] <name>> [options]

Parâmetros

Parâmetro Descrição

-s <computer name> Executa o comando no computador remoto especificado.

-config <value> Especifica o arquivo de configurações que contém as opções de comando.

[-n] <name> O nome do objeto de destino.

-f <bin|bincirc> Especifica o formato de log do coletor de dados.

-[-]u <user Especifica o usuário para Executar como. Inserir um * da senha produz um
[password]> prompt que solicita a senha. A senha não é exibida quando você a digita no
prompt de senha.

-m <[start] Alterado para iniciar ou parar manualmente em vez de em uma hora de


[stop] [[start] início ou término agendada.
[stop] [...]]>

-rf <[[hh:]mm:]ss> Executa o coletor de dados no período especificado.

-b <M/d/yyyy Começa a coletar dados na hora especificada.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Encerra a coleta de dados na hora especificada.


h:mm:ss[AM|PM]>

-si <[[hh:]mm:]ss> Especifica o intervalo de amostra para os coletores de dados do contador de


desempenho.
Parâmetro Descrição

-o <path|dsn!log> Especifica o arquivo de log de saída ou o DSN e o nome do conjunto de


logs em um banco de dados SQL.

-[-]r Repete o coletor de dados diariamente nas horas de início e término


especificados.

-[-]a Acrescenta um arquivo de log existente.

-[-]ow Substitui um arquivo de log existente.

-[-]v Anexa informações de controle de versão do arquivo ao final do nome do


<nnnnnn|mmddhhmm> arquivo de log.

-[-]rc <task> Executa o comando especificado sempre que o log é fechado.

-[-]max <value> O tamanho máximo do arquivo de log em MB ou o número máximo de


registros para os logs SQL.

-[-]cnf Quando a hora é especificada, cria um arquivo quando a hora especificada é


<[[hh:]mm:]ss> ultrapassada. Quando a hora não é especificada, cria um arquivo quando o
tamanho máximo é excedido.

-y Responder sim a todas as perguntas sem solicitar.

-mods <path Especifica a lista de módulos dos quais as chamadas à API são registradas.
[path [...]]>

-inapis Especifica a lista de chamadas à API a serem incluídas no registro em log.


<module!api
[module!api
[...]]>

-exapis Especifica a lista de chamadas à API a serem excluídas do registro em log.


<module!api
[module!api
[...]]>

-[-]ano Registrar somente nomes de API (-ano) ou não registrar apenas nomes de
API (-ano).

-[-]recursive Registrar log (-recursivo) ou não registrar APIS (-recursivas) recursivamente


além da primeira camada.

-exe <value> Especifica o caminho completo para um executável para rastreamento de


API.

/? Exibe a ajuda contextual.


Comentários
Onde [-] está listado, adicionar um hífen extra (-) nega a opção.

Exemplos
Para criar um contador de rastreamento de API chamado trace_notepad para o arquivo
executável c:\windows\notepad.exe e colocar os resultados no arquivo c:\notepad.etl,
digite:

logman create api trace_notepad -exe c:\windows\notepad.exe -o


c:\notepad.etl

Para criar um contador de rastreamento de API chamado trace_notepad para o arquivo


executável c:\windows\notepad.exe coletando valores produzidos pelo módulo em
c:\windows\system32\advapi32.dll, digite:

logman create api trace_notepad -exe c:\windows\notepad.exe -mods


c:\windows\system32\advapi32.dll

Para criar um contador de rastreamento de API chamado trace_notepad para o arquivo


executável c:\windows\notepad.exe excluindo a chamada à API TlsGetValue produzida
pelo módulo kernel32.dll, digite:

logman create api trace_notepad -exe c:\windows\notepad.exe -exapis


kernel32.dll!TlsGetValue

Links relacionados
Chave da sintaxe de linha de comando

Comando logman update api

Comando logman
logman create cfg
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria um coletor de dados de configuração.

Sintaxe

logman create cfg <[-n] <name>> [options]

Parâmetros

Parâmetro Descrição

-s <computer name> Executa o comando no computador remoto especificado.

-config <value> Especifica o arquivo de configurações que contém as opções de comando.

[-n] <name> O nome do objeto de destino.

-[-]u <user Especifica o usuário para Executar como. Inserir um * na senha produz uma
[password]> solicitação para a senha. A senha não é exibida quando você a digita no
prompt de senha.

-m <[start] Muda para iniciar ou parar manualmente em vez de em um horário de início


[stop] [[start] ou encerramento agendado.
[stop] [...]]>

-rf <[[hh:]mm:]ss> Executa o coletor de dados no período de tempo especificado.

-b <M/d/yyyy Inicia a coleta de dados no momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Encerra a coleta de dados no momento especificado.


h:mm:ss[AM|PM]>

-si <[[hh:]mm:]ss> Especifica o intervalo de amostra para os coletores de dados do contador de


desempenho.
Parâmetro Descrição

-o <path|dsn!log> Especifica o arquivo de log de saída ou o DSN e o nome do conjunto de


logs em um banco de dados SQL.

-[-]r Repete o coletor de dados diariamente nos horários de início e


encerramento especificados.

-[-]a Acrescenta um arquivo de log existente.

-[-]ow Substitui um arquivo de log existente.

-[-]v Anexa informações de controle de versão do arquivo ao final do nome do


<nnnnnn|mmddhhmm> arquivo de log.

-[-]rc <task> Executa o comando especificado sempre que o log é fechado.

-[-]max <value> O tamanho máximo do arquivo de log em MB ou o número máximo de


registros para os logs SQL.

-[-]cnf Quando o tempo for especificado, cria-se um arquivo quando esse tempo
<[[hh:]mm:]ss> especificado tiver transcorrido. Quando o tempo não for especificado, cria-
se um arquivo quando o tamanho máximo for excedido.

-y Responde sim a todas as perguntas sem solicitar.

-[-]ni Habilita (-ni) ou desabilita a consulta do adaptador de rede (-ni).

-reg <path [path Especifica os valores do registro a serem coletados.


[...]]>

-mgt <query Especifica objetos WMI a serem coletados usando a linguagem de consulta
[query [...]]> SQL.

-ftc <path [path Especifica o caminho completo dos arquivos a serem coletados.
[...]]>

/? Exibe uma ajuda contextual.

Comentários
Onde [-] está listado, adicionar um hífen extra (-) nega a opção.

Exemplos
Para criar um coletor de dados de configuração chamado cfg_log, usando a chave de
registro HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\Currentverion\ , digite:
logman create cfg cfg_log -reg HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
NT\Currentverion\\

Para criar um coletor de dados de configuração chamado cfg_log, que registra todos os
objetos WMI em root\wmi na coluna de banco de dados MSNdis_Vendordriverversion ,
digite:

logman create cfg cfg_log -mgt root\wmi:select * FROM


MSNdis_Vendordriverversion

Links relacionados
Chave da sintaxe de linha de comando

comando logman update cfg

comando logman
logman create counter
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria um coletor de dados do contador.

Sintaxe

logman create counter <[-n] <name>> [options]

Parâmetros

Parâmetro Descrição

-s <computer name> Execute o comando no computador remoto especificado.

-config <value> Especifica o arquivo de configurações que contém as opções de


comando.

[-n] <name> O nome do objeto de destino.

-f Especifica o formato de log para o coletor de dados. O tamanho


<bin|bincirc|csv|tsv|sql> máximo do arquivo de log será limitado a 2 GB se csv for
especificado

-[-]u <user [password]> Especifica o usuário para Executar como. Inserir * para a senha
produz um prompt da senha. A senha não é exibida quando você a
digita no prompt de senha.

-m <[start] [stop] Muda para iniciar ou parar manualmente em vez de uma hora de
[[start] [stop] [...]]> início ou término agendada.

-rf <[[hh:]mm:]ss> Executa o coletor de dados no período de tempo especificado.

-b <M/d/yyyy Começa a coleta de dados no momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Encerra a coleta de dados no momento especificado.


h:mm:ss[AM|PM]>
Parâmetro Descrição

-si <[[hh:]mm:]ss> Especifica o intervalo de exemplo para os coletores de dados do


contador de desempenho.

-o <path|dsn!log> Especifica o arquivo de log de saída ou o DSN e o nome do


conjunto de logs em um banco de dados SQL.

-[-]r Repete o coletor de dados diariamente nos horários de início e


término especificados.

-[-]a Acrescenta um arquivo de log existente.

-[-]ow Substitui um arquivo de log existente.

-[-]v <nnnnnn|mmddhhmm> Anexa informações de controle de versão do arquivo ao final do


nome do arquivo de log.

-[-]rc <task> Executa o comando especificado sempre que o log é fechado.

-[-]max <value> O tamanho máximo do arquivo de log em MB ou o número


máximo de registros para os logs SQL.

-[-]cnf <[[hh:]mm:]ss> Quando o tempo for especificado, crie um novo arquivo quando o
tempo especificado tiver transcorrido. Quando o tempo não for
especificado, crie um novo arquivo quando o tamanho máximo for
excedido.

-y Responde sim a todas as perguntas sem avisar.

-cf <filename> Especifica os contadores de desempenho da listagem de arquivos a


serem coletados. O arquivo deve conter um nome do contador de
desempenho por linha.

-c <path [path [ ]]> Especifica o(s) contador(es) de desempenho a ser(em) coletado(s).

-sc <value> Especifica o número máximo de amostras a serem coletadas com


um coletor de dados do contador de desempenho.

/? Exibe uma ajuda contextual.

Comentários
Onde [-] está listado, adicionar um hífen extra (-) nega a opção.

Exemplos
Para criar um contador chamado perf_log usando o contador de tempo % Processador
da categoria de contador Processador (_Total), digite:
logman create counter perf_log -c \Processor(_Total)\% Processor time

Para criar um contador chamado perf_log usando o contador de tempo % Processador


da categoria de contador Processador (_Total), criando um arquivo de log com um
tamanho máximo de 10 MB e coletando dados por 1 minuto e 0 segundo, digite:

logman create counter perf_log -c \Processor(_Total)\% Processor time -max


10 -rf 01:00

Links relacionados
Chave da sintaxe de linha de comando

comando logman update counter

comando logman
logman create trace
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Crie um coletor de dados de rastreamento de eventos.

Sintaxe

logman create trace <[-n] <name>> [options]

Parâmetros

Parâmetro Descrição

-s <computer name> Executa o comando no computador remoto


especificado.

-config <value> Especifica o arquivo de configurações que contém


as opções de comando.

-ets Envia os comandos para as Sessões de


rastreamento de eventos diretamente sem salvar
ou agendar.

[-n] <name> O nome do objeto de destino.

-f <bin|bincirc> Especifica o formato de log para o coletor de


dados.

-[-]u <user [password]> Especifica o usuário para Executar como. Inserir


um * na senha produz uma solicitação para a
senha. A senha não é exibida quando você a
digita no prompt de senha.

-m <[start] [stop] [[start] [stop] [...]]> Muda para iniciar ou parar manualmente em vez
de em um horário de início ou encerramento
agendado.

-rf <[[hh:]mm:]ss> Executa o coletor de dados no período de tempo


especificado.
Parâmetro Descrição

-b <M/d/yyyy h:mm:ss[AM|PM]> Inicia a coleta de dados no momento


especificado.

-e <M/d/yyyy h:mm:ss[AM|PM]> Encerra a coleta de dados no momento


especificado.

-o <path|dsn!log> Especifica o arquivo de log de saída ou o DSN e o


nome do conjunto de logs em um banco de
dados SQL.

-[-]r Repete o coletor de dados diariamente nos


horários de início e encerramento especificados.

-[-]a Acrescenta um arquivo de log existente.

-[-]ow Substitui um arquivo de log existente.

-[-]v <nnnnnn|mmddhhmm> Anexa informações de controle de versão do


arquivo ao final do nome do arquivo de log.

-[-]rc <task> Executa o comando especificado sempre que o


log é fechado.

-[-]max <value> O tamanho máximo do arquivo de log em MB ou


o número máximo de registros para os logs SQL.

-[-]cnf <[[hh:]mm:]ss> Quando o tempo for especificado, cria-se um


arquivo quando esse tempo especificado tiver
transcorrido. Quando o tempo não for
especificado, cria-se um arquivo quando o
tamanho máximo for excedido.

-y Responde sim a todas as perguntas sem solicitar.

-ct <perf|system|cycle> Especifica o tipo de relógio da Sessão de


rastreamento de eventos.

-ln <logger_name> Especifica o nome do agente para Sessões de


rastreamento de eventos.

-ft <[[hh:]mm:]ss> Especifica o temporizador de liberação da Sessão


de rastreamento de eventos.

-[-]p <provider [flags [level]]> Especifica um único provedor de Rastreamento


de eventos a ser habilitado.

-pf <filename> Especifica um arquivo que lista vários provedores


de Rastreamento de eventos a serem habilitados.
O arquivo deve ser um arquivo de texto que
contenha um provedor por linha.
Parâmetro Descrição

-[-]rt Executa a Sessão de rastreamento de eventos em


tempo real.

-[-]ul Executa a Sessão de Rastreamento de eventos no


usuário.

-bs <value> Especifica o tamanho em kb do buffer da Sessão


de rastreamento de eventos.

-nb <min max> Especifica o número de buffers da Sessão de


rastreamento de eventos.

-mode Especifica o modo do agente da Sessão de


<globalsequence|localsequence|pagedmemory> rastreamento de eventos, incluindo:
Globalsequence: especifica que o
rastreador de eventos deve adicionar um
número de sequência a cada evento
recebido, independentemente de qual
sessão de rastreamento o recebeu.
Localsequence: especifica que o rastreador
de eventos deve adicionar números de
sequência para eventos recebidos em uma
sessão de rastreamento específica. Quando
essa opção for usada, poderão existir
números de sequência duplicados em todas
as sessões, mas eles serão exclusivos em
cada sessão de rastreamento.
Pagedmemory: especifica que o rastreador
de eventos deve usar memória paginada
em vez do pool de memória não paginada
padrão para suas alocações de buffer
internas.

/? Exibe uma ajuda contextual.

Comentários
Onde [-] está listado, adicionar um hífen extra (-) nega a opção.

Exemplos
Para criar um coletor de dados de rastreamento de eventos chamado trace_log, usando
no mínimo 16 e no máximo 256 buffers, com cada buffer tendo 64 kb de tamanho e
colocando os resultados em c:\logfile, digite:
logman create trace trace_log -nb 16 256 -bs 64 -o c:\logfile

Links relacionados
Chave da sintaxe de linha de comando

comando logman update trace

comando logman
logman delete
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exclui um coletor de dados existente.

Sintaxe

logman delete <[-n] <name>> [options]

Parâmetros

Parâmetro Descrição

-s Executa o comando no computador remoto especificado.


<computer
name>

-config Especifica o arquivo de configurações que contém as opções de comando.


<value>

[-n] <name> O nome do objeto de destino.

-ets Envia os comandos para as Sessões de Rastreamento de Eventos diretamente sem


salvar ou agendar.

-[-]u <user Especifica o usuário para Executar como. Inserir um * na senha produz um prompt
[password]> para a senha. A senha não é exibida quando você a digita no prompt de senha.

/? Exibe uma ajuda contextual.

Exemplos
Para excluir o perf_log do coletor de dados, digite:

logman delete perf_log


Links relacionados
Chave da sintaxe de linha de comando

Comando logman
logman import e logman export
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Importa um conjunto de coletores de dados de um arquivo XML ou exporta um


conjunto de coletores de dados para um arquivo XML.

Sintaxe

logman import <[-n] <name> <-xml <name> [options]


logman export <[-n] <name> <-xml <name> [options]

Parâmetros

Parâmetro Descrição

-s Execute o comando no computador remoto especificado.


<computer
name>

-config Especifica o arquivo de configurações que contém as opções de comando.


<value>

[-n] <name> O nome do objeto de destino.

-xml <name> Nome do arquivo XML a ser importado ou exportado.

-ets Envia os comandos para as Sessões de Rastreamento de Eventos diretamente sem


salvar ou agendar.

-[-]u <user Especifica o usuário para Executar como. Inserir um * na senha produz um prompt
[password]> para a senha. A senha não é exibida quando você a digita no prompt de senha.

-y Responde sim a todas as perguntas sem solicitar.

/? Exibe a ajuda contextual.

Exemplos
Para importar o arquivo XML c:\windows\perf_log.xml do computador server_1 como
conjunto de coletores de dados chamado perf_log, digite:

logman import perf_log -s server_1 -xml c:\windows\perf_log.xml

Links relacionados
Chave da sintaxe de linha de comando

comando logman
logman query
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Consulta as propriedades do coletor de dados e do conjunto de coletores de dados.

Sintaxe

logman query [providers|Data Collector Set name] [options]

Parâmetros

Parâmetro Descrição

-s <computer Execute o comando no computador remoto especificado.


name>

-config Especifica o arquivo de configurações que contém as opções de comando.


<value>

[-n] <name> O nome do objeto de destino.

-ets Envia os comandos para as Sessões de Rastreamento de Eventos diretamente


sem salvar ou agendar.

/? Exibe uma ajuda contextual.

Exemplos
Para listar todos os Conjuntos de Coletores de Dados configurados no sistema de
destino, digite:

logman query
Para listar os coletores de dados contidos no Conjunto de Coletores de Dados chamado
perf_log, digite:

logman query perf_log

Para listar todos os provedores disponíveis de coletores de dados no sistema de


destino, digite:

logman query providers

Links relacionados
Chave da sintaxe de linha de comando

comando logman
logman start e logman stop
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

O comando logman start inicia um coletor de dados e define a hora de início como
manual. O comando logman start interrompe um Conjunto de coletores de dados e
define o horário de encerramento como manual.

Sintaxe

logman start <[-n] <name>> [options]


logman stop <[-n] <name>> [options]

Parâmetros

Parâmetro Descrição

-s <computer Execute o comando no computador remoto especificado.


name>

-config Especifica o arquivo de configurações que contém as opções de comando.


<value>

[-n] <name> Especifica o nome do objeto de destino.

-ets Envia os comandos diretamente para as Sessões de rastreamento de eventos


sem salvar nem agendar.

-as Executa a operação solicitada de modo assíncrono.

-? Exibe uma ajuda contextual.

Exemplos
Para iniciar o coletor de dados perf_log, no computador remoto server_1, digite:
logman start perf_log -s server_1

Links relacionados
Chave da sintaxe de linha de comando

comando logman
logman update
Artigo • 10/04/2023

Atualiza um coletor de dados existente.

Sintaxe

logman update <counter | trace | alert | cfg | api> <[-n] <name>> [options]

Parâmetros

Parâmetro Descrição

logman update counter Atualiza um coletor de dados de contador.

logman update alert Atualiza um coletor de dados de alerta.

logman update cfg Atualiza um coletor de dados de configuração.

logman update api Atualiza um coletor de dados de rastreamento de API.

Links relacionados
Chave da sintaxe de linha de comando

Comando logman
logman update alert
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Atualiza as propriedades de um coletor de dados de alerta existente.

Sintaxe

logman update alert <[-n] <name>> [options]

Parâmetros

Parâmetro Descrição

-s <computer name> Execute o comando no computador remoto especificado.

-config <value> Especifica o arquivo de configurações que contém as opções de comando.

[-n] <name> O nome do objeto de destino.

-[-]u <user Especifica o usuário para Executar como. Inserir * para a senha produz um
[password]> prompt da senha. A senha não é exibida quando você a digita no prompt de
senha.

-m <[start] Muda para iniciar ou parar manualmente em vez de uma hora de início ou
[stop] [[start] término agendada.
[stop] [...]]>

-rf <[[hh:]mm:]ss> Executa o coletor de dados no período de tempo especificado.

-b <M/d/yyyy Começa a coleta de dados no momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Encerra a coleta de dados no momento especificado.


h:mm:ss[AM|PM]>

-si <[[hh:]mm:]ss> Especifica o intervalo de exemplo para os coletores de dados do contador


de desempenho.
Parâmetro Descrição

-o <path|dsn!log> Especifica o arquivo de log de saída ou o DSN e o nome do conjunto de


logs em um banco de dados SQL.

-[-]r Repete o coletor de dados diariamente nos horários de início e término


especificados.

-[-]a Acrescenta um arquivo de log existente.

-[-]ow Substitui um arquivo de log existente.

-[-]v Anexa informações de controle de versão do arquivo ao final do nome do


<nnnnnn|mmddhhmm> arquivo de log.

-[-]rc <task> Executa o comando especificado sempre que o log é fechado.

-[-]max <value> O tamanho máximo do arquivo de log em MB ou o número máximo de


registros para os logs SQL.

-[-]cnf Quando o tempo for especificado, crie um novo arquivo quando o tempo
<[[hh:]mm:]ss> especificado tiver transcorrido. Quando o tempo não for especificado, crie
um novo arquivo quando o tamanho máximo for excedido.

-y Responde sim a todas as perguntas sem avisar.

-cf <filename> Especifica os contadores de desempenho da listagem de arquivos a serem


coletados. O arquivo deve conter um nome do contador de desempenho
por linha.

-[-]el Habilita ou desabilita o relatório do Log de Eventos.

-th <threshold Especifique os contadores e seus valores de limite para um alerta.


[threshold
[...]]>

-[-]rdcs <name> Especifica o Conjunto de Coletores de Dados a ser iniciado quando um


alerta é acionado.

-[-]tn <task> Especifica a tarefa a ser executada quando um alerta é acionado.

-[-]targ Especifica os argumentos de tarefa a serem usados com a tarefa


<argument> especificada usando -tn.

/? Exibe uma ajuda contextual.

Comentários
Onde [-] está listado, adicionar um hífen extra (-) nega a opção.
Exemplos
Para atualizar o alerta existente chamado new_alert, definindo o valor limite do contador
% de tempo do processador no grupo de contadores Processador (_Total) para 40%,
digite:

logman update alert new_alert -th \Processor(_Total)\% Processor time>40

Links relacionados
Chave da sintaxe de linha de comando

comando logman create alert

comando logman
logman update api
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Atualiza as propriedades de um coletor de dados de rastreamento de API existente.

Sintaxe

logman update api <[-n] <name>> [options]

Parâmetros

Parâmetro Descrição

-s <computer name> Executa o comando no computador remoto especificado.

-config <value> Especifica o arquivo de configurações que contém as opções de comando.

[-n] <name> O nome do objeto de destino.

-f <bin|bincirc> Especifica o formato de log para o coletor de dados.

-[-]u <user Especifica o usuário para Executar como. Inserir um * da senha produz um
[password]> prompt para a senha. A senha não é exibida quando você a digita no
prompt de senha.

-m <[start] Alterado para iniciar ou parar manualmente em vez de em uma hora de


[stop] [[start] início ou término agendada.
[stop] [...]]>

-rf <[[hh:]mm:]ss> Executa o coletor de dados no período de tempo especificado.

-b <M/d/yyyy Inicia a coleta de dados no momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Encerra a coleta de dados no momento especificado.


h:mm:ss[AM|PM]>

-si <[[hh:]mm:]ss> Especifica o intervalo de exemplo para os coletores de dados do contador


de desempenho.
Parâmetro Descrição

-o <path|dsn!log> Especifica o arquivo de log de saída ou o DSN e o nome do conjunto de


logs em um banco de dados SQL.

-[-]r Repete o coletor de dados diariamente nos horários de início e término


especificados.

-[-]a Acrescenta um arquivo de log existente.

-[-]ow Substitui um arquivo de log existente.

-[-]v Anexa informações de controle de versão do arquivo ao final do nome do


<nnnnnn|mmddhhmm> arquivo de log.

-[-]rc <task> Executa o comando especificado sempre que o log for fechado.

-[-]max <value> O tamanho máximo do arquivo de log em MB ou o número máximo de


registros para os logs SQL.

-[-]cnf Quando o tempo for especificado, ele cria um arquivo quando esse tempo
<[[hh:]mm:]ss> especificado tiver transcorrido. Quando o tempo não for especificado, ele
cria um arquivo quando o tamanho máximo for excedido.

-y Responder sim a todas as perguntas sem solicitar.

-mods <path Especifica a lista de módulos dos quais as chamadas à API serão registradas.
[path [...]]>

-inapis Especifica a lista de chamadas à API a serem incluídas no registro em log.


<module!api
[module!api
[...]]>

-exapis Especifica a lista de chamadas à API a serem excluídas do registro em log.


<module!api
[module!api
[...]]>

-[-]ano Registrar somente nomes de API (-ano) ou não registrar apenas nomes de
API (-ano).

-[-]recursive Registrar log (-recursivo) ou não registrar APIS (recursivas) recursivamente


além da primeira camada.

-exe <value> Especifica o caminho completo para um executável para rastreamento de


API.

/? Exibe uma ajuda contextual.


Comentários
Onde [-] está listado, adicionar um hífen extra (-) nega a opção.

Exemplos
Para atualizar um contador de rastreamento de API existente chamado trace_notepad,
no arquivo executável c:\windows\notepad.exe, excluindo a chamada à API TlsGetValue
produzida pelo módulo kernel32.dll, digite:

logman update api trace_notepad -exe c:\windows\notepad.exe -exapis


kernel32.dll!TlsGetValue

Links relacionados
Chave da sintaxe de linha de comando

comando logman create api

comando logman
logman update cfg
Artigo • 06/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Atualiza as propriedades de um coletor de dados de configuração existente.

Sintaxe

logman update cfg <[-n] <name>> [options]

Parâmetros

Parâmetro Descrição

-s <computer name> Executa o comando no computador remoto especificado.

-config <value> Especifica o arquivo de configurações que contém as opções de comando.

[-n] <name> O nome do objeto de destino.

-[-]u <user Especifica o usuário para Executar como. Inserir um * na senha produz um
[password]> prompt para a senha. A senha não é exibida quando você a digita no
prompt de senha.

-m <[start] Muda para iniciar ou parar manualmente em vez de um horário de início ou


[stop] [[start] encerramento agendado.
[stop] [...]]>

-rf <[[hh:]mm:]ss> Executa o coletor de dados no período de tempo especificado.

-b <M/d/yyyy Inicia a coleta de dados no momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Encerra a coleta de dados no momento especificado.


h:mm:ss[AM|PM]>

-si <[[hh:]mm:]ss> Especifica o intervalo de exemplo para os coletores de dados do contador


de desempenho.
Parâmetro Descrição

-o <path|dsn!log> Especifica o arquivo de log de saída ou o DSN e o nome do conjunto de


logs em um banco de dados SQL.

-[-]r Repete o coletor de dados diariamente nos horários de início e


encerramento especificados.

-[-]a Acrescenta um arquivo de log existente.

-[-]ow Substitui um arquivo de log existente.

-[-]v Anexa informações de controle de versão do arquivo ao final do nome do


<nnnnnn|mmddhhmm> arquivo de log.

-[-]rc <task> Executa o comando especificado sempre que o log é fechado.

-[-]max <value> O tamanho máximo do arquivo de log em MB ou o número máximo de


registros para os logs SQL.

-[-]cnf Quando o tempo for especificado, ele cria um arquivo quando esse tempo
<[[hh:]mm:]ss> especificado tiver transcorrido. Quando o tempo não for especificado, ele
cria um arquivo quando o tamanho máximo for excedido.

-y Responde sim a todas as perguntas sem solicitar.

-[-]ni Habilita (-ni) ou desabilita a consulta do adaptador de rede (-ni).

-reg <path [path Especifica os valores do registro a serem coletados.


[...]]>

-mgt <query Especifica objetos WMI a serem coletados usando a linguagem de consulta
[query [...]]> SQL.

-ftc <path [path Especifica o caminho completo para os arquivos a serem coletados.
[...]]>

/? Exibe uma ajuda contextual.

Comentários
Onde [-] está listado, adicionar um hífen extra (-) nega a opção.

Exemplos
Para atualizar um coletor de dados de configuração chamado cfg_log, para coletar a
chave de registro HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\Currentverion\ ,
digite:
logman update cfg cfg_log -reg HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
NT\Currentverion\

Links relacionados
Chave da sintaxe de linha de comando

Comando logman create cfg

Comando logman
logman update counter
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Atualiza as propriedades de um coletor de dados de contador existente.

Sintaxe

logman update counter <[-n] <name>> [options]

Parâmetros

Parâmetro Descrição

-s <computer name> Execute o comando no computador remoto especificado.

-config <value> Especifica o arquivo de configurações que contém as opções de comando.

[-n] <name> O nome do objeto de destino.

-f <bin|bincirc> Especifica o formato de log para o coletor de dados.

-[-]u <user Especifica o usuário para Executar como. Inserir um * na senha produz uma
[password]> solicitação para a senha. A senha não é exibida quando você a digita no
prompt de senha.

-m <[start] Muda para iniciar ou parar manualmente em vez de em um horário de início


[stop] [[start] ou encerramento agendado.
[stop] [...]]>

-rf <[[hh:]mm:]ss> Executa o coletor de dados no período de tempo especificado.

-b <M/d/yyyy Inicia a coleta de dados no momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Encerra a coleta de dados no momento especificado.


h:mm:ss[AM|PM]>

-si <[[hh:]mm:]ss> Especifica o intervalo de amostra para os coletores de dados do contador de


desempenho.
Parâmetro Descrição

-o <path|dsn!log> Especifica o arquivo de log de saída ou o DSN e o nome do conjunto de


logs em um banco de dados SQL.

-[-]r Repete o coletor de dados diariamente nos horários de início e


encerramento especificados.

-[-]a Acrescenta um arquivo de log existente.

-[-]ow Substitui um arquivo de log existente.

-[-]v Anexa informações de controle de versão do arquivo ao final do nome do


<nnnnnn|mmddhhmm> arquivo de log.

-[-]rc <task> Executa o comando especificado sempre que o log é fechado.

-[-]max <value> O tamanho máximo do arquivo de log em MB ou o número máximo de


registros para os logs SQL.

-[-]cnf Quando o tempo for especificado, crie um novo arquivo quando o tempo
<[[hh:]mm:]ss> especificado tiver transcorrido. Quando o tempo não for especificado, crie
um novo arquivo quando o tamanho máximo for excedido.

-y Responde sim a todas as perguntas sem solicitar.

-cf <filename> Especifica os contadores de desempenho da listagem de arquivos a serem


coletados. O arquivo deve conter um nome do contador de desempenho
por linha.

-c <path [path [ Especifica o(s) contador(es) de desempenho a ser(em) coletado(s).


]]>

-sc <value> Especifica o número máximo de amostras a serem coletadas com um coletor
de dados do contador de desempenho.

/? Exibe uma ajuda contextual.

Comentários
Onde [-] está listado, adicionar um hífen extra (-) nega a opção.

Exemplos
Para criar um contador chamado perf_log usando o contador de tempo % Processador
da categoria de contador Processador (_Total), digite:
logman create counter perf_log -c \Processor(_Total)\% Processor time

Para atualizar um contador existente chamado perf_log, alterando o intervalo de


amostra para 10, o formato de log para CSV e adicionando controle de versão ao nome
do arquivo de log no formato mmddhhmm, digite:

logman update counter perf_log -si 10 -f csv -v mmddhhmm

Links relacionados
Chave da sintaxe de linha de comando

Comando logman create counter

Comando logman
logman update trace
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Atualiza as propriedades de um coletor de dados de rastreamento de evento existente.

Sintaxe

logman update trace <[-n] <name>> [options]

Parâmetros

Parâmetro Descrição

-s <computer name> Executa o comando no computador remoto


especificado.

-config <value> Especifica o arquivo de configurações que contém


as opções de comando.

-ets Envia os comandos para as Sessões de


Rastreamento de Eventos diretamente sem salvar
ou agendar.

[-n] <name> O nome do objeto de destino.

-f <bin|bincirc> Especifica o formato de log para o coletor de


dados.

-[-]u <user [password]> Especifica o usuário para Executar como. Inserir


um * na senha produz uma solicitação para a
senha. A senha não é exibida quando você a
digita no prompt de senha.

-m <[start] [stop] [[start] [stop] [...]]> Muda para iniciar ou parar manualmente em vez
de em um horário de início ou encerramento
agendado.

-rf <[[hh:]mm:]ss> Executa o coletor de dados no período de tempo


especificado.
Parâmetro Descrição

-b <M/d/yyyy h:mm:ss[AM|PM]> Inicia a coleta de dados no momento


especificado.

-e <M/d/yyyy h:mm:ss[AM|PM]> Encerra a coleta de dados no momento


especificado.

-o <path|dsn!log> Especifica o arquivo de log de saída ou o DSN e o


nome do conjunto de logs em um banco de
dados SQL.

-[-]r Repete o coletor de dados diariamente nos


horários de início e encerramento especificados.

-[-]a Acrescenta um arquivo de log existente.

-[-]ow Substitui um arquivo de log existente.

-[-]v <nnnnnn|mmddhhmm> Anexa informações de controle de versão do


arquivo ao final do nome do arquivo de log.

-[-]rc <task> Executa o comando especificado sempre que o


log é fechado.

-[-]max <value> O tamanho máximo do arquivo de log em MB ou


o número máximo de registros para os logs SQL.

-[-]cnf <[[hh:]mm:]ss> Quando o tempo for especificado, cria-se um


arquivo quando esse tempo especificado tiver
transcorrido. Quando o tempo não for
especificado, cria-se um arquivo quando o
tamanho máximo for excedido.

-y Responde sim a todas as perguntas sem solicitar.

-ct <perf|system|cycle> Especifica o tipo de relógio da Sessão de


rastreamento de eventos.

-ln <logger_name> Especifica o nome do agente para Sessões de


rastreamento de eventos.

-ft <[[hh:]mm:]ss> Especifica o temporizador de liberação da Sessão


de rastreamento de eventos.

-[-]p <provider [flags [level]]> Especifica um único provedor de Rastreamento


de eventos a ser habilitado.

-pf <filename> Especifica um arquivo que lista vários provedores


de Rastreamento de eventos a serem habilitados.
O arquivo deve ser um arquivo de texto que
contenha um provedor por linha.
Parâmetro Descrição

-[-]rt Executa a Sessão de rastreamento de eventos em


tempo real.

-[-]ul Executa a Sessão de Rastreamento de eventos no


usuário.

-bs <value> Especifica o tamanho em kb do buffer da Sessão


de rastreamento de eventos.

-nb <min max> Especifica o número de buffers da Sessão de


rastreamento de eventos.

-mode Especifica o modo do agente da Sessão de


<globalsequence|localsequence|pagedmemory> rastreamento de eventos, incluindo:
Globalsequence: especifica que o
rastreador de eventos deve adicionar um
número de sequência a cada evento
recebido, independentemente de qual
sessão de rastreamento o recebeu.
Localsequence: especifica que o rastreador
de eventos deve adicionar números de
sequência para eventos recebidos em uma
sessão de rastreamento específica. Quando
essa opção for usada, poderão existir
números de sequência duplicados em todas
as sessões, mas eles serão exclusivos em
cada sessão de rastreamento.
Pagedmemory: especifica que o rastreador
de eventos deve usar memória paginada
em vez do pool de memória não paginada
padrão para suas alocações de buffer
internas.

/? Exibe uma ajuda contextual.

Comentários
Onde [-] está listado, adicionar um hífen extra (-) nega a opção.

Exemplos
Para atualizar um coletor de dados de rastreamento de eventos existente chamado
trace_log, alterando o tamanho máximo do log para 10 MB, atualizando o formato de
arquivo de log para CSV e acrescentando o controle de versão do arquivo no formato
mmddhhmm, digite:

logman update trace trace_log -max 10 -f csv -v mmddhhmm

Links relacionados
Chave da sintaxe de linha de comando

Comando logman create trace

Comando logman
fazer logoff
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Faz logoff de um usuário de uma sessão em um servidor Host da Sessão da Área de


Trabalho Remota e exclui a sessão.

Sintaxe

logoff [<sessionname> | <sessionID>] [/server:<servername>] [/v]

Parâmetros

Parâmetro Descrição

<sessionname> Especifica o nome da sessão. Essa precisa ser uma sessão ativa.

<sessionID> Especifica a ID numérica que identifica a sessão para o servidor.

/server: <servername> Especifica o servidor Host da Sessão da Área de Trabalho Remota que
contém a sessão cujo usuário você deseja fazer logoff. Se não for
especificado, o servidor no qual você está ativo no momento será usado.

/v Exibe informações sobre as ações sendo executadas.

/? Exibe a ajuda no prompt de comando.

Comentários
Você sempre pode fazer logoff da sessão à qual está conectado no momento. No
entanto, você precisa ter permissão de Controle Total para fazer logoff de usuários
de outras sessões.

Encerrar a sessão de um usuário sem aviso pode resultar em perda de dados na


sessão do usuário. Envie uma mensagem ao usuário usando o comando msg para
avisá-lo antes de realizar essa ação.
Se <sessionID> ou <sessionname> não for especificado, logoff fará logoff do
usuário da sessão atual.

Após ser feito logoff de um usuário, todos os processos são encerrados e a sessão
é excluída do servidor.

Você não pode fazer logoff de um usuário da sessão do console.

Exemplos
Para fazer logoff de um usuário da sessão atual, digite:

logoff

Para fazer logoff de um usuário de uma sessão usando a ID da sessão, por exemplo, a
sessão 12, digite:

logoff 12

Para fazer logoff de um usuário de uma sessão usando o nome da sessão e do servidor,
por exemplo, sessão TERM04 no Server1, digite:

logoff TERM04 /server:Server1

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
lpq
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe o status de uma fila de impressão em um computador com o LPD.

Sintaxe

lpq -S <servername> -P <printername> [-l]

Parâmetros

Parâmetro Descrição

-S Especifica (por nome ou endereço IP) o computador ou dispositivo de


<servername> compartilhamento de impressora que hospeda a fila de impressão do LPD com
um status que você deseja exibir. Esse parâmetro é necessário e deve estar em
letras maiúsculas.

-P Especifica (por nome) a impressora para a fila de impressão com um status que
<Printername> você deseja exibir. Esse parâmetro é necessário e deve estar em letras
maiúsculas.

-l Especifica que você deseja exibir detalhes sobre o status da fila de impressão.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para exibir o status da fila da impressora Laserprinter1 em um host LPD em 10.0.0.45,
digite:

lpq -S 10.0.0.45 -P Laserprinter1


Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos de impressão


lpr
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Envia um arquivo para um computador ou dispositivo de compartilhamento de


impressora com o serviço LPD em preparação para impressão.

Sintaxe

lpr [-S <servername>] -P <printername> [-C <bannercontent>] [-J <jobname>]


[-o | -o l] [-x] [-d] <filename>

Parâmetros

Parâmetro Descrição

-S <servername> Especifica (por nome ou endereço IP) o computador ou dispositivo de


compartilhamento de impressora que hospeda a fila de impressão do LPD
com um status que você deseja exibir. Esse parâmetro é necessário e deve
estar em letras maiúsculas.

-P Especifica (por nome) a impressora para a fila de impressão com um status


<printername> que você deseja exibir. Para localizar o nome da impressora, abra a pasta
Impressoras. Esse parâmetro é necessário e deve estar em letras maiúsculas.

-C Especifica o conteúdo a ser impresso na página da faixa do trabalho de


<bannercontent> impressão. Se você não incluir esse parâmetro, o nome do computador do
qual o trabalho de impressão foi enviado aparecerá na página da faixa. Esse
parâmetro precisa estar em maiúsculas.

-J <jobname> Especifica o nome do trabalho de impressão que será impresso na página da


faixa. Se você não incluir esse parâmetro, o nome do arquivo que está sendo
impresso aparecerá na página da faixa. Esse parâmetro precisa estar em
maiúsculas.

[-o | -o l] Especifica o tipo de arquivo que você deseja imprimir. O parâmetro -o


especifica que você deseja imprimir um arquivo de texto. O parâmetro -o l
especifica que você deseja imprimir um arquivo binário (por exemplo, um
arquivo PostScript).
Parâmetro Descrição

-d Especifica que o arquivo de dados precisa ser enviado antes do arquivo de


controle. Use esse parâmetro se a impressora exigir que o arquivo de dados
seja enviado primeiro. Para obter mais informações, consulte a documentação
da impressora.

-X Especifica que o comando lpr precisa ser compatível com o sistema


operacional Sun Microsystems (conhecido como SunOS) para versões até e
incluindo 4.1.4_u1.

<filename> Especifica (por nome) o arquivo a ser impresso. Este parâmetro é necessário.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para imprimir o arquivo de texto Document.txt na fila da impressora Laserprinter1 em
um host LPD em 10.0.0.45, digite:

lpr -S 10.0.0.45 -P Laserprinter1 -o Document.txt

Para imprimir o arquivo Adobe PostScript PostScript_file.ps na fila da impressora


Laserprinter1 em um host LPD em 10.0.0.45, digite:

lpr -S 10.0.0.45 -P Laserprinter1 -o l PostScript_file.ps

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos de impressão


macfile
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Gerencia servidores, volumes, diretórios e arquivos do Servidor de Arquivos para


Macintosh. Você pode automatizar tarefas administrativas incluindo uma série de
comandos em arquivos em lote e iniciando-os manualmente ou em horários
predeterminados.

Modificar diretórios em volumes acessíveis


para Macintosh
Para alterar o nome, o local, o proprietário, o grupo e as permissões do diretório para
volumes acessíveis para Macintosh.

Sintaxe

macfile directory[/server:\\<computername>] /path:<directory> [/owner:


<ownername>] [/group:<groupname>] [/permissions:<permissions>]

Parâmetros

Parâmetro Descrição

/server: \\<computername> Especifica o servidor no qual alterar um diretório. Se omitida, a


operação será executada no computador local.

/path: <directory> Especifica o caminho para o diretório que você quer alterar. Este
parâmetro é necessário. Observação: O diretório já deve existir; o
uso de macfile directory não criará diretórios.

/owner: <ownername> Altera o proprietário do diretório. Se for omitido, o nome do


proprietário não será alterado.

/group: <groupname> Especifica ou altera o grupo primário do Macintosh associado ao


diretório. Se omitido, o grupo primário permanecerá inalterado.
Parâmetro Descrição

/permissions: <permissions> Define permissões no diretório para o proprietário, para o grupo


primário e para o mundo (todos). Deve ser um número de 11
dígitos, em que o número 1 concede permissão e 0 revoga a
permissão (por exemplo, 11111011000). Se esse parâmetro for
omitido, as permissões permanecerão inalteradas.

/? Exibe a ajuda no prompt de comando.

Posição do dígito de permissões

A posição do dígito de permissões determina qual permissão está definida, incluindo:

Posição Define a Permissão

Primeiro OwnerSeeFiles

Segundo OwnerSeeFolders

Terceiro OwnerMakechanges

Quarto GroupSeeFiles

Quinto GroupSeeFolders

Sexto GroupMakechanges

Sétimo WorldSeeFiles

Oitavo WorldSeeFolders

Nono WorldMakechanges

Décimo O diretório não pode ser renomeado, movido ou excluído.

Décimo primeiro As alterações se aplicam ao diretório atual e a todos os subdiretórios.

Comentários

Se as informações fornecidas contiverem espaços ou caracteres especiais, coloque


o texto entre aspas (por exemplo, " <computer name> ").

Use macfile directory para tornar um diretório existente em um volume acessível


para Macintosh disponível para usuários do Macintosh. O comando macfile
directory não cria diretórios.
Use o Gerenciador de Arquivos, o prompt de comando ou o comando macintosh
new folder para criar um diretório em um volume acessível para Macintosh antes
de usar o comando macfile directory.

Exemplos
Para atribuir as permissões Ver Arquivos, Ver Pastas e Fazer alterações ao proprietário,
defina a permissão Ver pasta para todos os outros usuários e para impedir que o
diretório seja renomeado, movido ou excluído, digite:

macfile directory /path:e:\statistics\may sales /permissions:11111011000

Onde o subdiretório é Vendas de maio, localizado em Estatísticas do volume acessível


para Macintosh, na unidade E:\ do servidor local.

Unir os dados e as bifurcações de recursos de


um arquivo Macintosh
Para especificar o servidor no qual unir arquivos, quem criou o arquivo, o tipo de
arquivo, onde o fork de dados está localizado, onde o fork do recurso está localizado e
onde o arquivo de saída deve estar localizado.

Sintaxe

macfile forkize[/server:\\<computername>] [/creator:<creatorname>] [/type:


<typename>] [/datafork:<filepath>] [/resourcefork:<filepath>] /targetfile:
<filepath>

Parâmetros

Parâmetro Descrição

/server: \\<computername> Especifica o servidor no qual unir arquivos. Se omitida, a operação


será executada no computador local.
Parâmetro Descrição

/creator: <creatorname> Especifica o criador do arquivo. O Explorador de Arquivos do


Macintosh usa a opção de linha de comando /creator para determinar
o aplicativo que criou o arquivo.

/type: <typename> Especifica o tipo de arquivo. O Finder do Macintosh usa a opção de


linha de comando /type para determinar o tipo de arquivo dentro do
aplicativo que criou o arquivo.

/datafork: <filepath> Especifica o local da bifurcação de dados que deve ser unida. Você
pode especificar um caminho remoto.

/resourcefork: <filepath> Especifica o local da bifurcação do recurso que será unido. Você pode
especificar um caminho remoto.

/targetfile: <filepath> Especifica o local do arquivo criado ao unir um fork de dados e um


fork de recurso ou especifica o local do arquivo cujo tipo ou criador
você está alterando. O arquivo deve estar no servidor especificado.
Este parâmetro é necessário.

/? Exibe a ajuda no prompt de comando.

Comentários

Se as informações fornecidas contiverem espaços ou caracteres especiais, coloque


o texto entre aspas (por exemplo, " <computer name> ").

Exemplos
Para criar o arquivo tree_app no volume acessível para Macintosh D:\Release, usando o
fork de recurso C:\Cross\Mac\Appcode e para fazer esse novo arquivo aparecer para
clientes Macintosh como um aplicativo (aplicativos Macintosh usam o tipo APPL) com o
criador (assinatura) definido como MAGNOLIA, digite:

macfile forkize /resourcefork:c:\cross\mac\appcode /type:APPL


/creator:MAGNOLIA /targetfile:D:\Release\tree_app

Para alterar o criador do arquivo para Microsoft Word 5.1, para o arquivo Word.txt no
diretório D:\Word documents\Group files, no servidor \ServerA, digite:
macfile forkize /server:\\ServerA /creator:MSWD /type:TEXT
/targetfile:d:\Word documents\Group files\Word.txt

Alterar a mensagem de entrada e limitar


sessões
Para alterar a mensagem de entrada exibida quando um usuário entrar no servidor do
Servidor de Arquivos para Macintosh e para limitar o número de usuários que podem
usar simultaneamente servidores de arquivo e impressão para Macintosh.

Sintaxe

macfile server [/server:\\<computername>] [/maxsessions:{number |


unlimited}] [/loginmessage:<message>]

Parâmetros

Parâmetro Descrição

/server: \\<computername> Especifica o servidor no qual alterar parâmetros. Se omitida, a


operação será executada no computador local.

/maxsessions: {number | Especifica o número máximo de usuários que podem usar


unlimited} simultaneamente os Servidores de arquivo e impressão para
Macintosh. Se omitida, a configuração maxsessions para o servidor
permanecerá inalterada.

/loginmessage: <message> Altera a mensagem que os usuários do Macintosh veem ao entrar no


servidor do Servidor de Arquivos para Macintosh. O número máximo
de caracteres para a mensagem de entrada é 199. Se omitida, a
mensagem loginmessage para o servidor permanecerá inalterada.
Para remover uma mensagem de entrada existente, inclua o
parâmetro /loginmessage, mas deixe a variável message em branco.

/? Exibe a ajuda no prompt de comando.

Comentários

Se as informações fornecidas contiverem espaços ou caracteres especiais, coloque


o texto entre aspas (por exemplo, " <computer name> ").
Exemplos
Para alterar o número de sessões permitidas do Servidor de Arquivos e Impressão para
Macintosh no servidor local para cinco sessões e adicionar a mensagem de entrada "Sair
do Servidor para Macintosh quando terminar", digite:

macfile server /maxsessions:5 /loginmessage:Sign off from Server for


Macintosh when you are finished

Adicionar, alterar ou remover volumes


acessíveis para Macintosh
Para adicionar, alterar ou remover um volume acessível para Macintosh.

Sintaxe

macfile volume {/add|/set} [/server:\\<computername>] /name:


<volumename>/path:<directory>[/readonly:{true | false}] [/guestsallowed:
{true | false}] [/password:<password>] [/maxusers:{<number>>|unlimited}]
macfile volume /remove[/server:\\<computername>] /name:<volumename>

Parâmetros

Parâmetro Descrição

{/add | /set} Necessário ao adicionar ou alterar um volume acessível para Macintosh.


Adiciona ou altera o volume especificado.

/server: \\ Especifica o servidor no qual adicionar, alterar ou remover um volume.


<computername> Se omitida, a operação será executada no computador local.

/name: <volumename> Obrigatórios. Especifica o nome do volume a ser adicionado, alterado ou


removido.

/path: <directory> Obrigatório e válido somente quando você está adicionando um volume.
Especifica o caminho para o diretório raiz do volume a ser adicionado.
Parâmetro Descrição

/readonly: {true | Especifica se os usuários podem alterar arquivos no volume. Use True
false} para especificar que os usuários não podem alterar arquivos no volume.
Use False para especificar que os usuários podem alterar arquivos no
volume. Se for omitido ao adicionar um volume, as alterações nos
arquivos serão permitidas. Se omitido ao alterar um volume, a
configuração readonly para o volume permanecerá inalterada.

/guestsallowed: {true Especifica se os usuários que fazem logon como convidados podem usar
| false} o volume. Use True para especificar que os convidados podem usar o
volume. Use False para especificar que os convidados não podem usar o
volume. Se for omitido ao adicionar um volume, os convidados poderão
usar o volume. Se omitido ao alterar um volume, a configuração
guestallowed para o volume permanecerá inalterada.

/password: <password> Especifica uma senha que será necessária para acessar o volume. Se for
omitido ao adicionar um volume, nenhuma senha será criada. Se for
omitido ao alterar um volume, a senha permanecerá inalterada.

/maxusers: {<number>> Especifica o número máximo de usuários que podem usar


| unlimited} simultaneamente os arquivos no volume. Se for omitido ao adicionar um
volume, um número ilimitado de usuários poderá usar o volume. Se
omitido ao alterar um volume, o valor maxusers permanecerá inalterado.

/remove Necessário ao remover um volume acessível para Macintosh. remove o


volume especificado.

/? Exibe a ajuda no prompt de comando.

Comentários

Se as informações fornecidas contiverem espaços ou caracteres especiais, coloque


o texto entre aspas (por exemplo, " <computer name> ").

Exemplos

Para criar um volume chamado Estatísticas de Marketing dos EUA no servidor local,
usando o diretório Estatísticas na unidade E e especificar que o volume não pode ser
acessado por convidados, digite:

macfile volume /add /name:US Marketing Statistics /guestsallowed:false


/path:e:\Stats
Para alterar o volume criado acima para ser de somente leitura, para exigir uma senha e
definir o número máximo de usuários como cinco, digite:

macfile volume /set /name:US Marketing Statistics /readonly:true


/password:saturn /maxusers:5

Para adicionar um volume chamado Design de paisagem, no servidor \Magnolia, usando


o diretório trees na unidade E e especificar que o volume pode ser acessado por
convidados, digite:

macfile volume /add /server:\\Magnolia /name:Landscape Design /path:e:\trees

Para remover o volume chamado Relatórios de Vendas no servidor local, digite:

macfile volume /remove /name:Sales Reports

Links relacionados
Chave da sintaxe de linha de comando
makecab
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Empacote os arquivos existentes em um arquivo de gabinete (.cab).

7 Observação

Esse comando é igual ao comando diantz.

Sintaxe

makecab [/v[n]] [/d var=<value> ...] [/l <dir>] <source> [<destination>]


makecab [/v[<n>]] [/d var=<value> ...] /f <directives_file> [...]

Parâmetros

Parâmetro Descrição

<source> Arquivo a ser compactado.

<destination> Nome do arquivo a ser dado ao arquivo compactado. Se omitido, o último


caractere do nome do arquivo de origem será substituído por um
sublinhado (_) e usado como o destino.

/f Um arquivo com diretivas makecab (pode ser repetido).


<directives_file>

/d var= <value> Define a variável com o valor especificado.

/l <dir> Local para colocar o destino (o padrão é o diretório atual).

/v[ <n> ] Defina o nível de detalhamento de depuração (0=none,...,3=full).

/? Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando

Comando diantz

Formato do Microsoft Cabinet


manage-bde
Artigo • 11/04/2023

Ativa ou desativa o BitLocker, especifica os mecanismos de desbloqueio, atualiza os


métodos de recuperação e desbloqueia as unidades de dados protegidas pelo
BitLocker.

7 Observação

Essa ferramenta da linha de comando pode ser usada no lugar do item do Painel
de Controle Criptografia de Unidade de Disco BitLocker.

Sintaxe

manage-bde [-status] [–on] [–off] [–pause] [–resume] [–lock] [–unlock] [–


autounlock] [–protectors] [–tpm]
[–setidentifier] [-forcerecovery] [–changepassword] [–changepin] [–
changekey] [-keypackage] [–upgrade] [-wipefreespace] [{-?|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

manage bde Fornece informações sobre todas as unidades no computador,


status independentemente de serem ou não protegidas pelo BitLocker.

manage bde on Criptografa a unidade e ativa o BitLocker.

manage bde off Descriptografa a unidade e desativa o BitLocker. Todos os protetores de chave
são removidos quando a descriptografia é concluída.

manage bde Pausa a criptografia ou a descriptografia.


pause

manage bde Retoma a criptografia ou a descriptografia.


resume

manage bde Impede o acesso aos dados protegidos pelo BitLocker.


lock
Parâmetro Descrição

manage bde Permite o acesso aos dados protegidos pelo BitLocker com uma senha de
unlock recuperação ou uma chave de recuperação.

manage bde Gerencia o desbloqueio automático das unidades de dados.


autounlock

manage bde Gerencia os métodos de proteção para a chave de criptografia.


protectors

manage bde Configura o TPM (Trusted Platform Module) do computador. Esse comando
tpm não tem suporte em computadores que executam o Windows 8 ou o
win8_server_2. Para gerenciar o TPM nesses computadores, use o snap-in
MMC de Gerenciamento do TPM ou os cmdlets de Gerenciamento do TPM
para Windows PowerShell.

manage bde Define o campo identificador na unidade para o valor especificado na


setidentifier configuração Fornecer identificadores exclusivos para sua organização da
Política de Grupo.

manage-bde Força uma unidade protegida pelo BitLocker para o modo de recuperação na
ForceRecovery reinicialização. Esse comando exclui da unidade todos os protetores de chave
relacionados ao TPM. Quando o computador é reiniciado, somente uma senha
de recuperação ou uma chave de recuperação pode ser usada para
desbloquear a unidade.

manage-bde Modifica a senha de uma unidade de dados.


changepassword

manage-bde Modifica o PIN de uma unidade do sistema operacional.


changepin

manage-bde Modifica a chave de inicialização de uma unidade do sistema operacional.


changekey

manage-bde Gera um pacote de chaves para uma unidade.


KeyPackage

manage-bde Atualiza a versão do BitLocker.


upgrade

manage-bde Apaga o espaço livre em uma unidade.


WipeFreeSpace

-? ou /? Exibe uma pequena Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando

Habilitando o BitLocker usando a linha de comando


manage-bde status
Artigo • 12/04/2023

Fornece informações sobre todas as unidades no computador, independentemente de


serem ou não protegidas pelo BitLocker, incluindo:

Tamanho

Versão do BitLocker

Status de conversão

Porcentagem criptografada

Método de criptografia

Status de proteção

Bloquear status

Campo de identificação

Protetores de chave

Sintaxe

manage-bde -status [<drive>] [-protectionaserrorlevel] [-computername


<name>] [{-?|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

- Faz com que a ferramenta de linha de comando manage-bde envie o


protectionaserrorlevel código de retorno de 0, se o volume estiver protegido, e 1, se o volume
estiver desprotegido, mais comumente usado para scripts em lote para
determinar se uma unidade é protegida pelo BitLocker. Você também
pode usar -p como uma versão abreviada desse comando.
Parâmetro Descrição

-computername Especifica que manage-bde.exe será usado para modificar a proteção do


BitLocker em um computador diferente. Você também pode usar -cn
como uma versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do


BitLocker. Os valores aceitos incluem o nome NetBIOS do computador e
o endereço IP dele.

-? ou /? Exibe uma pequena Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Exemplos
Para exibir o status da unidade C, digite:

manage-bde –status C:

Links relacionados
Chave da sintaxe de linha de comando

comando manage-bde
manage-bde on
Artigo • 12/04/2023

Criptografa a unidade e ativa o BitLocker.

Sintaxe

manage-bde –on <drive> {[-recoverypassword <numericalpassword>]|[-


recoverykey <pathtoexternaldirectory>]|[-startupkey
<pathtoexternalkeydirectory>]|[-certificate]|
[-tpmandpin]|[-tpmandpinandstartupkey <pathtoexternalkeydirectory>]|[-
tpmandstartupkey <pathtoexternalkeydirectory>]|[-password]|[-
ADaccountorgroup <domain\account>]}
[-usedspaceonly][-encryptionmethod
{aes128_diffuser|aes256_diffuser|aes128|aes256}] [-skiphardwaretest] [-
discoveryvolumetype <filesystemtype>] [-forceencryptiontype <type>] [-
removevolumeshadowcopies][-computername <name>]
[{-?|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

-recoverypassword Adiciona um protetor de senha numérica. Você também pode


usar -rp como uma versão abreviada desse comando.

<numericalpassword> Representa a senha de recuperação.

-recoverykey Adiciona um protetor de chave externa para recuperação. Você


também pode usar -rk como uma versão abreviada desse
comando.

<pathtoexternaldirectory> Representa o caminho do diretório para a chave de recuperação.

-startupkey Adiciona um protetor de chave externa para inicialização. Você


também pode usar -sk como uma versão abreviada desse
comando.

<pathtoexternalkeydirectory> Representa o caminho do diretório para a chave de inicialização.


Parâmetro Descrição

-certificate Adiciona um protetor de chave pública para uma unidade de


dados. Você também pode usar -cert como uma versão
abreviada desse comando.

-tpmandpin Adiciona um TPM (Trusted Platform Module) e um protetor de


PIN (número de identificação pessoal) para a unidade do sistema
operacional. Você também pode usar -tp como uma versão
abreviada desse comando.

-tpmandstartupkey Adiciona um TPM e um protetor de chave de inicialização para a


unidade do sistema operacional. Você também pode usar -tsk
como uma versão abreviada desse comando.

-tpmandpinandstartupkey Adiciona um protetor de chave de inicialização, PIN e TPM para


a unidade do sistema operacional. Você também pode usar -tpsk
como uma versão abreviada desse comando.

-password Adiciona um protetor de chave de senha para a unidade de


dados. Você também pode usar -pw como uma versão abreviada
desse comando.

-ADaccountorgroup Adiciona um protetor de identidade baseado em SID para o


volume. O volume será desbloqueado automaticamente se o
usuário ou o computador tiver as credenciais adequadas. Ao
especificar uma conta de computador, acrescente um $ ao nome
do computador e especifique –service para indicar que o
desbloqueio deve ocorrer no conteúdo do servidor BitLocker em
vez do usuário. Você também pode usar -sid como uma versão
abreviada desse comando.

-usedspaceonly Define o modo de criptografia como criptografia Somente


Espaço Usado. As seções do volume contendo o espaço usado
serão criptografadas, mas o espaço livre não será. Se essa opção
não for especificada, todo o espaço usado e o espaço livre no
volume serão criptografados. Você também pode usar -used
como uma versão abreviada desse comando.

-encryptionMethod Configura o algoritmo de criptografia e o tamanho da chave.


Você também pode usar -em como uma versão abreviada desse
comando.

-skiphardwaretest Inicia a criptografia sem um teste de hardware. Você também


pode usar -s como uma versão abreviada desse comando.

-discoveryvolumetype Especifica o sistema de arquivos a ser usado para a unidade de


dados de descoberta. A unidade de dados de descoberta é uma
unidade oculta adicionada a uma unidade de dados removível
formatada em FAT e protegida pelo BitLocker, que contém o
Leitor BitLocker To Go.
Parâmetro Descrição

-forceencryptiontype Força o BitLocker a usar a criptografia de hardware ou software.


Você pode especificar Hardware ou Software como o tipo de
criptografia. Se o parâmetro hardware estiver selecionado, mas a
unidade não der suporte à criptografia de hardware, manage-
bde retornará um erro. Se as configurações da Política de Grupo
proibir o tipo de criptografia especificado, manage-bde
retornará um erro. Você também pode usar -fet como uma
versão abreviada desse comando.

-removevolumeshadowcopies Force a exclusão de Cópias de Sombra de Volume para o


volume. Você não poderá restaurar esse volume usando pontos
de restauração do sistema anteriores depois de executar esse
comando. Você também pode usar -rvsc como uma versão
abreviada desse comando.

<filesystemtype> Especifica quais sistemas de arquivos podem ser usados com


unidades de dados de descoberta: FAT32, padrão ou nenhum.

-computername Especifica que manage-bde está sendo usado para modificar a


proteção do BitLocker em um computador diferente. Você
também pode usar -cn como uma versão abreviada desse
comando.

<name> Representa o nome do computador no qual modificar a


proteção do BitLocker. Valores aceitos incluem o nome NetBIOS
do computador e o endereço IP dele.

-? or /? Exibe uma breve Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Exemplos
Para ativar o BitLocker para a unidade C e adicionar uma senha de recuperação à
unidade, digite:

manage-bde –on C: -recoverypassword

Para ativar o BitLocker para a unidade C, adicione uma senha de recuperação à unidade
e, para salvar uma chave de recuperação para a unidade E, digite:

manage-bde –on C: -recoverykey E:\ -recoverypassword


Para ativar o BitLocker para a unidade C, usando um protetor de chave externa (como
uma chave USB) para desbloquear a unidade do sistema operacional, digite:

manage-bde -on C: -startupkey E:\

) Importante

Esse método será necessário se você estiver usando o BitLocker com computadores
que não têm um TPM.

Para ativar o BitLocker para a unidade de dados E e adicionar um protetor de chave de


senha, digite:

manage-bde –on E: -pw

Para ativar o BitLocker para a unidade do sistema operacional C e usar a criptografia


baseada em hardware, digite:

manage-bde –on C: -fet hardware

Links relacionados
Chave da sintaxe de linha de comando

comando manage-bde off

comando manage-bde pause

comando manage-bde resume

comando manage-bde
manage-bde off
Artigo • 12/04/2023

Descriptografa a unidade e desativa o BitLocker. Todos os protetores de chave são


removidos quando a descriptografia é concluída.

Sintaxe

manage-bde -off [<volume>] [-computername <name>] [{-?|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

<volume> Especifica uma letra de unidade seguida por dois pontos, um caminho GUID de
volume ou um volume montado.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Os valores aceitos incluem o nome NetBIOS do computador e o endereço IP
dele.

-? ou /? Exibe uma pequena Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Exemplos
Para desativar o BitLocker na unidade C, digite:

manage-bde –off C:

Links relacionados
Chave da sintaxe de linha de comando

comando manage-bde on

comando manage-bde pause

comando manage-bde resume

comando manage-bde
manage-bde -pause
Artigo • 11/04/2023

Pausa a criptografia ou descriptografia do BitLocker.

Sintaxe

manage-bde -pause [<volume>] [-computername <name>] [{-?|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

<volume> Especifica uma letra de unidade seguida por dois pontos, um caminho GUID de
volume ou um volume montado.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Os valores aceitos incluem o nome NetBIOS do computador e o endereço IP
dele.

-? ou /? Exibe uma pequena Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Exemplos
Para pausar a criptografia do BitLocker na unidade C, digite:

Output

manage-bde -pause C:

Links relacionados
Chave da sintaxe de linha de comando
comando manage-bde on

comando manage-bde off

comando manage-bde resume

comando manage-bde
manage-bde resume
Artigo • 11/04/2023

Retoma a criptografia ou a descriptografia do BitLocker depois que ela é pausada.

Sintaxe

manage-bde -resume [<drive>] [-computername <name>] [{-?|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Os valores aceitos incluem o nome NetBIOS do computador e o endereço IP
dele.

-? ou /? Exibe uma pequena Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Exemplos
Para retomar a criptografia do BitLocker na unidade C, digite:

manage-bde –resume C:

Links relacionados
Chave da sintaxe de linha de comando
comando manage-bde on

comando manage-bde off

comando manage-bde pause

comando manage-bde
manage-bde lock
Artigo • 12/04/2023

Bloqueia uma unidade protegida pelo BitLocker para impedir o acesso a ela, a menos
que a chave de desbloqueio seja fornecida.

Sintaxe

manage-bde -lock [<drive>] [-computername <name>] [{-?|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Os valores aceitos incluem o nome NetBIOS do computador e o endereço IP
dele.

-? ou /? Exibe uma pequena Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Exemplos
Para bloquear a unidade de dados D, digite:

manage-bde -lock D:

Links relacionados
Chave da sintaxe de linha de comando
comando manage-bde
manage-bde unlock
Artigo • 12/04/2023

Desbloqueia uma unidade protegida pelo BitLocker usando uma senha de recuperação
ou uma chave de recuperação.

Sintaxe

manage-bde -unlock {-recoverypassword -password | -recoverykey


<pathtoexternalkeyfile>} <drive> [-certificate {-cf pathtocertificatefile |
-ct certificatethumbprint} {-pin}] [-password] [-computername <name>] [{-?
|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

-recoverypassword Especifica que uma senha de recuperação será usada para


desbloquear a unidade. Você também pode usar -rp como uma
versão abreviada desse comando. Essa é a chave de recuperação salva
em um arquivo de texto e deve ser gravada exatamente como
mostrado, incluindo traços.

-password Representa a senha de recuperação que pode ser usada para


desbloquear a unidade definida por você ou pelo administrador.

-recoverykey Especifica que um arquivo de chave de recuperação externa será


usado para desbloquear a unidade. Você também pode usar -rk como
uma versão abreviada desse comando. Esse método pesquisa o
arquivo de chave de recuperação .bek salvo em uma unidade USB.

<pathtoexternalkeyfile> Representa o arquivo de chave de recuperação externa, que pode ser


usado para desbloquear a unidade.

<drive> Representa uma letra de unidade seguida de dois-pontos.

-certificate O certificado de usuário local de um certificado BitLocker para


desbloquear o volume está localizado no repositório de certificados
do usuário local. Você também pode usar -cert como uma versão
abreviada desse comando.

-cf Caminho do arquivo de certificado.


<pathtocertificatefile>
Parâmetro Descrição

-ct Impressão digital do certificado que, opcionalmente, pode incluir o


<certificatethumbprint> PIN (-pin).

-password Apresenta um prompt para que a senha desbloqueie o volume. Você


também pode usar -pw como uma versão abreviada desse comando.

-computername Especifica que manage-bde.exe será usado para modificar a proteção


do BitLocker em um computador diferente. Você também pode usar -
cn como uma versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do


BitLocker. Valores aceitos incluem o nome NetBIOS do computador e
o endereço IP dele.

-? or /? Exibe uma breve Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Exemplos
Para desbloquear a unidade E com uma senha, digite:

Prompt de comando do Windows

manage-bde -unlock E: -password

Para desbloquear a unidade E com uma senha de recuperação, digite:

Prompt de comando do Windows

manage-bde -unlock E: -recoverypassword xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-


xxxxxx-xxxxxx-xxxxxx

Para desbloquear a unidade E com um arquivo de chave de recuperação que foi salvo
em uma pasta de backup em outra unidade, digite:

Prompt de comando do Windows

manage-bde -unlock E: -recoverykey F:\Backupkeys\recoverykey.bek

Links relacionados
Chave da sintaxe de linha de comando
comando manage-bde
manage-bde autounlock
Artigo • 12/04/2023

Gerencia o desbloqueio automático das unidades de dados protegidas pelo BitLocker.

Sintaxe

manage-bde -autounlock [{-enable|-disable|-clearallkeys}] <drive> [-


computername <name>] [{-?|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

-enable Habilita o desbloqueio automático de uma unidade de dados.

-disable Desabilita o desbloqueio automático de uma unidade de dados.

-clearallkeys Remove todas as chaves externas armazenadas na unidade do sistema


operacional.

<drive> Representa uma letra de unidade seguida de dois-pontos.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Os valores aceitos incluem o nome NetBIOS do computador e o endereço IP
dele.

-? ou /? Exibe uma pequena Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Exemplos
Para habilitar o desbloqueio automático da unidade de dados E, digite:

manage-bde –autounlock -enable E:


Links relacionados
Chave da sintaxe de linha de comando

comando manage-bde
manage-bde protectors
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019 e Windows Server 2016

Gerencia os métodos de proteção usados para a chave de criptografia do BitLocker.

Sintaxe

manage-bde -protectors [{-get|-add|-delete|-disable|-enable|-adbackup|-


aadbackup}] <drive> [-computername <name>] [{-?|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

-get Exibe todos os métodos de proteção de chave habilitados na unidade e fornece


seu tipo e identificador (ID).

-add Adiciona métodos de proteção de chave conforme especificado usando


parâmetros -add adicionais.

-delete Exclui os métodos de proteção de chave usados pelo BitLocker. Todos os


protetores de chave serão removidos de uma unidade, a menos que os
parâmetros opcionais -delete sejam usados para especificar quais protetores
devem ser excluídos. Quando o último protetor em uma unidade é excluído, a
proteção do BitLocker da unidade é desabilitada para garantir que o acesso aos
dados não seja perdido inadvertidamente.

-disable Desabilita a proteção, o que permitirá que qualquer pessoa acesse dados
criptografados, disponibilizando a chave de criptografia sem segurança na
unidade. Nenhum protetor de chave é removido. A proteção será retomada na
próxima vez que o Windows for inicializado, a menos que os parâmetros -
disable opcionais sejam usados para especificar a contagem de reinicialização.

-enable Habilita a proteção removendo a chave de criptografia não segura da unidade.


Todos os protetores de chave configurados na unidade serão impostos.

-adbackup Faz backup das informações de recuperação da unidade especificada para o AD


DS (Active Directory Domain Services). Acrescente o parâmetro -id e especifique
a ID de uma chave de recuperação específica para fazer backup. O parâmetro -
id é necessário.
Parâmetro Descrição

-aadbackup Faz backup de todas as informações de recuperação da unidade especificada


para o Azure AD (Azure Active Directory). Acrescente o parâmetro -id e
especifique a ID de uma chave de recuperação específica para fazer backup. O
parâmetro -id é necessário.

<drive> Representa uma letra de unidade seguida de dois-pontos.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Os valores aceitos incluem o nome NetBIOS do computador e o endereço IP
dele.

-? or /? Exibe uma pequena ajuda no prompt de comando.

-help ou -h Exibe uma ajuda completa no prompt de comando.

Parâmetros -add adicionais

O parâmetro -add também pode usar esses parâmetros adicionais válidos.

manage-bde -protectors -add [<drive>] [-forceupgrade] [-recoverypassword


<numericalpassword>] [-recoverykey <pathtoexternalkeydirectory>]
[-startupkey <pathtoexternalkeydirectory>] [-certificate {-cf
<pathtocertificatefile>|-ct <certificatethumbprint>}] [-tpm] [-tpmandpin]
[-tpmandstartupkey <pathtoexternalkeydirectory>] [-tpmandpinandstartupkey
<pathtoexternalkeydirectory>] [-password][-adaccountorgroup
<securityidentifier> [-computername <name>]
[{-?|/?}] [{-help|-h}]

Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

-recoverypassword Adiciona um protetor de senha numérico. Você também pode


usar -rp como uma versão abreviada desse comando.

<numericalpassword> Representa a senha de recuperação.

-recoverykey Adiciona um protetor de chave externa para recuperação. Você


também pode usar -rk como uma versão abreviada desse
comando.
Parâmetro Descrição

<pathtoexternalkeydirectory> Representa o caminho do diretório para a chave de recuperação.

-startupkey Adiciona um protetor de chave externa para inicialização. Você


também pode usar -sk como uma versão abreviada desse
comando.

<pathtoexternalkeydirectory> Representa o caminho do diretório para a chave de inicialização.

-certificate Adiciona um protetor de chave pública para uma unidade de


dados. Você também pode usar -cert como uma versão
abreviada desse comando.

-cf Especifica que um arquivo de certificado será usado para


fornecer o certificado de chave pública.

<pathtocertificatefile> Representa o caminho do diretório para o arquivo de certificado.

-ct Especifica que uma impressão digital do certificado será usada


para identificar o certificado de chave pública

<certificatethumbprint> Especifica o valor da propriedade de impressão digital do


certificado que você deseja usar. Por exemplo, o valor da
Impressão digital do certificado de a9 09 50 2d d8 2a e4 14 33
e6 f8 38 86 b0 0d 42 77 a3 2 a 7b deve ser especificado como
a909502dd82ae41433e6f83886b00d4277a32a7b.

-tpmandpin Adiciona um TPM (Trusted Platform Module) e um protetor de


PIN (número de identificação pessoal) para a unidade do sistema
operacional. Você também pode usar -tp como uma versão
abreviada desse comando.

-tpmandstartupkey Adiciona um TPM e um protetor de chave de inicialização para a


unidade do sistema operacional. Você também pode usar -tsk
como uma versão abreviada desse comando.

-tpmandpinandstartupkey Adiciona um protetor de chave de inicialização, PIN e TPM para


a unidade do sistema operacional. Você também pode usar -tpsk
como uma versão abreviada desse comando.

-password Adiciona um protetor de chave de senha para a unidade de


dados. Você também pode usar -pw como uma versão abreviada
desse comando.
Parâmetro Descrição

-adaccountorgroup Adiciona um protetor de identidade baseado em SID


(identificador de segurança) no volume. Você também pode usar
-sid como uma versão abreviada desse comando. IMPORTANTE:
por padrão, você não pode adicionar um protetor
ADaccountorgroup remotamente usando WMI ou manage-bde.
Se sua implantação exigir a capacidade de adicionar esse
protetor remotamente, você deverá habilitar a delegação restrita.

-computername Especifica que manage-bde está sendo usado para modificar a


proteção do BitLocker em um computador diferente. Você
também pode usar -cn como uma versão abreviada desse
comando.

<name> Representa o nome do computador no qual modificar a


proteção do BitLocker. Os valores aceitos incluem o nome
NetBIOS do computador e o endereço IP dele.

-? or /? Exibe uma pequena ajuda no prompt de comando.

-help ou -h Exibe uma ajuda completa no prompt de comando.

Parâmetros -delete adicionais

manage-bde -protectors -delete <drive> [-type


{recoverypassword|externalkey|certificate|tpm|tpmandstartupkey|tpmandpin|tpm
andpinandstartupkey|Password|Identity}]
[-id <keyprotectorID>] [-computername <name>] [{-?|/?}] [{-help|-h}]

Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

-type Identifica o protetor de chave a ser excluído. Você também pode usar
-t como uma versão abreviada desse comando.

recoverypassword Especifica que todos os protetores de chave de senha de recuperação


devem ser excluídos.

externalkey Especifica que todos os protetores de chave externa associados à


unidade devem ser excluídos.

certificado Especifica que todos os protetores de chave de certificado associados


à unidade devem ser excluídos.
Parâmetro Descrição

tpm Especifica que todos os protetores de chave somente TPM associados


à unidade devem ser excluídos.

tpmandstartupkey Especifica que todos os protetores de chave baseados em chave de


inicialização e TPM associados à unidade devem ser excluídos.

tpmandpin Especifica que todos os protetores de chave baseados em TPM e PIN


associados à unidade devem ser excluídos.

tpmandpinandstartupkey Especifica que todos os protetores de chave baseados em chave de


inicialização, PIN e TPM associados à unidade devem ser excluídos.

password Especifica que todos os protetores de chave de senha associados à


unidade devem ser excluídos.

identidade Especifica que todos os protetores de chave de identidade associados


à unidade devem ser excluídos.

-ID Identifica o protetor de chave a ser excluído usando o identificador de


chave. Esse parâmetro é uma opção alternativa para o parâmetro -
type.

<keyprotectorID> Identifica um protetor de chave individual na unidade a ser excluída.


As IDs do protetor de chave podem ser exibidas usando o comando
manage-bde -protectors -get.

-computername Especifica que manage-bde.exe será usado para modificar a proteção


do BitLocker em um computador diferente. Você também pode usar -
cn como uma versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do


BitLocker. Os valores aceitos incluem o nome NetBIOS do
computador e o endereço IP dele.

-? or /? Exibe uma pequena ajuda no prompt de comando.

-help ou -h Exibe uma ajuda completa no prompt de comando.

Parâmetros -disable adicionais

manage-bde -protectors -disable <drive> [-rebootcount <integer 0 - 15>] [-


computername <name>] [{-?|/?}] [{-help|-h}]

Parâmetro Descrição
Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

rebootcount Especifica que a proteção do volume do sistema operacional foi suspensa e será
retomada depois que o Windows tiver sido reiniciado o número de vezes
especificado no parâmetro rebootcount. Especifique 0 para suspender a
proteção indefinidamente. Se esse parâmetro não for especificado, a proteção
do BitLocker será retomada automaticamente depois que o Windows for
reiniciado. Você também pode usar -rc como uma versão abreviada desse
comando.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Os valores aceitos incluem o nome NetBIOS do computador e o endereço IP
dele.

-? or /? Exibe uma pequena ajuda no prompt de comando.

-help ou -h Exibe uma ajuda completa no prompt de comando.

Exemplos
Para adicionar um protetor de chave de certificado, identificado por um arquivo de
certificado, na unidade E, digite:

manage-bde -protectors -add E: -certificate -cf c:\File Folder\Filename.cer

Para adicionar um protetor de chave adaccountorgroup, identificado pelo nome de


usuário e domínio, na unidade E, digite:

manage-bde -protectors -add E: -sid DOMAIN\user

Para desabilitar a proteção até que o computador seja reinicializado três vezes, digite:

manage-bde -protectors -disable C: -rc 3


Para excluir todos os protetores de chave baseados em chaves de inicialização e TPM na
unidade C, digite:

manage-bde -protectors -delete C: -type tpmandstartupkey

Para listar todos os protetores de chave para a unidade C, digite:

manage-bde -protectors -get C:

Para fazer backup de todas as informações de recuperação da unidade C para o AD DS,


digite (onde -id é a ID do protetor de chave específico para backup):

manage-bde -protectors -adbackup C: -id '{00000000-0000-0000-0000-


000000000000}'

Links relacionados
Chave da sintaxe de linha de comando

manage-bde command
manage-bde tpm
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Configura o TPM (Trusted Platform Module) do computador.

Sintaxe

manage-bde -tpm [-turnon] [-takeownership <ownerpassword>] [-computername


<name>] [{-?|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

-turnon Habilita e ativa o TPM, permitindo que a senha do proprietário do TPM seja
definida. Você também pode usar -t como uma versão abreviada desse
comando.

-takeownership Apropria-se do TPM definindo uma senha de proprietário. Você também pode
usar -o como uma versão abreviada desse comando.

<ownerpassword> Representa a senha de proprietário especificada para o TPM.

-computername Especifica que manage-bde.exe será usado para modificar a proteção do


BitLocker em um computador diferente. Você também pode usar -cn como
uma versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Os valores aceitos incluem o nome NetBIOS do computador e o endereço IP
dele.

-? ou /? Exibe uma pequena Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Exemplos
Para ativar o TPM, digite:
manage-bde tpm -turnon

Para se apropriar do TPM e definir a senha do proprietário como 0wnerP@ss, digite:

manage-bde tpm takeownership 0wnerP@ss

Links relacionados
Chave da sintaxe de linha de comando

Cmdlets de gerenciamento de TPM no Windows PowerShell

comando manage-bde
manage-bde setidentifier
Artigo • 17/04/2023

Define o campo identificador na unidade para o valor especificado na configuração


Fornecer identificadores exclusivos para sua organização da Política de Grupo.

Sintaxe

manage-bde –setidentifier <drive> [-computername <name>] [{-?|/?}] [{-help|-


h}]

Parâmetros

Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Os valores aceitos incluem o nome NetBIOS do computador e o endereço IP
dele.

-? ou /? Exibe uma pequena Ajuda na solicitação de comando.

-help ou -h Exibe uma Ajuda completa na solicitação de comando.

Exemplos
Para definir o campo identificador de unidade do BitLocker para C, digite:

manage-bde –setidentifier C:

Links relacionados
Chave da sintaxe de linha de comando

comando manage-bde

Guia de recuperação do BitLocker


manage-bde forcerecovery
Artigo • 17/04/2023

Força uma unidade protegida pelo BitLocker para o modo de recuperação na


reinicialização. Esse comando exclui todos os protetores de chave relacionados ao TPM
(Trusted Platform Module) da unidade. Quando o computador é reiniciado, somente
uma senha de recuperação ou uma chave de recuperação pode ser usada para
desbloquear a unidade.

Sintaxe

manage-bde –forcerecovery <drive> [-computername <name>] [{-?|/?}] [{-help|-


h}]

Parâmetros

Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Valores aceitos incluem o nome NetBIOS do computador e o endereço IP dele.

-? or /? Exibe uma pequena Ajuda na solicitação de comando.

-help ou -h Exibe uma Ajuda completa na solicitação de comando.

Exemplos
Para fazer com que o BitLocker comece no modo de recuperação na unidade C, digite:

manage-bde –forcerecovery C:
Links relacionados
Chave da sintaxe de linha de comando

Comando manage-bde
manage-bde changepassword
Artigo • 11/04/2023

Modifica a senha de uma unidade de dados. É solicitado que o usuário digite uma nova
senha.

Sintaxe

manage-bde -changepassword [<drive>] [-computername <name>] [{-?|/?}] [{-


help|-h}]

Parâmetros

Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Os valores aceitos incluem o nome NetBIOS do computador e o endereço IP
dele.

-? ou /? Exibe uma pequena Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Exemplos
Para alterar a senha usada para desbloquear o BitLocker na unidade de dados D, digite:

manage-bde –changepassword D:

Links relacionados
Chave da sintaxe de linha de comando

comando manage-bde
manage-bde changepin
Artigo • 12/04/2023

Modifica o PIN de uma unidade do sistema operacional. O usuário é solicitado a inserir


um novo PIN.

Sintaxe

manage-bde -changepin [<drive>] [-computername <name>] [{-?|/?}] [{-help|-


h}]

Parâmetros

Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Os valores aceitos incluem o nome NetBIOS do computador e o endereço IP
dele.

-? ou /? Exibe uma pequena Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Exemplos
Para alterar o PIN usado com o BitLocker na unidade C, digite:

manage-bde –changepin C:

Links relacionados
Chave da sintaxe de linha de comando

comando manage-bde
manage-bde changekey
Artigo • 12/04/2023

Modifica a chave de inicialização de uma unidade do sistema operacional.

Sintaxe

manage-bde -changekey [<drive>] [<pathtoexternalkeydirectory>] [-


computername <name>] [{-?|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Os valores aceitos incluem o nome NetBIOS do computador e o endereço IP
dele.

-? ou /? Exibe uma pequena Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Exemplos
Para criar uma nova chave de inicialização na unidade E, para usar com a criptografia
BitLocker na unidade C, digite:

manage-bde -changekey C: E:\

Links relacionados
Chave da sintaxe de linha de comando

comando manage-bde
manage-bde keypackage
Artigo • 10/04/2023

Gera um pacote de chaves para uma unidade. O pacote de chaves pode ser usado em
conjunto com a ferramenta de reparo para reparar unidades corrompidas.

Sintaxe

manage-bde -keypackage [<drive>] [-ID <keyprotectoryID>] [-path


<pathtoexternalkeydirectory>] [-computername <name>] [{-?|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

-ID Cria um pacote de chaves usando o protetor de chave com o identificador


especificado pelo valor de ID. Dica: use o comando manage-bde –protectors –
get, juntamente com a letra da unidade para a qual deseja criar um pacote de
chaves, para obter uma lista de GUIDs disponíveis a serem usadas como o valor
da ID.

-path Especifica o local onde salvar o pacote de chaves criado.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Valores aceitos incluem o nome NetBIOS do computador e o endereço IP dele.

-? or /? Exibe uma breve Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Exemplos
Para criar um pacote de chaves para a unidade C com base no protetor de chave
identificado pelo GUID e salvar o pacote de chaves em F:\Folder, digite:
manage-bde -keypackage C: -id {84E151C1...7A62067A512} -path f:\Folder

Links relacionados
Chave da sintaxe de linha de comando

Comando manage-bde
manage-bde upgrade
Artigo • 11/04/2023

Atualiza a versão do BitLocker.

Sintaxe

manage-bde -upgrade [<drive>] [-computername <name>] [{-?|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Os valores aceitos incluem o nome NetBIOS do computador e o endereço IP
dele.

-? ou /? Exibe uma pequena Ajuda no prompt de comando.

-help ou -h Exibe uma Ajuda completa no prompt de comando.

Exemplos
Para atualizar a criptografia do BitLocker na unidade C, digite:

manage-bde –upgrade C:

Links relacionados
Chave da sintaxe de linha de comando
comando manage-bde
manage-bde wipefreespace
Artigo • 17/04/2023

Apaga o espaço livre no volume, removendo todos os fragmentos de dados que


possam ter existido no espaço. A execução desse comando em um volume
criptografado usando o método de criptografia Somente Espaço Usado fornece o
mesmo nível de proteção que o método de criptografia Criptografia de Volume Total.

Sintaxe

manage-bde -wipefreespace|-w [<drive>] [-cancel] [-computername <name>] [{-?


|/?}] [{-help|-h}]

Parâmetros

Parâmetro Descrição

<drive> Representa uma letra de unidade seguida de dois-pontos.

-cancel Cancela um apagamento de espaço livre que está em andamento.

- Especifica que manage-bde.exe será usado para modificar a proteção do


computername BitLocker em um computador diferente. Você também pode usar -cn como uma
versão abreviada desse comando.

<name> Representa o nome do computador no qual modificar a proteção do BitLocker.


Valores aceitos incluem o nome NetBIOS do computador e o endereço IP dele.

-? or /? Exibe uma pequena Ajuda na solicitação de comando.

-help ou -h Exibe uma Ajuda completa na solicitação de comando.

Exemplos
Para apagar o espaço livre na unidade C, digite:

manage-bde -w C:
manage-bde -wipefreespace C:

Para cancelar o apagamento do espaço livre na unidade C, digite:

manage-bde -w -cancel C:

manage-bde -wipefreespace -cancel C:

Links relacionados
Chave da sintaxe de linha de comando

Comando manage-bde
mapadmin
Artigo • 11/04/2023

O utilitário de linha de comando mapadmin administra o Mapeamento de Nome de


Usuário no computador local ou remoto que executa o Serviço de NFS da Microsoft. Se
você estiver conectado com uma conta que não tem credenciais administrativas, poderá
especificar um nome de usuário e uma senha de uma conta que tenha.

Sintaxe

mapadmin [<computer>] [-u <user> [-p <password>]]


mapadmin [<computer>] [-u <user> [-p <password>]] {start | stop}
mapadmin [<computer>] [-u <user> [-p <password>]] config <option[...]>
mapadmin [<computer>] [-u <user> [-p <password>]] add -wu <windowsuser> -uu
<UNIXuser> [-setprimary]
mapadmin [<computer>] [-u <user> [-p <password>]] add -wg <windowsgroup> -ug
<UNIXgroup> [-setprimary]
mapadmin [<computer>] [-u <user> [-p <password>]] setprimary -wu
<Windowsuser> [-uu <UNIXuser>]
mapadmin [<computer>] [-u <user> [-p <password>]] setprimary -wg
<Windowsgroup> [-ug <UNIXgroup>]
mapadmin [<computer>] [-u <user> [-p <password>]] delete <option[...]>
mapadmin [<computer>] [-u <user> [-p <password>]] list <option[...]>
mapadmin [<computer>] [-u <user> [-p <password>]] backup <filename>
mapadmin [<computer>] [-u <user> [-p <password>]] restore <filename>
mapadmin [<computer>] [-u <user> [-p <password>]] adddomainmap -d
<Windowsdomain> {-y <<NISdomain>> | -f <path>}
mapadmin [<computer>] [-u <user> [-p <password>]] removedomainmap -d
<Windowsdomain> -y <<NISdomain>>
mapadmin [<computer>] [-u <user> [-p <password>]] removedomainmap -all
mapadmin [<computer>] [-u <user> [-p <password>]] listdomainmaps

Parâmetros

Parâmetro Descrição

<computer> Especifica o computador remoto que executa o serviço Mapeamento de


Nome de Usuário que você deseja administrar. Você pode especificar o
computador usando um nome WINS (Serviço de Cadastramento na Internet
do Windows) ou um nome DNS (Sistema de Nomes de Domínio) ou por
endereço IP (Protocolo IP).
Parâmetro Descrição

-u <user> Especifica o nome de usuário do usuário cujas credenciais devem ser


usadas. Pode ser necessário adicionar o nome de domínio ao nome de
usuário no formato domínio\nome de usuário.

-p <password> Especifica a senha do usuário. Se você especificar a opção -u, mas omitir a
opção -p, será solicitada a senha do usuário.

start | stop Inicia ou interrompe o serviço Mapeamento de Nome de Usuário.

config Especifica as configurações gerais para Mapeamento de Nome de Usuário.


As seguintes opções estão disponíveis com esse parâmetro:
-r <dddd>:<hh>:<mm> : especifica o intervalo de atualização para a
atualização dos bancos de dados Windows e NIS em dias, horas e
minutos. O intervalo mínimo é de 5 minutos.
-i {yes | no} : ativa (sim) ou desativa o mapeamento simples (não).
Por padrão, o mapeamento está ativo.

add Cria um mapeamento para um usuário ou grupo. As seguintes opções


estão disponíveis com esse parâmetro:
-wu <name> : especifica o nome do usuário do Windows para o qual
um novo mapeamento está sendo criado.
-wu <name> : especifica o nome do usuário UNIX para o qual um novo
mapeamento está sendo criado.
-wu <group> : especifica o nome do grupo do Windows para o qual
um novo mapeamento está sendo criado.
-wu <group> : especifica o nome do grupo UNIX para o qual um novo
mapeamento está sendo criado.
-setprimary: especifica que o novo mapeamento é o mapeamento
primário.

setprimary Especifica qual mapeamento é o mapeamento primário para um usuário ou


grupo UNIX com vários mapeamentos. As seguintes opções estão
disponíveis com esse parâmetro:
-wu <name> : especifica o usuário do Windows do mapeamento
primário. Se houver mais de um mapeamento para o usuário, use a
opção -uu para especificar o mapeamento primário.
-uu <name> : especifica o usuário UNIX do mapeamento primário.
-wg <group> : especifica o grupo do Windows do mapeamento
primário. Se houver mais de um mapeamento para o grupo, use a
opção -ug para especificar o mapeamento primário.
-ug <group> : especifica o grupo UNIX do mapeamento primário.
Parâmetro Descrição

excluir Remove o mapeamento de um usuário ou grupo. As seguintes opções


estão disponíveis para esse parâmetro:
-wu <user> : especifica o usuário do Windows para o qual o
mapeamento será excluído, especificado como <windowsdomain>\
<username> .

Você deve especificar a opção -wu ou -uu, ou ambos. Se você


especificar as duas opções, o mapeamento específico identificado
pelas duas opções será excluído. Se você especificar apenas a opção -
wu, todos os mapeamentos para o usuário especificado serão
excluídos.
-uu <user> : especifica o usuário UNIX para o qual o mapeamento
será excluído, especificado como <username> .

Você deve especificar a opção -wu ou -uu, ou ambos. Se você


especificar as duas opções, o mapeamento específico identificado
pelas duas opções será excluído. Se você especificar apenas a opção -
uu, todos os mapeamentos para o usuário especificado serão
excluídos.
-wg <group> : especifica o grupo do Windows para o qual o
mapeamento será excluído, especificado como <windowsdomain>\
<username> .

Você deve especificar a opção -wg ou -ug, ou ambos. Se você


especificar as duas opções, o mapeamento específico identificado
pelas duas opções será excluído. Se você especificar apenas a opção -
wg, todos os mapeamentos para o grupo especificado serão
excluídos.
-ug <group> : especifica o grupo UNIX para o qual o mapeamento
será excluído, especificado como <groupname> .

Você deve especificar a opção -wg ou -ug, ou ambos. Se você


especificar as duas opções, o mapeamento específico identificado
pelas duas opções será excluído. Se você especificar apenas a opção -
ug, todos os mapeamentos para o grupo especificado serão
excluídos.
Parâmetro Descrição

list Exibe informações sobre mapeamentos de usuário e grupo. As seguintes


opções estão disponíveis com esse parâmetro:
-all: lista mapeamentos simples e avançados para usuários e grupos.
-simple: lista todos os usuários e grupos com mapeamento simples.
-advanced: lista todos os usuários e grupos com mapeamentos
avançados. Os mapas são listados na ordem em que são avaliados.
Os mapas primários, marcados com um asterisco (*) são listados
primeiro, seguidos de mapas secundários, que são marcados com um
caractere (^) .
-wu <name> : lista o mapeamento para um usuário do Windows
especificado.
-wg <group> : lista o mapeamento para um grupo do Windows.
-uu <name> : lista o mapeamento para um usuário UNIX.
-ug <group> : lista o mapeamento para um grupo UNIX.

backup Salva a configuração de Mapeamento de Nome de Usuário e os dados de


mapeamento no arquivo especificado por <filename> .

restaurar Substitui dados de configuração e mapeamento por dados do arquivo


(especificado por <filename> ) que foram criados usando o parâmetro
backup.

adddomainmap Adiciona um mapa simples entre um domínio do Windows e um domínio


NIS ou senha e arquivos de grupo. As seguintes opções estão disponíveis
para esse parâmetro:
-d <windowsdomain> : especifica o domínio do Windows a ser
mapeado.
-d <NISdomain> : especifica o domínio do NIS a ser mapeado. Você
precisa usar o parâmetro -n <NISserver> a fim de especificar o
servidor NIS para o domínio do NIS especificado pela opção -y.
-f <path> : especifica o caminho totalmente qualificado do diretório
que contém a senha e os arquivos de grupo a serem mapeados. Os
arquivos precisam estar localizados no computador que está sendo
gerenciado, e você não pode usar mapadmin para gerenciar um
computador remoto a fim de configurar mapas com base em
arquivos de senha e grupo.
Parâmetro Descrição

removedomainmap Remove um mapa simples entre um domínio do Windows e um domínio do


NIS. As seguintes opções e argumento estão disponíveis para esse
parâmetro:
-d <windowsdomain> : especifica o domínio do Windows do mapa a ser
removido.
-y <NISdomain> : especifica o domínio do NIS do mapa a ser
removido.
-all: especifica que todos os mapas simples entre domínios do
Windows e do NIS devem ser removidos. Isso também removerá
todos os mapas simples entre um domínio do Windows e senha e
arquivos de grupo.

listdomainmaps Lista os domínios do Windows mapeados para domínios do NIS ou senha e


arquivos de grupo.

Comentários

Se você não especificar nenhum parâmetro, o comando mapadmin exibirá as


configurações atuais para Mapeamento de Nome de Usuário.

Para todas as opções que especificam um nome de usuário ou grupo, os seguintes


formatos poderão ser usados:

Para usuários do Windows, use os formatos: <domain>\<username> , \\


<computer>\<username> , \<computer>\<username> ou <computer>\<username>

Para grupos do Windows, use os formatos: <domain>\<groupname> , \\


<computer>\<groupname> , \<computer>\<groupname> ou <computer>\<groupname>

Para usuários UNIX, use os formatos: <NISdomain>\<username> ,


<username>@<NISdomain> , <username>@PCNFS ou PCNFS\<username>

Para grupos UNIX, use os formatos: <NISdomain>\<groupname> ,


<groupname>@<NISdomain> , <groupname>@PCNFS ou PCNFS\<groupname>

Links relacionados
Chave da sintaxe de linha de comando
md
Artigo • 11/04/2023

Cria um diretório ou um subdiretório. As extensões de comando, que são habilitadas


por padrão, permitem que você use um único comando md para criar diretórios
intermediários em um caminho especificado.

7 Observação

Esse comando é igual ao comando mkdir.

Sintaxe

md [<drive>:]<path>

Parâmetros

Parâmetro Descrição

<drive> : Especifica a unidade na qual você deseja criar o novo diretório.

<path> Especifica o nome e o local do novo diretório. O comprimento máximo de qualquer


caminho é determinado pelo sistema de arquivos. Esse é um parâmetro necessário.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para criar um diretório chamado Directory1 no diretório atual, digite:

md Directory1

Para criar a árvore de diretórios Taxes\Property\Current dentro do diretório-raiz, com as


extensões de comando habilitadas, digite:
md \Taxes\Property\Current

Para criar a árvore de diretórios Taxes\Property\Current dentro do diretório-raiz como


no exemplo anterior, mas com as extensões de comando desabilitadas, digite a seguinte
sequência de comandos:

md \Taxes
md \Taxes\Property
md \Taxes\Property\Current

Links relacionados
Chave da sintaxe de linha de comando

comando mkdir
merge vdisk
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Mescla um VHD (disco rígido virtual) diferente com seu VHD pai correspondente. O
VHD pai será modificado para incluir as modificações do VHD diferente. Esse comando
modifica o VHD pai. Como resultado, outros VHDs diferentes que dependem do pai não
serão mais válidos.

) Importante

Escolha e desanexe um VHD para que essa operação seja bem-sucedida. Use o
comando select vdisk para selecionar um VHD e mudar o foco para ele.

Sintaxe

merge vdisk depth=<n>

Parâmetros

Parâmetro Descrição

depth= <n> Indica o número de arquivos VHD pai a serem mesclados. Por exemplo, depth=1
indica que o VHD diferente será mesclado com um nível da cadeia de diferenciação.

Exemplos
Para mesclar um VHD de diferenciação com seu VHD pai, digite:

merge vdisk depth=1


Links relacionados
Chave da sintaxe de linha de comando

comando attach vdisk

comando compact vdisk

comando detail vdisk

comando detach vdisk

comando expand vdisk

comando select vdisk

Comando list
mkdir
Artigo • 12/04/2023

Cria um diretório ou um subdiretório. As extensões de comando, que são habilitadas


por padrão, permitem que você use um único comando mkdir para criar diretórios
intermediários em um caminho especificado.

7 Observação

Esse comando é igual ao comando md.

Sintaxe

mkdir [<drive>:]<path>

Parâmetros

Parâmetro Descrição

<drive> : Especifica a unidade na qual você deseja criar o novo diretório.

<path> Especifica o nome e o local do novo diretório. O comprimento máximo de qualquer


caminho é determinado pelo sistema de arquivos. Esse é um parâmetro necessário.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para criar um diretório chamado Directory1 no diretório atual, digite:

mkdir Directory1

Para criar a árvore de diretórios Taxes\Property\Current dentro do diretório-raiz, com as


extensões de comando habilitadas, digite:
mkdir \Taxes\Property\Current

Para criar a árvore de diretórios Taxes\Property\Current dentro do diretório-raiz como


no exemplo anterior, mas com as extensões de comando desabilitadas, digite a seguinte
sequência de comandos:

mkdir \Taxes
mkdir \Taxes\Property
mkdir \Taxes\Property\Current

Links relacionados
Chave da sintaxe de linha de comando

comando md
mklink
Artigo • 17/04/2023

Cria um diretório ou um arquivo simbólico ou link rígido.

Sintaxe

mklink [[/d] | [/h] | [/j]] <link> <target>

Parâmetros

Parâmetro Descrição

/d Cria um link simbólico de diretório. Por padrão, esse comando cria um link
simbólico de arquivo.

/h Cria um link rígido em vez de um link simbólico.

/j Cria uma Junção de Diretório.

<link> Especifica o nome do link simbólico que está sendo criado.

<target> Especifica o caminho (relativo ou absoluto) ao qual o novo link simbólico se refere.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para criar e remover um link simbólico chamado MyFolder do diretório raiz para o
diretório \Users\User1\Documents e um link rígido chamado Myfile.file para o arquivo
example.file localizado no diretório, digite:

mklink /d \MyFolder \Users\User1\Documents


mklink /h \MyFile.file \User1\Documents\example.file
rd \MyFolder
del \MyFile.file
Links relacionados
Chave da sintaxe de linha de comando

comando del

comando rd

New-Item no Windows PowerShell


mmc
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Usando as opções de linha de comando do mmc, você pode abrir um console do mmc
específico, abrir o mmc no modo de autor ou especificar que a versão de 32 bits ou 64
bits do mmc esteja aberta.

Sintaxe

mmc <path>\<filename>.msc [/a] [/64] [/32]

Parâmetros

Parâmetro Descrição

<path>\ inicia o mmc e abre um console salvo. Você precisa especificar o caminho
<filename>.msc completo e o nome do arquivo de console salvo. Se você não especificar um
arquivo de console, o mmc abrirá um novo console.

/a Abre um console salvo no modo de autor. Usado para fazer alterações em


consoles salvos.

/64 Abre a versão de 64 bits do mmc (mmc64). Use essa opção somente se você
estiver executando um sistema operacional da Microsoft de 64 bits e quiser usar
um snap-in de 64 bits.

/32 Abre a versão de 32 bits do mmc (mmc32). Ao executar um sistema operacional


da Microsoft de 64 bits, você pode executar snap-ins de 32 bits abrindo o mmc
com essa opção de linha de comando, quando você tiver snap-ins de somente
32 bits.

Comentários
Você pode usar variáveis de ambiente para criar linhas de comando ou atalhos que
não dependem do local explícito dos arquivos de console. Por exemplo, se o
caminho para um arquivo de console estiver na pasta do sistema (por exemplo,
mmc c:\winnt\system32\console_name.msc), você poderá usar a cadeia de
caracteres de dados expansível %systemroot% para especificar o local
(mmc%systemroot%\system32\console_name.msc). Isso pode ser útil se você
estiver delegando tarefas para pessoas na sua organização que estão trabalhando
em computadores diferentes.

Quando os consoles são abertos usando a opção /a, eles são abertos no modo de
autor, independentemente do modo padrão. Isso não altera permanentemente a
configuração de modo padrão para arquivos. Quando você omite essa opção, o
mmc abre arquivos de console de acordo com as configurações de modo padrão.

Depois de abrir o mmc ou um arquivo de console no modo de autor, você pode


abrir qualquer console existente clicando em Abrir no menu Console.

Você pode usar a linha de comando para criar atalhos para abrir o mmc e os
consoles salvos. Um comando de linha de comando funciona com o comando
Executar no menu Iniciar, em qualquer janela de prompt de comando, em atalhos
ou em qualquer arquivo em lote ou programa que chame o comando.

Links relacionados
Chave da sintaxe de linha de comando
mode
Artigo • 11/04/2023

Ele exibe o status do sistema, altera as configurações do sistema ou reconfigura portas


ou dispositivos. Se usado sem parâmetros, mode exibirá todos os atributos controláveis
do console e dos dispositivos COM disponíveis.

Porta serial
Configura uma porta de comunicação serial e define o handshake de saída.

Sintaxe

mode com<m>[:] [baud=<b>] [parity=<p>] [data=<d>] [stop=<s>] [to={on|off}]


[xon={on|off}] [odsr={on|off}] [octs={on|off}] [dtr={on|off|hs}] [rts=
{on|off|hs|tg}] [idsr={on|off}]

Parâmetros

Parâmetro Descrição

com<m>[:] Especifica o número da porta de comunicação assíncrona Prncnfg.vbshronous.

baud=<b> Especifica a taxa de transmissão em bits por segundo. Os valores válidos incluem:
11 - 110 bauds
15 - 150 bauds
30 - 300 bauds
60 - 600 bauds
12 - 1200 bauds
24 - 2400 bauds
48 - 4800 bauds
96 - 9600 bauds
19 - 19200 bauds
Parâmetro Descrição

parity= Especifica como o sistema usa o bit de paridade para verificar se há erros de
<p> transmissão. Os valores válidos incluem:
n – nenhum
e – par (valor padrão)
o – ímpar
m – marca
s – espaço

Nem todos os dispositivos dão suporte ao uso dos parâmetros m ou s.

data=<d> Especifica o número de bits de dados em um caractere. Os valores válidos variam de


5 a 8. O valor padrão é 7. Nem todos os dispositivos dão suporte aos valores 5 e 6.

stop=<s> Especifica o número de bits de parada que definem o final de um caractere: 1, 1,5ou
2. Se a taxa de transmissão for 110, o valor padrão será 2. Caso contrário, o valor
padrão será 1. Nem todos os dispositivos dão suporte aos valores 1,5.

to={on | Especifica se o dispositivo usa processamento infinito de tempo limite. O valor


off} padrão é off. A ativação dessa opção significa que o dispositivo nunca deixará de
esperar receber uma resposta de um host ou computador cliente.

xon={on | Especifica se o sistema permite o protocolo XON/XOFF. Esse protocolo fornece


off} controle de fluxo de comunicações seriais, que aumenta a confiabilidade, mas reduz
o desempenho.

odsr={on | Especifica se o sistema ativa o handshake de saída DSR (Data Set Ready).
off}

octs={on | Especifica se o sistema ativa o handshake de saída CTS (Clear to Send).


off}

dtr={on | Especifica se o sistema ativa o handshake de saída DTR (Data Terminal Ready). A
off | hs} definição desse valor no modo on fornece um sinal constante para mostrar que o
terminal está pronto para enviar dados. A definição desse valor no modo hs fornece
um sinal de handshake entre os dois terminais.

rts={on | Especifica se o sistema ativa o handshake de saída RTS (Request to Send). A


off | hs | definição desse valor no modo on fornece um sinal constante para mostrar que o
tg} terminal está pronto para enviar dados. A definição desse valor no modo hs fornece
um sinal de handshake entre os dois terminais. A definição desse valor no modo tg
fornece uma maneira de alternar entre estados prontos e não prontos.

idsr={on | Especifica se o sistema ativa a sensibilidade do DSR. Você deve ativar essa opção
off} para usar o handshaking DSR.

/? Exibe a ajuda no prompt de comando.


Status do dispositivo
Exibe o status de um dispositivo especificado. Se usado sem parâmetros, mode exibirá o
status de todos os dispositivos instalados em seu sistema.

Sintaxe

mode [<device>] [/status]

Parâmetros

Parâmetro Descrição

<device> Especifica o nome do dispositivo do qual você pretende mostrar o status. Os nomes
padrão incluem LPT1: a LPT3:, COM1: a COM9:, e CON.

/status Solicita o status de qualquer impressora paralela redirecionada. Você também pode
usar /sta como uma versão abreviada desse comando.

/? Exibe a ajuda no prompt de comando.

Redirecionar impressão
Redireciona a saída da impressora. Você precisa ser membro do grupo Administradores
para redirecionar uma impressão.

7 Observação

Para configurar o sistema e enviar a saída da impressora paralela para uma impressora
serial, você precisará usar o comando mode duas vezes. Na primeira vez, você precisará
usar mode para configurar a porta serial. Na segunda vez, você precisará usar mode a
fim de redirecionar a saída da impressora paralela para a porta serial especificada no
primeiro comando mode.

Sintaxe

mode LPT<n>[:]=COM<m>[:]
Parâmetros

Parâmetro Descrição

LPT <n> [:] Especifica o número do LPT a ser configurado. Normalmente, isso significa fornecer
um valor de LTP1: a LTP3:, a menos que seu sistema inclua suporte especial à porta
paralela. Este parâmetro é necessário.

COM <m> [:] Especifica a porta COM a ser configurada. Normalmente, isso significa fornecer um
valor de COM1: a COM9:, a menos que seu sistema tenha hardware especial para
portas COM adicionais. Este parâmetro é necessário.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para redirecionar uma impressora serial que opera em 4800 bauds com paridade
uniforme e está conectada à porta COM1 (a primeira conexão serial no computador),
digite:

mode com1 48,e,,,b


mode lpt1=com1

Para redirecionar a saída da impressora paralela de LPT1 para COM1 e imprimir um


arquivo usando LPT1, digite o seguinte comando antes de imprimir o arquivo:

mode lpt1

Esse comando impede o redirecionamento do arquivo de LPT1 para COM1.

Selecionar página de código


Configura ou consulta as informações da página de código para um dispositivo
selecionado.

Sintaxe
mode <device> codepage select=<yyy>
mode <device> codepage [/status]

Parâmetros

Parâmetro Descrição

<device> Especifica o dispositivo para o qual você deseja selecionar uma página de código.
CON é o único nome válido para um dispositivo. Este parâmetro é necessário.

codepage Especifica qual página de código usar com o dispositivo especificado. Você
também pode usar cp como uma versão abreviada desse comando. Este
parâmetro é necessário.

select= <yyy> Especifica o número da página de código a ser usada com o dispositivo. As
páginas de código com suporte, por país/região ou idioma, incluem:
437: Estados Unidos
850: Multilíngue (Latino I)
852: Eslavo (Latino II)
855: Cirílico (russo)
857: Turco
860: Português
861: Islandês
863: Francês canadense
865: Nórdico
866: Russo
869: Grego Moderno

Este parâmetro é necessário.

/status Exibe os números das páginas de código atuais selecionadas para o dispositivo
especificado. Você também pode usar /sta como uma versão abreviada desse
comando. Independentemente de você especificar /status, o comando mode
codepage exibirá os números das páginas de código selecionadas para o
dispositivo especificado.

/? Exibe a ajuda no prompt de comando.

Modo de exibição
Altera o tamanho do buffer de tela do prompt de comando

Sintaxe
mode con[:] [cols=<c>] [lines=<n>]

Parâmetros

Parâmetro Descrição

con[:] Indica que a alteração se aplica à janela do Prompt de Comando. Este parâmetro é
necessário.

cols= <c> Especifica o número de colunas no buffer de tela do prompt de comando. A


configuração padrão é 80 colunas, mas você pode definir isso como qualquer valor.
Se você não usar o padrão, os valores típicos serão 40 e 135 colunas. O uso de
valores não padrão pode resultar em problemas no aplicativo de prompt de
comando.

lines= <n> Especifica o número de linhas no buffer de tela do prompt de comando. O valor
padrão é 25, mas você pode definir qualquer valor. Se você não usar o padrão, o
outro valor típico será 50 linhas.

/? Exibe a ajuda no prompt de comando.

Intervalo de digitação
Define o intervalo de digitação do teclado. O intervalo de digitação é a velocidade em
que o Windows pode repetir um caractere quando você pressiona a tecla em um
teclado.

7 Observação

Alguns teclados não reconhecem esse comando.

Sintaxe

mode con[:] [rate=<r> delay=<d>]

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

con[:] Especifica o teclado. Este parâmetro é necessário.

rate= <r> Especifica a taxa na qual um caractere é repetido na tela quando você segura uma
tecla. O valor padrão é 20 caracteres por segundo para teclados compatíveis com
IBM AT e 21 para teclados compatíveis com IBM PS/2, mas você pode usar qualquer
valor de 1 a 32. Se você definir esse parâmetro, também precisará definir o
parâmetro delay.

delay= <d> Especifica a quantidade de tempo decorrido depois que você pressionar e segurar
uma tecla antes que a saída do caractere se repita. O valor padrão é 2 (0,50
segundos), mas você também pode usar 1 (0,25 segundos), 3 (0,75 segundos) ou 4
(1 segundo). Se você definir esse parâmetro, também precisará definir o parâmetro
rate.

/? Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
mais
Artigo • 12/04/2023

Exibe uma tela de saída por vez.

7 Observação

O comando more, com parâmetros diferentes, também está disponível no Console


de Recuperação.

Sintaxe

<command> | more [/c] [/p] [/s] [/t<n>] [+<n>]


more [[/c] [/p] [/s] [/t<n>] [+<n>]] < [<drive>:][<path>]<filename>
more [/c] [/p] [/s] [/t<n>] [+<n>] [<files>]

Parâmetros

Parâmetro Descrição

<command> Especifica um comando para o qual você deseja exibir a saída.

/c Limpa a tela antes de exibir uma página.

/p Expande os caracteres de feed de formulário.

/s Exibe várias linhas em branco como uma única linha em branco.

/t <n> Exibe as guias como o número de espaços especificado por n.

+ <n> Exibe o primeiro arquivo, começando na linha especificada por n.

[<drive>:][<path>] Especifica o local e o nome de um arquivo a ser exibido.


<filename>

<files> Especifica uma lista de arquivos a serem exibidos. Os arquivos devem ser
separados usando espaços.

/? Exibe a ajuda no prompt de comando.

Comentários
Os seguintes subcomandos são aceitos no prompt more ( -- More -- ), incluindo:

Chave Ação

BARRA DE Pressione a BARRA DE ESPAÇOS para exibir a próxima tela.


ESPAÇOS

Enter Pressione ENTER para exibir o arquivo uma linha de cada vez.

f Pressione F para exibir o próximo arquivo listado na linha de


comando.

q Pressione Q para sair do comando more.

= Mostra o número de linha.

p <n> Pressione P para exibir as próximas n linhas.

s <n> Pressione S para ignorar as próximas n linhas.

? Pressione ? para mostrar os comandos disponíveis no prompt more.

Se você usar o caractere de redirecionamento ( < ), também deverá especificar um


nome de arquivo como a origem.

Se você usar o pipe ( | ), poderá usar comandos como dir, sort e type.

Exemplos
Para exibir a primeira tela de informações de um arquivo chamado Clients.new, digite
um dos seguintes comandos:

more < clients.new


type clients.new | more

O comando more exibe a primeira tela de informações de Clients.new e você pode


pressionar a BARRA DE ESPAÇOS para ver a próxima tela de informações.

Para limpar a tela e remover todas as linhas em branco adicionais, antes de exibir o
arquivo Clients.new, digite um dos seguintes comandos:

more /c /s < clients.new


type clients.new | more /c /s
Para exibir o número de linha atual no prompt more, digite:

more =

O número de linha atual é adicionado ao prompt more, como -- More [Line: 24] --

Para exibir um número específico de linhas no prompt more, digite:

more p

O prompt more solicita o número de linhas a serem exibidas da seguinte maneira: --


More -- Lines: . Digite o número de linhas a serem exibidas e pressione ENTER. A tela

muda para mostrar apenas esse número de linhas.

Para ignorar um número específico de linhas no prompt more, digite:

more s

O prompt more solicita o número de linhas a serem ignoradas da seguinte maneira: --


More -- Lines: . Digite o número de linhas a serem ignoradas e pressione ENTER. A tela

muda para mostrar que essas linhas foram ignoradas.

Links relacionados
Chave da sintaxe de linha de comando

WinRE (Ambiente de Recuperação do Windows)


montagem
Artigo • 12/04/2023

Um utilitário de linha de comando que monta compartilhamentos de rede NFS (Sistema


de Arquivos de Rede). Quando usado sem opções ou argumentos, o mount exibe as
informações sobre todos os sistemas de arquivos NFS montados.

7 Observação

Esse utilitário só estará disponível se o Cliente para NFS estiver instalado.

Sintaxe

mount [-o <option>[...]] [-u:<username>] [-p:{<password> | *}] {\\


<computername>\<sharename> | <computername>:/<sharename>} {<devicename> | *}

Parâmetros

Parâmetro Descrição

-o rsize= <buffersize> Define o tamanho em quilobytes do buffer de leitura. Os valores


aceitáveis são 1, 2, 4, 8, 16 e 32. O padrão é 32 KB.

-o wsize= <buffersize> Define o tamanho em quilobytes do buffer de gravação. Os valores


aceitáveis são 1, 2, 4, 8, 16 e 32. O padrão é 32 KB.

-o timeout= <seconds> Define o valor de tempo limite em segundos para uma RPC (chamada
de procedimento remoto). Os valores aceitáveis são 0,8, 0,9 e
qualquer inteiro no intervalo de 1 a 60. O padrão é 0,8.

-o retry= <number> Define o número de repetições para uma montagem reversível. Os


valores aceitáveis são inteiros no intervalo de 1 a 10. O padrão é 1.

-o mtype= {soft|hard} Define o tipo de montagem para o compartilhamento NFS. Por


padrão, o Windows usa uma montagem reversível. As montagens
reversíveis atingirão o tempo limite com mais facilidade, quando
houver problemas de conexão. No entanto, para reduzir a interrupção
de E/S durante as reinicializações do servidor NFS, recomendamos
usar uma montagem irreversível.

-o anon Monta como um usuário anônimo.


Parâmetro Descrição

-o nolock Desabilita o bloqueio (o padrão é habilitado).

-o casesensitive Força as pesquisas de arquivo no servidor a diferenciar maiúsculas de


minúsculas.

-o fileaccess= <mode> Especifica o modo de permissão padrão de novos arquivos criados no


compartilhamento NFS. Especifique mode como um número de três
dígitos no formulário ogw, onde o, g e w são um dígito que
representa o acesso concedido ao proprietário, grupo e mundo do
arquivo, respectivamente. Os dígitos devem estar no intervalo de 0 a
7, incluindo:

0: sem acesso
1: x (acesso de execução)
2: w (acesso de gravação)
3: wx (acesso de gravação e execução)
4: r (acesso de leitura)
5: rx (acesso de leitura e execução)
6: rw (acesso de leitura e gravação)
7: rwx (acesso de leitura, gravação e execução)

-o lang= {euc-jp|euc- Especifica a codificação de idioma a ser configurada em um


tw|euc-kr|shift- compartilhamento NFS. Você pode usar apenas um idioma no
jis|Big5|Ksc5601|Gb2312- compartilhamento. Esse valor pode incluir qualquer um dos seguintes
80|Ansi) valores:
euc-jp: japonês
euc-tw: chinês
euc-kr: coreano
shift-jis: japonês
Big5: chinês
Ksc5601: coreano
Gb2312-80: chinês simplificado
Ansi: codificado em ANSI

-u: <username> Especifica o nome de usuário a ser usado para montar o


compartilhamento. Se o nome de usuário não for precedido de uma
barra invertida (\), será tratado como um nome de usuário UNIX.

-p: <password> A senha a ser usada para montar o compartilhamento. Se você usar
um asterisco (*), a ferramenta solicitará a senha.

<computername> Especifica o nome do servidor NFS.

<sharename> Especifica o nome do sistema de arquivos.


Parâmetro Descrição

<devicename> Especifica a letra da unidade e o nome do dispositivo. Se você usar


um asterisco (*), esse valor representará a primeira letra da unidade
disponível.

Links relacionados
Chave da sintaxe de linha de comando
mountvol
Artigo • 10/04/2023

Cria, exclui ou lista um ponto de montagem de volume. Você também pode vincular
volumes sem exigir uma letra de unidade.

Sintaxe

mountvol [<drive>:]<path volumename>


mountvol [<drive>:]<path> /d
mountvol [<drive>:]<path> /l
mountvol [<drive>:]<path> /p
mountvol /r
mountvol [/n|/e]
mountvol <drive>: /s

Parâmetros

Parâmetro Descrição

[<drive>:] Especifica o diretório NTFS existente no qual o ponto de montagem residirá.


<path>

<volumename> Especifica o nome do volume que é o destino do ponto de montagem. O nome


do volume usa a seguinte sintaxe, em que GUID é um identificador global
exclusivo: \\?\volume\{GUID}\ . Os colchetes { } são obrigatórios.

/d Remove o ponto de montagem de volume da pasta especificada.

/l Lista o nome do volume montado para a pasta especificada.

/p Remove o ponto de montagem de volume do diretório especificado, desmonta o


volume básico e deixa o volume básico offline, tornando-o desmontável. Se
outros processos estiverem usando o volume, mountvol fechará todas as alças
abertas antes de desmontar o volume.

/r Remove diretórios de ponto de montagem de volume e configurações de registro


para volumes que não estão mais no sistema, impedindo que sejam montados
automaticamente e que recebam os pontos de montagem de volume anteriores
quando adicionados de volta ao sistema.

/n Desabilita a montagem automática de novos volumes básicos. Novos volumes


não são montados automaticamente quando adicionados ao sistema.
Parâmetro Descrição

/e Reabilita a montagem automática de novos volumes básicos.

/s Monta a partição do sistema EFI na unidade especificada.

/? Exibe a ajuda no prompt de comando.

Comentários
Se você desmontar o volume ao usar o parâmetro /p, a lista de volumes mostrará
o volume como não montado até que um ponto de montagem de volume seja
criado.

Se o volume tiver mais de um ponto de montagem, use /d para remover os pontos


de montagem adicionais antes de usar /p. Você pode tornar o volume básico
montável novamente atribuindo um ponto de montagem de volume.

Se precisar expandir o espaço de volume sem reformatar ou substituir um disco


rígido, você poderá adicionar um caminho de montagem a outro volume. O
benefício de usar um volume com vários caminhos de montagem é que você pode
acessar todos os volumes locais usando somente uma letra de unidade (como C: ).
Você não precisa lembrar qual volume corresponde a qual letra da unidade,
embora ainda possa montar volumes locais e atribuir letras de unidade a eles.

Exemplos
Para criar um ponto de montagem, digite:

mountvol \sysmount \\?\volume\{2eca078d-5cbc-43d3-aff8-7e8511f60d0e}\

Links relacionados
Chave da sintaxe de linha de comando
move
Artigo • 11/04/2023

Move um ou mais arquivos de um diretório para outro.

) Importante

Mover arquivos criptografados para um volume sem suporte para os resultados do


EFS (sistema de arquivos com criptografia) resultará em um erro. Primeiro, você
deve descriptografar os arquivos ou movê-los para um volume que dê suporte ao
EFS.

Sintaxe

move [{/y|-y}] [<source>] [<target>]

Parâmetros

Parâmetro Descrição

/y Interrompe a solicitação para confirmar que você deseja substituir um arquivo de


destino existente. Esse parâmetro pode ser predefinido na variável de ambiente
COPYCMD. Você pode substituir essa predefinição usando o parâmetro -y. O padrão
é perguntar antes de substituir os arquivos, a menos que o comando seja executado
de dentro de um script em lote.

-y Inicia a solicitação para confirmar que você deseja substituir um arquivo de destino
existente.

<source> Especifica o caminho e o nome do(s) arquivo(s) a ser(em) movido(s). Para mover ou
renomear um diretório, a origem deve ser o caminho e o nome do diretório atuais.

<target> Especifica o caminho e o nome para o qual mover os arquivos. Para mover ou
renomear um diretório, o destino deve ser o caminho e o nome do diretório
desejados.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para mover todos os arquivos com a extensão .xls do diretório \Data para o diretório
\Second_Q\Reports, digite:

move \data\*.xls \second_q\reports\

Links relacionados
Chave da sintaxe de linha de comando
mqbkup
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Faz backup de arquivos de mensagem MSMQ e configurações de registro em um


dispositivo de armazenamento e restaura as mensagens e configurações armazenadas
anteriormente.

As operações de backup e restauração interrompem o serviço MSMQ local. Se o serviço


MSMQ tiver sido iniciado com antecedência, o utilitário tentará reiniciar o serviço
MSMQ ao fim da operação de backup ou restauração. Se o serviço já tiver sido
interrompido antes de executar o utilitário, não haverá tentativa de reiniciar o serviço.

Antes de usar o utilitário de Backup/Restauração de Mensagens MSMQ, você deve


fechar todos os aplicativos locais que estão usando o MSMQ.

Sintaxe

mqbkup {/b | /r} <folder path_to_storage_device>

Parâmetros

Parâmetro Descrição

/b Especifica a operação de backup.

/r Especifica a operação de restauração.

<folder Especifica o caminho em que os arquivos de mensagem MSMQ e as


path_to_storage_device> configurações de registro são armazenados.

/? Exibe a ajuda no prompt de comando.

Comentários
Se não houver uma pasta especificada durante a execução da operação de backup
ou restauração, a pasta será criada automaticamente pelo utilitário.
Se você optar por especificar uma pasta existente, ela deverá estar vazia. Se você
especificar uma pasta com conteúdo, o utilitário excluirá todos os arquivos e
subpastas encontrados nela. Nesse caso, você será solicitado a conceder
permissão para excluir os arquivos e as subpastas existentes. Você pode usar o
parâmetro /y para indicar que concorda de antemão com a exclusão de todos os
arquivos e subpastas existentes na pasta especificada.

Os locais das pastas usadas para armazenar arquivos de mensagem MSMQ são
armazenados no registro. Portanto, o utilitário restaura os arquivos de mensagem
MSMQ nas pastas especificadas no registro e não nas pastas de armazenamento
usadas antes da operação de restauração.

Exemplos
Para fazer backup de todos os arquivos de mensagens MSMQ e configurações de
registro e armazená-los na pasta msmqbkup na sua unidade C:, digite:

mqbkup /b c:\msmqbkup

Para excluir todos os arquivos e subpastas existentes na pasta oldbkup na sua unidade
C: e, em seguida, para armazenar arquivos de mensagem MSMQ e configurações de
registro na pasta, digite:

mqbkup /b /y c:\oldbkup

Para restaurar as mensagens MSMQ e as configurações de registro, digite:

mqbkup /r c:\msmqbkup

Links relacionados
Chave da sintaxe de linha de comando

Referência do MSMQ PowerShell


mqsvc
Artigo • 12/04/2023

A tecnologia de Enfileiramento de Mensagens permite que aplicativos executados em


horários diferentes se comuniquem em redes e sistemas heterogêneos que podem estar
temporariamente offline. O Enfileiramento de Mensagens fornece entrega de
mensagens garantida, roteamento eficiente, segurança e mensagem baseada em
prioridade. Pode ser usado para implementar soluções em cenários de mensagens
assíncronas e síncronas. Para obter mais informações sobre o Enfileiramento de
Mensagens, confira MSMQ (Enfileiramento de Mensagens).

Syntax

mqsvc.exe

Links relacionados
Chave da sintaxe de linha de comando

Referência do MSMQ PowerShell


mqtgsvc
Artigo • 12/04/2023

Monitora uma fila de mensagens de entrada e executa uma ação na forma de um


arquivo executável ou componente COM, quando as regras de um gatilho são avaliadas
como true. Para obter exemplos de como o serviço gatilhos de enfileiramento de
mensagens pode ser usado, confira Gatilhos de enfileiramento de mensagens.

Syntax

mqtgsvc.exe

Links relacionados
Chave da sintaxe de linha de comando

Referência do MSMQ PowerShell


msdt
Artigo • 12/04/2023

Invoca um pacote de solução de problemas na linha de comando ou como parte de um


script automatizado e habilita opções adicionais sem a entrada do usuário.

7 Observação

A MSDT (Ferramenta de Diagnóstico de Suporte da Microsoft) foi preterida. Para


obter mais informações, confira Recursos preteridos do Windows.

Sintaxe

msdt </id <name> | /path <name> | /cab < name>> <</parameter> [options] …
<parameter> [options]>>

Parâmetros

Parâmetro Descrição

/id <packagename> Especifica qual pacote de diagnóstico executar. Para obter uma lista de
pacotes disponíveis, consulte Pacotes de solução de problemas
disponíveis.

/path Especifica o caminho completo para um pacote de diagnóstico. Se você


<directory|.diagpkg especificar um diretório, o diretório deverá conter um pacote de
file|.diagcfg file> diagnóstico. Você não pode usar o parâmetro /path em conjunto com o
parâmetro ** /id**, /dci ou /cab.

/dci <passkey> Preenche previamente o campo de chave de acesso. Esse parâmetro só é


usado quando um provedor de suporte fornece uma chave de acesso.

/dt <directory> Exibe o histórico de solução de problemas no diretório especificado. Os


resultados do diagnóstico são armazenados no diretório
%LOCALAPPDATA%\Diagnostics ou
%LOCALAPPDATA%\ElevatedDiagnostics do usuário.

/af <answerfile> Especifica um arquivo de resposta no formato XML que contém respostas
a uma ou mais interações de diagnóstico.
Parâmetro Descrição

/modal <ownerHWND> Torna o pacote de solução de problemas modal para uma janela
designada pelo Identificador de Janela do Console pai (HWND), em
decimal. Esse parâmetro normalmente é usado por aplicativos que iniciam
um pacote de solução de problemas. Para obter mais informações sobre
como obter Identificadores de Janela do Console, consulte Como obter um
Identificador de Janela do Console (HWND) .

/moreoptions Habilita (true) ou suprime (false) a tela de solução de problemas final que
<true|false> pergunta se o usuário deseja explorar opções adicionais. Esse parâmetro
normalmente é usado quando o pacote de solução de problemas é
iniciado por uma solução de problemas que não faz parte do sistema
operacional.

/param Especifica um conjunto de respostas de interação na linha de comando,


<parameters> semelhante a um arquivo de resposta. Normalmente, esse parâmetro não
é usado no contexto de pacotes de solução de problemas criados com o
Designer TSP. Para obter mais informações sobre como desenvolver
parâmetros personalizados, consulte Plataforma de solução de problemas
do Windows.

/advanced Expande o link avançado na página inicial por padrão quando o pacote de
solução de problemas é iniciado.

/custom Solicita que o usuário confirme cada resolução possível antes de ser
aplicada.

Códigos de retorno
Os pacotes de solução de problemas compõem um conjunto de causas raiz, cada uma
delas descreve um problema técnico específico. Depois de concluir as tarefas do pacote
de solução de problemas, cada causa raiz retorna um estado corrigido, não corrigido,
detectado (mas não fixável) ou não encontrado. Além dos resultados específicos
relatados na interface do usuário da solução de problemas, o mecanismo de solução de
problemas retorna um código nos resultados que descrevem, em termos gerais, se a
solução de problemas corrigiu ou não o problema original. Os códigos são:

Código Descrição

-1 Interrupção: a solução de problemas foi fechada antes da conclusão das tarefas de


solução de problemas.

0 Fixo: a solução de problemas identificou e corrigiu pelo menos uma causa raiz e
nenhuma causa raiz permanece em um estado não fixo.
Código Descrição

1 Presente, mas não corrigido: a solução de problemas identificou uma ou mais causas
raiz que permanecem em um estado não fixo. Esse código é retornado mesmo que
outra causa raiz tenha sido corrigida.

2 Não encontrado: a solução de problemas não identificou nenhuma causa raiz.

Links relacionados
Chave da sintaxe de linha de comando

Pacotes de solução de problemas disponíveis

Referência do PowerShell do pacote de solução de problemas


msg
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Envia uma mensagem a um usuário em um servidor Host da Sessão da Área de Trabalho


Remota.

7 Observação

Você deve ter permissão de acesso especial de mensagem para enviar uma
mensagem.

Sintaxe

msg {<username> | <sessionname> | <sessionID>| @<filename> | *} [/server:


<servername>] [/time:<seconds>] [/v] [/w] [<message>]

Parâmetros

Parâmetro Descrição

<username> Especifica o nome do usuário para o qual você deseja receber a


mensagem. Se você não especificar um usuário ou uma sessão, este
comando exibirá uma mensagem de erro. Ao especificar uma sessão, ela
deve estar ativa.

<sessionname> Especifica o nome da sessão para o qual você deseja receber a mensagem.
Se você não especificar um usuário ou uma sessão, este comando exibirá
uma mensagem de erro. Ao especificar uma sessão, ela deve estar ativa.

<sessionID> Especifica a ID numérica da sessão do usuário para o qual você deseja


receber uma mensagem.

@<filename> Identifica um arquivo que contém uma lista de nomes de usuário, nomes
de sessão e IDs de sessão para a qual você deseja receber a mensagem.

* Envia a mensagem para todos os nomes de usuário no sistema.


Parâmetro Descrição

/server: <servername> Especifica o servidor Host da Sessão da Área de Trabalho Remota da


sessão ou usuário para o qual você deseja receber a mensagem. Se não
for especificado, /server usará o servidor no qual você está conectado no
momento.

/time: <seconds> Especifica o tempo pelo qual a mensagem enviada será exibida na tela do
usuário. Depois que o limite de tempo é atingido, a mensagem
desaparece. Se nenhum limite de tempo for definido, a mensagem será
padronizada como 60 segundos e desaparecerá.

/v Exibe as informações sobre as ações sendo executadas.

/w Aguarda uma confirmação do usuário de que a mensagem foi recebida.


Use esse parâmetro com /time:<*seconds*> para evitar um possível atraso
longo, se o usuário não responder imediatamente. Usar esse parâmetro
com /v também é útil.

<message> Especifica o texto da mensagem que você deseja enviar. Se nenhuma


mensagem for especificada, você será solicitado a inserir uma mensagem.
Para enviar uma mensagem contida em um arquivo, digite o símbolo de
menor que (<) seguido do nome do arquivo.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para enviar uma mensagem intitulada Vamos nos reunir às 13h de hoje para todas as
sessões do User1, digite:

msg User1 Let's meet at 1PM today

Para enviar a mesma mensagem a sessão modeM02, digite:

msg modem02 Let's meet at 1PM today

Para enviar a mensagem para todas as sessões contidas na lista de usuários do arquivo,
digite:

msg @userlist Let's meet at 1PM today


Para enviar a mensagem para todos os usuários que estão conectados, digite:

msg * Let's meet at 1PM today

Para enviar a mensagem para todos os usuários, com um tempo limite de confirmação
(por exemplo, 10 segundos), digite:

msg * /time:10 Let's meet at 1PM today

Links relacionados
Chave da sintaxe de linha de comando
msiexec
Artigo • 17/04/2023

Fornece os meios para instalar, modificar e executar operações no Windows Installer a


partir da linha de comando.

Opções de instalação
Defina o tipo de instalação para iniciar um pacote de instalação.

Sintaxe

msiexec.exe [/i][/a][/j{u|m|/g|/t}][/x] <path_to_package>

Parâmetros

Parâmetro Descrição

/i Especifica a instalação normal.

/a Especifica a instalação administrativa.

/ju Anuncie o produto ao usuário atual.

/jm Anuncie o produto a todos os usuários.

/j/g Especifica o identificador de idioma usado pelo pacote anunciado.

/j/t Aplica a transformação ao pacote anunciado.

/x Desinstala o pacote.

<path_to_package> Especifica o local e o nome do arquivo do pacote de instalação.

Exemplos

Para instalar um pacote chamado example.msi da unidade C:, usando um processo de


instalação normal, digite:
msiexec.exe /i "C:\example.msi"

Opções de exibição
Você pode configurar o que um usuário vê durante o processo de instalação, com base
em seu ambiente de destino. Por exemplo, se você estiver distribuindo um pacote a
todos os clientes para instalação manual, deverá haver uma interface do usuário
completa. No entanto, se você estiver implantando um pacote usando Política de Grupo,
o que não requer interação do usuário, não deverá haver nenhuma interface do usuário
envolvida.

Sintaxe

msiexec.exe /i <path_to_package> [/quiet][/passive][/q{n|b|r|f}]

Parâmetros

Parâmetro Descrição

<path_to_package> Especifica o local e o nome do arquivo do pacote de instalação.

/quiet Especifica o modo silencioso, o que significa que não há necessidade de


interação do usuário.

/passive Especifica o modo autônomo, o que significa que a instalação mostra


apenas uma barra de progresso.

/qn Especifica que não há interface do usuário durante o processo de instalação.

/qn+ Especifica que não há interface do usuário durante o processo de instalação,


exceto para uma caixa de diálogo final no final.

/qb Especifica que há uma interface do usuário básica durante o processo de


instalação.

/qb+ Especifica que há uma interface do usuário básica durante o processo de


instalação, incluindo uma caixa de diálogo final no final.

/qr Especifica uma experiência de interface do usuário reduzida durante o


processo de instalação.
Parâmetro Descrição

/qf Especifica uma experiência de interface do usuário completa durante o


processo de instalação.

Comentários

A caixa modal não será mostrada se a instalação for cancelada pelo usuário. Você
pode usar qb+! ou qb!+ para ocultar o botão CANCELAR.

Exemplos
Para instalar o pacote C:\example.msi, usando um processo de instalação normal e
nenhuma interface do usuário, digite:

msiexec.exe /i "C:\example.msi" /qn

Opções de reinicialização
Se o pacote de instalação substituir arquivos ou tentar alterar os arquivos que estão em
uso, talvez seja necessário fazer uma reinicialização antes da conclusão da instalação.

Sintaxe

msiexec.exe /i <path_to_package> [/norestart][/promptrestart][/forcerestart]

Parâmetros

Parâmetro Descrição

<path_to_package> Especifica o local e o nome do arquivo do pacote de instalação.

/norestart Impede que o dispositivo seja reiniciado após a conclusão da instalação.

/promptrestart Pergunta ao usuário se é necessário reinicializar.

/forcerestart Reinicia o dispositivo após a conclusão da instalação.


Exemplos
Para instalar o pacote C:\example.msi, usando um processo de instalação normal sem
reinicialização no final, digite:

msiexec.exe /i "C:\example.msi" /norestart

Opções de log
Se você precisar depurar seu pacote de instalação, poderá definir os parâmetros para
criar um arquivo de log com informações específicas.

Sintaxe

msiexec.exe [/i][/x] <path_to_package> [/L{i|w|e|a|r|u|c|m|o|p|v|x+|!|*}]


<path_to_log>

Parâmetros

Parâmetro Descrição

/i Especifica a instalação normal.

/x Desinstala o pacote.

<path_to_package> Especifica o local e o nome do arquivo do pacote de instalação.

/li Ativa o registro em log e inclui mensagens de status no arquivo de log de


saída.

/lw Ativa o registro em log e inclui avisos não fatais no arquivo de log de saída.

/le Ativa o registro em log e inclui todas as mensagens de erro no arquivo de


log de saída.

/la Ativa o registro em log e inclui informações sobre quando uma ação foi
iniciada no arquivo de log de saída.

/lr Ativa o registro em log e inclui registros de ações específicas no arquivo de


log de saída.
Parâmetro Descrição

/lu Ativa o registro em log e inclui informações de solicitação de usuário no


arquivo de log de saída.

/lc Ativa o registro em log e inclui os parâmetros iniciais de interface do usuário


no arquivo de log de saída.

/lm Ativa o registro em log e inclui informações sobre a falta de memória ou


saída fatal no arquivo de log de saída.

/lo Ativa o registro em log e inclui mensagens de falta de espaço em disco no


arquivo de log de saída.

/lp Ativa o registro em log e inclui propriedades terminais no arquivo de log de


saída.

/lv Ativa o registro em log e inclui saída detalhada no arquivo de log de saída.

/lx Ativa o registro em log e inclui informações extras de depuração no arquivo


de log de saída.

/l+ Ativa o registro em log e acrescenta as informações a um arquivo de log


existente.

/l! Ativa o registro em log e libera cada linha para o arquivo de log.

/l* Ativa o registro em log e registra todas as informações, exceto informações


detalhadas (/lv) ou informações extras de depuração (/lx).

<path_to_logfile> Especifica o local e o nome do arquivo de log de saída.

Exemplos
Para instalar o pacote C:\example.msi, usando um processo de instalação normal com
todas as informações de registro em log fornecidas, incluindo a saída detalhada, e
armazenando o arquivo de log de saída em C:\package.log, digite:

msiexec.exe /i "C:\example.msi" /L*V "C:\package.log"

Opções de atualização
Você pode aplicar ou remover as atualizações usando um pacote de instalação.
Sintaxe

msiexec.exe [/p][/update][/uninstall[/package<product_code_of_package>]]
<path_to_package>

Parâmetros

Parâmetro Descrição

/p Instala um patch. Se você estiver instalando silenciosamente, também deverá definir


a propriedade REINSTALLMODE como ecmus e REINSTALL como ALL. Caso
contrário, o patch atualizará apenas o MSI armazenado em cache no dispositivo de
destino.

/update Opção de instalação de patches. Se você estiver aplicando várias atualizações,


deverá separá-las usando um ponto e vírgula (;).

/package Instala ou configura um produto.

Exemplos

msiexec.exe /p "C:\MyPatch.msp"
msiexec.exe /p "C:\MyPatch.msp" /qb REINSTALLMODE="ecmus" REINSTALL="ALL"
msiexec.exe /update "C:\MyPatch.msp"

msiexec.exe /uninstall {1BCBF52C-CD1B-454D-AEF7-852F73967318} /package


{AAD3D77A-7476-469F-ADF4-04424124E91D}

Onde o primeiro GUID é o GUID do patch, e o segundo é o código do produto MSI ao


qual o patch foi aplicado.

Opções de reparo
Você pode usar esse comando para reparar um pacote instalado.

Sintaxe
msiexec.exe [/f{p|o|e|d|c|a|u|m|s|v}] <product_code>

Parâmetros

Parâmetro Descrição

/fp Repara o pacote se um arquivo estiver ausente.

/fo Repara o pacote se um arquivo estiver ausente ou se uma versão mais antiga estiver
instalada.

/fe Repara o pacote se um arquivo estiver ausente ou se uma versão igual ou mais
antiga estiver instalada.

/fd Repara o pacote se um arquivo estiver ausente ou se uma versão diferente estiver
instalada.

/fc Repara o pacote se o arquivo estiver ausente ou se a soma de verificação não


corresponder ao valor calculado.

/fa Força a reinstalação de todos os arquivos.

/fu Repara todas as entradas do Registro necessárias específicas ao usuário.

/fm Repara todas as entradas do Registro necessárias específicas ao computador.

/fs Repara todos os atalhos existentes.

/fv Executa a partir da origem e armazena novamente em cache o pacote local.

Exemplos

Para forçar a reinstalação de todos os arquivos com base no código do produto MSI a
ser reparado, {AAD3D77A-7476-469F-ADF4-04424124E91D}, digite:

msiexec.exe /fa {AAD3D77A-7476-469F-ADF4-04424124E91D}

Definir propriedades públicas


Você pode definir propriedades públicas por meio desse comando. Para saber mais
sobre as propriedades disponíveis e como defini-las, confira Propriedades Públicas.
Links relacionados
Chave da sintaxe de linha de comando

Opções de linha de comando de Msiexec.exe

Opções da linha de comando do Instalador Autônomo


msinfo32
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Abre a ferramenta Informações do Sistema para mostrar uma exibição abrangente do


hardware, dos componentes do sistema e do ambiente de software no computador
local.

Algumas categorias de Informações do Sistema contêm grandes volumes de dados.


Você pode usar o comando start /wait para otimizar o desempenho do relatório dessas
categorias. Para obter mais informações, confira Informações do Sistema.

Sintaxe

msinfo32 [/pch] [/nfo <path>] [/report <path>] [/computer <computername>]


[/showcategories] [/category <categoryID>] [/categories {+<categoryID>(+
<categoryID>)|+all(-<categoryID>)}]

Parâmetros

Parâmetro Descrição

<path> Especifica o arquivo a ser aberto no formato C:\Folder1\File1.xxx, onde C é a


letra da unidade, Folder1 é a pasta, File1 é o nome do arquivo e xxx é a
extensão de nome de arquivo.

Esse arquivo pode ser um arquivo .nfo, .xml, .txt ou .cab.

<computername> Especifica o nome do computador local ou de destino. Pode ser um nome


UNC, um endereço IP ou um nome de computador completo.

<categoryID> Especifica a ID do item de categoria. Você pode obter a ID da categoria


usando /showcategories.

/pch Mostra a exibição Histórico do Sistema na ferramenta Informações do Sistema.

/nfo Salva o arquivo exportado como um arquivo .nfo. Se o nome do arquivo


especificado em path não terminar em uma extensão .nfo, a extensão .nfo será
acrescentada automaticamente ao nome do arquivo.
Parâmetro Descrição

/report Salva o arquivo em path como um arquivo de texto. O nome do arquivo é


salvo exatamente como aparece em path. A extensão .txt não é acrescentada
ao arquivo, a menos que isso seja especificado no caminho.

/computer Inicia a ferramenta Informações do Sistema para o computador remoto


especificado. Você deve ter as permissões apropriadas para acessar o
computador remoto.

/showcategories Inicia a ferramenta Informações do Sistema com todas as IDs de categoria


disponíveis exibidas, em vez de exibir os nomes amigáveis ou localizados. Por
exemplo, a categoria Ambiente de Software é exibida como a categoria
SWEnv.

/category Inicia a ferramento Informações do Sistema com a categoria especificada


selecionada. Use /showcategories para exibir uma lista de IDs de categoria
disponíveis.

/categories Inicia a ferramenta Informações do Sistema exibindo somente a categoria ou


as categorias especificadas. Também limita a saída para a categoria ou as
categorias selecionadas. Use /showcategories para exibir uma lista de IDs de
categoria disponíveis.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para listar as IDs de categoria disponíveis, digite:

msinfo32 /showcategories

Para iniciar a ferramenta Informações do Sistema com todas as informações disponíveis


exibidas, exceto os Módulos Carregados, digite:

msinfo32 /categories +all -loadedmodules

Para exibir as informações de Resumo do Sistema e criar um arquivo .nfo chamado


syssum.nfo, que contém as informações na categoria Resumo do Sistema, digite:

msinfo32 /nfo syssum.nfo /categories +systemsummary


Para exibir as informações de conflito de recursos e criar um arquivo .nfo chamado
conflicts.nfo, que contém as informações sobre conflitos de recursos, digite:

msinfo32 /nfo conflicts.nfo /categories


+componentsproblemdevices+resourcesconflicts+resourcesforcedhardware

Links relacionados
Chave da sintaxe de linha de comando
mstsc
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria conexões com servidores Host da Sessão da Área de Trabalho Remota ou outros
computadores remotos e edita um arquivo de configuração de Conexão de Área de
Trabalho Remota (.rdp) existente.

Sintaxe

mstsc.exe [<connectionfile>] [/v:<server>[:<port>]] [/g:<gateway>] [/admin]


[/f <fullscreen>] [/w:<width> /h:<height>] [/public] [/multimon] [/l]
[/restrictedadmin] [/remoteguard] [/prompt] [/shadow:<sessionid>] [/control]
[/noconsentprompt]
mstsc.exe /edit <connectionfile>

Parâmetros

Parâmetro Descrição

<connectionfile> Especifica o nome de um arquivo .rdp para a conexão.

/v: <server>[:<port>] Especifica o computador remoto e, opcionalmente, o número da porta ao


qual você deseja se conectar.

/g: <gateway> Especifica o servidor de Gateway de Área de Trabalho Remota a ser usado
para a conexão. Esse parâmetro só será lido se o PC de ponto de
extremidade for especificado com /v.

/admin Conecta você a uma sessão para administrar o servidor.

/f Inicia a Conexão de Área de Trabalho Remota no modo de tela inteira.

/w: <width> Especifica a largura da janela da Área de Trabalho Remota.

/h: <height> Especifica a altura da janela da Área de Trabalho Remota.

/public Executa a Área de Trabalho Remota no modo público. No modo público,


as senhas e os bitmaps não são armazenados em cache.
Parâmetro Descrição

/multimon Configura o layout do monitor de sessão dos Serviços de Área de


Trabalho Remota para ser idêntico à configuração atual do lado do
cliente.

/l Enumera o monitor anexado ao PC local e a ID associada a cada monitor.


A ID do monitor pode ser usada para preencher a configuração de
arquivo RDP de monitores selecionados.

/edit Abre o arquivo .rdp especificado para edição.


<connectionfile>

/restrictedAdmin Esse modo não enviará suas credenciais para o PC remoto, o que pode
proteger você em caso de conexão com um dispositivo comprometido.
As conexões feitas do PC remoto podem não ser autenticadas por outros
PCs, o que afeta a funcionalidade e a compatibilidade do aplicativo. O
parâmetro /admin está implícito.

/remoteGuard Esse modo impede que as credenciais sejam enviadas para o PC remoto,
o que pode ajudar a proteger suas credenciais se você se conectar a um
dispositivo comprometido. Ao contrário do modo administrador restrito,
o Remote Guard também dá suporte a conexões feitas do PC remoto,
redirecionando todas as solicitações novamente para seu dispositivo.

/prompt Solicita suas credenciais quando você se conecta ao PC remoto.

/shadow: <sessionID> Especifica a ID da sessão a ser sombreada.

/control Permite o controle da sessão ao sombrear.

/noConsentPrompt Permite o sombreamento sem o consentimento do usuário.

/? Exibe a ajuda no prompt de comando.

Comentários

Default.rdp é armazenado para cada usuário como um arquivo oculto na pasta


Documentos do usuário.

Os arquivos .rdp criados pelo usuário são salvos por padrão na pasta Documentos
do usuário, mas podem ser salvos em qualquer lugar.

Para abranger os monitores, os monitores devem usar a mesma resolução e devem


ser alinhados horizontalmente (ou seja, lado a lado). No momento, não há suporte
para abranger vários monitores verticalmente no sistema cliente.

Exemplos
Para se conectar a uma sessão no modo de tela inteira, digite:

mstsc /f

ou

mstsc /v:computer1 /f

Para atribuir a largura/altura, digite:

mstsc /v:computer1 /w:1920 /h:1080

Para abrir um arquivo chamado filename.rdp para edição, digite:

mstsc /edit filename.rdp

Links relacionados
Chave da sintaxe de linha de comando
nbtstat
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe estatísticas de protocolo NetBIOS por TCP/IP (NetBT), tabelas de nomes NetBIOS
para o computador local e computadores remotos e o cache de nomes NetBIOS. Esse
comando também permite uma atualização do cache de nomes NetBIOS e os nomes
registrados com o WINS (Windows Internet Name Service). Usado sem parâmetros, esse
comando exibe informações de Ajuda.

Esse comando só estará disponível se o Protocolo de Internet (TCP/IP) estiver instalado


como um componente nas propriedades de um adaptador de rede em Conexões de
Rede.

Sintaxe

nbtstat [/a <remotename>] [/A <IPaddress>] [/c] [/n] [/r] [/R] [/RR] [/s]
[/S] [<interval>]

Parâmetros

Parâmetro Descrição

/a Exibe a tabela de nomes NetBIOS de um computador remoto, em que


<remotename> remotename é o nome do computador NetBIOS do computador remoto. A tabela
de nomes NetBIOS é a lista de nomes NetBIOS que correspondem a aplicativos
NetBIOS em execução nesse computador.

/A Exibe a tabela de nomes NetBIOS de um computador remoto, especificada pelo


<IPaddress> endereço IP (em notação decimal com ponto) do computador remoto.

/c Exibe o conteúdo do cache de nomes NetBIOS, a tabela de nomes NetBIOS e


seus endereços IP resolvidos.

/n Exibe a tabela de nomes NetBIOS do computador local. O status registered indica


que o nome está registrado por difusão ou com um servidor WINS.

/r Exibe estatísticas de resolução de nomes NetBIOS.


Parâmetro Descrição

/R Limpa o conteúdo do cache de nomes NetBIOS e recarrega as entradas pré-


marcadas do arquivo Lmhosts.

/RR Libera e atualiza nomes NetBIOS para o computador local registrado com
servidores WINS.

/s Exibe sessões de cliente e servidor NetBIOS, tentando converter o endereço IP de


destino em um nome.

/S Exibe sessões de cliente e servidor NetBIOS, listando os computadores remotos


apenas por endereço IP de destino.

<interval> Exibe estatísticas selecionadas, pausando o número de segundos especificado no


intervalo entre cada exibição. Pressione CTRL+C para parar de exibir estatísticas.
Se esse parâmetro for omitido, nbtstat imprimirá as informações de configuração
atuais apenas uma vez.

/? Exibe a ajuda no prompt de comando.

Comentários
Os parâmetros de linha de comando de nbtstat diferenciam maiúsculas de
minúsculas.

Os títulos de coluna gerados pelo comando nbtstat incluem:

Direcionamento Descrição

Entrada O número de bytes recebidos.

Saída O número de bytes enviados.

Entrada/saída Se a conexão é do computador (saída) ou de outro computador para o


computador local (entrada).

Vida útil O tempo restante em que uma entrada de cache de tabela de nomes
viverá antes de ser limpa.

Nome local O nome NetBIOS local associado à conexão.

Host remoto O nome ou endereço IP associado ao computador remoto.

<03> O último byte de um nome NetBIOS convertido em hexadecimal. Cada


nome NetBIOS tem 16 caracteres. Esse último byte geralmente tem um
significado especial porque o mesmo nome pode estar presente várias
vezes em um computador, sendo diferente apenas no último byte. Por
exemplo, <20> é um espaço no texto ASCII.
Direcionamento Descrição

tipo O tipo do nome. Um nome pode ser um nome exclusivo ou um nome


de grupo.

Status Se o serviço NetBIOS no computador remoto estiver em execução


(registrado) ou se um nome de computador duplicado registrou o
mesmo serviço (Conflito).

Estado O estado das conexões NetBIOS.

Os possíveis estados das conexão NetBIOS incluem:

Estado Descrição

Conectado A sessão foi estabelecida.

escutando Esse ponto de extremidade está disponível para uma conexão de entrada.

Ocioso Esse ponto de extremidade foi aberto, mas não pode receber conexões.

Connecting Uma sessão está na fase de conexão e o mapeamento de nome para


endereço IP do destino está sendo resolvido.

Aceitando Uma sessão de entrada está sendo aceita e será conectada em breve.

Reconectando Uma sessão está tentando se reconectar (falha ao se conectar na primeira


tentativa).

Saída Uma sessão está na fase de conexão e a conexão TCP está sendo criada
no momento.

Entrada Uma sessão de entrada está na fase de conexão.

Desconectando Uma sessão está em processo de desconexão.

Desconectado O computador local emitiu uma desconexão e está aguardando a


confirmação do sistema remoto.

Exemplos
Para exibir a tabela de nomes NetBIOS do computador remoto com o nome do
computador NetBIOS corp07, digite:

nbtstat /a CORP07
Para exibir a tabela de nomes NetBIOS do computador remoto atribuído ao endereço IP
10.0.0.99, digite:

nbtstat /A 10.0.0.99

Para exibir a tabela de nomes NetBIOS do computador local, digite:

nbtstat /n

Para exibir o conteúdo do cache de nomes NetBIOS do computador local, digite:

nbtstat /c

Para limpar o cache de nomes NetBIOS e recarregar as entradas pré-marcadas no


arquivo Lmhosts local, digite:

nbtstat /R

Para liberar os nomes NetBIOS registrados no servidor WINS e registrá-los novamente,


digite:

nbtstat /RR

Para exibir estatísticas de sessão do NetBIOS por endereço IP a cada cinco segundos,
digite:

nbtstat /S 5

Links relacionados
Chave da sintaxe de linha de comando
netcfg
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Instala o WinPE (Ambiente de Pré-Instalação do Windows), uma versão leve do


Windows usada para implantar estações de trabalho.

Sintaxe

netcfg [/v] [/e] [/winpe] [/l ] /c /i

Parâmetros

Parâmetro Descrição

/v Executado no modo detalhado (detalhado).

/e Usa variáveis de ambiente de manutenção durante a instalação e a desinstalação.

/winpe Instala o TCP/IP, o NetBIOS e Cliente Microsoft para WinPE (Ambiente de Pré-
instalação do Windows).

/l Fornece o local do arquivo INF.

/c Fornece a classe do componente a ser instalado; protocolo, serviçoou cliente.

/i <comp- Fornece o ID do componente.


ID>

/s Fornece o tipo de componentes a serem mostrados, incluindo \ta para adaptadores


ou n para componentes.

/b Exibe os caminhos de associação, quando seguido por uma cadeia de caracteres


que contém o nome do caminho.

/q <comp- Consulta se o ID do componente está instalado


ID>

/u <comp- Desinstala o ID do componente.


ID>
Parâmetro Descrição

/m Gera o mapa de associação para NetworkBindingMap.txt no diretório atual. O uso


com /v também exibirá o mapa de associação para o console.

/d Executa uma limpeza em todos os dispositivos de rede. Isso exigirá uma


reinicialização.

/x Executa uma limpeza em dispositivos de rede, ignorando os que não têm nomes de
objetos físicos. Isso exigirá uma reinicialização.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para instalar o exemplo de protocolo usando c:\oemdir\example.inf, digite:

netcfg /l c:\oemdir\example.inf /c p /i example

Para instalar o serviço MS_Server, digite:

netcfg /c s /i MS_Server

Para instalar o TCP/IP, o NetBIOS e Cliente Microsoft para Ambiente de Pré-instalação


do Windows, digite:

netcfg /v /winpe

Para exibir se o componente MS_IPX está instalado, digite:

netcfg /q MS_IPX

Para desinstalar o componente MS_IPX, digite:

netcfg /u MS_IPX
Para mostrar todos os componentes instalados, digite:

netcfg /s n

Para exibir caminhos de associação que contêm MS_TCPIP, digite:

netcfg /b ms_tcpip

Links relacionados
Chave da sintaxe de linha de comando
net print
Artigo • 12/04/2023

) Importante

Esse comando foi preterido. No entanto, você pode executar muitas das mesmas
tarefas usando o comando prnjobs, WMI (Instrumentação de Gerenciamento do
Windows), PrintManagement no Powershell ou Recursos de Script para
profissionais de TI .

Exibe as informações sobre uma fila de impressora especificada ou um trabalho de


impressão especificado ou controla um trabalho de impressão especificado.

Sintaxe

net print {\\<computername>\<sharename> | \\<computername> <jobnumber>


[/hold | /release | /delete]} [help]

Parâmetros

Parâmetros Descrição

\\ Especifica (por nome) o computador e a fila de impressão sobre a qual você


<computername>\ deseja exibir as informações.
<sharename>

\\ Especifica (por nome) o computador que hospeda o trabalho de impressão que


<computername> você deseja controlar. Se você não especificar um computador, o computador
local será adotado. Requer o parâmetro <jobnumber> .

<jobnumber> Especifica o número do trabalho de impressão que você deseja controlar. Esse
número é atribuído pelo computador que hospeda a fila de impressão para
onde o trabalho de impressão é enviado. Depois que um computador atribui
um número a um trabalho de impressão, esse número não é atribuído a
nenhum outro trabalho de impressão em qualquer fila hospedada por esse
computador. Necessário ao usar o parâmetro \\<computername> .
Parâmetros Descrição

[/hold | Especifica a ação a ser tomada com o trabalho de impressão. Se você


/release | especificar um número de trabalho, mas não especificar uma ação, as
/delete] informações sobre o trabalho de impressão serão exibidas.
/hold – Adia o trabalho, permitindo que outros trabalhos de impressão o
ignorem até que ele seja liberado.
/release – Libera um trabalho de impressão que foi adiado.
/delete – Remove um trabalho de impressão de uma fila de impressão.

ajuda Exibe a ajuda no prompt de comando.

Comentários

O comando net print\\<computername> exibe as informações sobre trabalhos de


impressão em uma fila de impressora compartilhada. Veja a seguir um exemplo de
um relatório para todos os trabalhos de impressão em uma fila para uma
impressora compartilhada chamada LASER:

printers at \\PRODUCTION
Name Job # Size Status
-----------------------------
LASER Queue 3 jobs *printer active*
USER1 84 93844 printing
USER2 85 12555 Waiting
USER3 86 10222 Waiting

Veja a seguir um exemplo de um relatório para um trabalho de impressão:

Job # 35
Status Waiting
Size 3096
remark
Submitting user USER2
Notify USER2
Job data type
Job parameters
additional info

Exemplos
Para listar o conteúdo da fila de impressão do Dotmatrix no computador \Production,
digite:

net print \\Production\Dotmatrix

Para exibir as informações sobre o número de trabalho 35 no computador \Production,


digite:

net print \\Production 35

Para adiar o número de trabalho 263 no computador \Production, digite:

net print \\Production 263 /hold

Para liberar o número de trabalho 263 no computador \Production, digite:

net print \\Production 263 /release

Links relacionados
Chave da sintaxe de linha de comando

referência aos comandos de impressão

comando prnjobs

WMI (Instrumentação de Gerenciamento do Windows)

PrintManagement no PowerShell

Recursos de script para profissionais de TI


netsh
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019 e Windows Server 2016

O utilitário de script de linha de comando Network Shell que permite, local ou


remotamente, exibir ou modificar a configuração de rede de um computador em
execução no momento. Você pode iniciar esse utilitário no prompt de comando ou no
Windows PowerShell.

Sintaxe

netsh [-a <Aliasfile>][-c <Context>][-r <Remotecomputer>][-u [<domainname>\


<username>][-p <Password> | [{<NetshCommand> | -f <scriptfile>}]

Parâmetros

Parâmetro Descrição

-a <Aliasfile> Especifica que você será retornado para o prompt netsh, depois de executar
o Aliasfile e o nome do arquivo de texto que contém um ou mais comandos
netsh.

-c <Context> Especifica que o netsh inserirá o contexto netsh especificado e o contexto


netsh a ser inserido.

-r Especifica o computador remoto a ser configurado.


<Remotecomputer> Importante: se você usar esse parâmetro, deverá verificar se o serviço
Registro Remoto está em execução no computador remoto. Se não estiver
em execução, o Windows exibirá uma mensagem de erro "Caminho de Rede
não encontrado".

-u <domainname>\ Especifica o domínio e o nome da conta de usuário a serem usados durante a


<username> execução do comando netsh em uma conta de usuário. Se você omitir o
domínio, o domínio local será usado por padrão.

-p <Password> Especifica a senha da conta de usuário especificada pelo parâmetro -u


<username> .

<NetshCommand> Especifica o comando netsh a ser executado.


Parâmetro Descrição

-f <scriptfile> Sai do comando netsh depois de executar o arquivo de script especificado.

/? Exibe a ajuda no prompt de comando.

Comentários

Se você especificar -r seguido por outro comando, netsh executará o comando no


computador remoto e voltará para o prompt de comando Cmd.exe. Se você
especificar -r sem outro comando, o netsh será aberto no modo remoto. O
processo é semelhante ao uso de set machine no prompt de comando Netsh.
Quando você usa -r, você define o computador de destino da instância atual do
netsh somente. Depois de sair e entrar novamente no netsh, o computador de
destino será redefinido como o computador local. Você pode executar comandos
netsh em um computador remoto especificando um nome do computador
armazenado no WINS, um nome UNC, um nome de Internet a ser resolvido pelo
servidor DNS ou um endereço IP.

Se o valor da cadeia de caracteres contiver espaços entre caracteres, você deverá


colocar o valor da cadeia de caracteres entre aspas. Por exemplo, -r "contoso
remote device"

Links relacionados
Chave da sintaxe de linha de comando
netstat
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe conexões TCP ativas, portas nas quais o computador está em escuta, estatísticas
de Ethernet, tabela de roteamento de IP, estatísticas de IPv4 (para os protocolos IP,
ICMP, TCP e UDP) e estatísticas de IPv6 (para os protocolos IPv6, ICMPv6, TCP sobre IPv6
e UDP sobre IPv6). Usado sem parâmetros, esse comando exibe conexões TCP ativas.

) Importante

Esse comando só estará disponível se o Protocolo de Internet (TCP/IP) estiver


instalado como um componente nas propriedades de um adaptador de rede em
Conexões de Rede.

Sintaxe

netstat [-a] [-b] [-e] [-n] [-o] [-p <Protocol>] [-r] [-s] [<interval>]

Parâmetros

Parâmetro Descrição

-a Exibe todas as conexões TCP ativas e as portas TCP e UDP nas quais o computador
está em escuta.

-b Exibe o executável envolvido na criação de cada conexão ou porta de escuta. Em


alguns casos, executáveis conhecidos hospedam vários componentes
independentes e, nesses casos, a sequência de componentes envolvidos na criação
da conexão ou da porta de escuta é exibida. Nesse caso, o nome executável está
em [] na parte inferior, na parte superior está o componente que ele chamou e
assim por diante até que o TCP/IP seja atingido. Observe que essa opção pode ser
demorada e falhará, a menos que você tenha permissões suficientes.

-E Exibe estatísticas de Ethernet, como o número de bytes e pacotes enviados e


recebidos. Esse parâmetro pode ser combinado com -s.
Parâmetro Descrição

-n Exibe conexões TCP ativas, no entanto, endereços e números de porta são


expressos numericamente e nenhuma tentativa é feita para determinar nomes.

-o Exibe conexões TCP ativas e inclui a ID do processo (PID) para cada conexão. Você
pode encontrar o aplicativo com base no PID na guia Processos no Gerenciador de
Tarefas do Windows. Esse parâmetro pode ser combinado com -a, -n e -p.

-p Mostra conexões para o protocolo especificado pelo Protocol. Nesse caso, o


<Protocol> Protocol pode ser tcp, udp, tcpv6 ou udpv6. Se esse parâmetro for usado com -s
para exibir estatísticas por protocolo, o Protocol poderá ser tcp, udp, icmp, ip, tcpv6,
udpv6, icmpv6 ou ipv6.

-S Exibe estatísticas por protocolo. Por padrão, as estatísticas são mostradas para os
protocolos TCP, UDP, ICMP e IP. Se o protocolo IPv6 estiver instalado, as estatísticas
serão mostradas para os protocolos TCP sobre IPv6, UDP sobre IPv6, ICMPv6 e IPv6.
O parâmetro -p pode ser usado para especificar um conjunto de protocolos.

-r Exibe o conteúdo da tabela de roteamento de IP. Isso é equivalente ao comando de


impressão de rota.

<interval> Exibe novamente as informações selecionadas a cada intervalo de segundos.


Pressione CTRL+C para interromper a reprodução. Se esse parâmetro for omitido,
esse comando imprimirá as informações selecionadas apenas uma vez.

/? Exibe a ajuda no prompt de comando.

Comentários

O comando netstat fornece estatísticas para o seguinte:

Parâmetro Descrição

Proto O nome do protocolo (TCP ou UDP).

Local O endereço IP do computador local e o número da porta que está sendo


address usado. O nome do computador local que corresponde ao endereço IP e o
nome da porta é mostrado, a menos que o parâmetro -n seja especificado. Se
a porta ainda não estiver estabelecida, o número da porta será mostrado
como um asterisco (*).

Endereço O endereço IP e o número da porta do computador remoto ao qual o


externo soquete está conectado. Os nomes que correspondem ao endereço IP e à
porta são mostrados, a menos que o parâmetro -n seja especificado. Se a
porta ainda não estiver estabelecida, o número da porta será mostrado como
um asterisco (*).
Parâmetro Descrição

Estado Indica o estado de uma conexão TCP, incluindo:


CLOSE_WAIT
CLOSED
ESTABLISHED
FIN_WAIT_1
FIN_WAIT_2
LAST_ACK
LISTEN
SYN_RECEIVED
SYN_SEND
TIMED_WAIT

Exemplos
Para exibir as estatísticas de Ethernet e as estatísticas de todos os protocolos, digite:

netstat -e -s

Para exibir as estatísticas apenas para os protocolos TCP e UDP, digite:

netstat -s -p tcp udp

Para exibir conexões TCP ativas e as IDs de processo a cada 5 segundos, digite:

netstat -o 5

Para exibir conexões TCP ativas e as IDs de processo usando o formulário numérico,
digite:

netstat -n -o

Links relacionados
Chave da sintaxe de linha de comando
nfsadmin
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Um utilitário de linha de comando que administra o Servidor para NFS ou Cliente NFS
no computador local ou remoto que executa o NFS (Serviços de NFS da Microsoft).
Usado sem parâmetros, o servidor nfsadmin exibe as definições de configuração atuais
do Servidor para NFS e o cliente nfsadmin exibe as definições de configuração do
Cliente NFS.

Syntax

nfsadmin server [computername] [-u Username [-p Password]] -l


nfsadmin server [computername] [-u Username [-p Password]] -r {client | all}
nfsadmin server [computername] [-u Username [-p Password]] {start | stop}
nfsadmin server [computername] [-u Username [-p Password]] config
option[...]
nfsadmin server [computername] [-u Username [-p Password]] creategroup
<name>
nfsadmin server [computername] [-u Username [-p Password]] listgroups
nfsadmin server [computername] [-u Username [-p Password]] deletegroup
<name>
nfsadmin server [computername] [-u Username [-p Password]] renamegroup
<oldname> <newname>
nfsadmin server [computername] [-u Username [-p Password]] addmembers
<hostname>[...]
nfsadmin server [computername] [-u Username [-p Password]] listmembers
nfsadmin server [computername] [-u Username [-p Password]] deletemembers
<hostname><groupname>[...]
nfsadmin client [computername] [-u Username [-p Password]] {start | stop}
nfsadmin client [computername] [-u Username [-p Password]] config
option[...]

Parâmetros gerais

Parâmetro Descrição
Parâmetro Descrição

computername Especifica o computador remoto que você deseja administrar. Você pode
especificar o computador usando um nome WINS (Serviço de Cadastramento
na Internet do Windows) ou um nome DNS (Sistema de Nomes de Domínio) ou
por endereço IP (Protocolo IP).

-u Nome de Especifica o nome de usuário do usuário cujas credenciais devem ser usadas.
usuário Pode ser necessário adicionar o nome de domínio ao nome de usuário no
formato domínio\nome de usuário.

-p Senha Especifica a senha do usuário especificada usando a opção -u. Se você


especificar a opção -u, mas omitir a opção -p, será solicitada a senha do
usuário.

Parâmetros relacionados ao Servidor para NFS

Parâmetro Descrição

-l Lista todos os bloqueios mantidos pelos clientes.

-r {client|all} Libera os bloqueios mantidos por um cliente ou, se todos forem


especificados, por todos os clientes.

iniciar Inicia o servidor para o serviço NFS.

parar Interrompe o servidor para o serviço NFS.

config Especifica as configurações gerais do Servidor para NFS. Você precisa


fornecer pelo menos uma das seguintes opções com o argumento de
comando config:

mapsvr= <server> – Define o servidor como o servidor de


Mapeamento de Nome de Usuário do Servidor para NFS. Embora
essa opção continue com suporte em relação à compatibilidade
com versões anteriores, você deve usar o utilitário sfuadmin.
auditlocation= {eventlog|file|both|none} – Especifica se os eventos
serão auditados e onde os eventos serão registrados. Um dos
seguintes argumentos é obrigatório:
eventlog – Especifica que os eventos auditados serão registrados
somente no log do aplicativo Visualizador de Eventos.
file – Especifica que os eventos auditados serão registrados
somente no arquivo especificado por config fname .
both – Especifica que os eventos auditados serão registrados no
log do aplicativo Visualizador de Eventos, bem como no arquivo
especificado por config fname .
none – Especifica que os eventos não serão auditados.
fname= <file> – Define o arquivo especificado pelo arquivo como o
arquivo de auditoria. O padrão é %sfudir%\log\nfssvr.log.
Parâmetro Descrição

fsize= <size> – Define size como o tamanho máximo em megabytes


do arquivo de auditoria. O tamanho máximo padrão é 7 MB.
audit=[+|-]mount [+|-]read [+|-]write [+|-]create [+|-]delete
[+|-]locking [+|-]all – Especifica os eventos a serem registrados.
Para começar a registrar um evento em log, digite um sinal de
adição (+) antes do nome do evento; para interromper o registro em
log de um evento, digite um sinal de menos (-) antes do nome do
evento. Se o sinal for omitido, o sinal + será assumido. Não use all
com nenhum outro nome de evento.
lockperiod= <seconds> – Especifica o número de segundos que o
Servidor para NFS aguardará para recuperar bloqueios depois que
uma conexão com o Servidor para NFS for perdida e, em seguida,
restabelecida ou depois que o serviço Servidor para NFS tiver sido
reiniciado.
portmapprotocol= {TCP|UDP|TCP+UDP} – Especifica a quais
protocolos de transporte o Portmap dá suporte. A configuração
padrão é TCP+UDP.
mountprotocol= {TCP|UDP|TCP+UDP} – Especifica a quais protocolos
de transporte a montagem dá suporte. A configuração padrão é
TCP+UDP.
nfsprotocol= {TCP|UDP|TCP+UDP} – Especifica a quais protocolos de
transporte o NFS (Sistema de Arquivos de Rede) dá suporte. A
configuração padrão é TCP+UDP
nlmprotocol= {TCP|UDP|TCP+UDP} – Especifica a quais protocolos de
transporte o NLM (Gerenciador de Bloqueio de Rede) dá suporte. A
configuração padrão é TCP+UDP.
nlmprotocol= {TCP|UDP|TCP+UDP} – Especifica a quais protocolos de
transporte o NSM (Gerenciador de Status de Rede) dá suporte. A
configuração padrão é TCP+UDP.
enableV3= {yes|no} – Especifica se haverá suporte a protocolos NFS
versão 3. A configuração padrão é Sim.
renewauth= {yes|no} – Especifica se as conexões de cliente
precisarão ser autenticadas novamente após o período especificado
por config renewauthinterval. A configuração padrão é no.
renewauthinterval= <seconds> – Especifica o número de segundos
decorridos antes que um cliente seja forçado a ser reautenticado se
config renewauth estiver definido como yes. O valor padrão é 600
segundos.
dircache= <size> – Especifica o tamanho em KiloBytes do cache de
diretório. O número especificado como size precisa ser um múltiplo
de 4 entre 4 e 128. O tamanho do cache de diretório padrão é 128
KB.
translationfile= <file> – Especifica um arquivo que contém
informações de mapeamento para substituir caracteres nos nomes
dos arquivos ao movê-los de sistemas de arquivos baseados em
Windows para UNIX. Se o arquivo não for especificado, a conversão
de caracteres de nome de arquivo será desabilitada. Se o valor de
Parâmetro Descrição

translationfile for alterado, você precisará reiniciar o servidor para


que a alteração entre em vigor.
dotfileshidden= {yes|no} – Especifica se os arquivos com nomes
que começam com um ponto (.) são marcados como ocultos no
sistema de arquivos do Windows e, consequentemente, ocultos de
clientes NFS. A configuração padrão é no.
casesensitivelookups= {yes|no} – Especifica se as pesquisas de
diretório diferenciam maiúsculas de minúsculas (exigem
correspondência exata de maiúsculas e minúsculas).

Você também precisa desabilitar a diferenciação de maiúsculas e


minúsculas do kernel do Windows para dar suporte a nomes de
arquivo que diferenciam maiúsculas de minúsculas. Para dar suporte
à diferenciação de maiúsculas e minúsculas, altere o valor DWord da
chave do Registro, HKLM\SYSTEM\CurrentControlSet\Control\Session
Manager\kernel , para 0.
ntfscase= {lower|upper|preserve} – Especifica se os caracteres nos
nomes dos arquivos no sistema de arquivos NTFS serão retornados
em letras minúsculas, maiúsculas ou na forma armazenada no
diretório. A configuração padrão é preserve. Essa configuração não
poderá ser alterada se casesensitivelookups estiver definido como
yes.

creategroup <name> Cria um grupo de clientes, dando-lhe o nome especificado.

listgroups Exibe os nomes de todos os grupos de clientes.

deletegroup <name> Remove o grupo de clientes especificado por nome.

renamegroup Altera o nome do grupo de clientes especificado por oldname para


<oldname> <newname> newname.

addmembers Adiciona um host ao grupo de clientes especificado por name.


<hostname>[...]

listmembers <name> Lista os computadores host no grupo de clientes especificado pelo name.

deletemembers Remove o cliente especificado pelo host do grupo de clientes especificado


<hostname> por group.
<groupname>[...]

Parâmetros relacionados ao Cliente NFS

Parâmetro Descrição

iniciar Inicia o serviço Cliente NFS.


Parâmetro Descrição

parar Interrompe o serviço Cliente NFS.

config Especifica as configurações gerais do Cliente NFS. Você precisa fornecer pelo menos
uma das seguintes opções com o argumento de comando config:

fileaccess= <mode> – Especifica o modo de permissão padrão para arquivos


criados em servidores NFS (Sistema de Arquivos de Rede). O argumento
mode consiste em um número de três dígitos, de 0 a 7 (inclusive), que
representam as permissões padrão concedidas a usuário, grupo e outros. Os
dígitos são convertidos em permissões de estilo UNIX da seguinte maneira:
0=none, 1=x (executar), 2=w (somente gravação), 3=wx (gravação e execução),
4=r (somente leitura),5=rx (leitura e execução), 6=rw (leitura e gravação)e
7=rwx (leitura, gravação e execução). Por exemplo, fileaccess=750 fornece
permissões de leitura, gravação e execução ao proprietário, permissões de
leitura e execução ao grupo e nenhuma permissão de acesso a outras
pessoas.
mapsvr= <server> – Define o servidor como o servidor de Mapeamento de
Nome de Usuário do Cliente NFS. Embora essa opção continue com suporte
em relação à compatibilidade com versões anteriores, você deve usar o
utilitário sfuadmin.
mtype= {hard|soft} – Especifica o tipo de montagem padrão. Em uma
montagem definitiva, o Cliente NFS continua a tentar novamente um RPC
com falha até que ele seja bem-sucedido. Em uma montagem temporária, o
Cliente NFS retorna falha na chamada ao aplicativo depois de tentar
novamente chamar o número de vezes especificado pela opção de repetição.
retry= <number> - Especifica o número de tentativas de fazer uma conexão em
uma montagem temporária. Esse valor precisa ser de 1 a 10, inclusive. O
padrão é 1.
timeout= <seconds> – Especifica o número de segundos a se aguardar uma
conexão (chamada de procedimento remoto). Esse valor deve ser 0,8, 0,9ou
um inteiro de 1 a 60, inclusive. O padrão é 0,8.
protocol= {TCP|UDP|TCP+UDP} – Especifica a quais protocolos de transporte o
cliente dá suporte. A configuração padrão é TCP+UDP.
rsize= <size> -Especifica o tamanho, em KiloBytes, do buffer de leitura. Esse
valor pode ser 0,5, 1, 2, 4, 8, 16, ou 32. O padrão é 32.
wsize= <size> – Especifica o tamanho, em KiloBytes, do buffer de gravação.
Esse valor pode ser 0,5, 1, 2, 4, 8, 16, ou 32. O padrão é 32.
perf=default – Restaura as seguintes configurações de desempenho para
valores padrão, mtype, retry, timeout, rsize ou wsize.

Exemplos
Para interromper o Servidor para NFS ou o Cliente NFS, digite:
nfsadmin server stop
nfsadmin client stop

Para iniciar o Servidor para NFS ou Cliente NFS, digite:

nfsadmin server start


nfsadmin client start

Para definir que o Servidor para NFS não diferencie maiúsculas de minúsculas, digite:

nfsadmin server config casesensitive=no

Para definir que o Cliente NFS diferencie maiúsculas de minúsculas, digite:

nfsadmin client config casesensitive=yes

Para exibir todas as opções atuais do Servidor para NFS ou do Cliente NFS, digite:

nfsadmin server config


nfsadmin client config

Links relacionados
Chave da sintaxe de linha de comando

Referência de cmdlets NFS


nfsshare
Artigo • 12/04/2023

Controle os compartilhamentos do NFS (Sistema de Arquivos de Rede). Usado sem


parâmetros, esse comando exibe todos os compartilhamentos do NFS (Sistema de
Arquivos de Rede) exportados pelo Servidor para NFS.

Sintaxe

nfsshare <sharename>=<drive:path> [-o <option=value>...]


nfsshare {<sharename> | <drive>:<path> | * } /delete

Parâmetros

Parâmetro Descrição

-o anon= {yes|no} Especifica se usuários anônimos (não mapeados) podem acessar o


diretório de compartilhamento.

-o rw= [<host>[: Fornece acesso de leitura/gravação ao diretório compartilhado pelos


<host>]...] hosts ou grupos de clientes especificados pelo host. Você deve
separar nomes de host e de grupo com dois-pontos (:). Se o host não
for especificado, todos os hosts e grupos de clientes (exceto os
especificados com a opção ro) terão acesso de leitura/gravação. Se
nem a opção ro nem a rw estiver definida, todos os clientes terão
acesso de leitura/gravação ao diretório compartilhado.

-o ro= [<host>[: Fornece acesso somente leitura ao diretório compartilhado pelos


<host>]...] hosts ou grupos de clientes especificados pelo host. Você deve
separar nomes de host e de grupo com dois-pontos (:). Se o host não
for especificado, todos os clientes (exceto os especificados com a
opção rw) terão acesso somente leitura. Se a opção ro estiver
definida para um ou mais clientes, mas a opção rw não estiver
definida, somente os clientes especificados com a opção ro terão
acesso ao diretório compartilhado.
Parâmetro Descrição

-o encoding= {euc- Especifica a codificação de idioma a ser configurada em um


jp|euc-tw|euc-kr|shift- compartilhamento NFS. Você pode usar apenas um idioma no
jis|Big5|Ksc5601|Gb2312- compartilhamento. Esse valor pode incluir qualquer um dos seguintes
80|Ansi) valores:
euc-jp: japonês
euc-tw: chinês
euc-kr: coreano
shift-jis: japonês
Big5: chinês
Ksc5601: coreano
Gb2312-80: chinês simplificado
Ansi: codificado em ANSI

-o anongid= <gid> Especifica que usuários anônimos (não mapeados) acessem o


diretório de compartilhamento usando gid como o GID (identificador
de grupo). O padrão é -2. O GID anônimo é usado ao relatar o
proprietário de um arquivo pertencente a um usuário não mapeado,
mesmo que o acesso anônimo esteja desabilitado.

-o anonuid= <uid> Especifica que usuários anônimos (não mapeados) acessem o


diretório de compartilhamento usando uid como o UID (identificador
de usuário). O padrão é -2. O UID anônimo é usado ao relatar o
proprietário de um arquivo pertencente a um usuário não mapeado,
mesmo que o acesso anônimo esteja desabilitado.

-o root= [<host>[: Fornece acesso raiz ao diretório compartilhado pelos hosts ou grupos
<host>]...] de clientes especificados pelo host. Você deve separar nomes de host
e de grupo com dois-pontos (:). Se o host não for especificado, todos
os clientes terão acesso raiz. Se a opção root não estiver definida,
nenhum cliente terá acesso raiz ao diretório compartilhado.

/delete Se sharename ou <drive>:<path> for especificado, esse parâmetro


excluirá o compartilhamento especificado. Se um curinga (*) for
especificado, esse parâmetro excluirá todos os compartilhamentos
NFS.

/? Exibe a ajuda no prompt de comando.

Comentários
Se sharename for o único parâmetro, esse comando listará as propriedades do
compartilhamento do NFS identificado por sharename.

Se sharename e <drive>:<path> forem usados, esse comando exportará a pasta


identificada por <drive>:<path> como sharename. Se você usar a opção /delete, a
pasta especificada deixará de estar disponível para clientes NFS.

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos dos Serviços para Network File System

Referência de cmdlets NFS


nfsstat
Artigo • 12/04/2023

Um utilitário de linha de comando que exibe as informações estatísticas sobre as


chamadas NFS (Sistema de Arquivos de Rede) e RPC (Chamada de Procedimento
Remoto). Usado sem parâmetros, esse comando exibe todos os dados estatísticos sem
redefinir nada.

Sintaxe

nfsstat [-c][-s][-n][-r][-z][-m]

Parâmetros

Parâmetro Descrição

-c Exibe apenas as chamadas NFS do lado do cliente e as chamadas RPC e NFS


enviadas e rejeitadas pelo cliente. Para exibir somente as informações de NFS ou
RPC, combine esse sinalizador com o parâmetro -n ou -r.

-S Exibe apenas as chamadas NFS do lado do servidor e as chamadas RPC e NFS


enviadas e rejeitadas pelo servidor. Para exibir somente as informações de NFS ou
RPC, combine esse sinalizador com o parâmetro -n ou -r.

-M Exibe as informações sobre os sinalizadores de montagem definidos por opções de


montagem, sinalizadores de montagem internos para o sistema e outras
informações de montagem.

-n Exibe as informações de NFS para o cliente e o servidor. Para exibir apenas as


informações do cliente ou servidor NFS, combine esse sinalizador com o parâmetro
-c ou -s.

-r Exibe as informações de RPC para o cliente e o servidor. Para exibir apenas as


informações do cliente ou servidor RPC, combine esse sinalizador com o parâmetro
-c ou -s.

-Z Redefine as estatísticas de chamada. Esse sinalizador só está disponível para o


usuário raiz e pode ser combinado com qualquer um dos outros parâmetros para
redefinir determinados conjuntos de estatísticas, depois de exibi-los.

Exemplos
Para exibir as informações sobre o número de chamadas RPC e NFS enviadas e
rejeitadas pelo cliente, digite:

nfsstat -c

Para exibir e imprimir as informações relacionadas à chamada NFS do cliente, digite:

nfsstat -cn

Para exibir as informações relacionadas à chamada RPC para o cliente e o servidor,


digite:

nfsstat -r

Para exibir as informações sobre o número de chamadas RPC e NFS recebidas e


rejeitadas pelo servidor, digite:

nfsstat -s

Para redefinir todas as informações relacionadas à chamada como zero no cliente e no


servidor, digite:

nfsstat -z

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos dos Serviços para Network File System

Referência de cmdlets NFS


nlbmgr
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Configure e gerencie seus clusters de Balanceamento de Carga de Rede e todos os


hosts de cluster em um único computador, usando o Gerenciador de Balanceamento de
Carga de Rede. Você também pode usar esse comando para replicar a configuração do
cluster para outros hosts.

Você pode iniciar o Gerenciador de Balanceamento de Carga de Rede na linha de


comando usando o comando nlbmgr.exe, que está instalado na pasta
systemroot\System32.

Sintaxe

nlbmgr [/noping][/hostlist <filename>][/autorefresh <interval>][/help | /?]

Parâmetros

Parâmetro Descrição

/noping Impede que o Gerenciador de Balanceamento de Carga de Rede execute ping nos
hosts, antes de tentar entrar em contato com eles por meio do WMI
(Instrumentação de Gerenciamento do Windows). Use essa opção se você tiver
desabilitado o protocolo ICMP em todos os adaptadores de rede disponíveis. Se o
Gerenciador de Balanceamento de Carga de Rede tentar entrar em contato com
um host que não está disponível, você terá um atraso ao usar essa opção.

/hostlist Carrega os hosts especificados no nome do arquivo no Gerenciador de


<filename> Balanceamento de Carga de Rede.

/autorefresh Faz com que o Gerenciador de Balanceamento de Carga de Rede atualize as


<interval> informações de host e cluster a cada <interval> segundos. Se nenhum intervalo
for especificado, as informações serão atualizadas a cada 60 segundos.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.


Links relacionados
Chave da sintaxe de linha de comando

Referência de cmdlets do NetworkLoadBalancingClusters


nslookup
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe informações que você pode usar para diagnosticar a infraestrutura do DNS
(Serviço de Nomes de Domínio). Antes de usar essa ferramenta, você deve estar
familiarizado com o funcionamento do DNS. A ferramenta de linha de comando
nslookup só estará disponível se você tiver instalado o protocolo TCP/IP.

A ferramenta de linha de comando nslookup tem dois modos: interativo e não


interativo.

Se você precisar pesquisar apenas uma única parte dos dados, recomendamos usar o
modo não interativo. Para o primeiro parâmetro, digite o nome ou o endereço IP do
computador que você deseja pesquisar. Para o segundo parâmetro, digite o nome ou o
endereço IP de um servidor de nomes DNS. Se você omitir o segundo argumento, o
nslookup usará o servidor de nomes DNS padrão.

Se você precisar pesquisar mais de um dado, poderá usar o modo interativo. Digite um
hífen (-) para o primeiro parâmetro e o nome ou endereço IP de um servidor de nomes
DNS para o segundo parâmetro. Se você omitir ambos os parâmetros, a ferramenta
usará o servidor de nomes DNS padrão. Ao usar o modo interativo, você pode:

Interromper comandos interativos a qualquer momento pressionando CTRL+B.

Sair, digitando exit.

Tratar um comando interno como um nome de computador, precedendo-o com o


caractere de escape ( \ ). Um comando não reconhecido é interpretado como um
nome de computador.

Sintaxe

nslookup [exit | finger | help | ls | lserver | root | server | set | view]


[options]
Parâmetros

Parâmetro Descrição

nslookup Sai da ferramenta da linha de comando nslookup.


exit

nslookup Conecta o servidor finger no computador atual.


finger

nslookup Exibe um breve resumo de subcomandos.


help

nslookup Lista informações para um domínio DNS.


ls

nslookup Altera o servidor padrão para o domínio DNS especificado.


lserver

nslookup Altera o servidor padrão para o servidor da raiz do espaço de nome de domínio do
root DNS.

nslookup Altera o servidor padrão para o domínio DNS especificado.


server

nslookup Altera as definições de configuração que afetam como as pesquisas funcionam.


set

nslookup Imprime os valores atuais das definições de configuração.


set all

nslookup Altera a classe de consulta. A classe especifica o grupo de protocolos das


set class informações.

nslookup Ativa ou desativa o modo de depuração exaustiva. Todos os campos de cada pacote
set d2 são impressos.

nslookup Ativa ou desativa o modo de depuração.


set debug

nslookup Altera o nome de domínio DNS padrão para o nome especificado.


set domain

nslookup Altera a porta do servidor de nome DNS TCP/UDP padrão para o valor especificado.
set port

nslookup Altera o tipo de registro de recurso da consulta.


set
querytype
Parâmetro Descrição

nslookup Informa ao servidor de nomes DNS para consultar outros servidores se ele não tiver
set recurse as informações.

nslookup Define o número de repetições.


set retry

nslookup Altera o nome do servidor raiz usado para consultas.


set root

nslookup Acrescenta os nomes de domínio DNS na lista de pesquisa de domínios DNS à


set search solicitação até que uma resposta seja recebida. Isso se aplica quando o conjunto e a
solicitação de pesquisa contêm, pelo menos, um ponto, mas não terminam com um
ponto à direita.

nslookup Altera o nome de domínio DNS padrão e a lista de pesquisa.


set srchlist

nslookup Altera o número inicial de segundos para aguardar uma resposta a uma solicitação.
set
timeout

nslookup Altera o tipo de registro de recurso da consulta.


set type

nslookup Especifica se um circuito virtual deve ser usado ou não ao enviar solicitações para o
set vc servidor.

nslookup Classifica e lista a saída dos subcomandos ou dos comandos ls anteriores.


view

Comentários
Se computerTofind for um endereço IP e a consulta for para um tipo de registro de
recurso A ou PTR, o nome do computador será retornado.

Se computerTofind for um nome e não tiver um período à direita, o nome de


domínio DNS padrão será acrescentado ao nome. Esse comportamento depende
do estado dos seguintes subcomandos set: domain, srchlist, defname e search.

Se você digitar um hífen (-) em vez de computerTofind, o prompt de comando será


alterado para o modo interativo nslookup.

Se a solicitação de pesquisa falhar, a ferramenta de linha de comando fornecerá


uma mensagem de erro, incluindo:
Mensagem Descrição
de erro

tempo O servidor não respondeu a uma solicitação após um determinado período


limite de tempo e um determinado número de repetições. Você pode definir o
atingido período de tempo limite com o comando nslookup set timeout. Você pode
definir o número de repetições com o comando nslookup set retry.

Sem Nenhum servidor de nomes DNS está em execução no computador do


resposta do servidor.
serviço

Sem O servidor de nomes DNS não tem registros de recurso do tipo de consulta
registros atual para o computador, embora o nome do computador seja válido. O tipo
de consulta é especificado com o comando nslookup set querytype.

Domínio O computador ou o nome de domínio DNS não existe.


inexistente

Conexão Não foi possível fazer a conexão com o servidor de nomes DNS ou o servidor
recusada finger. Esse erro geralmente ocorre com as solicitações ls e finger.
ou Rede
inacessível

Falha do O servidor de nomes DNS encontrou uma inconsistência interna em seu


servidor banco de dados e não pôde retornar uma resposta válida.

Recusado O servidor de nome DNS se recusou a atender à solicitação.

erro de O servidor de nome DNS descobriu que o pacote de solicitação não estava
formato no formato adequado. Pode indicar um erro no nslookup.

Links relacionados
Chave da sintaxe de linha de comando
nslookup /exit
Artigo • 11/04/2023

Sai da ferramenta da linha de comando nslookup.

Sintaxe

nslookup /exit

Parâmetros

Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
nslookup /finger
Artigo • 11/04/2023

Conecta o servidor finger no dispositivo atual.

Sintaxe

finger [<username>] [{[>] <filename> | [>>] <filename>}]

Parâmetros

Parâmetro Descrição

<username> Especifica o nome do usuário a ser pesquisado.

<filename> Especifica um nome de arquivo no qual salvar a saída. Você pode usar os caracteres
maiores que ( > ) e duplos maiores que ( >> ) para redirecionar a saída da maneira
usual.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
nslookup help
Artigo • 12/04/2023

Exibe o texto de ajuda de subcomando.

Sintaxe

help

Parâmetros

Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
nslookup ls
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Lista as informações de domínio DNS.

Sintaxe

ls [<option>] <DNSdomain> [{[>] <filename>|[>>] <filename>}]

Parâmetros

Parâmetro Descrição

<option> As opções válidas incluem:


-t: lista todos os registros do tipo especificado. Para obter mais informações,
confira nslookup set querytype.
-a: lista os aliases dos computadores no domínio DNS. Esse parâmetro é
igual ao -t CNAME
-d: lista todos os registros do domínio DNS. Esse parâmetro é igual ao -t
ANY
-h: lista as informações de CPU e sistema operacional do domínio DNS. Esse
parâmetro é igual ao -t HINFO
-s: lista os serviços conhecidos dos computadores no domínio DNS. Esse
parâmetro é igual ao -t WKS.

<DNSdomain> Especifica o domínio DNS para o qual você deseja obter informações.

<filename> Especifica um nome de arquivo a ser usado para a saída salva. Você pode usar os
caracteres maiores que ( > ) e duplos maiores que ( >> ) para redirecionar a saída da
maneira usual.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Comentários
A saída padrão desse comando inclui os nomes de computador e os endereços IP
associados.

Se a saída for direcionada a um arquivo, as marcas de hash serão adicionadas para


cada 50 registros recebidos do servidor.

Links relacionados
Chave da sintaxe de linha de comando

nslookup set querytype


nslookup lserver
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o servidor inicial para o domínio DNS (Sistema de Nomes de Domínio)


especificado.

Esse comando usa o servidor inicial para pesquisar as informações sobre o domínio DNS
especificado. Se você quiser pesquisar informações usando o servidor padrão atual, use
o comando nslookup server.

Sintaxe

lserver <DNSdomain>

Parâmetros

Parâmetro Descrição

<DNSdomain> Especifica o domínio DNS do servidor inicial.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando

nslookup server
nslookup root
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o servidor padrão para o servidor da raiz do espaço de nome de domínio do DNS
(Sistema de Nomes de Domínio). No momento, o servidor de nomes ns.nic.ddn.mil é
usado. Você pode alterar o nome do servidor raiz usando o comando nslookup set root.

7 Observação

Esse comando é igual a lserver ns.nic.ddn.mil .

Sintaxe

root

Parâmetros

Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando

nslookup set root


nslookup server
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o servidor padrão para o domínio DNS (Sistema de Nomes de Domínio)


especificado.

Esse comando usa o servidor padrão atual para pesquisar informações sobre o domínio
DNS especificado. Se você quiser pesquisar informações usando o servidor inicial, use o
comando nslookup lserver.

Sintaxe

server <DNSdomain>

Parâmetros

Parâmetro Descrição

<DNSdomain> Especifica o domínio DNS para o servidor padrão.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando

nslookup lserver
nslookup set
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera as definições de configuração que afetam como as pesquisas funcionam.

Sintaxe

set all [class | d2 | debug | domain | port | querytype | recurse | retry |


root | search | srchlist | timeout | type | vc] [options]

Parâmetros

Parâmetro Descrição

nslookup Lista todas as configurações atuais.


set all

nslookup Altera a classe de consulta, que especifica o grupo de protocolos das informações.
set class

nslookup Ativa ou desativa o modo de depuração detalhado.


set d2

nslookup Desativa completamente o modo de depuração.


set debug

nslookup Altera o nome de domínio DNS (Sistema de Nomes de Domínio) padrão para o
set domain nome especificado.

nslookup Altera a porta do servidor de nome DNS (Sistema de Nomes de Domínio) TCP/UDP
set port padrão para o valor especificado.

nslookup Altera o tipo de registro de recurso da consulta.


set
querytype

nslookup Informa ao servidor de nomes DNS (Sistema de Nomes de Domínio) para consultar
set recurse outros servidores, se ele não encontrar as informações.
Parâmetro Descrição

nslookup Define o número de repetições.


set retry

nslookup Altera o nome do servidor raiz usado para consultas.


set root

nslookup Acrescenta os nomes de domínio DNS (Sistema de Nomes de Domínio) na lista de


set search pesquisa de domínios DNS à solicitação até que uma resposta seja recebida.

nslookup Altera o nome de domínio DNS (Sistema de Nomes de Domínio) padrão e a lista de
set srchlist pesquisa.

nslookup Altera o número inicial de segundos para aguardar uma resposta a uma solicitação
set de pesquisa.
timeout

nslookup Altera o tipo de registro de recurso da consulta.


set type

nslookup Especifica se um circuito virtual deve ser usado ao enviar solicitações para o
set vc servidor.

Links relacionados
Chave da sintaxe de linha de comando
nslookup set all
Artigo • 12/04/2023

Gera os valores de configuração atuais, incluindo o servidor e o computador padrão (o


host).

Sintaxe

set all

Parâmetros

Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
nslookup set class
Artigo • 11/04/2023

Altera a classe de consulta. A classe especifica o grupo de protocolos das informações.

Sintaxe

set class=<class>

Parâmetros

Parâmetro Descrição

<class> Os valores válidos incluem:


IN: Especifica a classe Internet. Esse é o valor padrão.
CHAOS: Especifica a classe Chaos.
HESIOD: Especifica a classe MIT Athena Hesiod.
ANY: Especifica o uso de qualquer um dos valores listados anteriormente.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
nslookup set d2
Artigo • 12/04/2023

Ativa ou desativa o modo de depuração detalhado. Todos os campos de cada pacote


são impressos.

Sintaxe

set [no]d2

Parâmetros

Parâmetro Descrição

nod2 Desativa o modo de depuração detalhado. Esse é o valor padrão.

d2 Ativa o modo de depuração detalhado.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
nslookup set debug
Artigo • 12/04/2023

Ativa ou desativa o modo de depuração.

Sintaxe

set [no]debug

Parâmetros

Parâmetro Descrição

nodebug Desativa o modo de depuração. Esse é o valor padrão.

depurar Ativa o modo de depuração. Ao ativar o modo de depuração, você pode exibir mais
informações sobre o pacote enviado ao servidor e a resposta resultante.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
nslookup set domain
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o nome de domínio DNS (Sistema de Nomes de Domínio) padrão para o nome
especificado.

Sintaxe

set domain=<domainname>

Parâmetros

Parâmetro Descrição

<domainname> Especifica um novo nome para o nome de domínio DNS padrão. O valor padrão é
o nome do host.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Comentários
O nome de domínio DNS padrão é acrescentado a uma solicitação de pesquisa,
dependendo do estado das opções defname e search.

A lista de pesquisa de domínios DNS contém os pais do domínio DNS padrão se


ele tem, pelo menos, dois componentes em seu nome. Por exemplo, se o domínio
DNS padrão for mfg.widgets.com, a lista de pesquisa será nomeada como
mfg.widgets.com e widgets.com.

Use o comando nslookup set srchlist para especificar uma lista diferente e o
comando nslookup set all para exibir a lista.

Links relacionados
Chave da sintaxe de linha de comando

nslookup set srchlist

nslookup set all


nslookup set port
Artigo • 12/04/2023

Altera a porta do servidor de nome DNS (Sistema de Nomes de Domínio) TCP/UDP


padrão para o valor especificado.

Sintaxe

set port=<port>

Parâmetros

Parâmetro Descrição

<port> Especifica o novo valor para a porta do servidor de nome DNS TCP/UDP padrão. A
porta padrão é 53.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
nslookup set querytype
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o tipo de registro de recurso da consulta. Para obter informações sobre os tipos
de registro de recurso, confira Solicitação de Comentário (Rfc) 1035 .

7 Observação

Esse comando é igual ao comando nslookup set type.

Sintaxe

set querytype=<resourcerecordtype>

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

<resourcerecordtype> Especifica um tipo de registro de recurso DNS. O tipo de registro de


recurso padrão é A, mas você pode usar qualquer um dos seguintes
valores:

A: especifica o endereço IP de um computador.


ANY: especifica o endereço IP de um computador.
CNAME: especifica um nome canônico para um alias.
GID Especifica um identificador de grupo de um nome de grupo.
HINFO: especifica a CPU e o tipo de sistema operacional de um
computador.
MB: especifica um nome de domínio de caixa de correio.
MG: especifica um membro do grupo de email.
MINFO: especifica as informações de caixa de correio ou lista de
correio.
MR: especifica o nome de domínio de renomeação de email.
MX: especifica o trocador de email.
NS: especifica um servidor de nomes DNS da zona nomeada.
PTR: especifica um nome de computador, se a consulta for um
endereço IP. Caso contrário, especifica o ponteiro para as outras
informações.
SOA: especifica o start-of-authority de uma zona DNS.
TXT: especifica as informações de texto.
UID: especifica o identificador do usuário.
UINFO: especifica as informações do usuário.
WKS: descreve um serviço conhecido.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando

nslookup set type


nslookup set recurse
Artigo • 11/04/2023

Informa ao servidor DNS (Sistema de Nomes de Domínio) para consultar outros


servidores se ele não conseguir encontrar as informações no servidor especificado.

Sintaxe

set [no]recurse

Parâmetros

Parâmetro Descrição

norecurse Informa o servidor DNS (Sistema de Nomes de Domínio) para não consultar outros
servidores se ele não conseguir encontrar as informações no servidor especificado.

recurse Informa ao servidor DNS (Sistema de Nomes de Domínio) para consultar outros
servidores se ele não conseguir encontrar as informações no servidor especificado.
Esse é o valor padrão.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
nslookup set retry
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Se uma resposta não for recebida dentro de um determinado período de tempo, o


período de tempo limite será duplicado e a solicitação será reenviada. Esse comando
define o número de vezes que uma solicitação é reenviada para um servidor para obter
informações, antes de desistir.

7 Observação

Para alterar o tempo limite antes do tempo limite da solicitação, use o comando
nslookup set timeout.

Sintaxe

set retry=<number>

Parâmetros

Parâmetro Descrição

<number> Especifica o novo valor para o número de repetições. O número padrão de novas
tentativas é 4.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando

nslookup set timeout


nslookup set root
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o nome do servidor raiz usado para consultas.

7 Observação

Esse comando dá suporte ao comando nslookup root.

Sintaxe

set root=<rootserver>

Parâmetros

Parâmetro Descrição

<rootserver> Especifica o novo nome do servidor raiz. O valor padrão é ns.nic.ddn.mil.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando

nslookup root
nslookup set search
Artigo • 11/04/2023

Acrescenta os nomes de domínio DNS (Sistema de Nomes de Domínio) na lista de


pesquisa de domínios DNS à solicitação até que uma resposta seja recebida. Isso se
aplica quando o conjunto e a solicitação de pesquisa contêm, pelo menos, um ponto,
mas não terminam com um ponto à direita.

Sintaxe

set [no]search

Parâmetros

Parâmetro Descrição

nosearch Para de acrescentar os nomes de domínio DNS (Sistema de Nomes de Domínio) na


lista de pesquisa de domínios DNS para a solicitação.

pequisa Acrescenta os nomes de domínio DNS (Sistema de Nomes de Domínio) na lista de


pesquisa de domínios DNS para a solicitação até que uma resposta seja recebida.
Esse é o valor padrão.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
nslookup set srchlist
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o nome de domínio DNS (Sistema de Nomes de Domínio) padrão e a lista de


pesquisa. Esse comando substitui o nome de domínio DNS padrão e a lista de pesquisa
do comando nslookup set domain.

Sintaxe

set srchlist=<domainname>[/...]

Parâmetros

Parâmetro Descrição

<domainname> Especifica novos nomes para o domínio DNS padrão e a lista de pesquisa. O valor
de nome de domínio padrão é baseado no nome do host. Você pode especificar
no máximo seis nomes separados por barras (/).

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Comentários

Use o comando nslookup set all para exibir a lista.

Exemplos
Para definir o domínio DNS como mfg.widgets.com e a lista de pesquisa como os três
nomes:

set srchlist=mfg.widgets.com/mrp2.widgets.com/widgets.com
Links relacionados
Chave da sintaxe de linha de comando

nslookup set domain

nslookup set all


nslookup set timeout
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o número inicial de segundos para aguardar uma resposta a uma solicitação de
pesquisa. Se uma resposta não for recebida em um período especificado, o tempo limite
será duplicado e a solicitação reenviada. Use o comando nslookup set retry para
determinar o número de vezes para tentar enviar a solicitação.

Sintaxe

set timeout=<number>

Parâmetros

Parâmetro Descrição

<number> Especifica o número de segundos para aguardar uma resposta. O número padrão
de segundos para esperar é 5.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Exemplos
Para definir o tempo limite para obter uma resposta como 2 segundos:

set timeout=2

Links relacionados
Chave da sintaxe de linha de comando
nslookup set retry
nslookup set type
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o tipo de registro de recurso da consulta. Para obter informações sobre os tipos
de registro de recurso, confira Solicitação de Comentário (Rfc) 1035 .

7 Observação

Esse comando é igual ao comando nslookup set querytype.

Sintaxe

set type=<resourcerecordtype>

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

<resourcerecordtype> Especifica um tipo de registro de recurso DNS. O tipo de registro de


recurso padrão é A, mas você pode usar qualquer um dos seguintes
valores:

A: especifica o endereço IP de um computador.


ANY: especifica o endereço IP de um computador.
CNAME: especifica um nome canônico para um alias.
GID Especifica um identificador de grupo de um nome de grupo.
HINFO: especifica a CPU e o tipo de sistema operacional de um
computador.
MB: especifica um nome de domínio de caixa de correio.
MG: especifica um membro do grupo de email.
MINFO: especifica as informações de caixa de correio ou lista de
correio.
MR: especifica o nome de domínio de renomeação de email.
MX: especifica o trocador de email.
NS: especifica um servidor de nomes DNS da zona nomeada.
PTR: especifica um nome de computador, se a consulta for um
endereço IP. Caso contrário, especifica o ponteiro para as outras
informações.
SOA: especifica o start-of-authority de uma zona DNS.
TXT: especifica as informações de texto.
UID: especifica o identificador do usuário.
UINFO: especifica as informações do usuário.
WKS: descreve um serviço conhecido.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando

nslookup set type


nslookup set vc
Artigo • 12/04/2023

Especifica se um circuito virtual deve ser usado ao enviar solicitações para o servidor.

Sintaxe

set [no]vc

Parâmetros

Parâmetro Descrição

novc Especifica que um circuito virtual nunca seja usado ao enviar solicitações para o
servidor. Esse é o valor padrão.

vc Especifica que um circuito virtual sempre seja usado ao enviar solicitações para o
servidor.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
nslookup view
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Classifica e lista a saída dos comandos ou dos subcomandos ls anteriores.

Sintaxe

view <filename>

Parâmetros

Parâmetro Descrição

<filename> Especifica o nome do arquivo que contém a saída dos comandos ou dos
subcomandos ls anteriores.

/? Exibe a ajuda no prompt de comando.

/help Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando

nslookup ls
ntbackup
Artigo • 08/05/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O comando ntbackup faz backup do computador e dos arquivos de um prompt de


comando e os restaura. Esse comando é substituído pelo comando wbadmin.

) Importante

O comando wbadmin não pode recuperar backups criados usando os comandos


ntbackup . O utilitário Windows NT Backup - Restore é necessário para se recuperar
de backups herdados.

Links relacionados
Chave da sintaxe de linha de comando

wbadmin
ntcmdprompt
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Executa o interpretador de comando Cmd.exe, em vez de Command.com, depois de


executar um TSR (Terminate and Stay Resident) ou depois de iniciar o prompt de
comando de dentro de um aplicativo MS-DOS.

Sintaxe

ntcmdprompt

Parâmetros

Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Comentários

Quando o Command.com está em execução, alguns recursos do Cmd.exe, como a


exibição do doskey do histórico de comandos, não ficam disponíveis. Se preferir
executar o interpretador de comando Cmd.exe, depois de iniciar um TSR
(Terminate and Stay Resident) ou iniciar o prompt de comando de dentro de um
aplicativo baseado em MS-DOS, você poderá usar o comando ntcmdprompt. No
entanto, tenha em mente que o TSR pode não ficar disponível para uso enquanto
você estiver executando Cmd.exe. Você pode incluir o comando ntcmdprompt no
arquivo Config.nt ou o arquivo de inicialização personalizado equivalente no
arquivo de informações do programa (Pif) de um aplicativo.

Links relacionados
Chave da sintaxe de linha de comando
ntfrsutl
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Despeja as tabelas internas, o thread e as informações de memória do NTFRS (Serviço


de Replicação de Arquivos NT) dos servidores locais e remotos. A configuração de
recuperação do NTFRS no SCM (Gerenciador de Controle de Serviço) pode ser essencial
para localizar e manter eventos de log importantes no computador. Essa ferramenta
fornece um método prático de revisão dessas configurações.

Sintaxe

ntfrsutl[idtable|configtable|inlog|outlog][<computer>]
ntfrsutl[memory|threads|stage][<computer>]
ntfrsutl ds[<computer>]
ntfrsutl [sets][<computer>]
ntfrsutl [version][<computer>]
ntfrsutl poll[/quickly[=[<n>]]][/slowly[=[<n>]]][/now][<computer>]

Parâmetros

Parâmetro Descrição

idtable Especifica a tabela de ID.

configtable Especifica a tabela de configuração do FRS.

inlog Especifica o log de entrada.

outlog Especifica o log de saída.

<computer> Especifica o computador.

memória Especifica o uso de memória.

threads Especifica o uso de memória.

preparar Especifica o uso de memória.

ds Lista a exibição do serviço NTFRS do DS.


Parâmetro Descrição

conjuntos Especifica os conjuntos de réplicas ativos.

version Especifica as versões de serviço da API e do NTFRS.

poll Especifica os intervalos de sondagem atuais.


/quickly – Sonda rapidamente até recuperar uma configuração estável.
/quickly= – Sonda rapidamente cada número de minutos padrão.
/quickly=<n> – Sonda rapidamente a cada n minutos.
/slowly – Sonda lentamente até recuperar uma configuração estável.
/slowly= – Sonda lentamente cada número de minutos padrão.
/slowly=<n> – Sonda lentamente a cada n minutos.
/now – Sonda agora.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para determinar o intervalo de sondagem para replicação de arquivo, digite:

C:\Program Files\SupportTools>ntfrsutl poll wrkstn-1

Para determinar a versão atual da API do NTFRS, digite:

C:\Program Files\SupportTools>ntfrsutl version

Links relacionados
Chave da sintaxe de linha de comando
offline
Artigo • 12/04/2023

Leva um disco ou volume online para o estado offline.

Sintaxe

offline disk
offline volume

Parâmetros

Parâmetro Descrição

offline disk Leva o disco online com foco para o estado offline.

offline volume Leva o volume online com foco para o estado offline.

Links relacionados
Chave da sintaxe de linha de comando
offline disk
Artigo • 12/04/2023

Leva o disco online com foco para o estado offline. Se um disco dinâmico em um grupo
de discos for colocado offline, o status do disco será alterado para ausente e o grupo
mostrará um disco offline. O disco ausente será movido para o grupo inválido. Se o
disco dinâmico for o último disco do grupo, o status do disco será alterado para offline
e o grupo vazio será removido.

7 Observação

Um disco deve ser selecionado para que o comando offline disk tenha êxito. Use o
comando select disk para selecionar um disco e mudar o foco para ele.

Esse comando também funciona em discos no modo online SAN alterando o modo
SAN para offline.

Sintaxe

offline disk [noerr]

Parâmetros

Parâmetro Descrição

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Exemplos
Para colocar o disco com foco offline, digite:

offline disk
Links relacionados
Chave da sintaxe de linha de comando
offline volume
Artigo • 12/04/2023

Leva o volume online com foco para o estado offline.

7 Observação

Um volume deve ser selecionado para que o comando de offline volume tenha
êxito. Use o comando select volume para selecionar um disco e mudar o foco para
ele.

Sintaxe

offline volume [noerr]

Parâmetros

Parâmetro Descrição

noerr Somente para scripts. Quando um erro é encontrado, DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que DiskPart saia com um código de erro.

Exemplos
Para colocar o disco com foco offline, digite:

offline volume

Links relacionados
Chave da sintaxe de linha de comando
online
Artigo • 12/04/2023

Leva um disco ou volume offline para o estado online.

Sintaxe

online disk
online volume

Parâmetros

Parâmetro Descrição

online disk Leva o disco offline com foco para o estado online.

online volume Leva o volume offline com foco para o estado online.

Links relacionados
Chave da sintaxe de linha de comando
online disk
Artigo • 14/04/2023

Leva o disco offline para o estado online. Para os discos básicos, esse comando tenta
colocar online o disco selecionado e todos os volumes nesse disco. Para os discos
dinâmicos, esse comando tenta colocar online todos os discos que não estão marcados
como estrangeiros no computador local. Ele também tenta colocar online todos os
volumes no conjunto de discos dinâmicos.

Se um disco dinâmico em um grupo de discos for colocado online e for o único disco
no grupo, o grupo original será recriado e o disco movido para esse grupo. Se houver
outros discos no grupo e eles estiverem online, o disco será simplesmente adicionado
novamente ao grupo. Se o grupo de um disco selecionado contiver volumes espelhados
ou RAID-5, esse comando também sincronizará de novo esses volumes.

7 Observação

Um disco deve ser selecionado para que o comando online disk tenha êxito. Use o
comando select disk para selecionar um disco e mudar o foco para ele.

) Importante

Esse comando falhará se for usado em um disco de somente leitura.

Sintaxe

online disk [noerr]

Parâmetros
Para obter instruções sobre como usar esse comando, consulte Reativar um disco
dinâmico ausente ou offline.

Parâmetro Descrição
Parâmetro Descrição

noerr Somente para scripts. Quando um erro é encontrado, DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que DiskPart saia com um código de erro.

Exemplos
Para colocar online o disco com foco, digite:

online disk

Links relacionados
Chave da sintaxe de linha de comando
online volume
Artigo • 14/04/2023

Leva o volume offline para o estado online. Esse comando funciona em volumes que
falharam, estão falhando ou estão em um estado de redundância com falha.

7 Observação

Um volume deve ser selecionado para que o comando de online volume tenha
êxito. Use o comando select volume para selecionar um volume e mudar o foco
para ele.

) Importante

Esse comando falhará se for usado em um disco de somente leitura.

Sintaxe

online volume [noerr]

Parâmetros

Parâmetro Descrição

noerr Somente para scripts. Quando um erro é encontrado, DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que DiskPart saia com um código de erro.

Exemplos
Para colocar o volume com foco online, digite:

online volume
Links relacionados
Chave da sintaxe de linha de comando
openfiles
Artigo • 12/04/2023

Permite que um administrador consulte, exiba ou desconecte arquivos e diretórios que


foram abertos em um sistema. Esse comando também habilita ou desabilita o
sinalizador global Maintain Objects List do sistema.

openfiles /disconnect
Permite que um administrador desconecte arquivos e pastas que foram abertos
remotamente por meio de uma pasta compartilhada.

Sintaxe

openfiles /disconnect [/s <system> [/u [<domain>\]<username> [/p


[<password>]]]] {[/id <openfileID>] | [/a <accessedby>] | [/o {read | write
| read/write}]} [/op <openfile>]

Parâmetros

Parâmetro Descrição

/s <system> Especifica o sistema remoto ao qual se conectar (por nome ou endereço IP). Não
use barras invertidas. Se você não usar a opção /s, o comando será executado no
computador local por padrão. Esse parâmetro se aplica a todos os arquivos e
pastas que foram especificados no comando.

/u Executa o comando usando as permissões da conta de usuário especificada. Se


[<domain>\] você não usar a opção /u, as permissões do sistema serão usadas por padrão.
<username>

/p Especifica a senha da conta de usuário especificada na opção /u. Se você não usar
[<password>] a opção /p, um prompt de senha será exibido quando o comando for executado.

/id Desconecta arquivos abertos pela ID de arquivo especificada. Você pode usar o
<openfileID> caractere curinga (*) com esse parâmetro.

Observação: você pode usar o comando openfiles /query para localizar a ID do


arquivo.
Parâmetro Descrição

/a Desconecta todos os arquivos abertos associados ao nome de usuário


<accessedby> especificado no parâmetro accessedby. Você pode usar o caractere curinga (*)
com esse parâmetro.

/o {read | Desconecta todos os arquivos abertos com o valor de modo aberto especificado.
write | Os valores válidos são Read, Write ou Read/Write. Você pode usar o caractere
read/write} curinga (*) com esse parâmetro.

/op Desconecta todas as conexões de arquivo abertas que foram criadas por um
<openfile> nome de arquivo aberto específico. Você pode usar o caractere curinga (*) com
esse parâmetro.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para desconectar todos os arquivos abertos com a ID de arquivo 26843578, digite:

openfiles /disconnect /id 26843578

Para desconectar todos os arquivos e diretórios abertos acessados pelo usuário hiropln,
digite:

openfiles /disconnect /a hiropln

Para desconectar todos os arquivos e diretórios abertos com o modo read/write, digite:

openfiles /disconnect /o read/write

Para desconectar o diretório com o nome de arquivo aberto *C:\testshare*,


independentemente de quem o está acessando, digite:

openfiles /disconnect /a * /op c:\testshare\


Para desconectar todos os arquivos abertos no computador remoto srvmain que estão
sendo acessados pelo usuário hiropln, independentemente de sua ID, digite:

openfiles /disconnect /s srvmain /u maindom\hiropln /id *

openfiles /query
Consulta e exibe todos os arquivos abertos.

Sintaxe

openfiles /query [/s <system> [/u [<domain>\]<username> [/p [<password>]]]]


[/fo {TABLE | LIST | CSV}] [/nh] [/v]

Parâmetros

Parâmetro Descrição

/s <system> Especifica o sistema remoto ao qual se conectar (por nome ou endereço IP). Não
use barras invertidas. Se você não usar a opção /s, o comando será executado no
computador local por padrão. Esse parâmetro se aplica a todos os arquivos e
pastas que foram especificados no comando.

/u Executa o comando usando as permissões da conta de usuário especificada. Se


[<domain>\] você não usar a opção /u, as permissões do sistema serão usadas por padrão.
<username>

/p Especifica a senha da conta de usuário especificada na opção /u. Se você não usar
[<password>] a opção /p, um prompt de senha será exibido quando o comando for executado.

[/fo {TABLE | Exibe a saída no formato especificado. Os valores válidos incluem:


LIST | CSV} ] TABLE – Exibe a saída em uma tabela.
LIST – Exibe a saída em uma lista.
CSV – Exibe a saída no formato CSV (valores separados por vírgula).

/nh Suprime os cabeçalhos de coluna na saída. Válido somente quando o parâmetro


/fo é definido como TABLE ou CSV.

/v Especifica as informações detalhadas que serão exibidas na saída.


Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Exemplos
Para consultar e exibir todos os arquivos abertos, digite:

openfiles /query

Para consultar e exibir todos os arquivos abertos no formato de tabela sem cabeçalhos,
digite:

openfiles /query /fo table /nh

Para consultar e exibir todos os arquivos abertos no formato de lista com informações
detalhadas, digite:

openfiles /query /fo list /v

Para consultar e exibir todos os arquivos abertos no sistema remoto srvmain usando as
credenciais do usuário hiropln no domínio maindom, digite:

openfiles /query /s srvmain /u maindom\hiropln /p p@ssW23

7 Observação

Neste exemplo, a senha é fornecida na linha de comando. Para evitar a exibição da


senha, deixe de fora a opção /p. Você será solicitado a fornecer a senha, que não
será ecoada na tela.

openfiles /local
Habilita ou desabilita o sinalizador global Maintain Objects List do sistema. Se usado
sem parâmetros, openfiles /local exibe o status atual do sinalizador global Maintain
Objects List.

7 Observação

As alterações feitas usando a opção on ou off não serão aplicadas até que você
reinicie o sistema. Habilitar o sinalizador global Maintain Objects List pode
diminuir a velocidade do sistema.

Sintaxe

openfiles /local [on | off]

Parâmetros

Parâmetro Descrição

[on | Habilita ou desabilita o sinalizador global Maintain Objects List do sistema, que
off] rastreia identificadores de arquivos locais.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para verificar o status atual do sinalizador global Maintain Objects List, digite:

openfiles /local

Por padrão, o sinalizador global Maintain Objects List fica desabilitado e a mensagem a
seguir é exibida, INFO: The system global flag 'maintain objects list' is currently
disabled.

Para habilitar o sinalizador global Maintain Objects List, digite:


openfiles /local on

A mensagem a seguir é exibida quando o sinalizador global está habilitado, SUCCESS:


The system global flag 'maintain objects list' is enabled. This will take effect
after the system is restarted.

Para desabilitar o sinalizador global Maintain Objects List, digite:

openfiles /local off

Links relacionados
Chave da sintaxe de linha de comando
pagefileconfig
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2003,
Windows Server 2003 R2, Windows Server 2003 SP1, Windows Server 2003 SP2

) Importante

Esse comando foi preterido.

Permite que um administrador exiba e defina as configurações de memória virtual do


arquivo de paginação de um sistema. Para obter descrições e informações de uso,
consulte pagefileconfig.

Links relacionados
Chave da sintaxe de linha de comando
caminho
Artigo • 12/04/2023

Define o caminho do comando na variável de ambiente PATH, especificando o conjunto


de diretórios usados para pesquisar arquivos executáveis (.exe). Se usado sem
parâmetros, esse comando exibirá o caminho de comando atual.

Sintaxe

path [[<drive>:]<path>[;...][;%PATH%]]
path ;

Parâmetros

Parâmetro Descrição

[<drive>:] Especifica a unidade e o diretório a serem definidos no caminho do comando. O


<path> diretório atual sempre é pesquisado antes dos diretórios especificados no caminho
do comando.

; Separa os diretórios no caminho do comando. Se usado sem outros parâmetros, ;


limpa os caminhos do comando existentes na variável de ambiente PATH e direciona
o Cmd.exe para pesquisar somente no diretório atual.

%PATH% Acrescenta o caminho do comando ao conjunto existente de diretórios listados na


variável de ambiente PATH. Se você incluir esse parâmetro, o Cmd.exe o substituirá
pelos valores de caminho do comando encontrados na variável de ambiente PATH,
eliminando a necessidade de inserir esses valores manualmente no prompt de
comando.

/? Exibe a ajuda no prompt de comando.

Comentários
O sistema operacional Windows pesquisa usando as extensões de nome de
arquivo padrão na seguinte ordem de precedência: .exe, .com, .bat e .cmd. O que
significa que, se você estiver procurando um arquivo em lote chamado acct.bat,
mas tiver um aplicativo chamado acct.exe no mesmo diretório, você deve incluir a
extensão .bat no prompt de comando.
Se dois ou mais arquivos no caminho do comando tiverem o mesmo nome de
arquivo e extensão, esse comando pesquisará primeiro o nome de arquivo
especificado no diretório atual. Em seguida, ele pesquisará os diretórios no
caminho do comando na ordem em que estão listados na variável de ambiente
PATH.

Se você colocar o comando path no arquivo Autoexec.nt, o sistema operacional


Windows acrescentará automaticamente o caminho de pesquisa do subsistema
MS-DOS especificado, sempre que você fizer logon no computador. O Cmd.exe
não usa o arquivo Autoexec.nt. Quando iniciado a partir de um atalho, o Cmd.exe
herda as variáveis de ambiente definidas em Meu
Computador/Propriedades/Avançado/Ambiente.

Exemplos
Para pesquisar os caminhos c:\user\taxes, b:\user\invest e b:\bin para comandos
externos, digite:

path c:\user\taxes;b:\user\invest;b:\bin

Links relacionados
Chave da sintaxe de linha de comando
pathping
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Fornece informações sobre latência e perda de rede em saltos intermediários entre uma
origem e um destino. Esse comando envia várias mensagens de solicitação de eco para
cada roteador entre uma origem e um destino, durante um período de tempo e, em
seguida, calcula os resultados de acordo com os pacotes retornados de cada roteador.
Como esse comando exibe o grau de perda de pacotes em determinado roteador ou
link, você pode determinar quais roteadores ou sub-redes podem ter problemas na
rede. Usado sem parâmetros, esse comando exibe a ajuda.

7 Observação

Esse comando só estará disponível se o protocolo TCP/IP (Protocolo de Internet)


estiver instalado como um componente nas propriedades de um adaptador de
rede em Conexões de Rede.

Além disso, esse comando identifica quais roteadores estão no caminho, o mesmo
que usar o comando tracert. No entanto, esse comando também envia pings
periodicamente para todos os roteadores durante um período de tempo
especificado e calcula estatísticas de acordo com o número retornado de cada um.

Sintaxe

pathping [/n] [/h <maximumhops>] [/g <hostlist>] [/p <Period>] [/q


<numqueries> [/w <timeout>] [/i <IPaddress>] [/4 <IPv4>] [/6 <IPv6>]
[<targetname>]

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

/n Impede que o pathping tente resolver os endereços IP de roteadores


intermediários para seus nomes. Isso pode agilizar a exibição de resultados de
pathping.

/h Especifica o número máximo de saltos no caminho para pesquisar o destino. O


<maximumhops> padrão corresponde a 30 saltos.

/g <hostlist> Especifica que as mensagens de solicitação de eco usam a opção Rota de


Origem Flexível no cabeçalho IP com o conjunto de destinos intermediários
especificados em hostlist. Com o roteamento de origem flexível, os destinos
intermediários sucessivos podem ser separados por um ou vários roteadores. O
número máximo de endereços ou nomes na lista de hosts é 9. A hostlist é uma
série de endereços IP (em notação decimal pontilhada) separados por espaços.

/p <period> Especifica o número de milissegundos a aguardar entre pings consecutivos. O


padrão corresponde a 250 milissegundos (1/4 segundo). Esse parâmetro envia
pings individuais para cada salto intermediário. Por isso, o intervalo entre dois
pings enviados para o mesmo salto é o período multiplicado pelo número de
saltos.

/q Especifica o número de mensagens de solicitação de eco enviadas para cada


<numqueries> roteador no caminho. O padrão corresponde a 100 consultas.

/w <timeout> Especifica o número de milissegundos a aguardar por cada resposta. O padrão


corresponde a 3000 milissegundos (3 segundos). Esse parâmetro envia vários
pings em paralelo. Por isso, a quantidade de tempo especificada no parâmetro
de tempo limite não é limitada pela quantidade de tempo especificada no
parâmetro de período para aguardar entre pings.

/i <IPaddress> Especifica o endereço de origem.

/4 <IPv4> Especifica que o pathping usa apenas IPv4.

/6 <IPv6> Especifica que o pathping usa apenas IPv6.

<targetname> Especifica o destino, que é identificado pelo endereço IP ou pelo nome do host.

/? Exibe a ajuda no prompt de comando.

Comentários

Todos os parâmetros diferenciam maiúsculas de minúsculas.

Para evitar o congestionamento da rede e minimizar os efeitos das perdas de


intermitência, os pings devem ser enviados em um ritmo suficientemente lento.
Exemplo da saída do comando pathping

D:\>pathping /n contoso1
Tracing route to contoso1 [10.54.1.196]
over a maximum of 30 hops:
0 172.16.87.35
1 172.16.87.218
2 192.168.52.1
3 192.168.80.1
4 10.54.247.14
5 10.54.1.196
computing statistics for 125 seconds...
Source to Here This Node/Link
Hop RTT Lost/Sent = Pct Lost/Sent = Pct address
0 172.16.87.35
0/ 100 = 0% |
1 41ms 0/ 100 = 0% 0/ 100 = 0% 172.16.87.218
13/ 100 = 13% |
2 22ms 16/ 100 = 16% 3/ 100 = 3% 192.168.52.1
0/ 100 = 0% |
3 24ms 13/ 100 = 13% 0/ 100 = 0% 192.168.80.1
0/ 100 = 0% |
4 21ms 14/ 100 = 14% 1/ 100 = 1% 10.54.247.14
0/ 100 = 0% |
5 24ms 13/ 100 = 13% 0/ 100 = 0% 10.54.1.196
Trace complete.

Quando pathping é executado, os primeiros resultados listam o caminho. Em seguida,


uma mensagem de ocupado é exibida por aproximadamente 90 segundos (o tempo
varia de acordo com a contagem de saltos). Durante esse tempo, as informações são
coletadas de todos os roteadores listados anteriormente e dos links entre eles. No final
desse período, os resultados do teste são exibidos.

No relatório de exemplo acima, as colunas Este Nó/Link, Perdido/Enviado = Pct e


endereço mostram que o link entre 172.16.87.218 e 192.168.52.1 está descartando 13%
dos pacotes. Os roteadores nos saltos 2 e 4 também estão descartando pacotes
endereçados a eles, mas essa perda não afeta sua capacidade de encaminhar o tráfego
que não é endereçado a eles.

As taxas de perda exibidas para os links, identificadas como uma barra vertical (|) na
coluna endereço, indicam congestionamento de links que está causando a perda de
pacotes que estão sendo encaminhados no caminho. As taxas de perda exibidas para
roteadores (identificados por seus endereços IP) indicam que esses roteadores podem
estar sobrecarregados.
Links relacionados
Chave da sintaxe de linha de comando

comando tracert
pause
Artigo • 12/04/2023

Suspende o processamento de um programa em lotes, exibindo o prompt: Press any


key to continue . . .

Sintaxe

pause

Parâmetros

Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Comentários
Se você pressionar CTRL+C para interromper um programa em lotes, a seguinte
mensagem será exibida: Terminate batch job (Y/N)? . Se você pressionar Y (para
sim) em resposta a essa mensagem, o programa em lote será encerrado e o
controle retornará ao sistema operacional.

Você pode inserir o comando pause antes de uma seção do arquivo em lote, que
talvez você não queira processar. Quando o pause suspende o processamento de
programa em lotes, você pode pressionar CTRL+C e depois Y para interromper o
programa em lotes.

Exemplos
Para criar um programa em lotes que solicita que o usuário altere os discos em uma das
unidades, digite:

@echo off
:Begin
copy a:*.*
echo Put a new disk into Drive A
pause
goto begin

Neste exemplo, todos os arquivos no disco na Unidade A são copiados para o diretório
atual. Depois que a mensagem solicitar que você coloque um novo disco na Unidade A,
o comando pause suspenderá o processamento para que você possa alterar os discos,
então pressione qualquer tecla para retomar o processamento. Esse programa em lotes
é executado em um loop infinito, o comando goto begin envia o interpretador de
comando para o rótulo Begin do arquivo em lote.

Links relacionados
Chave da sintaxe de linha de comando
pbadmin
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2003,
Windows Server 2003 R2, Windows Server 2003 SP1, Windows Server 2003 SP2

) Importante

Esse comando foi preterido.

Administra as agendas de telefones. Usado sem parâmetros, o pbadmin inicia o


Administrador de Agendas de Telefones. Para obter descrições e informações de uso,
confira pbadmin.

Links relacionados
Chave da sintaxe de linha de comando
pentnt
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2003,
Windows Server 2003 R2, Windows Server 2003 SP1, Windows Server 2003 SP2

) Importante

Esse comando foi preterido.

Detecta o erro de divisão de ponto flutuante (se presente) no chip Pentium, desabilita o
hardware de ponto flutuante e ativa a emulação de ponto flutuante. Para obter
descrições e informações de uso, consulte pentnt.

Links relacionados
Chave da sintaxe de linha de comando
perfmon
Artigo • 11/04/2023

Inicie a Confiabilidade do Windows e o Monitor de Desempenho em um modo


autônomo específico.

Sintaxe

perfmon </res|report|rel|sys>

Parâmetros

Parâmetro Descrição

/res Inicia a Exibição de Recurso.

/report Inicia o Conjunto de Coletores de Dados de Diagnóstico do Sistema e exibe um


relatório dos resultados.

/rel Inicia o Monitor de Confiabilidade.

/sys Inicia o Monitor de Desempenho.

Links relacionados
Chave da sintaxe de linha de comando

Monitor de desempenho do Windows


ping
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Verifica a conectividade no nível de IP com outro computador TCP/IP enviando


mensagens de solicitação de eco do protocolo ICMP. O recebimento de mensagens de
resposta de eco correspondentes é exibido, acompanhado dos tempos de viagem de
ida e volta. ping é o comando TCP/IP primário usado para solucionar problemas de
conectividade, acessibilidade e resolução de nomes. Usado sem parâmetros, esse
comando exibe o conteúdo da Ajuda.

Você também pode usar esse comando para testar o nome do computador e o
endereço IP do computador. Se o ping no endereço IP for bem-sucedido, mas o ping no
nome do computador não for, você poderá ter um problema de resolução de nomes.
Nesse caso, verifique se o nome do computador que você está especificando pode ser
resolvido por meio do arquivo de hosts local, usando consultas DNS (Sistema de Nomes
de Domínio) ou por meio de técnicas de resolução de nomes NetBIOS.

7 Observação

Esse comando só estará disponível se o protocolo TCP/IP estiver instalado como


um componente nas propriedades de um adaptador de rede em Conexões de
Rede.

Sintaxe

ping [/t] [/a] [/n <count>] [/l <size>] [/f] [/I <TTL>] [/v <TOS>] [/r
<count>] [/s <count>] [{/j <hostlist> | /k <hostlist>}] [/w <timeout>] [/R]
[/S <Srcaddr>] [/4] [/6] <targetname>

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

/t Especifica que o ping continue enviando mensagens de solicitação de eco para o


destino até ser interrompido. Para interromper e exibir estatísticas, pressione
CTRL+ENTER. Para interromper e encerrar esse comando, pressione CTRL+C.

/a Especifica que a resolução de nomes reversa seja executada no endereço IP de


destino. Se isso for bem-sucedido, o ping exibirá o nome do host
correspondente.

/n <count> Especifica o número de mensagens de solicitação de eco a serem enviadas. O


padrão é 4.

/l <size> Especifica o tamanho, em bytes, do campo Dados nas mensagens de solicitação


de eco. O padrão é 32. O tamanho máximo é 65.527.

/f Especifica que as mensagens de solicitação de eco são enviadas com o sinalizador


Não Fragmentar no cabeçalho IP definido como 1 (disponível apenas no IPv4). A
mensagem de solicitação de eco não pode ser fragmentada por roteadores no
caminho para o destino. Esse parâmetro é útil para solucionar problemas de
PMTU (Unidade de Transmissão Máxima do Caminho).

/I <TTL> Especifica o valor do campo TTL (Vida Útil) no cabeçalho IP para mensagens de
solicitação de eco enviadas. O padrão é o valor TTL padrão para o host. O TTL
máximo é 255.

/v <TOS> Especifica o valor do campo TOS (Tipo de Serviço) no cabeçalho IP para


mensagens de solicitação de eco enviadas (disponíveis somente no IPv4). O
padrão é 0. TOS é especificado como um valor decimal de 0 a 255.

/r <count> Especifica que a opção Rota de Registro no cabeçalho IP é usada para registrar o
caminho percorrido pela mensagem de solicitação de eco e pela mensagem de
resposta de eco correspondente (disponível apenas no IPv4). Cada salto no
caminho usa uma entrada na opção Rota de Registro. Se possível, especifique
uma contagem igual ou maior que o número de saltos entre a origem e o destino.
A contagem deve ser um mínimo de 1 e um máximo de 9.

/s <count> Especifica que a opção Carimbo de data/hora da Internet no cabeçalho IP é


usada para registrar a hora de chegada da mensagem de solicitação de eco e da
mensagem de resposta de eco correspondente para cada salto. A contagem deve
ser um mínimo de 1 e um máximo de 4. Isso é necessário para endereços de
destino link-local.

/j <hostlist> Especifica que as mensagens de solicitação de eco usam a opção Rota de Origem
Flexível no cabeçalho IP com o conjunto de destinos intermediários especificados
em hostlist (disponível apenas no IPv4). Com o roteamento de origem flexível, os
destinos intermediários sucessivos podem ser separados por um ou vários
roteadores. O número máximo de endereços ou nomes na lista de hosts é 9. A
lista de hosts é uma série de endereços IP (em notação decimal pontilhada)
separados por espaços.
Parâmetro Descrição

/k Especifica que as mensagens de solicitação de eco usam a opção Rota de Origem


<hostlist> Estrita no cabeçalho IP com o conjunto de destinos intermediários especificados
em hostlist (disponível apenas no IPv4). Com o roteamento de origem estrito, o
próximo destino intermediário deve ser diretamente acessível (ele deve ser um
vizinho em uma interface do roteador). O número máximo de endereços ou
nomes na lista de hosts é 9. A lista de hosts é uma série de endereços IP (em
notação decimal pontilhada) separados por espaços.

/w <timeout> Especifica o tempo, em milissegundos, para aguardar a mensagem de resposta de


eco correspondente a uma determinada mensagem de solicitação de eco. Se a
mensagem de resposta de eco não for recebida dentro do tempo limite, será
exibida a mensagem de erro "Solicitação atingiu o tempo limite". O valor de
tempo limite padrão é 4000 (4 segundos).

/R Especifica que o caminho de viagem de ida e volta é rastreado (disponível apenas


no IPv6).

/S <Srcaddr> Especifica o endereço de origem a ser usado (disponível apenas no IPv6).

/4 Especifica o IPv4 usado para executar ping. Esse parâmetro não é necessário para
identificar o host de destino com um endereço IPv4. Só é necessário identificar o
host de destino pelo nome.

/6 Especifica o IPv6 usado para executar ping. Esse parâmetro não é necessário para
identificar o host de destino com um endereço IPv6. Só é necessário identificar o
host de destino pelo nome.

<targetname> Especifica o nome do host ou endereço IP do destino.

/? Exibe a ajuda no prompt de comando.

Exemplo da saída do comando ping

C:\>ping example.microsoft.com
pinging example.microsoft.com [192.168.239.132] with 32 bytes of data:
Reply from 192.168.239.132: bytes=32 time=101ms TTL=124
Reply from 192.168.239.132: bytes=32 time=100ms TTL=124
Reply from 192.168.239.132: bytes=32 time=120ms TTL=124
Reply from 192.168.239.132: bytes=32 time=120ms TTL=124

Exemplos
Para executar ping no destino 10.0.99.221 e resolver 10.0.99.221 para seu nome de host,
digite:

ping /a 10.0.99.221

Para executar ping no destino 10.0.99.221 com 10 mensagens de solicitação de eco,


cada uma com um campo Dados de 1000 bytes, digite:

ping /n 10 /l 1000 10.0.99.221

Para executar ping no destino 10.0.99.221 e registrar a rota para 4 saltos, digite:

ping /r 4 10.0.99.221

Para executar ping no destino 10.0.99.221 e especificar a rota de origem flexível de


10.12.0.1-10.29.3.1-10.1.44.1, digite:

ping /j 10.12.0.1 10.29.3.1 10.1.44.1 10.0.99.221

Links relacionados
Chave da sintaxe de linha de comando
pktmon
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure

O Pktmon (Monitor de Pacotes) é uma ferramenta nativa de diagnóstico de rede entre


componentes para o Windows. Pode ser usada para captura avançada de pacotes e
coleta de eventos, detecção de remoção, filtragem e contagem. O pktmon é
especialmente útil em cenários de virtualização, como rede de contêiner e SDN, porque
fornece visibilidade da pilha de rede.

Sintaxe

pktmon { filter | list | start | stop | status | unload | counters | reset |


etl2txt | etl2pcap | hex2pkt | help } [options]

Comandos

Comando Descrição

pktmon filter Gerencie os filtros de pacote.

pktmon list Liste os componentes de processamento de pacotes.

pktmon start Inicie a captura de pacotes e a coleção de eventos.

pktmon stop Interrompa a coleta de dados.

pktmon status Consulte o status atual.

pktmon unload Descarregue o driver do pktmon.

pktmon counters Exiba os contadores de pacotes atuais.

pktmon reset Redefina os contadores de pacote como zero.

pktmon etl2txt Converta o arquivo de log em formato de texto.

pktmon etl2pcap Converta o arquivo de log em formato pcapng.

pktmon hex2pkt Decodifique o pacote no formato hexadecimal.


Comando Descrição

pktmon help Mostre o texto da ajuda para um comando específico.

Links relacionados
Visão geral do Monitor de Pacotes
Suporte a pktmon para Monitor de Rede da Microsoft (Netmon)
pktmon counters
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure

O pktmon counters permite consultar e exibir os contadores de pacotes atuais nos


componentes monitorados, para confirmar a presença do tráfego esperado e obter uma
exibição de alto nível de como o tráfego fluiu no computador.

Sintaxe

pktmon counters [--type { all | flow | drop }] [--include-hidden] [--zero]


[--drop-reason] [--live] [--refresh-rate <n>] [--json]

Parâmetros

Parâmetro Descrição

-t, --type Seleciona quais tipos de contadores devem ser mostrados. Os valores com suporte
são all counters (padrão), flow (somente fluxos) ou drop (somente remoções).

-z, --zero Mostra os contadores que são zero em ambas as direções.

-i, -- Mostra os contadores de componentes ocultos por padrão.


include-
hidden

-r, --drop- Mostra o motivo de remoção mais recente para cada contador de remoção.
reason

--live Atualiza os contadores automaticamente. Pressione Ctrl+C para parar.

--refresh- Número de vezes para atualizar os contadores por segundo, de 1 a 30. O padrão é
rate <n> 10.

--json Gera os contadores no formato JSON. Implies -i and -r.

Links relacionados
Pktmon
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon start
Pktmon status
Pktmon unload
Visão geral do Monitor de Pacotes
pktmon etl2pcap
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure

Converta o arquivo de log pktmon no formato pcapng. Os pacotes removidos não são
incluídos por padrão.

Syntax

pktmon etl2pcap <file> [--out <name>] [--drop-only] [--component-id <id>]

Onde <file> é o arquivo ETL a ser convertido.

Parâmetros

Parâmetro Descrição

-o, --out <name> Nome do arquivo pcapng formatado.

-d, --drop-only Converte somente os pacotes removidos.

-c, --component-id <id> Filtra os pacotes por uma ID de componente específica.

Links relacionados
Pktmon
Pktmon counters
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon start
Pktmon status
Pktmon unload
Visão geral do Monitor de Pacotes
pktmon etl2txt
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure

Converta o arquivo de log ETL no formato de texto.

Syntax

pktmon etl2txt <file> [--out <name>] [--stats-only] [--timestamp-only] [--


metadata]
[--tmfpath <path>] [--brief] [--verbose <n>] [--hex]
[--no-ethernet] [--vxlan <port>]

Onde <file> é o arquivo ETL a ser convertido.

Parâmetros

Parâmetro Descrição

-o, --out O nome do arquivo de texto formatado.


<name>

-s, --stats- Exiba informações estatísticas do arquivo de log.


only

-t, -- Use o prefixo do carimbo de data/hora somente para eventos e pacotes.


timestamp-
only

-m, -- Imprima metadados de evento, como o nível de log e palavras-chave.


metadata

-p, -- O caminho para os arquivos TMF para decodificar os rastreamentos WPP. Vários
tmfpath caminhos devem ser separados por ponto e vírgula. Todos os rastreamentos WPP
<path> são ignorados quando essa opção não é especificada.

Opções de formatação do pacote de rede


Parâmetro Descrição

-b, --brief Use o formato de pacote abreviado.

-v, --verbose <n> Nível de detalhamento de 1 a 3.

-x, --hex Inclua o formato hexadecimal.

-e, --no-ethernet Não imprima o cabeçalho ethernet.

-l, --vxlan <port> Porta VXLAN personalizada.

Links relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon start
Pktmon status
Pktmon unload
Packet Monitor overview
pktmon filter
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure

O filtro do pktmon permite listar, adicionar ou remover filtros de pacote.

Sintaxe

pktmon filter { list | add | remove } [OPTIONS | help]

Parâmetros

Parâmetro Descrição

pktmon filter list Exiba os filtros de pacote ativos.

pktmon filter add Adicione um filtro para controlar quais pacotes são relatados.

pktmon filter remove Remova todos os filtros de pacote.

Links relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon start
Pktmon status
Pktmon unload
Visão geral do Monitor de Pacotes
pktmon filter add
Artigo • 29/09/2022

aplica-se a: Windows server 2022, Windows server 2019, Windows 10, Azure Stack
HCI, Hub de Azure Stack, Azure

Pktmon filtro Add permite que você adicione um filtro para controlar quais pacotes são
relatados. Para que um pacote seja relatado, ele deve corresponder a todas as
condições especificadas em pelo menos um filtro. Até 32 filtros podem estar ativos ao
mesmo tempo.

Sintaxe

pktmon filter add <name> [-m <mac> [mac2]] [-v <vlan>] [-d { IPv4 | IPv6 |
number }]
[-t { TCP [flags...] | UDP | ICMP | ICMPv6 | number
}]
[-i <ip> [ip2]] [-p <port> [port2]] [-b] [-e
[port]]

Você pode fornecer um nome opcional ou uma descrição do filtro.

7 Observação

Quando dois MACs (-m), IPs (-i) ou portas (-p) são especificados, o filtro
corresponde aos pacotes que contêm ambos. Ele não fará distinção entre a origem
ou o destino para essa finalidade.

Parâmetros
Você pode fornecer parâmetros para o quadro Ethernet, o cabeçalho IP, o cabeçalho
TCP/UDP, a pulsação do cluster e o encapsulamento.

Parâmetro Descrição

-m,--Mac Corresponder endereço MAC de origem ou de destino. Consulte a observação


[-address] acima.

-v,--VLAN Corresponder por ID de VLAN (VID) no cabeçalho 802.1 Q.


Parâmetro Descrição

-d,--data- Corresponder pelo protocolo de vínculo de dados (camada 2). Pode ser IPv4, IPv6,
link [- ARP ou um número de protocolo.
Protocol],-
-
EtherType

-t,-- Corresponder pelo protocolo de transporte (camada 4). Pode ser TCP, UDP, ICMP,
Transport ICMPv6 ou um número de protocolo. Para filtrar ainda mais os pacotes TCP, é
[- possível fornecer uma lista opcional de sinalizadores TCP para correspondência. Os
Protocol],- sinalizadores com suporte são FIN, SYN, RST, PSH, ACK, URG, ECE e CWR.
-IP-
Protocol

-i,--IP [- Corresponder endereço IP de origem ou de destino. Consulte a observação acima.


address] Para fazer a correspondência por sub-rede, use a notação CIDR com o comprimento
do prefixo.

-p,--porta Corresponder ao número da porta de origem ou de destino. Consulte a observação


acima.

-b,-- Corresponder mensagens de pulsação de RCP pela porta UDP 3343.


pulsação

-e,--encap Aplique os parâmetros de filtragem acima aos cabeçalhos de encapsulamento


interno e externo. Os métodos de encapsulamento com suporte são VXLAN, GRE,
NVGRE e IP-in-IP. A porta VXLAN personalizada é opcional e o padrão é 4789.

Exemplos
O conjunto de filtros a seguir capturará qualquer tráfego ICMP de ou para o endereço IP
10.0.0.10, juntamente com qualquer tráfego na porta 53.

PowerShell

C:\Test> pktmon filter add -i 10.0.0.10 -t icmp


C:\Test> pktmon filter add -p 53

O filtro a seguir capturará todos os pacotes SYN enviados ou recebidos pelo endereço
IP 10.0.0.10:

PowerShell

C:\Test> pktmon filter add -i 10.0.0.10 -t tcp syn


O filtro a seguir chamou pings de myping 10.10.10.10 usando o protocolo ICMP:

PowerShell

C:\Test> pktmon filter add MyPing -i 10.10.10.10 -t ICMP

O filtro a seguir chamado MySmbSyb captura o tráfego SMB sincronizado com TCP:

PowerShell

C:\Test> pktmon filter add MySmbSyn -i 10.10.10.10 -t TCP SYN -p 445

O filtro a seguir, chamado mysubnet , captura o tráfego na máscara de sub-rede


255.255.255.0 ou/24 na notação CIDR:

PowerShell

C:\Test> pktmon filter add MySubnet -i 10.10.10.0/24

Outras referências
Pktmon
Contadores de Pktmon
Pktmon etl2pcap
Pktmon etl2txt
Filtro de Pktmon
Pktmon hex2pkt
Lista de Pktmon
Redefinição de Pktmon
Pktmon iniciar
Status do Pktmon
Descarregamento de Pktmon
Visão geral do monitor de pacotes
pktmon hex2pkt
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure

Decodifique o pacote no formato hexadecimal.

Sintaxe

pktmon hex2pkt [--type { Ethernet | IP | HTTP }]

Parâmetros

Parâmetro Descrição

-t, --type Tipo de pacote a ser decodificado. As opções são Ethernet, IP e HTTP. O padrão é
Ethernet.

Links relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon list
Pktmon reset
Pktmon start
Pktmon status
Pktmon unload
Packet Monitor overview
pktmon list
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure

Lista todos os componentes de rede ativos que podem ser monitorados, permitindo
que você examine o layout da pilha de rede. O comando mostra os componentes de
rede (drivers) organizados por associações de adaptadores.

Sintaxe

pktmon list [--all] [--include-hidden] [--json]

Parâmetros

Parâmetro Descrição

-a, --all Mostra todos os tipos de componente. Somente adaptadores de rede são
exibidos por padrão.

-i, --include- Mostra os componentes ocultos por padrão.


hidden

--json Gera a lista no formato JSON. Implica -i e -a.

Links relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon reset
Pktmon start
Pktmon status
Pktmon unload
Visão geral do Monitor de Pacotes
pktmon reset
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure

Redefinir contadores como zero.

Syntax

pktmon reset [-counters]

Links relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon start
Pktmon status
Pktmon unload
Visão geral do Monitor de Pacotes
pktmon start
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure

Inicia a captura de pacotes e a coleção de eventos.

Syntax

pktmon start [--capture [--counters-only] [--comp <selector>] [--type


<type>] [--pkt-size <bytes>] [--flags <mask>]]
[--trace --provider <name> [--keywords <k>] [--level <n>] ...]
[--file-name <name>] [--file-size <size>] [--log-mode <mode>]

Parâmetros de captura de pacote


Use -c ou --capture para habilitar a captura de pacotes e contadores de pacotes,
juntamente com os seguintes parâmetros opcionais.

Parâmetro Descrição

-o, -- Coleta somente os contadores de pacotes. Não há log de pacotes.


counters-
only

--comp Seleciona os componentes para capturar pacotes. Pode ser todos os componentes
(all), somente NICs (nics) ou uma lista de IDs de componente. O padrão é all.

--type Selecione quais pacotes devem ser capturados. Pode ser all, flow ou drop. O padrão
é todos.

--pkt-size Número de bytes a serem registrados em cada pacote. Para sempre registrar o
<bytes> pacote inteiro, defina-o como 0. O padrão é 128 bytes.

--flags Bitmask hexadecimal que controla as informações registradas durante a captura de


<mask> pacotes. O padrão é 0x012. Sinalizadores de captura de pacotes, abaixo.

Sinalizadores de captura de pacotes

Os sinalizadores a seguir se aplicam ao parâmetro --flags (veja acima).


Sinalizador Descrição

0x001 Erros internos do Monitor de Pacotes.

0x002 Informações sobre os componentes, contadores e filtros. Essas informações são


adicionadas ao fim do arquivo de log.

0x004 Informações de origem e destino para o primeiro pacote no grupo


NET_BUFFER_LIST.

0x008 Selecione os metadados de pacote na enumeração NDIS_NET_BUFFER_LIST_INFO.

0x010 Pacote bruto, truncado para o tamanho especificado no parâmetro [--pkt-size].

Parâmetros da coleção de eventos


Use -t ou --trace para habilitar a coleção de eventos, juntamente com os seguintes
parâmetros opcionais.

Parâmetro Descrição

-p, --provider Nome do provedor de eventos ou GUID. Para vários provedores, use esse
<name> parâmetro mais de uma vez.

-k, -- Bitmask hexadecimal que controla quais eventos são registrados para o
keywords <k> provedor correspondente. O padrão é 0xFFFFFFFF.

-l, --level <n> Nível de log do provedor correspondente. O padrão é 4 (nível de informações).

Parâmetros de log
Use os seguintes parâmetros para log:

Parâmetro Descrição

-f, --file-name Nome do arquivo de log. O padrão é PktMon.etl.


<name>

-s, --file-size <size> O tamanho máximo do arquivo de log, em megabytes. O padrão é 512
MB.

-m, --log-mode Define o modo de log (veja abaixo). O padrão é circular.

Modos de log
Os modos a seguir se aplicam ao parâmetro -m ou --log-mode (veja acima).
Modo Descrição

circular Os novos eventos substituem os mais antigos quando o log está cheio.

multi- Um novo arquivo de log é criado sempre que o log está cheio. Os arquivos de log são
file numerados sequencialmente: PktMon1.etl, PktMon2.etl etc. Não há limitação no
número de eventos capturados.

real- Exibe os eventos e pacotes na tela em tempo real. Nenhum arquivo de log é criado.
time Pressione Ctrl+C para interromper o monitoramento.

memory Como circular, mas todo o log é armazenado na memória. É gravado em um arquivo
quando o pktmon é interrompido. O tamanho do buffer de memória é especificado no
parâmetro [--file-size].

Exemplos
Exemplo 1: captura de pacotes

PowerShell

C:\Test> pktmon start --capture

Exemplo 2: somente contadores de pacotes

PowerShell

C:\Test> pktmon start --capture --counters-only

Exemplo 3: log de eventos

PowerShell

C:\Test> pktmon start --trace -p Microsoft-Windows-TCPIP -p Microsoft-


Windows-NDIS

Exemplo 4: captura de pacotes com log de eventos

PowerShell

C:\Test> pktmon start --capture --trace -p Microsoft-Windows-TCPIP -k 0xFF -


l 4

Links relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon status
Pktmon unload
Visão geral do Monitor de Pacotes
pktmon status
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure

Consulte o status atual do Monitor de Pacotes.

Sintaxe

pktmon status [--buffer-info]

Parâmetros

Parâmetro Descrição

-b, --buffer-info Exiba informações do buffer ETW.

Links relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon start
Pktmon unload
Visão geral do Monitor de Pacotes
pktmon unload
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure

Interrompa o serviço de driver PktMon e descarregue PktMon.sys. Efetivamente


equivalente a "sc.exe stop PktMon". A medida (se ativa) será interrompida
imediatamente e qualquer estado será excluído (contadores, filtros etc.).

Syntax

pktmon unload

Links relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon start
Pktmon status
Packet Monitor overview
pnpunattend
Artigo • 11/04/2023

Audita um computador para os drivers de dispositivo e executa instalações autônomas


do driver ou pesquisa os drivers sem instalar e, opcionalmente, relatar os resultados
para a linha de comando. Use esse comando para especificar a instalação de drivers
específicos para dispositivos de hardware específicos.

Pré-requisitos
A preparação preliminar é necessária para as versões mais antigas do sistema
operacional Windows. Antes de usar esse comando, você deve concluir as seguintes
tarefas:

1. Crie um diretório para os drivers que você deseja instalar. Por exemplo, crie uma
pasta em C:\Drivers\Video para os drivers do adaptador de vídeo.

2. Baixe e extraia o pacote de drivers para seu dispositivo. Copie o conteúdo da


subpasta que contém o arquivo INF para sua versão do sistema operacional e
quaisquer subpastas para a pasta de vídeo criada. Por exemplo, copie os arquivos
do driver de vídeo para C:\Drivers\Video.

3. Adicione uma variável de caminho de ambiente do sistema à pasta que você criou
na etapa 1. Por exemplo, C:\Drivers\Video.

4. Crie a chave de registro a seguir, então para a chave DriverPaths criada, defina os
Dados de Valor para 1.

5. Para o Windows® 7, navegue pelo caminho do registro:


HKEY_LOCAL_Machine\Software\Microsoft\Windows NT\CurrentVersion\ e crie
as chaves: UnattendSettings\PnPUnattend\DriverPaths\

Sintaxe

PnPUnattend.exe auditsystem [/help] [/?] [/h] [/s] [/l]

Parâmetros
Parâmetro Descrição

auditsystem Especifica a instalação do driver online.


Obrigatório, exceto quando esse comando é executado com os parâmetros /help
ou /?.

/s Opcional. Especifica a pesquisa de drivers sem instalação.

/l Opcional. Especifica a exibição das informações de log para esse comando no


prompt de comando.

/? | /help Opcional. Exibe ajuda para esse comando no prompt de comando.

Exemplos
Para o comando mostrar como usar PNPUnattend.exe para auditar um computador
para possíveis atualizações de driver e relatar as descobertas para o prompt de
comando, digite:

pnpunattend auditsystem /s /l

Links relacionados
Chave da sintaxe de linha de comando
pnputil
Artigo • 11/04/2023

Pnputil.exe é um utilitário da linha de comando que você pode usar para gerenciar o
repositório de driver. Você pode usar esse comando para adicionar, remover e listar os
pacotes de driver que estão no armazenamento.

Sintaxe

pnputil.exe [-f | -i] [ -? | -a | -d | -e ] <INF name>

Parâmetros

Parâmetro Descrição

-a Especifica para adicionar o arquivo INF identificado.

-d Especifica para excluir o arquivo INF identificado.

-E Especifica para enumerar todos os arquivos INF de terceiros.

-f Especifica para forçar a exclusão do arquivo INF identificado. Não é possível usar em
conjunto com o parâmetro –i.

-i Especifica para instalar o arquivo INF identificado. Não é possível usar em conjunto
com o parâmetro -f.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para adicionar um arquivo INF, chamado USBCAM.INF, digite:

pnputil.exe -a a:\usbcam\USBCAM.INF

Para adicionar todos os arquivos INF, localizados em c:\drivers, digite:


pnputil.exe -a c:\drivers\*.inf

Para adicionar e instalar o driver USBCAM.INF, digite:

pnputil.exe -i -a a:\usbcam\USBCAM.INF

Para enumerar todos os drivers de terceiros, digite:

pnputil.exe –e

Para excluir o arquivo INF e o driver chamado oem0.inf, digite:

pnputil.exe -d oem0.inf

Links relacionados
Chave da sintaxe de linha de comando

comando popd
popd
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

O comando popd altera o diretório atual para o diretório armazenado mais


recentemente pelo comando pushd.

Sempre que você usa o comando pushd, um único diretório é armazenado para o uso.
No entanto, você pode armazenar vários diretórios usando o comando pushd diversas
vezes. Os diretórios são armazenados sequencialmente em uma pilha virtual, portanto,
se você usar o comando pushd uma vez, o diretório no qual usa o comando será
colocado na parte inferior da pilha. Se você usar o comando novamente, o segundo
diretório será colocado sobre o primeiro. O processo se repete sempre que você usa o
comando pushd.

Se você usar o comando popd, o diretório no topo da pilha será removido e o diretório
atual mudará para esse diretório. Se você usar o comando popd novamente, o próximo
diretório na pilha será removido. Se as extensões de comando estiverem habilitadas, o
comando popd removerá qualquer atribuição de letra da unidade criada pelo comando
pushd.

Sintaxe

popd

Parâmetros

Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Exemplos
Para alterar o diretório atual no qual o programa em lote foi executado e, em seguida,
alterá-lo novamente, digite:
@echo off
rem This batch file deletes all .txt files in a specified directory
pushd %1
del *.txt
popd
cls
echo All text files deleted in the %1 directory

Links relacionados
Chave da sintaxe de linha de comando

pushd
PowerShell
Artigo • 12/04/2023

O Windows PowerShell é um shell de linha de comando e linguagem de scripts com


base em tarefa, projetado especialmente para a administração do sistema. Baseado no
.NET Framework, o Windows PowerShell ajuda os profissionais de TI e os usuários
avançados a controlar e automatizar a administração de sistemas operacionais Windows
e de aplicativos que são executados no Windows.

Como usar o PowerShell.exe


A ferramenta de linha de comando PowerShell.exe inicia uma sessão do Windows
PowerShell em uma janela do Prompt de Comando. Ao usar o PowerShell.exe, você
pode usar seus parâmetros opcionais para personalizar a sessão. Por exemplo, você
pode iniciar uma sessão que usa uma política de execução específica ou uma que exclua
um perfil do Windows PowerShell. Caso contrário, a sessão será igual a qualquer sessão
iniciada no console do Windows PowerShell.

Para iniciar uma sessão do Windows PowerShell em uma janela do Prompt de


Comando, digite PowerShell . Um prefixo PS é adicionado ao prompt de comando,
para indicar que você está em uma sessão do Windows PowerShell.

Para iniciar uma sessão com uma política de execução específica, use o parâmetro
ExecutionPolicy e digite:

PowerShell

PowerShell.exe -ExecutionPolicy Restricted

Para iniciar uma sessão do Windows PowerShell sem os perfis do Windows


PowerShell, use o parâmetro NoProfile e digite:

PowerShell

PowerShell.exe -NoProfile

Para iniciar uma sessão, use o parâmetro ExecutionPolicy e digite:

PowerShell

PowerShell.exe -ExecutionPolicy Restricted


Para ver o arquivo de ajuda PowerShell.exe, digite:

PowerShell

PowerShell.exe -help
PowerShell.exe -?
PowerShell.exe /?

Para encerrar uma sessão do Windows PowerShell em uma janela do Prompt de


Comando, digite exit . O prompt de comando típico será retornado.

Comentários
Para obter uma lista completa dos parâmetros de linha de comando do
PowerShell.exe, confira about_PowerShell.Exe.

Para obter informações sobre outras maneiras de iniciar o Windows PowerShell,


confira Como iniciar o Windows PowerShell.

O Windows PowerShell é executado na opção de instalação Server Core dos


sistemas operacionais Windows Server. No entanto, os recursos que exigem uma
interface gráfica do usuário, como o ISE (Ambiente de Script Integrado do
Windows PowerShell) e os cmdlets Out-GridView e Show-Command, não são
executados nas instalações do Server Core.

Links relacionados
about_PowerShell.Exe

about_PowerShell_Ise.exe

Windows PowerShell
PowerShell_ise
Artigo • 12/04/2023

O ISE (Ambiente de Script Integrado) do Windows PowerShell é um aplicativo host


gráfico que permite ler, gravar, executar, depurar e testar scripts e módulos em um
ambiente com assistência gráfica. Os principais recursos, como IntelliSense, Show-
Command, snippets, conclusão de tabulação, coloração de sintaxe, depuração visual e
Ajuda sensível ao contexto, fornecem uma rica experiência de script.

Como usar o PowerShell.exe


A ferramenta PowerShell_ISE.exe inicia uma sessão do ISE do Windows PowerShell. Ao
usar o PowerShell_ISE.exe, você pode usar seus parâmetros opcionais para abrir
arquivos no ISE do Windows PowerShell ou para iniciar uma sessão do ISE do Windows
PowerShell sem perfil ou com um multithreaded apartment.

Para iniciar uma sessão do ISE do Windows PowerShell em uma janela do Prompt
de Comando, no Windows PowerShell ou no menu Iniciar, digite:

PowerShell

PowerShell_Ise.exe

Para abrir um script (.ps1), módulo de script (.psm1), manifesto do módulo (.psd1),
arquivo XML ou qualquer outro arquivo com suporte no ISE do Windows
PowerShell, digite:

PowerShell

PowerShell_Ise.exe <filepath>

No Windows PowerShell 3.0, você pode usar o parâmetro opcional File da seguinte
maneira:

PowerShell

PowerShell_Ise.exe -file <filepath>

Para iniciar uma sessão do ISE do Windows PowerShell sem os perfis do Windows
PowerShell, use o parâmetro NoProfile. (O parâmetro NoProfile foi introduzido no
Windows PowerShell 3.0.), digite:
PowerShell

PowerShell_Ise.exe -NoProfile

Para ver o arquivo de ajuda PowerShell_ISE.exe, digite:

PowerShell

PowerShell_Ise.exe -help
PowerShell_Ise.exe -?
PowerShell_Ise.exe /?

Comentários
Para obter uma lista completa dos parâmetros de linha de comando do
PowerShell_ISE.exe, confira about_PowerShell_Ise.Exe.

Para obter informações sobre outras maneiras de iniciar o Windows PowerShell,


confira Como iniciar o Windows PowerShell.

O Windows PowerShell é executado na opção de instalação Server Core dos


sistemas operacionais Windows Server. No entanto, como o ISE do Windows
PowerShell exige uma interface gráfica do usuário, ele não é executado em
instalações do Server Core.

Links relacionados
about_PowerShell_Ise.exe
print
Artigo • 12/04/2023

Envia um arquivo de texto para uma impressora. Um arquivo poderá ser impresso em
segundo plano, se você enviá-lo para uma impressora conectada a uma porta serial ou
paralela no computador local.

7 Observação

Você pode executar muitas tarefas de configuração no prompt de comando


usando o comando Mode, incluindo configurar uma impressora conectada a uma
porta paralela ou serial, exibir o status da impressora ou preparar uma impressora
para troca de página de código.

Sintaxe

print [/d:<printername>] [<drive>:][<path>]<filename>[ ...]

Parâmetros

Parâmetro Descrição

/d: <printername> Especifica a impressora em que você deseja imprimir o trabalho. Para imprimir
em uma impressora conectada localmente, especifique a porta no
computador em que a impressora está conectada. Os valores válidos para
portas paralelas são LPT1, LPT2 e LPT3. Os valores válidos para portas seriais
são COM1, COM2, COM3 e COM4. Você também pode especificar uma
impressora de rede usando o nome de fila ( \\server_name\printer_name ). Se
você não especificar uma impressora, o trabalho de impressão será enviado
ao LPT1 por padrão.

<drive> : Especifica a unidade lógica ou física em que o arquivo que você deseja
imprimir está localizado. Esse parâmetro não será necessário, se o arquivo que
você deseja imprimir estiver localizado na unidade atual.

<path> Especifica o local do arquivo que você deseja imprimir. Esse parâmetro não
será necessário, se o arquivo que você deseja imprimir estiver localizado no
diretório atual.
Parâmetro Descrição

<filename>[ Obrigatórios. Especifica o arquivo que você deseja imprimir. Você pode incluir
...] vários arquivos em um comando.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para enviar o arquivo report.txt, localizado no diretório atual, para uma impressora
conectada ao lpt2 no computador local, digite:

print /d:lpt2 report.txt

Para enviar o arquivo report.txt, localizado no diretório c:\accounting, para a fila de


impressão printer1 no servidor /d:\copyroom, digite:

print /d:\\copyroom\printer1 c:\accounting\report.txt

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos de impressão

comando Mode
prncnfg
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Configura ou exibe as informações de configuração sobre uma impressora. Esse


comando é um script do Visual Basic localizado no diretório
%WINdir%\System32\printing_Admin_Scripts\<language> . Para usar esse comando em

uma solicitação de comando, digite cscript seguido do caminho completo para o


arquivo prncnfg ou altere os diretórios para a pasta apropriada. Por exemplo: cscript
%WINdir%\System32\printing_Admin_Scripts\en-US\prncnfg .

Sintaxe

cscript prncnfg {-g | -t | -x | -?} [-S <Servername>] [-P <Printername>] [-z


<newprintername>] [-u <Username>] [-w <password>] [-r <portname>] [-l
<location>] [-h <sharename>] [-m <comment>] [-f <separatorfilename>] [-y
<datatype>] [-st <starttime>] [-ut <untiltime>] [-i <defaultpriority>] [-o
<priority>] [<+|->shared] [<+|->direct] [<+|->hidden] [<+|->published] [<+|-
>rawonly] [<+|->queued] [<+|->enablebidi] [<+|->keepprintedjobs] [<+|-
>workoffline] [<+|->enabledevq] [<+|->docompletefirst]

Parâmetros

Parâmetro Descrição

-g Exibe as informações de configuração de uma impressora.

-T Configura uma impressora.

-X Renomeia uma impressora.

-S <Servername> Especifica o nome do computador remoto que hospeda a impressora


que você deseja gerenciar. Se você não especificar um computador, o
computador local será usado.

-P <Printername> Especifica o nome da impressora que você deseja gerenciar.


Obrigatórios.

-z <newprintername> Especifica o novo nome da impressora. Exige os parâmetros -x e -P.


Parâmetro Descrição

-u <Username> -w Especifica uma conta com permissões para se conectar ao computador


<password> que hospeda a impressora que você quer gerenciar. Todos os membros
do grupo de administradores locais do computador de destino têm essas
permissões, mas as permissões também podem ser concedidas a outros
usuários. Caso você não especifique uma conta, deve estar conectado a
uma conta com essas permissões para que o comando funcione.

-r <portname> Especifica a porta em que a impressora está conectada. Se for uma porta
paralela ou serial, use a ID da porta (por exemplo, LPT1 ou COM1). Se
essa for uma porta TCP/IP, use o nome da porta que foi especificado
quando a porta foi adicionada.

-l <location> Especifica o local da impressora, como Copyroom. Se o local contiver


espaços, use aspas ao redor do texto, por exemplo, "Sala de Cópia".

-h <sharename> Especifica o nome do compartilhamento da impressora.

-m <comment> Especifica a cadeia de caracteres de comentário da impressora.

-f Especifica um arquivo que contém o texto exibido na página do


<separatorfilename> separador.

-y <datatype> Especifica os tipos de dados que a impressora pode aceitar.

-st <starttime> Configura a impressora para disponibilidade limitada. Especifica a hora


do dia em que a impressora está disponível. Se você enviar um
documento para uma impressora quando ela estiver indisponível, o
documento será mantido (armazenado em spool) até que a impressora
fique disponível. Você deve especificar a hora como um relógio de 24
horas. Por exemplo, para especificar 23:00, digite 2300.

-ut <endtime> Configura a impressora para disponibilidade limitada. Especifica a hora


do dia em que a impressora não está mais disponível. Se você enviar um
documento para uma impressora quando ela estiver indisponível, o
documento será mantido (armazenado em spool) até que a impressora
fique disponível. Você deve especificar a hora como um relógio de 24
horas. Por exemplo, para especificar 23:00, digite 2300.

-o <priority> Especifica uma prioridade que o spooler usa para rotear trabalhos de
impressão para a fila de impressão. Uma fila de impressão com
prioridade mais alta recebe todos os trabalhos antes de qualquer fila
com prioridade mais baixa.

-i <defaultpriority> Especifica a prioridade padrão atribuída a cada trabalho de impressão.

{+|-} shared Especifica se essa impressora é compartilhada na rede.

{+|-} direct Especifica se o documento deve ser enviado diretamente para a


impressora sem ser carregado.
Parâmetro Descrição

{+|-} published Especifica se essa impressora deve ser publicada no Active Directory. Se
você publicar a impressora, outros usuários poderão pesquisá-la com
base na localização e funcionalidades (como impressão de cores e
associação).

{+|-} hidden Função reservada.

{+|-} rawonly Especifica se somente trabalhos de impressão de dados brutos podem


ser armazenados nessa fila.

{+|-} }queued Especifica que a impressora não deve começar a imprimir até que a
última página do documento seja carregada. O programa de impressão
só fica disponível após a conclusão da impressão do documento. No
entanto, o uso desse parâmetro garante que todo o documento fique
disponível para a impressora.

{+|-} keepprintedjobs Especifica se o spooler deve reter os documentos após a impressão.


Habilitar essa opção permite que um usuário reenvie um documento
para a impressora a partir da fila de impressão, e não do programa de
impressão.

{+|-} workoffline Especifica se um usuário poderá enviar trabalhos de impressão para a fila
de impressão se o computador não estiver conectado à rede.

{+|-} enabledevq Especifica se os trabalhos de impressão que não correspondem à


configuração da impressora (por exemplo, arquivos PostScript com spool
para impressoras não PostScript) devem ser mantidos na fila em vez de
serem impressos.

{+|-} docompletefirst Especifica se o spooler deve enviar trabalhos de impressão com


prioridade mais baixa que concluíram o spooling antes de enviar
trabalhos de impressão com prioridade mais alta e que não concluíram o
spooling. Se essa opção estiver habilitada e nenhum documento tiver
concluído o spooling, o spooler enviará documentos maiores antes dos
menores. Habilite essa opção se quiser maximizar a eficiência da
impressora ao custo da prioridade do trabalho. Se essa opção estiver
desabilitada, o spooler sempre enviará primeiro os trabalhos com
prioridade mais alta para suas respectivas filas.

{+|-} enablebidi Especifica se a impressora envia informações de status ao spooler.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para exibir informações de configuração da impressora chamada colorprinter_2 com
uma fila de impressão hospedada pelo computador remoto chamado HRServer, digite:
cscript prncnfg -g -S HRServer -P colorprinter_2

Para configurar uma impressora chamada colorprinter_2 para que o spooler no


computador remoto chamado HRServer mantenha os trabalhos de impressão depois
que eles tiverem sido impressos, digite:

cscript prncnfg -t -S HRServer -P colorprinter_2 +keepprintedjobs

Para alterar o nome de uma impressora no computador remoto chamado HRServer de


colorprinter_2 para colorprinter 3, digite:

cscript prncnfg -x -S HRServer -P colorprinter_2 -z "colorprinter 3"

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos de impressão


prndrvr
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Adiciona, exclui e lista drivers de impressora. Esse comando é um script do Visual Basic
localizado no diretório %WINdir%\System32\printing_Admin_Scripts\<language> . Para usar
esse comando em um prompt de comando, digite cscript seguido do caminho
completo para o arquivo prnmngr ou altere os diretórios para a pasta apropriada. Por
exemplo: cscript %WINdir%\System32\printing_Admin_Scripts\en-US\prndrvr .

Usado sem parâmetros, prndrvr exibe a ajuda da linha de comando.

Sintaxe

cscript prndrvr {-a | -d | -l | -x | -?} [-m <model>] [-v {0|1|2|3}] [-e


<environment>] [-s <Servername>] [-u <Username>] [-w <password>] [-h <path>]
[-i <inf file>]

Parâmetros

Parâmetro Descrição

-a Instala um driver.

-d Exclui um driver.

-l Lista todos os drivers de impressora instalados no servidor especificado pelo


parâmetro -s. Se você não especificar um servidor, o Windows listará os drivers
de impressora instalados no computador local.

-X Exclui todos os drivers de impressora e drivers de impressora adicionais que


não são usados por uma impressora lógica no servidor especificado pelo
parâmetro -s. Se você não especificar um servidor para remover da lista, o
Windows excluirá todos os drivers de impressora não utilizados no computador
local.

-m Especifica (por nome) o driver que você deseja instalar. Os drivers geralmente
<model_name> são nomeados para o modelo de impressora compatível. Confira a
documentação de impressora para obter mais informações.
Parâmetro Descrição

-v {0|1|2|3} Especifica a versão do driver que você deseja instalar. Consulte a descrição do
parâmetro -e para obter informações sobre as versões que estão disponíveis
para os ambientes. Se você não especificar uma versão, será instalada a versão
do driver apropriada para a versão do Windows em execução no computador
em que você está instalando o driver.

-e Especifica o ambiente para o driver que você deseja instalar. Se você não
<environment> especificar um ambiente, será usado o ambiente do computador em que você
está instalando o driver. Os parâmetros de ambiente compatíveis são: Windows
NT x86, Windows x64 ou Windows IA64.

-s <Servername> Especifica o nome do computador remoto que hospeda a impressora que você
deseja gerenciar. Se você não especificar um computador, o computador local
será usado.

-u <Username> - Especifica uma conta com permissões para se conectar ao computador que
w <password> hospeda a impressora que você deseja gerenciar. Todos os membros do grupo
de administradores locais do computador de destino têm essas permissões,
mas as permissões também podem ser concedidas a outros usuários. Caso você
não especifique uma conta, deve estar conectado a uma conta com essas
permissões para que o comando funcione.

-h <path> Especifica o caminho para o arquivo de driver. Se você não especificar um


caminho, será usado o caminho para o local em que o Windows foi instalado.

-i Especifica o caminho e o nome do arquivo completos para o driver que você


<filename.inf> deseja instalar. Se você não especificar um nome de arquivo, o script usará um
dos arquivos .inf da impressora de caixa de entrada no subdiretório inf do
diretório do Windows.
se o caminho do driver não for especificado, o script pesquisará arquivos de
driver no arquivo driver.cab.

/? Exibe a ajuda no prompt de comando.

Comentários
Se as informações fornecidas contiverem espaços, use o texto entre aspas (por
exemplo, "Nome do Computador").

O parâmetro -x exclui todos os drivers de impressora adicionais (drivers instalados


para uso em clientes que executam versões alternativas do Windows), mesmo que
o driver primário esteja em uso. Se o componente de fax estiver instalado, essa
opção também excluirá os drivers de fax. O driver de fax primário será excluído se
não estiver em uso (isto é, se não houver fila usando-o). Se o driver de fax primário
for excluído, a única maneira de reabilitar o fax será reinstalar o componente de
fax.

Exemplos
Para listar todos os drivers no servidor local \printServer1, digite:

cscript prndrvr -l -s

Para adicionar um driver de impressora do Windows x64 versão 3 para o modelo 1 da


impressora Laser usando o arquivo de informações de driver c:\temp\Laserprinter1.inf
para um driver armazenado na pasta c:\temp, digite:

cscript prndrvr -a -m Laser printer model 1 -v 3 -e Windows x64 -i


c:\temp\Laserprinter1.inf -h c:\temp

Para excluir um driver de impressora do Windows x64 versão 3 para o modelo 1 da


impressora Laser, digite:

cscript prndrvr -a -m Laser printer model 1 -v 3 -e Windows x64

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos de impressão


prnjobs
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Pausa, retoma, cancela e lista os trabalhos de impressão. Esse comando é um script do


Visual Basic localizado no diretório %WINdir%\System32\printing_Admin_Scripts\
<language> . Para usar esse comando em uma solicitação de comando, digite cscript

seguido do caminho completo para o arquivo prnjobs ou altere os diretórios para a


pasta apropriada. Por exemplo: cscript %WINdir%\System32\printing_Admin_Scripts\en-
US\prnjobs.vbs .

Sintaxe

cscript prnjobs {-z | -m | -x | -l | -?} [-s <Servername>] [-p


<Printername>] [-j <JobID>] [-u <Username>] [-w <password>]

Parâmetros

Parâmetro Descrição

-Z Pausa o trabalho de impressão especificado pelo parâmetro -j.

-M Retoma o trabalho de impressão especificado pelo parâmetro -j.

-X Cancela o trabalho de impressão especificado pelo parâmetro -j.

-l Lista todos os trabalhos de impressão em uma fila de impressão.

-s Especifica o nome do computador remoto que hospeda a impressora que você


<Servername> deseja gerenciar. Se você não especificar um computador, o computador local
será usado.

-p Obrigatórios. Especifica o nome da impressora que você deseja gerenciar.


<Printername>

-j <JobID> Especifica (por número de ID) o trabalho de impressão que você deseja cancelar.
Parâmetro Descrição

-u <Username> Especifica uma conta com permissões para se conectar ao computador que
-w <password> hospeda a impressora que você deseja gerenciar. Todos os membros do grupo
de administradores locais do computador de destino têm essas permissões, mas
as permissões também podem ser concedidas a outros usuários. Se você não
especificar uma conta, deve estar conectado a uma conta com essas permissões
para que o comando funcione.

/? Exibe a ajuda no prompt de comando.

Comentários
Se as informações fornecidas contiverem espaços, use o texto entre aspas (por
exemplo, "Nome do Computador").

Exemplos
Para pausar um trabalho de impressão com uma ID de trabalho de 27 enviada ao
computador remoto chamado HRServer para impressão na impressora chamada
colorprinter, digite:

cscript prnjobs.vbs -z -s HRServer -p colorprinter -j 27

Para listar todos os trabalhos de impressão atuais na fila da impressora local chamada
colorprinter_2, digite:

cscript prnjobs.vbs -l -p colorprinter_2

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos de impressão


prnmngr
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Adiciona, exclui e lista as impressoras ou conexões de impressora, além de definir e


exibir a impressora padrão. Esse comando é um script do Visual Basic localizado no
diretório %WINdir%\System32\printing_Admin_Scripts\<language> . Para usar esse
comando em um prompt de comando, digite cscript seguido do caminho completo
para o arquivo prnmngr ou altere os diretórios para a pasta apropriada. Por exemplo:
cscript %WINdir%\System32\printing_Admin_Scripts\en-US\prnmngr .

Sintaxe

cscript prnmngr {-a | -d | -x | -g | -t | -l | -?}[c] [-s <Servername>] [-p


<Printername>] [-m <printermodel>] [-r <portname>] [-u <Username>]
[-w <password>]

Parâmetros

Parâmetro Descrição

-a Adiciona uma conexão de impressora local.

-d Exclui uma conexão de impressora.

-X Exclui todas as impressoras do servidor especificado pelo parâmetro -s. Se você


não especificar um servidor, o Windows excluirá todas as impressoras no
computador local.

-g Exibe a impressora padrão.

-T Define a impressora padrão como a impressora especificada pelo parâmetro -p.

-l Lista todas as impressoras instaladas no servidor especificado pelo parâmetro -s.


Se você não especificar um servidor, o Windows listará as impressoras instaladas
no computador local.

c Especifica que o parâmetro se aplica a conexões de impressora. Pode ser usado


com os parâmetros -a e -x.
Parâmetro Descrição

-s Especifica o nome do computador remoto que hospeda a impressora que você


<Servername> deseja gerenciar. Se você não especificar um computador, o computador local
será usado.

-p Especifica o nome da impressora que você deseja gerenciar.


<Printername>

-m Especifica (por nome) o driver que você deseja instalar. Os drivers geralmente
<Modelname> são nomeados para o modelo de impressora a que dão suporte. Confira a
documentação de impressora para obter mais informações.

-r <portname> Especifica a porta em que a impressora está conectada. Se essa for uma porta
paralela ou serial, use a ID da porta (por exemplo, LPT1: ou COM1:). Se essa for
uma porta TCP/IP, use o nome da porta que foi especificado quando a porta foi
adicionada.

-u <Username> Especifica uma conta com permissões para se conectar ao computador que
-w <password> hospeda a impressora que você deseja gerenciar. Todos os membros do grupo
administradores locais do computador de destino têm essas permissões, mas as
permissões também podem ser concedidas a outros usuários. Se você não
especificar uma conta, deve estar conectado a uma conta com essas permissões
para que o comando funcione.

/? Exibe a ajuda no prompt de comando.

Comentários
Se as informações fornecidas contiverem espaços, use aspas ao redor do texto (por
exemplo, "Nome do Computador").

Exemplos
Para adicionar uma impressora chamada colorprinter_2 conectada ao LPT1 no
computador local e exigir um driver de impressora chamado driver1 de impressora
colorida, digite:

cscript prnmngr -a -p colorprinter_2 -m "color printer Driver1" -r lpt1:

Para excluir a impressora chamada colorprinter_2 do computador remoto chamado


HRServer, digite:
cscript prnmngr -d -s HRServer -p colorprinter_2

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos de impressão


prnport
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria, exclui e lista as portas de impressora TCP/IP padrão, além de exibir e alterar a
configuração da porta. Esse comando é um script do Visual Basic localizado no diretório
%WINdir%\System32\printing_Admin_Scripts\<language> . Para usar esse comando em um

prompt de comando, digite cscript seguido do caminho completo para o arquivo


prnport ou altere os diretórios para a pasta apropriada. Por exemplo: cscript
%WINdir%\System32\printing_Admin_Scripts\en-US\prnport .

Sintaxe

cscript prnport {-a | -d | -l | -g | -t | -?} [-r <portname>] [-s


<Servername>] [-u <Username>] [-w <password>] [-o {raw | lpr}] [-h
<Hostaddress>] [-q <Queuename>] [-n <portnumber>] -m{e | d} [-i <SNMPindex>]
[-y <communityname>] -2{e | -d}

Parâmetros

Parâmetro Descrição

-a Cria uma porta de impressora TCP/IP padrão.

-d Exclui uma porta de impressora TCP/IP padrão.

-l Lista todas as portas de impressora TCP/IP padrão no computador


especificado pelo parâmetro -s.

-g Exibe a configuração de uma porta de impressora TCP/IP padrão.

-T Define as configurações de porta para uma porta de impressora TCP/IP


padrão.

-r <portname> Especifica a porta à qual a impressora está conectada.

-s <Servername> Especifica o nome do computador remoto que hospeda a impressora que


você deseja gerenciar. Se você não especificar um computador, o computador
local será usado.
Parâmetro Descrição

-u <Username> - Especifica uma conta com permissões para se conectar ao computador que
w <password> hospeda a impressora que você deseja gerenciar. Todos os membros do grupo
de administradores locais do computador de destino têm essas permissões,
mas as permissões também podem ser concedidas a outros usuários. Caso
você não especifique uma conta, deve estar conectado a uma conta com essas
permissões para que o comando funcione.

-o {raw|lpr} Especifica qual protocolo a porta usa: TCP bruto ou TCP lpr. O protocolo TCP
bruto é um protocolo de melhor desempenho no Windows do que o
protocolo lpr. Se você usar o TCP bruto, opcionalmente, poderá especificar o
número da porta usando o parâmetro -n. O número da porta padrão é 9100.

-h Especifica (por endereço IP) a impressora para a qual você deseja configurar a
<Hostaddress> porta.

-q <Queuename> Especifica o nome da fila para uma porta TCP bruto.

-n <portnumber> Especifica o número da porta para uma porta TCP bruto. O número da porta
padrão é 9100.

-m {e|d} Especifica se o SNMP está habilitado. O parâmetro e habilita o SNMP. O


parâmetro d desabilita o SNMP.

-i <SNMPindex Especifica o índice SNMP, se o SNMP estiver habilitado. Para obter mais
informações, confira Rfc 1759 no site do editor rfc .

-y Especifica o nome da comunidade SNMP, se o SNMP estiver habilitado.


<communityname>

-2 {e|-d} Especifica se os spools duplos (também conhecidos como respooling) estão


habilitados para portas TCP lpr. Spools duplos são necessários porque o TCP
lpr deve incluir uma contagem precisa de bytes no arquivo de controle que é
enviado para a impressora, mas o protocolo não pode obter a contagem do
provedor de impressão local. Portanto, quando um arquivo é enfileirado em
uma fila de impressão TCP lpr, ele também é colocado em spool como um
arquivo temporário no diretório system32. O TCP lpr determina o tamanho do
arquivo temporário e envia o tamanho para o servidor que executa o LPD. O
parâmetro e habilita spools duplos. O parâmetro d desabilita spools duplos.

/? Exibe a ajuda no prompt de comando.

Comentários
Se as informações fornecidas contiverem espaços, use o texto entre aspas (por
exemplo, "Nome do Computador").
Exemplos
Para exibir todas as portas de impressão TCP/IP padrão no servidor \Server1, digite:

cscript prnport -l -s Server1

Para excluir a porta de impressão TCP/IP padrão no servidor \Server1, que se conecta a
uma impressora de rede em 10.2.3.4, digite:

cscript prnport -d -s Server1 -r IP_10.2.3.4

Para adicionar uma porta de impressão TCP/IP padrão no servidor \Server1, que se
conecta a uma impressora de rede em 10.2.3.4 e usa o protocolo TCP bruto na porta
9100, digite:

cscript prnport -a -s Server1 -r IP_10.2.3.4 -h 10.2.3.4 -o raw -n 9100

Para habilitar o SNMP, especifique o nome da comunidade "pública" e defina o índice


SNMP como 1 em uma impressora de rede em 10.2.3.4 compartilhado pelo servidor
\Server1, digite:

cscript prnport -t -s Server1 -r IP_10.2.3.4 -me -y public -i 1 -n 9100

Para adicionar uma porta de impressão TCP/IP padrão no computador local, que se
conecta a uma impressora de rede na versão 10.2.3.4, e obter automaticamente as
configurações do dispositivo da impressora, digite:

cscript prnport -a -r IP_10.2.3.4 -h 10.2.3.4

Links relacionados
Chave da sintaxe de linha de comando
Referência aos comandos de impressão
prnqctl
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Imprime uma página de teste, pausa ou retoma uma impressora e limpa uma fila de
impressora. Esse comando é um script do Visual Basic localizado no diretório
%WINdir%\System32\printing_Admin_Scripts\<language> . Para usar esse comando em um

prompt de comando, digite cscript seguido do caminho completo para o arquivo


prnqctl ou altere os diretórios para a pasta apropriada. Por exemplo: cscript
%WINdir%\System32\printing_Admin_Scripts\en-US\prnqctl .

Sintaxe

cscript Prnqctl {-z | -m | -e | -x | -?} [-s <Servername>] [-p


<Printername>] [-u <Username>] [-w <password>]

Parâmetros

Parâmetro Descrição

-Z Pausa a impressão na impressora especificada pelo parâmetro -p.

-M Retoma a impressão na impressora especificada pelo parâmetro -p.

-E Imprime uma página de teste na impressora especificada pelo parâmetro -p.

-X Cancela todos os trabalhos de impressão na impressora especificada pelo


parâmetro -p.

-s Especifica o nome do computador remoto que hospeda a impressora que você


<Servername> deseja gerenciar. Se você não especificar um computador, o computador local
será usado.

-p Obrigatórios. Especifica o nome da impressora que você deseja gerenciar.


<Printername>
Parâmetro Descrição

-u <Username> Especifica uma conta com permissões para se conectar ao computador que
-w <password> hospeda a impressora que você deseja gerenciar. Todos os membros do grupo
administradores locais do computador de destino têm essas permissões, mas as
permissões também podem ser concedidas a outros usuários. Se você não
especificar uma conta, deve estar conectado a uma conta com essas permissões
para que o comando funcione.

/? Exibe a ajuda no prompt de comando.

Comentários
Se as informações fornecidas contiverem espaços, use aspas ao redor do texto (por
exemplo, "Nome do Computador").

Exemplos
Para imprimir uma página de teste na impressora Laserprinter1 compartilhada pelo
computador \Server1, digite:

cscript prnqctl -e -s Server1 -p Laserprinter1

Para pausar a impressão na impressora Laserprinter1 no computador local, digite:

cscript prnqctl -z -p Laserprinter1

Para cancelar todos os trabalhos de impressão na impressora Laserprinter1 no


computador local, digite:

cscript prnqctl -x -p Laserprinter1

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos de impressão


prompt
Artigo • 12/04/2023

Altera o prompt de comando do Cmd.exe, incluindo a exibição de qualquer texto


desejado, como o nome do diretório atual, a hora e a data ou o número de versão do
Microsoft Windows. Se usado sem parâmetros, esse comando redefine o prompt de
comando para a configuração padrão, que é a letra da unidade e o diretório atuais
seguidos do símbolo maior que (>).

Sintaxe

prompt [<text>]

Parâmetros

Parâmetro Descrição

<text> Especifica o texto e as informações que você deseja incluir no prompt de comando.

/? Exibe a ajuda no prompt de comando.

Comentários
As combinações de caracteres que você pode incluir em vez de, ou além de, uma
ou mais cadeias de caracteres no parâmetro text:

Caractere Descrição

$q = (Sinal de igual)

$$ $ (sinal de dólar)

$t Hora atual

$d Data atual

$p Unidade e caminho atuais

$v Número de versão do Windows

$n Unidade atual
Caractere Descrição

$g > (sinal de maior que)

$l < (sinal de menor que)

$b | (símbolo de pipe)

$_ ENTER-LINEFEED

$e Código de escape ANSI (código 27)

$h Backspace (para excluir um caractere que foi gravado na linha de comando)

$a & (E comercial)

$c ( (parêntese esquerdo)

$f ) (parêntese direito)

$s Space

Quando as extensões de comando estão habilitadas, o comando prompt permite


os seguintes caracteres de formatação:

Caractere Descrição

$+ Os caracteres zero ou sinal de mais (+), dependendo da profundidade da pilha


de diretórios do pushd (um caractere para cada nível enviado).

$m O nome remoto associado à letra da unidade atual ou à cadeia de caracteres


vazia, se a unidade atual não for uma unidade de rede.

Se você incluir o caractere $p no parâmetro de texto, o disco será lido depois que
você inserir cada comando (para determinar a unidade e o caminho atuais). Isso
pode levar mais tempo, especialmente para unidades de disquete.

Exemplos
Para definir um prompt de comando de duas linhas com a hora e a data atuais na
primeira linha e o sinal de maior que na próxima linha, digite:

prompt $d$s$s$t$_$g

O prompt é alterado da seguinte maneira, onde a data e a hora são atuais:


Fri 06/01/2007 13:53:28.91

Para definir o prompt de comando a ser exibido como uma seta ( --> ), digite:

prompt --$g

Para alterar manualmente o prompt de comando para a configuração padrão (a unidade


e o caminho atuais seguidos do sinal de maior que), digite:

prompt $p$g

Links relacionados
Chave da sintaxe de linha de comando
pubprn
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Publica uma impressora no Active Directory Domain Services. Esse comando é um script
do Visual Basic localizado no diretório %WINdir%\System32\printing_Admin_Scripts\
<language> . Para usar esse comando em um prompt de comando, digite cscript seguido

do caminho completo para o arquivo pubprn ou altere os diretórios para a pasta


apropriada. Por exemplo: cscript %WINdir%\System32\printing_Admin_Scripts\en-
US\pubprn .

Sintaxe

cscript pubprn {<servername> | <UNCprinterpath>} LDAP://CN=<container>,DC=


<container>

Parâmetros

Parâmetro Descrição

<servername> Especifica o nome do servidor Windows que hospeda a impressora que você
deseja publicar. Se você não especificar um computador, o computador local
será usado.

<UNCprinterpath> O caminho UNC (Convenção de Nomenclatura Universal) para a impressora


compartilhada que você deseja publicar.

LDAP://CN= Especifica o caminho para o contêiner no Active Directory Domain Services


<Container>,DC= em que você deseja publicar a impressora.
<Container>

/? Exibe a ajuda no prompt de comando.

Comentários
Se as informações fornecidas contiverem espaços, use aspas ao redor do texto (por
exemplo, "Nome do Computador").
Exemplos
Para publicar todas as impressoras no computador \Server1 no contêiner MyContainer
no domínio MyDomain.company.com, digite:

cscript pubprn Server1 LDAP://CN=MyContainer,DC=MyDomain,DC=company,DC=Com

Para publicar a impressora Laserprinter1 no servidor \\Server1 no contêiner


MyContainer no domínio MyDomain.company.com, digite:

cscript pubprn \\Server1\Laserprinter1


LDAP://CN=MyContainer,DC=MyDomain,DC=company,DC=Com

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos de impressão


pushd
Artigo • 11/04/2023

Armazena o diretório atual para o uso pelo comando popd, em seguida, muda para o
diretório especificado.

Sempre que você usa o comando pushd, um único diretório é armazenado para o uso.
No entanto, você pode armazenar vários diretórios usando o comando pushd diversas
vezes. Os diretórios são armazenados sequencialmente em uma pilha virtual, portanto,
se você usar o comando pushd uma vez, o diretório no qual usa o comando será
colocado na parte inferior da pilha. Se você usar o comando novamente, o segundo
diretório será colocado sobre o primeiro. O processo se repete sempre que você usa o
comando pushd.

Se você usar o comando popd, o diretório no topo da pilha será removido e o diretório
atual mudará para esse diretório. Se você usar o comando popd novamente, o próximo
diretório na pilha será removido. Se as extensões de comando estiverem habilitadas, o
comando popd removerá qualquer atribuição de letra da unidade criada pelo comando
pushd.

Sintaxe

pushd [<path>]

Parâmetros

Parâmetro Descrição

<path> Especifica o diretório para tornar o diretório atual. Esse comando tem suporte para
os caminhos relativos.

/? Exibe a ajuda no prompt de comando.

Comentários

Se as extensões de comando estiverem habilitadas, o comando pushd aceitará um


caminho de rede ou uma letra e caminho da unidade local.
Se você especificar um caminho de rede, o comando pushd atribuirá
temporariamente a letra de unidade não utilizada mais alta (começando com Z:)
ao recurso de rede especificado. Em seguida, o comando altera a unidade e o
diretório atuais para o diretório especificado na unidade recém-atribuída. Se você
usar o comando popd com as extensões de comando habilitadas, o comando
popd removerá a atribuição de letra da unidade criada por pushd.

Exemplos
Para alterar o diretório atual no qual o programa em lote foi executado, em seguida,
alterá-lo novamente:

@echo off
rem This batch file deletes all .txt files in a specified directory
pushd %1
del *.txt
popd
cls
echo All text files deleted in the %1 directory

Links relacionados
Chave da sintaxe de linha de comando

comando popd
pushprinterconnections
Artigo • 12/04/2023

Lê as configurações de Conexão de Impressora Implantada na Política de Grupo e


implanta/remove as conexões de impressora conforme necessário.

) Importante

Esse utilitário é para uso em scripts de inicialização do computador ou logon do


usuário e não deve ser executado na linha de comando.

Sintaxe

pushprinterconnections <-log> <-?>

Parâmetros

Parâmetro Descrição

<-log> Grava um arquivo de log de depuração por usuário em %temp ou grava um log de
depuração por computador em %windir%\temp.

<-?> Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos de impressão

Implantar impressoras usando a Política de Grupo


pwlauncher
Artigo • 12/04/2023

Habilita ou desabilita as Opções de Inicialização do Windows To Go (pwlauncher). A


ferramenta de linha de comando pwlauncher permite que você configure o computador
para inicializar em um workspace do Windows To Go automaticamente (supondo que
esteja presente), sem exigir que você insira seu firmware ou altere suas opções de
inicialização.

As Opções de Inicialização do Windows To Go permitem que um usuário configure seu


computador para inicializar a partir de USB no Windows, sem nunca inserir o firmware,
desde que o firmware dê suporte à inicialização de USB. Permitir que um sistema
sempre inicialize a partir do USB primeiro tem implicações que você deve considerar.
Por exemplo, um dispositivo USB que inclui malware pode ser inicializado
inadvertidamente comprometendo o sistema ou várias unidades USB podem ser
conectadas causando um conflito de inicialização. Por esse motivo, a configuração
padrão tem as Opções de Inicialização do Windows To Go desabilitadas por padrão.
Além disso, privilégios de administrador são necessários para configurar as Opções de
Inicialização do Windows To Go. Se você habilitar as opções de inicialização do Windows
To Go usando a ferramenta de linha de comando pwlauncher ou o aplicativo Alterar
Opções de Inicialização do Windows To Go, o computador tentará inicializar a partir de
qualquer dispositivo USB inserido no computador, antes de ser iniciado.

Sintaxe

pwlauncher {/enable | /disable}

Parâmetros

Parâmetro Descrição

/enable Habilita as opções de inicialização do Windows To Go para que o computador seja


inicializado automaticamente a partir de um dispositivo USB, quando presente.

/disable Desabilita as opções de inicialização do Windows To Go para que o computador não


possa ser inicializado a partir de um dispositivo USB, a menos que seja configurado
manualmente no firmware.

/? Exibe a ajuda no prompt de comando.


Exemplos
Para habilitar a inicialização do USB:

pwlauncher /enable

Links relacionados
Chave da sintaxe de linha de comando
qappsrv
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe uma lista de todos os servidores Host da Sessão da Área de Trabalho Remota na
rede. Para descobrir as novidades da última versão, veja Novidades nos Serviços de Área
de Trabalho Remota do Windows Server.

7 Observação

Esse comando é igual ao comando query termserver.

Links relacionados
Chave da sintaxe de linha de comando

comando query termserver

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
qprocess
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe as informações sobre processos em execução em um servidor host da Sessão da


Área de Trabalho Remota. Para descobrir as novidades da última versão, confira
Novidades nos Serviços de Área de Trabalho Remota do Windows Server.

7 Observação

Esse comando é igual ao comando query process.

Links relacionados
Chave da sintaxe de linha de comando

comando query process

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
comandos de consulta
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe informações sobre processos, sessões e servidores Host da Sessão da Área de


Trabalho Remota. Para descobrir as novidades da última versão, veja Novidades nos
Serviços de Área de Trabalho Remota do Windows Server.

Sintaxe

query process
query session
query termserver
query user

Parâmetros

Parâmetro Descrição

query Exibe informações sobre os processos em execução em um servidor Host da Sessão


process da Área de Trabalho Remota.

query Exibe informações sobre as sessões em um servidor Host da Sessão da Área de


session Trabalho Remota.

query Exibe uma lista de todos os servidores Host da Sessão da Área de Trabalho Remota
termserver na rede.

query user Exibe informações sobre as sessões do usuário em um servidor Host da Sessão da
Área de Trabalho Remota.

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
processo de consulta
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe informações sobre processos em execução em um servidor Host da Sessão da


Área de Trabalho Remota. Use esse comando para descobrir quais programas um
usuário específico está executando e também quais usuários estão executando um
programa específico. Esse comando retorna as informações a seguir:

Usuário proprietário do processo

Sessão proprietária do processo

ID da sessão

Nome do processo

ID do processo

7 Observação

Para descobrir as novidades da última versão, confira Novidades nos Serviços de


Área de Trabalho Remota do Windows Server.

Sintaxe

query process [*|<processID>|<username>|<sessionname>|/id:<nn>|


<programname>] [/server:<servername>]

Parâmetros

Parâmetro Descrição

* Lista os processos para todas as sessões.

<processID> Especifica a ID numérica que identifica o processo que você deseja


consultar.
Parâmetro Descrição

<username> Especifica o nome do usuário cujos processos você deseja listar.

<sessionname> Especifica o nome da sessão ativa cujos processos você deseja listar.

/id: <nn> Especifica a ID da sessão cujos processos você deseja listar.

<programname> Especifica o nome do programa cujos processos você deseja consultar. A


extensão .exe é obrigatória.

/server: <servername> Especifica o servidor Host da Sessão da Área de Trabalho Remota cujos
processos você deseja listar. Se não for especificado, o servidor ao qual
você está conectado será usado.

/? Exibe a ajuda no prompt de comando.

Comentários
Administradores têm acesso completo a todas as funções de query process.

Se você não especificar os parâmetros <username>, <sessionname>, /id: <nn> ,


<programname> ou *, essa consulta exibirá apenas os processos que pertencem
ao usuário atual.

Quando query process retorna informações, um símbolo de maior que (>) é


exibido antes de cada processo que pertence à sessão atual.

Exemplos
Para exibir informações sobre os processos que estão sendo usados por todas as
sessões, digite:

query process *

Para exibir informações sobre os processos que estão sendo usados pela ID de sessão 2,
digite:

query process /ID:2


Links relacionados
Chave da sintaxe de linha de comando

query command

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
query session
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe as informações sobre as sessões em um servidor Host da Sessão da Área de


Trabalho Remota. A lista inclui as informações não só sobre as sessões ativas, mas
também sobre outras sessões que o servidor executa.

7 Observação

Para descobrir as novidades da última versão, confira Novidades nos Serviços de


Área de Trabalho Remota do Windows Server.

Sintaxe

query session [<sessionname> | <username> | <sessionID>] [/server:


<servername>] [/mode] [/flow] [/connect] [/counter]

Parâmetros

Parâmetro Descrição

<sessionname> Especifica o nome da sessão que você deseja consultar.

<username> Especifica o nome do usuário cujas sessões você deseja consultar.

<sessionID> Especifica a ID da sessão que você deseja consultar.

/server: <servername> Identifica o servidor Host da Sessão da Área de Trabalho Remota a ser
consultado. O padrão é o servidor atual.

/mode Exibe as configurações de linha atuais.

/flow Exibe as configurações atuais do controle de fluxo.

/connect Exibe as configurações de conexão atuais.


Parâmetro Descrição

/counter Exibe as informações de contadores atuais, incluindo o número total de


sessões criadas, desconectadas e reconectadas.

/? Exibe a ajuda no prompt de comando.

Comentários
Um usuário sempre pode consultar a sessão na qual o usuário está conectado no
momento. Para consultar outras sessões, o usuário deve ter permissão de acesso
especial.

Se você não especificar uma sessão usando os parâmetros <username>,


<sessionname> ou sessionID, essa consulta exibirá as informações sobre todas as
sessões ativas no sistema.

Quando o query session retorna as informações, um símbolo maior que (>) é


exibido antes da sessão atual. Por exemplo:

C:\>query session
SESSIONNAME USERNAME ID STATE TYPE DEVICE
console Administrator1 0 active wdcon
>rdp-tcp#1 User1 1 active wdtshare
rdp-tcp 2 listen wdtshare
4 idle
5 idle

Em que:
SESSIONNAME especifica o nome atribuído à sessão.
USERNAME indica o nome de usuário conectado à sessão.
STATE fornece as informações sobre o estado atual da sessão.
TYPE indica o tipo de sessão.
DEVICE, que não está presente nas sessões do console ou conectadas à rede, é
o nome do dispositivo atribuído à sessão.
As sessões nas quais o estado inicial está configurado como DESABILITADO não
aparecerão na lista do query session até que estejam habilitadas.

Exemplos
Para exibir as informações sobre todas as sessões ativas no servidor Server2, digite:
query session /server:Server2

Para exibir as informações sobre o modeM02 da sessão ativa, digite:

query session modeM02

Links relacionados
Chave da sintaxe de linha de comando

comando query

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
query termserver
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe uma lista de todos os servidores Host da Sessão da Área de Trabalho Remota na
rede. Esse comando pesquisa na rede todos os servidores Host da Sessão da Área de
Trabalho Remota anexados e retorna as seguintes informações:

Nome do servidor

Rede (e endereço do nó, se a opção /address for usada)

7 Observação

Para descobrir as novidades da última versão, confira Novidades nos Serviços de


Área de Trabalho Remota do Windows Server.

Sintaxe

query termserver [<servername>] [/domain:<domain>] [/address] [/continue]

Parâmetros

Parâmetro Descrição

<servername> Especifica o nome que identifica o servidor host da Sessão da Área de


Trabalho Remota.

/domain: <domain> Especifica o domínio a ser consultado para servidores de terminal. Você não
precisará especificar um domínio, se estiver consultando o domínio no qual
está trabalhando no momento.

/address Exibe os endereços de rede e nó de cada servidor.

/continue Impede a pausa depois que cada tela de informações é exibida.

/? Exibe a ajuda no prompt de comando.


Exemplos
Para exibir as informações sobre todos os servidores Host da Sessão da Área de
Trabalho Remota na rede, digite:

query termserver

Para exibir as informações sobre o servidor Host da Sessão da Área de Trabalho Remota
chamado Server3, digite:

query termserver Server3

Para exibir as informações sobre todos os servidores Host da Sessão da Área de


Trabalho Remota no domínio CONTOSO, digite:

query termserver /domain:CONTOSO

Para exibir a rede e o endereço do nó do servidor Host da Sessão da Área de Trabalho


Remota chamado Server3, digite:

query termserver Server3 /address

Links relacionados
Chave da sintaxe de linha de comando

comando query

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
query user
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe informações sobre as sessões do usuário em um servidor Host da Sessão da Área


de Trabalho Remota. Você pode usar esse comando para descobrir se um usuário
específico está conectado a um servidor Host da Sessão da Área de Trabalho Remota
específico. Esse comando retorna as informações a seguir:

Nome do usuário

Nome da sessão no servidor Host da Sessão da Área de Trabalho Remota

ID da sessão

Estado da sessão (ativo ou desconectado)

Tempo ocioso (o número de minutos desde a última tecla pressionada ou o


movimento do mouse na sessão)

Data e hora em que o usuário fez logon

7 Observação

Para descobrir as novidades da última versão, confira Novidades nos Serviços de


Área de Trabalho Remota do Windows Server.

Sintaxe

query user [<username> | <sessionname> | <sessionID>] [/server:<servername>]

Parâmetros

Parâmetro Descrição

<username> Especifica o nome de logon do usuário que você deseja consultar.


Parâmetro Descrição

<sessionname> Especifica o nome da sessão que você deseja consultar.

<sessionID> Especifica a ID da sessão que você deseja consultar.

/server: <servername> Especifica o servidor Host da Sessão da Área de Trabalho Remota que
você deseja consultar. Caso contrário, o servidor Host da Sessão da Área
de Trabalho Remota atual será usado. Esse parâmetro só será necessário
se você estiver usando esse comando a partir de um servidor remoto.

/? Exibe a ajuda no prompt de comando.

Comentários
Para usar esse comando, você deve ter permissão de Controle Total ou permissão
de acesso especial.

Se você não especificar um usuário usando os parâmetros <username>,


<sessionname> ou sessionID, uma lista de todos os usuários conectados ao
servidor será retornada. Como alternativa, você também pode usar o comando
query session para exibir uma lista de todas as sessões em um servidor.

Quando query user retorna informações, um símbolo maior que (>) é exibido
antes da sessão atual.

Exemplos
Para exibir informações sobre todos os usuários conectados ao sistema, digite:

query user

Para exibir informações sobre o usuário USER1 no servidor Server1, digite:

query user USER1 /server:Server1

Links relacionados
Chave da sintaxe de linha de comando
comando query

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
quser
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe informações sobre as sessões do usuário em um servidor Host da Sessão da Área


de Trabalho Remota. Você pode usar esse comando para descobrir se um usuário
específico está conectado a um servidor Host da Sessão da Área de Trabalho Remota
específico. Esse comando retorna as informações a seguir:

Nome do usuário

Nome da sessão no servidor Host da Sessão da Área de Trabalho Remota

ID da sessão

Estado da sessão (ativo ou desconectado)

Tempo ocioso (o número de minutos desde a última tecla pressionada ou o


movimento do mouse na sessão)

Data e hora em que o usuário fez logon

7 Observação

Esse comando é igual ao comando query user. Para descobrir as novidades da


última versão, veja Novidades nos Serviços de Área de Trabalho Remota do
Windows Server.

Sintaxe

quser [<username> | <sessionname> | <sessionID>] [/server:<servername>]

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

<username> Especifica o nome de logon do usuário que você deseja consultar.

<sessionname> Especifica o nome da sessão que você deseja consultar.

<sessionID> Especifica a ID da sessão que você deseja consultar.

/server: <servername> Especifica o servidor Host da Sessão da Área de Trabalho Remota que
você deseja consultar. Caso contrário, o servidor Host da Sessão da Área
de Trabalho Remota atual será usado. Esse parâmetro só será necessário
se você estiver usando esse comando a partir de um servidor remoto.

/? Exibe a ajuda no prompt de comando.

Comentários

Para usar esse comando, você deve ter permissão de Controle Total ou permissão
de acesso especial.

Se você não especificar um usuário usando os parâmetros <username>,


<sessionname> ou sessionID, uma lista de todos os usuários conectados ao
servidor será retornada. Como alternativa, você também pode usar o comando
query session para exibir uma lista de todas as sessões em um servidor.

Quando quser retorna informações, um símbolo maior que (>) é exibido antes da
sessão atual.

Exemplos
Para exibir informações sobre todos os usuários conectados ao sistema, digite:

quser

Para exibir informações sobre o usuário USER1 no servidor Server1, digite:

quser USER1 /server:Server1

Links relacionados
Chave da sintaxe de linha de comando

comando query user

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
qwinsta
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe informações sobre as sessões em um servidor Host da Sessão da Área de Trabalho


Remota. A lista inclui as informações não só sobre as sessões ativas, mas também sobre
outras sessões que o servidor executa.

7 Observação

Esse comando é igual a comando query session. Para descobrir as novidades da


última versão, confira Novidades nos Serviços de Área de Trabalho Remota do
Windows Server.

Sintaxe

qwinsta [<sessionname> | <username> | <sessionID>] [/server:<servername>]


[/mode] [/flow] [/connect] [/counter]

Parâmetros

Parâmetro Descrição

<sessionname> Especifica o nome da sessão que você deseja consultar.

<username> Especifica o nome do usuário cujas sessões você deseja consultar.

<sessionID> Especifica a ID da sessão que você deseja consultar.

/server: <servername> Identifica o servidor Host da Sessão da Área de Trabalho Remota a ser
consultado. O padrão é o servidor atual.

/mode Exibe as configurações de linha atuais.

/flow Exibe as configurações atuais do controle de fluxo.

/connect Exibe as configurações de conexão atuais.


Parâmetro Descrição

/counter Exibe as informações de contadores atuais, incluindo o número total de


sessões criadas, desconectadas e reconectadas.

/? Exibe a ajuda no prompt de comando.

Comentários
Um usuário sempre pode consultar a sessão na qual o usuário está conectado no
momento. Para consultar outras sessões, o usuário deve ter permissão de acesso
especial.

Se você não especificar uma sessão usando os parâmetros <username>,


<sessionname> ou sessionID, essa consulta exibirá as informações sobre todas as
sessões ativas no sistema.

Quando qwinsta retorna informações, um símbolo maior que (>) é exibido antes
da sessão atual. Por exemplo:

C:\>qwinsta
SESSIONNAME USERNAME ID STATE TYPE DEVICE
console Administrator1 0 active wdcon
>rdp-tcp#1 User1 1 active wdtshare
rdp-tcp 2 listen wdtshare
4 idle
5 idle

Em que:
SESSIONNAME especifica o nome atribuído à sessão.
USERNAME indica o nome de usuário conectado à sessão.
STATE fornece as informações sobre o estado atual da sessão.
TYPE indica o tipo de sessão.
DEVICE, que não está presente nas sessões do console ou conectadas à rede, é
o nome do dispositivo atribuído à sessão.
As sessões nas quais o estado inicial está configurado como DESABILITADO não
aparecerão na lista do qwinsta até que estejam habilitadas.

Exemplos
Para exibir as informações sobre todas as sessões ativas no servidor Server2, digite:
qwinsta /server:Server2

Para exibir as informações sobre o modeM02 da sessão ativa, digite:

qwinsta modeM02

Links relacionados
Chave da sintaxe de linha de comando

Comando query session

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
rd
Artigo • 17/04/2023

Exclui um diretório.

O comando rd também pode ser executado no Console de Recuperação do Windows,


usando parâmetros diferentes. Para obter mais informações, consulte WinRE (Ambiente
de Recuperação do Windows).

7 Observação

Esse comando é igual ao comando rmdir.

Sintaxe

rd [<drive>:]<path> [/s [/q]]

Parâmetros

Parâmetro Descrição

[<drive>:] Especifica o local e o nome do diretório que você deseja excluir. Um caminho é
<path> requerido. Se você incluir uma barra invertida () no início do caminho especificado,
o caminho começará no diretório-raiz (independentemente do diretório atual).

/s Exclui uma árvore de diretório (o diretório especificado e todos os subdiretórios,


incluindo todos os arquivos).

/q Especifica o modo silencioso. Não solicita confirmação ao excluir uma árvore de


diretório. O parâmetro /q só funcionará se /s também for especificado.

CUIDADO: quando você executa no modo silencioso, toda a árvore de diretório é


excluída sem confirmação. Verifique se os arquivos importantes foram movidos ou
submetidos a backup antes de usar a opção da linha de comando /q.

/? Exibe a ajuda no prompt de comando.

Comentários
Não é possível excluir um diretório que contenha arquivos, incluindo arquivos
ocultos ou do sistema. Se você tentar fazer isso, a seguinte mensagem será
exibida:

The directory is not empty

Use o comando dir /a para listar todos os arquivos (incluindo arquivos ocultos e
do sistema). Em seguida, use o comando attrib com -h para remover os atributos
de arquivo ocultos, -s para remover os atributos de arquivo do sistema ou -h -s
para remover os atributos de arquivo ocultos e do sistema. Depois que os
atributos ocultos e de arquivo forem removidos, você poderá excluir os arquivos.

Não é possível usar o comando rd para excluir o diretório atual. Se tentar excluir o
diretório atual, a seguinte mensagem de erro será exibida:

The process can't access the file because it is being used by another
process.

Se você vir essa mensagem de erro, deverá mudar para um diretório diferente (não
um subdiretório do diretório atual) e tentar novamente.

Exemplos
Para mudar para o diretório-pai para que você possa remover com segurança o
diretório desejado, digite:

cd ..

Para remover um diretório chamado test (e todos os seus subdiretórios e arquivos) do


diretório atual, digite:

rd /s test

Para executar o exemplo anterior no modo silencioso, digite:

rd /s /q test
Links relacionados
Chave da sintaxe de linha de comando
rdpsign
Artigo • 29/09/2022

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Permite que você assine digitalmente um arquivo protocolo RDP (. RDP).

7 Observação

para descobrir as novidades da versão mais recente, consulte novidades do


Serviços de Área de Trabalho Remota no Windows Server.

Sintaxe

rdpsign /sha1 <hash> [/q | /v |] [/l] <file_name.rdp>

Parâmetros

Parâmetro Descrição

/sha1 <hash> Especifica a impressão digital, que é o hash Secure Hash Algorithm 1 (SHA1)
do certificado de autenticação que está incluído no repositório de certificados.
usado no Windows Server 2012 R2 e mais antigo.

/sha256 <hash> Especifica a impressão digital, que é o hash do algoritmo de hash seguro 256
(SHA256) do certificado de autenticação que está incluído no repositório de
certificados. substitui/sha1 em Windows Server 2016 e mais recente.

/q Modo silencioso. Nenhuma saída quando o comando for bem sucedido e a


saída mínima se o comando falhar.

/v modo detalhado. Exibe todos os avisos, mensagens e status.

/l Testa os resultados de assinatura e saída sem realmente substituir nenhum dos


arquivos de entrada.

<file_name.rdp> O nome do arquivo. rdp. Você deve especificar o (ou arquivos) arquivo. rdp
para assinar usando o nome completo do arquivo. Caracteres curinga não são
aceitos.
Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Comentários
A impressão digital do certificado SHA1 ou SHA256 deve representar um
Publicador de arquivo. rdp confiável. Para obter a impressão digital do certificado,
abra o snap-in certificados , clique duas vezes no certificado que você deseja usar
(no repositório de certificados do computador local ou em seu armazenamento de
certificados pessoais), clique na guia detalhes e, na lista campo , clique em
impressão digital.

7 Observação

Ao copiar a impressão digital para uso com a ferramenta de rdpsign.exe, você


deve remover os espaços.

Os arquivos de saída assinados substituem os arquivos de entrada.

Se vários arquivos forem especificados, e se qualquer um dos arquivos. rdp não


puder ser lido ou gravado, a ferramenta continuará no próximo arquivo.

Exemplos
Para assinar um arquivo. rdp chamado arquivo1. rdp, navegue até a pasta em que você
salvou o arquivo. RDP e digite:

rdpsign /sha1 hash file1.rdp

7 Observação

O valor de hash representa a impressão digital do certificado SHA1, sem espaços.

Para testar se a assinatura digital terá sucesso para um arquivo. rdp sem realmente
assinar o arquivo, digite:
rdpsign /sha1 hash /l file1.rdp

Para assinar vários arquivos. rdp nomeados, arquivo1. rdp, file2. rdpe arquivo3. rdp,
digite (incluindo os espaços entre os nomes de arquivo):

rdpsign /sha1 hash file1.rdp file2.rdp file3.rdp

Consulte Também
Chave da sintaxe de linha de comando

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
recover
Artigo • 12/04/2023

Recupera as informações legíveis de um disco inválido ou defeituoso. Esse comando lê


um arquivo setor por setor e recupera os dados dos setores válidos. Os dados dos
setores inválidos são perdidos. Como todos os dados dos setores inválidos são perdidos
quando você recupera um arquivo, você deve recuperar apenas um arquivo por vez.

Os setores inválidos relatados pelo comando chkdsk foram marcados como inválidos
quando o disco foi preparado para operação. Eles não representam perigo e o recover
não os afeta.

Sintaxe

recover [<drive>:][<path>]<filename>

Parâmetros

Parâmetro Descrição

[<drive>:] Especifica o nome do arquivo (e o local do arquivo, se ele não estiver no diretório
[<path>] atual) que você deseja recuperar. O nome do arquivo é necessário e não há
<filename> suporte para curingas.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para recuperar o arquivo story.txt no diretório \fiction na unidade D, digite:

recover d:\fiction\story.txt

Links relacionados
Chave da sintaxe de linha de comando
recover (DiskPart)
Artigo • 17/04/2023

Atualiza o estado de todos os discos em um grupo de discos, tenta recuperar discos em


um grupo de disco inválido e ressincroniza volumes espelhados e volumes RAID-5 com
dados obsoletos. Esse comando opera em discos com falha ou prestes a falhar. Ele
também opera em volumes com falha, prestes a falhar ou em estado de redundância
com falha.

Esse comando opera em grupos de discos dinâmicos. Se esse comando for usado em
um grupo com um disco básico, ele não retornará um erro, mas nenhuma ação será
tomada.

7 Observação

Um disco que faz parte de um grupo de discos precisa ser selecionado para que
essa operação seja bem-sucedida. Use o comando select disk para selecionar um
disco e mudar o foco para ele.

Sintaxe

recover [noerr]

Parâmetros

Parâmetro Descrição

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Exemplos
Para recuperar o grupo de discos que contém o disco com foco, digite:
recover

Links relacionados
Chave da sintaxe de linha de comando
ReFSUtil
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019 e Windows 10

ReFSUtil é uma ferramenta incluída no Windows e no Windows Server que tenta


diagnosticar volumes do ReFS muito danificados, identificar arquivos restantes e copiar
esses arquivos para outro volume. Essa ferramenta vem na pasta
%SystemRoot%\Windows\System32 .

O ReFS Salvage é a função primária do ReFSUtil, útil para recuperar dados de volumes
que são mostrados como RAW no Gerenciamento de Disco. O ReFS Salvage tem duas
fases: uma Fase de Varredura e uma Fase de Cópia. No modo automático, a Fase de
Varredura e a Fase de Cópia serão executadas sequencialmente. No modo manual, cada
fase pode ser executada separadamente. O progresso e os logs são salvos em um
diretório de trabalho para permitir que as fases sejam executadas separadamente, bem
como a Fase de Varredura seja pausada e retomada. Você não deve precisar usar a
ferramenta ReFSutil, a menos que o volume seja RAW. Se somente leitura, os dados
ainda estarão acessíveis.

Parâmetros
Parâmetro Descrição

<source Especifica o volume ReFS a ser processado. A letra da unidade deve ser formatada
volume> como "L:", ou você deve fornecer um caminho para o ponto de montagem do
volume.

<working Especifica o local para armazenar informações e logs temporários. Ele não deve
directory> estar localizado no <source volume> .

<target Especifica o local para o qual os arquivos identificados são copiados. Ele não deve
directory> estar localizado no <source volume> .

-M Recupera todos os arquivos possíveis, incluindo os excluídos.


AVISO: Esse parâmetro não só faz com que o processo demore mais para ser
executado, como também pode levar a resultados inesperados.

-v Especifica o uso do modo detalhado.

-X Força o volume a desmontar primeiro, se necessário. Todos os identificadores


abertos para o volume são inválidos. Por exemplo, refsutil salvage -QA R:
N:\WORKING N:\DATA -x .
Uso e opções disponíveis

Modo automático rápido


Executa uma Fase de Varredura Rápida seguida por uma Fase de Cópia. Esse modo é
executado mais rapidamente, pois pressupõe que algumas estruturas críticas do volume
não estão corrompidas e, portanto, não há necessidade de examinar todo o volume
para localizá-las. Isso também reduz a recuperação de arquivos/diretórios/volumes
obsoletos.

refsutil salvage -QA <source volume> <working directory> <target directory>


<options>

Modo automático completo


Executa uma Fase de Varredura Completa seguida por uma Fase de Cópia. Esse modo
pode levar muito tempo, pois ele examinará todo o volume em busca de
arquivos/diretórios/volumes recuperáveis.

refsutil salvage -FA <source volume> <working directory> <target directory>


<options>

Fase de diagnóstico (modo manual)


Primeiro, tente determinar se o <source volume> é um volume ReFS e determine se o
volume é montável. Se um volume não for montável, os motivos serão fornecidos. Esta é
uma fase autônoma.

refsutil salvage -D <source volume> <working directory> <options>

Fase de Varredura Rápida


Executa uma Varredura Rápida do <source volume> para qualquer arquivo recuperável.
Esse modo é executado mais rapidamente, pois pressupõe que algumas estruturas
críticas do volume não estão corrompidas e, portanto, não há necessidade de examinar
todo o volume para localizá-las. Isso também reduz a recuperação de
arquivos/diretórios/volumes obsoletos. Os arquivos descobertos são registrados no
arquivo foundfiles.<volume signature>.txt , localizado em seu <working directory> . Se
a Fase de Varredura tiver sido interrompida anteriormente, a execução com o sinalizador
-QS retomará novamente a varredura de onde parou.

refsutil salvage -QS <source volume> <working directory> <options>

Fase de Varredura Completa


Examina a existência de arquivos recuperáveis em todo o <source volume> . Esse modo
pode levar muito tempo, pois ele examinará todo o volume em busca de arquivos
recuperáveis. Os arquivos descobertos serão registrados no arquivo foundfiles.<volume
signature>.txt , localizado em seu <working directory> . Se a Fase de Varredura tiver

sido interrompida anteriormente, a execução com o sinalizador -FS retomará


novamente a varredura de onde parou.

refsutil salvage -FS <source volume> <working directory> <options>

Fase de cópia
Copia todos os arquivos descritos no arquivo foundfiles.<volume signature>.txt para o
seu <target directory> . Se você parar a Fase de Varredura muito cedo, é possível que o
arquivo foundfiles.<volume signature>.txt ainda não exista, portanto, nenhum arquivo
é copiado para o <target directory> .

refsutil salvage -C <source volume> <working directory> <target directory>


<options>

Fase de cópia com lista


Copia todos os arquivos no <file list> do <source volume> para o seu <target
directory> . Os arquivos no <file list> devem ter sido identificados pela Fase de
Varredura, embora a verificação não precise ter sido executada até a conclusão. O <file
list> pode ser gerado copiando foundfiles.<volume signature>.txt para um novo
arquivo, removendo linhas referenciando arquivos que não devem ser restaurados e
preservando arquivos que devem ser restaurados. O cmdlet do PowerShell Select-String
pode ser útil na filtragem de foundfiles.<volume signature>.txt para incluir apenas
caminhos, extensões ou nomes de arquivo desejados.

refsutil salvage -SL <source volume> <working directory> <target directory>


<file list> <options>

Fase de cópia com o console interativo


Os usuários avançados podem salvar arquivos usando um console interativo. Esse modo
também requer arquivos gerados de qualquer uma das Fases de Varredura.

refsutil salvage -IC <source volume> <working directory> <options>

Links relacionados
Chave da sintaxe de linha de comando
comandos reg
Artigo • 12/04/2023

Executam operações nas informações e valores de subchave do registro nas entradas do


registro.

Algumas operações permitem exibir ou configurar as entradas do registro em


computadores locais ou remotos, enquanto outras permitem que você configure apenas
os computadores locais. Usar o reg para configurar o registro de computadores
remotos limita os parâmetros que você pode usar em algumas operações. Verifique a
sintaxe e os parâmetros de cada operação para ver se podem ser usados em
computadores remotos.

U Cuidado

Não edite o registro diretamente, a menos que você não tenha outra alternativa. O
Editor do registro ignora as proteções padrão, permitindo configurações que
podem prejudicar o desempenho, danificar o sistema ou até mesmo exigir que
você reinstale o Windows. É possível alterar com segurança a maioria das
configurações do Registro usando os programas no Painel de Controle ou no MMC
(Console de Gerenciamento Microsoft). Se você precisar editar o registro
diretamente, primeiro faça backup dele.

Sintaxe

reg add
reg compare
reg copy
reg delete
reg export
reg import
reg load
reg query
reg restore
reg save
reg unload

Parâmetros
Parâmetro Descrição

reg add Adiciona uma nova subchave ou entrada ao registro.

reg Compara as subchaves ou entradas do registro especificadas.


compare

reg copy Copia uma entrada do registro para um local especificado no computador local ou
remoto.

reg delete Exclui uma subchave ou as entradas do registro.

reg export Copia as subchaves, as entradas e os valores especificados do computador local em


um arquivo de transferência para outros servidores.

reg import Copia o conteúdo de um arquivo que contém subchaves, entradas e valores do
registro exportados para o registro do computador local.

reg load Grava as subchaves e entradas salvas em uma subchave diferente no registro.

reg query Retorna uma lista da próxima camada de subchaves e entradas localizadas em uma
subchave especificada no registro.

reg restore Grava as subchaves salvas e as entradas de volta no registro.

reg save Salva uma cópia de subchaves, entradas e valores especificados do registro em um
arquivo especificado.

reg unload Remove uma seção do registro que foi carregada usando a operação reg load.

Links relacionados
Chave da sintaxe de linha de comando
reg add
Artigo • 12/04/2023

Adiciona uma nova subchave ou entrada ao registro.

Sintaxe

reg add <keyname> [{/v valuename | /ve}] [/t datatype] [/s separator] [/d
data] [/f]

Parâmetros

Parâmetro Descrição

<keyname> Especifica o caminho completo da subchave ou entrada a ser adicionada. Para


especificar um computador remoto, inclua o nome do computador (no formato \\
<computername>\ ) como parte do nome da chave. Omitir \\<computername>\ faz
com que o padrão da operação seja o computador local. O nome da chave deve
incluir uma chave-raiz válida. As chaves-raiz válidas para o computador local são:
HKLM, HKCU, HKCR, HKU e HKCC. Se um computador remoto for especificado, as
chaves-raiz válidas serão: HKLM e HKU. Se o nome da chave do registro contiver
um espaço, coloque o nome entre aspas.

/v Especifica o nome da entrada para adicionar registro.


<Valuename>

/ve Especifica que a entrada de registro adicionada tem um valor nulo.

/t <Type> Especifica o tipo da entrada de registro. O tipo deve ser uma das seguintes opções:

REG_SZ
REG_MULTI_SZ
REG_DWORD_BIG_ENDIAN
REG_DWORD
REG_BINARY
REG_DWORD_LITTLE_ENDIAN
REG_LINK
REG_FULL_RESOURCE_DESCRIPTOR
REG_EXPAND_SZ
Parâmetro Descrição

/s Especifica o caractere a ser usado para separar várias instâncias de dados, quando
<Separator> o tipo de dados REG_MULTI_SZ é especificado e mais de uma entrada é listada. Se
não for especificado, o separador padrão será \0.

/d <Data> Especifica os dados para a nova entrada de registro.

/f Adiciona a entrada de registro sem solicitar confirmação.

/? Exibe a ajuda no prompt de comando.

Comentários
Não é possível adicionar subárvores com essa operação. Esta versão do reg não
solicita confirmação ao adicionar uma subchave.

Os valores retornados para a operação reg add são:

Valor Descrição

0 Êxito

1 Falha

Para o tipo de chave REG_EXPAND_SZ, use o símbolo de cursor (^) com % dentro
do parâmetro /d.

Exemplos
Para adicionar a chave HKLM\Software\MyCo no computador remoto ABC, digite:

reg add \\ABC\HKLM\Software\MyCo

Para adicionar uma entrada de registro a HKLM\Software\MyCo com um valor chamado


Data, o tipo REG_BINARY e os dados de fe340ead, digite:

reg add HKLM\Software\MyCo /v Data /t REG_BINARY /d fe340ead

Para adicionar uma entrada de registro de vários valores a HKLM\Software\MyCo com


um valor chamado MRU, o tipo REG_MULTI_SZ e os dados de fax\0mail\0, digite:
reg add HKLM\Software\MyCo /v MRU /t REG_MULTI_SZ /d fax\0mail\0

Para adicionar uma entrada de registro expandida a HKLM\Software\MyCo com um valor


chamado Path, o tipo REG_EXPAND_SZ e os dados de %systemroot%, digite:

reg add HKLM\Software\MyCo /v Path /t REG_EXPAND_SZ /d ^%systemroot^%

Links relacionados
Chave da sintaxe de linha de comando
reg compare
Artigo • 12/04/2023

Compara as subchaves ou entradas do registro especificadas.

Sintaxe

reg compare <keyname1> <keyname2> [{/v Valuename | /ve}] [{/oa | /od | /os |
on}] [/s]

Parâmetros

Parâmetro Descrição

<keyname1> Especifica o caminho completo da subchave ou entrada a ser adicionada. Para


especificar um computador remoto, inclua o nome do computador (no formato \\
<computername>\ ) como parte do nome da chave. Omitir \\<computername>\ faz
com que o padrão da operação seja o computador local. O nome da chave deve
incluir uma chave-raiz válida. As chaves-raiz válidas para o computador local são:
HKLM, HKCU, HKCR, HKU e HKCC. Se um computador remoto for especificado, as
chaves-raiz válidas serão: HKLM e HKU. Se o nome da chave do registro contiver
um espaço, coloque o nome entre aspas.

<keyname2> Especifica o caminho completo da segunda subchave a ser comparada. Para


especificar um computador remoto, inclua o nome do computador (no formato \\
<computername>\ ) como parte do nome da chave. Omitir \\<computername>\ faz
com que o padrão da operação seja o computador local. Especificar apenas o
nome do computador em keyname2 faz com que a operação use o caminho para a
subchave especificada em keyname1. O nome da chave deve incluir uma chave-raiz
válida. As chaves-raiz válidas para o computador local são: HKLM, HKCU, HKCR,
HKU e HKCC. Se um computador remoto for especificado, as chaves-raiz válidas
serão: HKLM e HKU. Se o nome da chave do registro contiver um espaço, coloque
o nome entre aspas.

/v Especifica o nome do valor a ser comparado na subchave.


<Valuename>

/ve Especifica que somente as entradas que têm um nome de valor nulo devem ser
comparadas.

/oa Especifica que todas as diferenças e correspondências sejam exibidas. Por padrão,
apenas as diferenças são listadas.
Parâmetro Descrição

/od Especifica que apenas as diferenças sejam exibidas. Esse é o comportamento


padrão.

/os Especifica que apenas correspondências sejam exibidas. Por padrão, apenas as
diferenças são listadas.

/on Especifica que nada seja exibido. Por padrão, apenas as diferenças são listadas.

/s Compara todas as subchaves e entradas recursivamente.

/? Exibe a ajuda no prompt de comando.

Comentários
Os valores retornados para a operação reg compare são:

Valor Descrição

0 A comparação é bem-sucedida e o resultado é idêntico.

1 A comparação falhou.

2 A comparação foi bem-sucedida e as diferenças foram encontradas.

Os símbolos exibidos nos resultados incluem:

Símbolo Descrição

= Os dados de KeyName1 são iguais aos dados de KeyName2.

< Os dados de KeyName1 são menores que os dados de KeyName2.

> Os dados de KeyName1 são maiores que os dados de KeyName2.

Exemplos
Para comparar todos os valores na chave MyApp com todos os valores na chave
SaveMyApp, digite:

reg compare HKLM\Software\MyCo\MyApp HKLM\Software\MyCo\SaveMyApp


Para comparar o valor da Versão na chave MyCo e o valor da Versão na chave MyCo1,
digite:

reg compare HKLM\Software\MyCo HKLM\Software\MyCo1 /v Version

Para comparar todas as subchaves e valores em HKLM\Software\MyCo no computador


chamado ZODIAC, com todas as subchaves e valores em HKLM\Software\MyCo no
computador local, digite:

reg compare \\ZODIAC\HKLM\Software\MyCo \\. /s

Links relacionados
Chave da sintaxe de linha de comando
reg copy
Artigo • 12/04/2023

Copia uma entrada do registro para um local especificado no computador local ou


remoto.

Sintaxe

reg copy <keyname1> <keyname2> [/s] [/f]

Parâmetros

Parâmetro Descrição

<keyname1> Especifica o caminho completo da subchave ou entrada a ser adicionada. Para


especificar um computador remoto, inclua o nome do computador (no formato \\
<computername>\ ) como parte do nome da chave. Omitir \\<computername>\ faz com
que o padrão da operação seja o computador local. O nome da chave deve incluir
uma chave-raiz válida. As chaves-raiz válidas para o computador local são: HKLM,
HKCU, HKCR, HKU e HKCC. Se um computador remoto for especificado, as chaves-
raiz válidas serão: HKLM e HKU. Se o nome da chave do registro contiver um
espaço, coloque o nome entre aspas.

<keyname2> Especifica o caminho completo da segunda subchave a ser comparada. Para


especificar um computador remoto, inclua o nome do computador (no formato \\
<computername>\ ) como parte do nome da chave. Omitir \\<computername>\ faz com
que o padrão da operação seja o computador local. O nome da chave deve incluir
uma chave-raiz válida. As chaves-raiz válidas para o computador local são: HKLM,
HKCU, HKCR, HKU e HKCC. Se um computador remoto for especificado, as chaves-
raiz válidas serão: HKLM e HKU. Se o nome da chave do registro contiver um
espaço, coloque o nome entre aspas.

/s Copia todas as subchaves e entradas na subchave especificada.

/f Copia a subchave sem solicitar confirmação.

/? Exibe a ajuda no prompt de comando.

Comentários

Esse comando não solicita confirmação ao copiar uma subchave.


Os valores retornados para a operação reg compare são:

Valor Descrição

0 Êxito

1 Falha

Exemplos
Para copiar todas as subchaves e valores na chave MyApp para a chave SaveMyApp,
digite:

reg copy HKLM\Software\MyCo\MyApp HKLM\Software\MyCo\SaveMyApp /s

Para copiar todos os valores na chave MyCo no computador chamado ZODIAC para a
chave MyCo1 no computador atual, digite:

reg copy \\ZODIAC\HKLM\Software\MyCo HKLM\Software\MyCo1

Links relacionados
Chave da sintaxe de linha de comando
reg delete
Artigo • 12/04/2023

Exclui uma subchave ou as entradas do registro.

Sintaxe

reg delete <keyname> [{/v valuename | /ve | /va}] [/f]

Parâmetros

Parâmetro Descrição

<keyname1> Especifica o caminho completo da subchave ou entrada a ser excluída. Para


especificar um computador remoto, inclua o nome do computador (no formato \\
<computername>\ ) como parte do nome da chave. Omitir \\<computername>\ faz
com que o padrão da operação seja o computador local. O nome da chave deve
incluir uma chave-raiz válida. As chaves-raiz válidas para o computador local são:
HKLM, HKCU, HKCR, HKU e HKCC. Se um computador remoto for especificado, as
chaves-raiz válidas serão: HKLM e HKU. Se o nome da chave do registro contiver
um espaço, coloque o nome entre aspas.

/v Exclui uma entrada específica na subchave. Se nenhuma entrada for especificada,


<valuename> todas as entradas e subchaves na subchave serão excluídas.

/ve Especifica que somente as entradas sem valor serão excluídas.

/va Exclui todas as entradas dentro da chave especificada. As entradas de subchave


que residem dentro da chave especificada não serão excluídas.

/f Exclui a subchave ou a entrada do registro existente, sem solicitar confirmação.

/? Exibe a ajuda no prompt de comando.

Comentários
Os valores retornados para a operação reg delete são:

Valor Descrição

0 Êxito
Valor Descrição

1 Falha

Exemplos
Para excluir a chave do registro Timeout e todas as subchaves e valores, digite:

reg delete HKLM\Software\MyCo\MyApp\Timeout

Para excluir o valor do registro MTU em HKLM\Software\MyCo no computador


chamado ZODIAC, digite:

reg delete \\ZODIAC\HKLM\Software\MyCo /v MTU

Links relacionados
Chave da sintaxe de linha de comando
reg export
Artigo • 12/04/2023

Copia as subchaves, as entradas e os valores especificados do computador local em um


arquivo de transferência para outros servidores.

Sintaxe

reg export <keyname> <filename> [/y]

Parâmetros

Parâmetro Descrição

<keyname> Especifica o caminho completo da subchave. A operação de exportação só funciona


no computador local. O nome da chave deve incluir uma chave-raiz válida. As
chaves-raiz válidas para o computador local são: HKLM, HKCU, HKCR, HKU e HKCC.
Se o nome da chave do registro contiver um espaço, coloque o nome entre aspas.

<filename> Especifica o nome e o caminho do arquivo a ser criado durante a operação. O


arquivo deve ter uma extensão .reg.

/y Substitui os arquivos existentes com o nome do arquivo, sem solicitar confirmação.

/? Exibe a ajuda no prompt de comando.

Comentários

Os valores retornados para a operação reg export são:

Valor Descrição

0 Êxito

1 Falha

Exemplos
Para exportar o conteúdo de todas as subchaves e os valores da chave do MyApp para
o arquivo AppBkUp.reg, digite:
reg export HKLM\Software\MyCo\MyApp AppBkUp.reg

Links relacionados
Chave da sintaxe de linha de comando
reg import
Artigo • 12/04/2023

Copia o conteúdo de um arquivo que contém subchaves, entradas e valores do registro


exportados para o registro do computador local.

Sintaxe

reg import <filename>

Parâmetros

Parâmetro Descrição

<filename> Especifica o nome e o caminho do arquivo que tem conteúdo a ser copiado para o
registro do computador local. Esse arquivo precisa ser criado com antecedência
usando reg export.

/reg:32 Especifica que a chave deve ser acessada usando a exibição do registro de 32 bits.

/reg:64 Especifica que a chave deve ser acessada usando a exibição do registro de 64 bits.

/? Exibe a ajuda no prompt de comando.

Comentários

Os valores retornados para a operação reg import são:

Valor Descrição

0 Êxito

1 Falha

Exemplos
Para importar entradas do registro do arquivo chamado AppBkUp.reg, digite:
reg import AppBkUp.reg

Links relacionados
Chave da sintaxe de linha de comando

Comando reg export


reg load
Artigo • 12/04/2023

Grava as subchaves e entradas salvas em uma subchave diferente no registro. Esse


comando destina-se ao uso com arquivos temporários usados para solução de
problemas ou edição de entradas do registro.

Sintaxe

reg load <keyname> <filename>

Parâmetros

Parâmetro Descrição

<keyname> Especifica o caminho completo da subchave a ser carregada. Para especificar um


computador remoto, inclua o nome do computador (no formato \\
<computername>\ ) como parte do nome da chave. Omitir \\<computername>\ faz com
que o padrão da operação seja o computador local. O nome da chave deve incluir
uma chave-raiz válida. As chaves-raiz válidas para o computador local são: HKLM,
HKCU, HKCR, HKU e HKCC. Se um computador remoto for especificado, as chaves-
raiz válidas serão: HKLM e HKU. Se o nome da chave do registro contiver um
espaço, coloque o nome entre aspas.

<filename> Especifica o nome e o caminho do arquivo a ser carregado. Esse arquivo deve ser
criado com antecedência usando o comando reg save e deve ter uma extensão .hiv.

/? Exibe a ajuda no prompt de comando.

Comentários
Os valores retornados para a operação reg load são:

Valor Descrição

0 Êxito

1 Falha

Exemplos
Para carregar o arquivo chamado TempHive.hiv para a chave HKLM\TempHive, digite:

reg load HKLM\TempHive TempHive.hiv

Links relacionados
Chave da sintaxe de linha de comando

comando reg save


reg query
Artigo • 10/04/2023

Retorna uma lista da próxima camada de subchaves e entradas localizadas em uma


subchave especificada no registro.

Sintaxe

reg query <keyname> [{/v <valuename> | /ve}] [/s] [/se <separator>] [/f
<data>] [{/k | /d}] [/c] [/e] [/t <Type>] [/z] [/reg:32] [/reg:64]

Parâmetros

Parâmetro Descrição

<keyname> Especifica o caminho completo da subchave. Para especificar um computador


remoto, inclua o nome do computador (no formato \\<computername>\ ) como
parte do nome da chave. Omitir \\<computername>\ faz com que o padrão da
operação seja no computador local. O nome da chave precisa incluir uma chave-
raiz válida. As chaves-raiz válidas para o computador local são: HKLM, HKCU,
HKCR, HKU e HKCC. Se um computador remoto for especificado, as chaves-raiz
válidas serão: HKLM e HKU. Se o nome da chave do registro contiver um espaço,
coloque o nome entre aspas.

/v Especifica o nome do valor do registro que deve ser consultado. Se omitido, todos
<valuename> os nomes de valor para keyname serão retornados. Valuename para esse
parâmetro será opcional se a opção /f também for usada.

/ve Executa uma consulta de nomes de valor que estão vazios.

/s Instrui a consultar todas as subchaves e nomes de valor recursivamente.

/se Especifica o separador de valor único a ser pesquisado no tipo de nome de valor
<separator> REG_MULTI_SZ. Se separator são for especificado, \0 será usado.

/f <data> Especifica os dados ou o padrão a serem pesquisados. Use aspas duplas se uma
cadeia de caracteres contiver espaços. Se não for especificado, um curinga (*) será
usado como o padrão de pesquisa.

/k Especifica a pesquisa somente em nomes de chave. Precisa ser usado com /f.

/d Especifica a pesquisa somente em dados.


Parâmetro Descrição

/c Especifica que a consulta diferencie maiúsculas de minúsculas. Por padrão, as


consultas não diferenciam maiúsculas de minúsculas.

/e Especifica que apenas correspondências exatas sejam retornadas. Por padrão,


todas as correspondências são retornadas.

/t <Type> Especifica os tipos de registro a serem pesquisados. Os tipos válidos são: REG_SZ,
REG_MULTI_SZ, REG_EXPAND_SZ, REG_DWORD, REG_BINARY, REG_NONE. Se não
for especificado, todos os tipos serão pesquisados.

/z Especifica a inclusão do equivalente numérico para o tipo de registro nos


resultados da pesquisa.

/reg:32 Especifica que a chave deve ser acessada usando a exibição do registro de 32 bits.

/reg:64 Especifica que a chave deve ser acessada usando a exibição do registro de 64 bits.

/? Exibe a ajuda no prompt de comando.

Comentários

Os valores retornados para a operação reg query são:

Valor Descrição

0 Êxito

1 Falha

Exemplos
Para exibir o valor da versão do valor de nome na chave
HKLM\Software\Microsoft\ResKit, digite:

reg query HKLM\Software\Microsoft\ResKit /v Version

Para exibir todas as subchaves e os valores na chave


HKLM\Software\Microsoft\ResKit\Nt\Setup em um computador remoto chamado ABC,
digite:
reg query \\ABC\HKLM\Software\Microsoft\ResKit\Nt\Setup /s

Para exibir todas as subchaves e os valores do tipo REG_MULTI_SZ usando # como


separador, digite:

reg query HKLM\Software\Microsoft\ResKit\Nt\Setup /se #

Para exibir a chave, o valor e os dados para correspondências exatas e que diferenciam
maiúsculas de minúsculas de SYSTEM na raiz HKLM do tipo de dados REG_SZ, digite:

reg query HKLM /f SYSTEM /t REG_SZ /c /e

Para exibir a chave, o valor e os dados que correspondem a 0F nos dados sob a chave
raiz HKCU do tipo de dados REG_BINARY, digite:

reg query HKCU /f 0F /d /t REG_BINARY

Para exibir as chaves, os valores e os dados que correspondem a asp.net na chave


HKLM\SOFTWARE\Microsoft e a todas as subchaves, digite:

reg query HKLM\SOFTWARE\Microsoft /s /f asp.net

Para exibir somente as chaves que correspondem a asp.net na chave


HKLM\SOFTWARE\Microsoft e a todas as subchaves, digite:

reg query HKLM\SOFTWARE\Microsoft /s /f asp.net /k

Para exibir o valor e os dados para nomes de valor nulos (padrão) em


HKLM\SOFTWARE, digite:
reg query HKLM\SOFTWARE /ve

Links relacionados
Chave da sintaxe de linha de comando
reg restore
Artigo • 11/04/2023

Grava as subchaves salvas e as entradas de volta no registro.

Sintaxe

reg restore <keyname> <filename>

Parâmetros

Parâmetro Descrição

<keyname> Especifica o caminho completo da subchave a ser restaurada. A operação de


restauração só funciona no computador local. O nome da chave deve incluir uma
chave-raiz válida. As chaves-raiz válidas para o computador local são: HKLM, HKCU,
HKCR, HKU e HKCC. Se o nome da chave do registro contiver um espaço, coloque o
nome entre aspas.

<filename> Especifica o nome e o caminho do arquivo com o conteúdo a ser gravado no


registro. Esse arquivo deve ser criado com antecedência usando o comando reg
save e deve ter uma extensão .hiv.

/? Exibe a ajuda no prompt de comando.

Comentários
Antes de editar as entradas do registro, você deve salvar a subchave-mãe usando
o comando reg save. Se a edição falhar, você poderá restaurar a subchave original
usando a operação reg restore.

Os valores retornados para a operação reg restore são:

Valor Descrição

0 Êxito

1 Falha

Exemplos
Para restaurar o arquivo chamado NTRKBkUp.hiv na chave
HKLM\Software\Microsoft\ResKit e substituir o conteúdo existente da chave, digite:

reg restore HKLM\Software\Microsoft\ResKit NTRKBkUp.hiv

Links relacionados
Chave da sintaxe de linha de comando

comando reg save


reg save
Artigo • 12/04/2023

Salva uma cópia de subchaves, entradas e valores especificados do registro em um


arquivo especificado.

Sintaxe

reg save <keyname> <filename> [/y]

Parâmetros

Parâmetro Descrição

<keyname> Especifica o caminho completo da subchave. Para especificar um computador


remoto, inclua o nome do computador (no formato \\<computername>\ ) como parte
do nome da chave. Omitir \\<computername>\ faz com que o padrão da operação
seja o computador local. O nome da chave deve incluir uma chave-raiz válida. As
chaves-raiz válidas para o computador local são: HKLM, HKCU, HKCR, HKU e HKCC.
Se um computador remoto for especificado, as chaves-raiz válidas serão: HKLM e
HKU. Se o nome da chave do registro contiver um espaço, coloque o nome entre
aspas.

<filename> Especifica o nome e o caminho do arquivo criado. Se nenhum caminho for


especificado, o caminho atual será usado.

/y Substitui um arquivo existente com o nome do arquivo, sem solicitar confirmação.

/? Exibe a ajuda no prompt de comando.

Comentários

Antes de editar as entradas do registro, você deve salvar a subchave-mãe usando


o comando reg save. Se a edição falhar, você poderá restaurar a subchave original
usando a operação reg restore.

Os valores retornados para a operação reg save são:

Valor Descrição
Valor Descrição

0 Êxito

1 Falha

Exemplos
Para salvar o Hive MyApp na pasta atual como um arquivo chamado AppBkUp.hiv,
digite:

reg save HKLM\Software\MyCo\MyApp AppBkUp.hiv

Links relacionados
Chave da sintaxe de linha de comando

comando reg restore


reg unload
Artigo • 12/04/2023

Remove uma seção do registro que foi carregada usando a operação reg load.

Sintaxe

reg unload <keyname>

Parâmetros

Parâmetro Descrição

<keyname> Especifica o caminho completo da subchave. Para especificar um computador


remoto, inclua o nome do computador (no formato \\<computername>\ ) como parte
do nome da chave. Omitir \\<computername>\ faz com que o padrão da operação
seja o computador local. O nome da chave deve incluir uma chave-raiz válida. As
chaves-raiz válidas para o computador local são: HKLM, HKCU, HKCR, HKU e HKCC.
Se um computador remoto for especificado, as chaves-raiz válidas serão: HKLM e
HKU. Se o nome da chave do registro contiver um espaço, coloque o nome entre
aspas.

/? Exibe a ajuda no prompt de comando.

Comentários
Os valores retornados para a operação reg unload são:

Valor Descrição

0 Êxito

1 Falha

Exemplos
Para descarregar o TempHive do hive no HKLM do arquivo, digite:
reg unload HKLM\TempHive

U Cuidado

Não edite o Registro diretamente, a menos que você não tenha outra alternativa. O
Editor do Registro ignora as proteções padrão, permitindo configurações que
podem prejudicar o desempenho, danificar o sistema ou até mesmo exigir que
você reinstale o Windows. É possível alterar com segurança a maioria das
configurações do Registro usando os programas no Painel de Controle ou no MMC
(Console de Gerenciamento Microsoft). Se você precisar editar o Registro
diretamente, primeiro faça backup dele.

Links relacionados
Chave da sintaxe de linha de comando

comando reg load


regini
Artigo • 12/04/2023

Modifica o registro da linha de comando ou de um script, e aplica as alterações


predefinidas em um ou mais arquivos de texto. Você pode criar, modificar ou excluir
chaves do registro, além de modificar as permissões nas chaves do registro.

Para obter detalhes sobre o formato e o conteúdo do arquivo de script de texto que o
regini.exe usa para fazer alterações no registro, confira Como alterar valores ou
permissões do registro de uma linha de comando ou um script .

Sintaxe

regini [-m \\machinename | -h hivefile hiveroot][-i n] [-o outputwidth][-b]


textfiles...

Parâmetros

Parâmetro Descrição

-m Especifica o nome do computador remoto com um registro que deve ser


<\\computername> modificado. Use o formato \ComputerName.

-h <hivefile Especifica o hive do registro local a ser modificado. Você deve especificar o
hiveroot> nome do arquivo hive e a raiz do hive no formato hivefile hiveroot.

-i <n> Especifica o nível de recuo a ser usado para indicar a estrutura de árvore das
chaves do registro na saída do comando. A ferramenta regdmp.exe (que
obtém as permissões atuais de uma chave do registro no formato binário)
usa o recuo em múltiplos de quatro, portanto, o valor padrão é 4.

-o <outputwidth> Especifica a largura da saída do comando, em caracteres. Se a saída aparecer


na janela de comando, o valor padrão será a largura da janela. Se a saída for
direcionada para um arquivo, o valor padrão será 240 caracteres.

-b Especifica que a saída do regini.exe é compatível com versões anteriores do


regini.exe.

textfiles Especifica o nome de um ou mais arquivos de texto que contêm dados do


registro. Qualquer número de arquivos de texto ANSI ou Unicode pode ser
listado.
Comentários
As diretrizes a seguir se aplicam principalmente ao conteúdo dos arquivos de texto que
contêm os dados do registro que você aplica usando o regini.exe.

Use o ponto e vírgula como caractere de comentário de fim de linha. Ele deve ser
o primeiro caractere não em branco em uma linha.

Use a barra invertida para indicar a continuação de uma linha. O comando


ignorará todos os caracteres da barra invertida até (mas exceto) o primeiro
caractere não em branco da próxima linha. Se você incluir mais de um espaço
antes da barra invertida, ele será substituído por um único espaço.

Use caracteres hard-tab para controlar o recuo. Esse recuo indica a estrutura de
árvore das chaves do registro. No entanto, esses caracteres são convertidos em um
único espaço, independentemente da posição.

Links relacionados
Chave da sintaxe de linha de comando
regsvr32
Artigo • 11/04/2023

Registra os arquivos .dll como componentes de comando no registro.

Sintaxe

regsvr32 [/u] [/s] [/n] [/i[:cmdline]] <Dllname>

Parâmetros

Parâmetro Descrição

/u Cancela o registro do servidor.

/s Impede a exibição de mensagens.

/n Impede a chamada de DllRegisterServer. Esse parâmetro exige que você também


use o parâmetro /i.

/i: <cmdline> Passa uma cadeia de caracteres da linha de comando opcional (cmdline) para
DllInstall. Se você usar esse parâmetro com o parâmetro /u, ele chamará
DllUninstall.

<Dllname> O nome do arquivo .dll que será registrado.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para registrar .dll no Esquema do Active Directory, digite:

regsvr32 schmmgmt.dll

Links relacionados
Chave da sintaxe de linha de comando
relog
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Extrai contadores de desempenho de logs do contador de desempenho em outros


formatos, como text-TSV (para texto delimitado por tabulação), text-CSV (para texto
delimitado por vírgula), binário-BIN ou SQL.

7 Observação

Para obter mais informações sobre como incorporar relog em seus scripts WMI
(Instrumentação de Gerenciamento do Windows), consulte o Blog Script .

Sintaxe

relog [<filename> [<filename> ...]] [/a] [/c <path> [<path> ...]] [/cf
<filename>] [/f {bin|csv|tsv|SQL}] [/t <value>] [/o
{outputfile|DSN!CounterLog}] [/b <M/D/YYYY> [[<HH>:] <MM>:] <SS>] [/e
<M/D/YYYY> [[<HH>:] <MM>:] <SS>] [/config {<filename>|i}] [/q]

Parâmetros

Parâmetro Descrição

filename [filename Especifica o nome do caminho de um log de contador de desempenho


...] existente. Podem ser especificados vários arquivos de entrada.

-a Acrescenta o arquivo de saída em vez de substituir. Essa opção não se


aplica ao formato SQL em que o padrão é sempre acrescentar.

-c path [path ...] Especifica o caminho do contador de desempenho a ser registrado. Para
especificar vários caminhos de contador, separe-os com um espaço e
coloque os caminhos do contador entre aspas (por exemplo, "path1
path2" ).
Parâmetro Descrição

-cf filename Especifica o nome do caminho do arquivo de texto que lista os


contadores de desempenho a serem incluídos em um arquivo relog. Use
essa opção para listar caminhos de contador em um arquivo de entrada,
um por linha. A configuração padrão é que todos os contadores no
arquivo de log original são registrados novamente.

-f {bin | csv | tsv | Especifica o nome do caminho do formato de arquivo de saída. O


SQL} formato padrão é bin. Para um banco de dados SQL, o arquivo de saída
especifica o DSN!CounterLog . Você pode especificar o local do banco de
dados usando o gerenciador ODBC para configurar o DSN (Nome do
Sistema de Banco de Dados).

-t value Especifica intervalos de exemplo em n registros. Inclui cada enésimo


ponto de dados no arquivo relog. O padrão é cada ponto de dados.

-o {Outputfile | Especifica o nome do caminho do arquivo de saída ou do banco de


SQL:DSN!Counter_Log} dados SQL onde os contadores serão gravados.
Observação: para as versões de 64 bits e 32 bits do relog.exe, você deve
definir um DSN na Fonte de Dados ODBC (64 bits e 32 bits,
respectivamente) no sistema. Use o driver ODBC do "SQL Server" para
definir um DSN.

-b <M/D/YYYY> Especifica a hora de início para copiar o primeiro registro do arquivo de


[[<HH>:]<MM>:]<SS>] entrada. A data e a hora devem estar nesse formato exato
M/D/AAAAH:MM:SS.

-e <M/D/YYYY> Especifica a hora de término para copiar o último registro do arquivo de


[[<HH>:]<MM>:]<SS>] entrada. A data e a hora devem estar nesse formato exato
M/D/AAAAH:MM:SS.

-config {filename | Especifica o nome do caminho do arquivo das configurações que contém
i} parâmetros de linha de comando. Se você estiver usando um arquivo de
configuração, use -i como um espaço reservado para uma lista de
arquivos de entrada que podem ser colocados na linha de comando. Se
você estiver usando a linha de comando, não use -i. Você também pode
usar curingas, como *.blg para especificar vários nomes de arquivo de
entrada ao mesmo tempo.

-Q Exibe os contadores de desempenho e intervalos de tempo dos arquivos


de log especificados no arquivo de entrada.

-y Ignora a solicitação respondendo "sim" a todas as perguntas.

/? Exibe a ajuda no prompt de comando.

Comentários
O formato geral para caminhos de contador é o seguinte: [\<computer>] \<object>
[<parent>\<instance#index>] \<counter>] onde os componentes pai, instância,
índice e contador do formato podem conter um nome válido ou um caractere
curinga. Os componentes de computador, pai, instância e índice não são
necessários para todos os contadores.

Você determina os caminhos do contador a serem usados com base no próprio


contador. Por exemplo, o objeto LogicalDisk tem uma instância <index> , portanto,
você deve fornecer o <#index> ou um caractere curinga. Portanto, você pode usar
o seguinte formato: \LogicalDisk(*/*#*)\\* .

Em comparação, o objeto Process não requer uma instância <index> . Portanto,


você pode usar o seguinte formato: \Process(*)\ID Process .

Se um caractere curinga for especificado no nome Pai, todas as instâncias do


objeto especificado que correspondem aos campos de instância e contador
especificados serão retornadas.

Se um caractere curinga for especificado no nome Instância, todas as instâncias do


objeto especificado e do objeto pai serão retornadas se todos os nomes de
instância correspondentes ao índice especificado corresponderem ao caractere
curinga.

Se um caractere curinga for especificado no nome Contador, todos os contadores


do objeto especificado serão retornados.

Não há suporte para correspondências parciais de cadeia de caracteres de


caminho do contador (por exemplo, pro*).

Arquivos de contador são arquivos de texto que listam um ou mais contadores de


desempenho no log existente. Copie o nome completo do contador do log ou da
saída /q no formato <computer>\<object>\<instance>\<counter> . Liste um caminho
de contador em cada linha.

Quando executado, o comando relog copia os contadores especificados de cada


registro no arquivo de entrada, convertendo o formato, se necessário. Caminhos
curinga são permitidos no arquivo de contador.

Use o parâmetro /t para especificar que os arquivos de entrada foram inseridos em


arquivos de saída em intervalos de cada registro nth . Por padrão, os dados são
colocados novamente no log de cada registro.

Você pode especificar que os logs de saída incluam registros de antes da hora de
início (ou seja, /b) para fornecer dados para contadores que exigem valores de
computação do valor formatado. O arquivo de saída terá os últimos registros de
arquivos de entrada com carimbos de data/hora menores que o parâmetro /e (ou
seja, hora de término).

O conteúdo do arquivo de configuração usado com a opção /config deve ter o


seguinte formato: <commandoption>\<value> , em que <commandoption> é uma
opção de linha de comando e <value> especifica seu valor.

Exemplos ##Q#

Para criar uma nova amostra dos logs de rastreamento existentes em intervalos fixos de
30, listar os caminhos do contador, arquivos de saída e formatos, digite:

relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o


c:\perflogs\reduced_log.csv /t 30 /f csv

Para criar uma nova amostra dos logs de rastreamento existentes em intervalos fixos de
30, listar os caminhos do contador e arquivos de saída, digite:

relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o


c:\perflogs\reduced_log.blg /t 30

Para criar uma nova amostra dos logs de rastreamento existentes em um banco de
dados, digite:

relog "c:\perflogs\daily_trace_log.blg" -f sql -o


"SQL:sql2016x64odbc!counter_log"

Links relacionados
Chave da sintaxe de linha de comando
rem
Artigo • 12/04/2023

Registra comentários em um script, lote ou arquivo config.sys. Se nenhum comentário


for especificado, o rem adicionará espaçamento vertical.

7 Observação

Esse comando é interno para o interpretador de linha de comando, cmd.exe.

Sintaxe

rem [<comment>]

Parâmetros

Parâmetro Descrição

<comment> Especifica uma cadeia de caracteres a ser incluída como comentário.

/? Exibe a ajuda no prompt de comando.

Comentários

O comando rem não exibe os comentários na tela. Para exibir os comentários na


tela, você deve incluir o comando echo on no arquivo.

Você não pode usar um caractere de redirecionamento ( < ou > ) ou pipe ( | ) em


um comentário de arquivo em lote.

Embora você possa usar o rem sem comentário para adicionar espaçamento
vertical a um arquivo em lote, você também pode usar linhas em branco. As linhas
em branco são ignoradas quando um programa em lote é processado.

Exemplos
Para adicionar espaçamento vertical por meio de comentários de arquivo em lote,
digite:

@echo off
rem This batch program formats and checks new disks.
rem It is named Checknew.bat.
rem
rem echo Insert new disk in Drive B.
pause
format b: /v chkdsk b:

Para incluir um comentário explicativo antes do comando prompt em um arquivo


config.sys, digite:

rem Set prompt to indicate current directory


prompt $p$g

Para fornecer um comentário sobre o que um script faz, digite:

rem The commands in this script set up 3 drives.


rem The first drive is a primary partition and is
rem assigned the letter D. The second and third drives
rem are logical partitions, and are assigned letters
rem E and F.
create partition primary size=2048
assign d:
create partition extended
create partition logical size=2048
assign e:
create partition logical
assign f:

Para comentários de várias linhas, use a execução condicional:

Rem/||(
The REM statement evaluates to success,
so these lines will never be executed.
Keep in mind that you will need to escape closing parentheses
within multi-line comment blocks like shown in this example. ^)
)
Links relacionados
Chave da sintaxe de linha de comando
remove
Artigo • 12/04/2023

Remove uma letra da unidade ou um ponto de montagem do volume com foco. Se o


parâmetro all for usado, todas as letras da unidade e os pontos de montagem atuais
serão removidos. Se nenhuma letra da unidade ou ponto de montagem for
especificado, o DiskPart removerá a primeira letra da unidade ou o primeiro ponto de
montagem encontrado.

O comando remove também pode ser usado para alterar a letra da unidade associada a
uma unidade removível. Não é possível remover as letras da unidade em volumes de
sistema, inicialização ou paginação. Além disso, você não pode remover a letra da
unidade de uma partição OEM, qualquer partição GPT com um GUID não reconhecido
ou qualquer uma das partições GPT especiais, não relacionadas a dados, como a
partição de sistema EFI.

7 Observação

Um volume deve ser selecionado para que o comando remove tenha êxito. Use o
comando select volume para selecionar um disco e mudar o foco para ele.

Sintaxe

remove [{letter=<drive> | mount=<path> [all]}] [noerr]

Parâmetros

Parâmetro Descrição

letter= <drive> A letra da unidade a ser removida.

mount= <path> O caminho do ponto de montagem a ser removido.

all Remove todas as letras da unidade e os pontos de montagem atuais.

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a


processar os comandos como se o erro não tivesse ocorrido. Sem esse
parâmetro, um erro faz com que o DiskPart saia com um código de erro.
Exemplos
Para remover a unidade d:\, digite:

remove letter=d

Links relacionados
Chave da sintaxe de linha de comando
ren
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Renomeia arquivos ou diretórios.

7 Observação

Esse comando é igual ao comando rename.

Sintaxe

ren [<drive>:][<path>]<filename1> <filename2>

Parâmetros

Parâmetro Descrição

[<drive>:] Especifica o local e o nome do arquivo ou conjunto de arquivos que você


[<path>] deseja renomear. O filename1 pode incluir caracteres curinga (* e ?).
<filename1>

<filename2> Especifica o novo nome do arquivo. Você pode usar caracteres curinga para
especificar novos nomes para vários arquivos.

/? Exibe a ajuda no prompt de comando.

Comentários

Você não pode especificar uma nova unidade ou caminho ao renomear arquivos.
Você também não pode usar esse comando para renomear arquivos entre
unidades ou para mover arquivos para um diretório diferente.

Os caracteres representados por caracteres curinga em filename2 serão idênticos


aos caracteres correspondentes em filename1.
O filename2 deve ser um nome de arquivo exclusivo. Se o filename2 corresponder
a um nome de arquivo existente, a seguinte mensagem será exibida: Duplicate
file name or file not found .

Exemplos
Para alterar todas as extensões de nome de arquivo .txt no diretório atual para
extensões .doc, digite:

ren *.txt *.doc

Para alterar o nome de um diretório de Chap10 para Part10, digite:

ren chap10 part10

Links relacionados
Chave da sintaxe de linha de comando

comando rename
renomear
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Renomeia arquivos ou diretórios.

7 Observação

Esse comando é igual ao comando ren.

Sintaxe

rename [<drive>:][<path>]<filename1> <filename2>

Parâmetros

Parâmetro Descrição

[<drive>:] Especifica o local e o nome do arquivo ou conjunto de arquivos que você


[<path>] deseja renomear. O filename1 pode incluir caracteres curinga (* e ?).
<filename1>

<filename2> Especifica o novo nome do arquivo. Você pode usar caracteres curinga para
especificar novos nomes para vários arquivos.

/? Exibe a ajuda no prompt de comando.

Comentários

Você não pode especificar uma nova unidade ou caminho ao renomear arquivos.
Você também não pode usar esse comando para renomear arquivos entre
unidades ou para mover arquivos para um diretório diferente.

Os caracteres representados por caracteres curinga em filename2 serão idênticos


aos caracteres correspondentes em filename1.
O filename2 deve ser um nome de arquivo exclusivo. Se o filename2 corresponder
a um nome de arquivo existente, a seguinte mensagem será exibida: Duplicate
file name or file not found .

Exemplos
Para alterar todas as extensões de nome de arquivo .txt no diretório atual para .doc
extensões, digite:

rename *.txt *.doc

Para alterar o nome de um diretório de Chap10 para Part10, digite:

rename chap10 part10

Links relacionados
Chave da sintaxe de linha de comando

comando ren
reparo
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Repara o volume RAID-5 com foco substituindo a região do disco com falha pelo disco
dinâmico especificado.

Um volume em uma matriz RAID-5 deve ser selecionado para que essa operação seja
bem-sucedida. Use o comando select volume para selecionar um volume e mudar o
foco para ele.

Sintaxe

repair disk=<n> [align=<n>] [noerr]

Parâmetros

Parâmetro Descrição

disk= <n> Especifica o disco dinâmico que substituirá a região de disco com falha. Onde n
deve ter um espaço livre maior ou igual ao tamanho total da região de disco com
falha no volume RAID-5.

align= <n> Alinha todas as extensões de partição ou volume ao limite de alinhamento mais
próximo. Onde n é o número de quilobytes (KB) desde o início do disco até o limite
de alinhamento mais próximo.

noerr somente para script. Quando um erro é encontrado, o DiskPart continua a processar
os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Exemplos
Para substituir o volume pelo foco substituindo-o pelo disco dinâmico 4, digite:
repair disk=4

Links relacionados
Chave da sintaxe de linha de comando

comando select volume


repair-bde
Artigo • 11/04/2023

Tenta reconstruir partes críticas de uma unidade gravemente danificada e recuperar


dados recuperáveis se a unidade foi criptografada usando o BitLocker e se ela tiver uma
senha de recuperação válida ou chave de recuperação para descriptografia.

) Importante

Se os dados de metadados do BitLocker na unidade estiverem corrompidos, você


deverá fornecer um pacote de chaves de backup, além da senha ou da chave de
recuperação. Se você usou a configuração de backup de chave padrão para o
Active Directory Domain Services, o backup do pacote de chaves será feito lá. É
possível usar o BitLocker: Usar o Visualizador de Senha de Recuperação do
BitLocker para obter o pacote de chaves do AD DS.

Com esse pacote de chaves e a senha ou a chave de recuperação, você poderá


descriptografar partes de uma unidade protegida pelo BitLocker, mesmo se o disco
estiver danificado. Cada pacote de chaves funciona apenas para uma unidade com
o identificador de unidade correspondente.

Syntax

repair-bde <inputvolume> <outputvolumeorimage> [-rk] [–rp] [-pw] [–kp] [–lf]


[-f] [{-?|/?}]

2 Aviso

O conteúdo do volume de saída será completamente excluído e substituído pelo


conteúdo descriptografado da unidade do BitLocker danificada. Se você quiser
salvar todos os dados existentes na unidade de destino selecionada, mova os
dados existentes para outra mídia de backup confiável primeiro, antes de executar
o comando repair-bde .

Parâmetros
Parâmetro Descrição

<inputvolume> Identifica a letra da unidade criptografada pelo BitLocker que você


deseja reparar. A letra da unidade deve incluir dois-pontos; por
exemplo: C:. Se o caminho para um pacote de chaves não for
especificado, esse comando pesquisará na unidade um pacote de
chaves. Caso o disco rígido esteja danificado, esse comando poderá não
conseguir localizar o pacote e solicitará que você forneça o caminho.

<outputvolumeorimage> Identifica a unidade na qual armazenar o conteúdo da unidade


reparada. Todas as informações sobre essa unidade de saída serão
substituídas.

-rk Identifica o local da chave de recuperação que deve ser usada para
desbloquear o volume. Esse comando também pode ser especificado
como -recoverykey.

-rp Identifica a senha de recuperação numérica que deve ser usada para
desbloquear o volume. Esse comando também pode ser especificado
como -recoverypassword.

-pw Identifica a senha que deve ser usada para desbloquear o volume. Esse
comando também pode ser especificado como -password.

-kp Identifica o pacote de chave de recuperação que pode ser usado para
desbloquear o volume. Esse comando também pode ser especificado
como -keypackage.

-lf Especifica o caminho para o arquivo que armazenará mensagens de


erro, de aviso e de informações do Repair-bde. Esse comando também
pode ser especificado como -logfile.

-f Força um volume a ser desmontado mesmo que ele não possa ser
bloqueado. Esse comando também pode ser especificado como -force.

-? ou /? Exibe a ajuda no prompt de comando.

Limitações
As seguintes limitações existem para este comando:

Este comando não pode reparar uma unidade que falhou durante o processo de
criptografia ou de descriptografia.

Este comando presume que, se a unidade tiver alguma criptografia, a unidade foi
totalmente criptografada.

Exemplos
Para tentar reparar a unidade C:, para gravar o conteúdo da unidade C: para a unidade
D: usando o arquivo de chave de recuperação (RecoveryKey.bek) armazenado na
unidade F:, e para gravar os resultados dessa tentativa no arquivo de log (log.txt) na
unidade Z:, digite:

repair-bde C: D: -rk F:\RecoveryKey.bek –lf Z:\log.txt

Para tentar reparar a unidade C: e gravar o conteúdo da unidade C: para a unidade D:


usando a senha de recuperação de 48 dígitos especificada, digite:

repair-bde C: D: -rp 111111-222222-333333-444444-555555-666666-777777-888888

7 Observação

A senha de recuperação deve ser digitada em oito blocos de seis dígitos com um
hífen separando cada bloco.

Para forçar a unidade C: a desmontar, tente reparar a unidade C:, e gravar o conteúdo
da unidade C: para a unidade D: usando o pacote de chaves de recuperação e o arquivo
de chave de recuperação (RecoveryKey.bek) armazenado na unidade F:, digite:

repair-bde C: D: -kp F:\RecoveryKeyPackage -rk F:\RecoveryKey.bek -f

Para tentar reparar a unidade C: e gravar o conteúdo da unidade C: para a unidade D:,
na qual você deve digitar uma senha para desbloquear a unidade C: (quando solicitado),
digite:

repair-bde C: D: -pw

Links relacionados
Chave da sintaxe de linha de comando
substituir
Artigo • 12/04/2023

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>:] Especifica o local e o nome do arquivo de origem ou do conjunto de arquivos. A


[<path1>] opção filename é necessária e pode incluir caracteres curinga (* e ?).
<filename>

[<drive2>:] Especifica o local do arquivo de destino. Não é possível especificar um nome de


[<path2>] 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.
Parâmetro Descrição

/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.
Código de saída Descrição

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.

7 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

Links relacionados
Chave da sintaxe de linha de comando
examinar novamente
Artigo • 12/04/2023

Usando o interpretador do comando diskpart, você pode localizar novos discos


adicionados ao computador.

Syntax

rescan

Links relacionados
Chave da sintaxe de linha de comando

Comando diskpart
reset
Artigo • 11/04/2023

Redefine DiskShadow.exe ao estado padrão. Esse comando é especialmente útil para


separar as operações compostas do DiskShadow, como criar, importar, fazer backup ou
restaurar.

[! IMPORTANTE Depois de executar esse comando, você perderá as informações de


estado dos comandos, como adicionar, definir, carregar ou gravar. Esse comando
também libera as interfaces IVssBackupComponent e perde as cópias de sombra
não persistentes.

Syntax

reset

Links relacionados
Chave da sintaxe de linha de comando

comando create

Comando import

comando backup

comando restore

comando add

Comando set

comando load

comando writer
reset session
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Permite redefinir (excluir) uma sessão em um servidor Host da Sessão da Área de


Trabalho Remota. Você deve redefinir uma sessão somente quando ela apresentar mau
funcionamento ou parecer que parou de responder.

7 Observação

Para descobrir as novidades da última versão, confira Novidades nos Serviços de


Área de Trabalho Remota do Windows Server.

Sintaxe

reset session {<sessionname> | <sessionID>} [/server:<servername>] [/v]

Parâmetros

Parâmetro Descrição

<sessionname> Especifica o nome da sessão que você deseja redefinir. Para determinar o
nome da sessão, use o comando query session.

<sessionID> Especifica a ID da sessão a ser redefinida.

/server: <servername> Especifica o servidor de terminal que contém a sessão que você deseja
redefinir. Caso contrário, usa o servidor Host da Sessão da Área de
Trabalho Remota atual. Esse parâmetro só será necessário se você usar
esse comando em um servidor remoto.

/v Exibe informações sobre as ações sendo executadas.

/? Exibe a ajuda no prompt de comando.

Comentários
Você sempre pode redefinir suas próprias sessões, mas precisa ter permissão de
acesso de Controle Total para redefinir a sessão de outro usuário. Lembre-se de
que redefinir a sessão de um usuário sem avisar o usuário pode resultar na perda
de dados na sessão.

Exemplos
Para redefinir a sessão designada como rdp-tcp#6, digite:

reset session rdp-tcp#6

Para redefinir a sessão que usa a ID da sessão 3, digite:

reset session 3

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos dos Serviços de Área de Trabalho Remota


retain
Artigo • 12/04/2023

Prepara um volume dinâmico simples existente para uso como um volume do


inicialização ou de sistema. Se você usar um disco dinâmico de MBR (registro mestre de
inicialização), esse comando criará uma entrada de partição no registro mestre de
inicialização. Se você usar um disco dinâmico de GPT (tabela de partição de GUID), esse
comando criará uma entrada de partição na tabela de partição de GUID.

Syntax

retain

Links relacionados
Chave da sintaxe de linha de comando
revert
Artigo • 12/04/2023

Reverte um volume para uma cópia de sombra especificada. Tem suporte apenas para
cópias de sombra no contexto CLIENTACCESSIBLE. Essas cópias de sombra são
persistentes e só podem ser feitas pelo provedor do sistema. Se usado sem parâmetros,
o revert exibe a ajuda no prompt de comando.

Sintaxe

revert <shadowcopyID>

Parâmetros

Parâmetro Descrição

<shadowcopyID> Especifica a ID da cópia de sombra para a qual o volume deve ser revertido. Se
você não usar esse parâmetro, o comando exibirá a ajuda no prompt de
comando.

Links relacionados
Chave da sintaxe de linha de comando
rexec
Artigo • 12/04/2023

Executa um comando especificado em um host remoto. O host remoto deve estar


executando um rexecd service (ou daemon) para que o rexec seja conectado.

) Importante

O comando rexec foi preterido e não há garantia de que tenha suporte no


Windows.
risetup
Artigo • 29/09/2022

Cria uma imagem do sistema operacional estivando os arquivos do CD Windows Server


2003 original ou de uma pasta de distribuição personalizada que contém esses arquivos.

) Importante

O comando rexec foi preterido e não há garantia de que o suporte seja feito
Windows.
rmdir
Artigo • 11/04/2023

Exclui um diretório.

O comando rmdir também pode ser executado no Console de Recuperação do


Windows, usando parâmetros diferentes. Para obter mais informações, consulte WinRE
(Ambiente de Recuperação do Windows).

7 Observação

Esse comando é igual ao comando rd.

Sintaxe

rmdir [<drive>:]<path> [/s [/q]]

Parâmetros

Parâmetro Descrição

[<drive>:] Especifica o local e o nome do diretório que você deseja excluir. Um caminho é
<path> requerido. Se você incluir uma barra invertida () no início do caminho especificado,
o caminho começará no diretório-raiz (independentemente do diretório atual).

/s Exclui uma árvore de diretório (o diretório especificado e todos os subdiretórios,


incluindo todos os arquivos).

/q Especifica o modo silencioso. Não solicita confirmação ao excluir uma árvore de


diretório. O parâmetro /q só funcionará se /s também for especificado.

CUIDADO: Quando você executa no modo silencioso, toda a árvore de diretório é


excluída sem confirmação. Verifique se os arquivos importantes foram movidos ou
submetidos a backup antes de usar a opção da linha de comando /q.

/? Exibe a ajuda no prompt de comando.

Comentários
Não é possível excluir um diretório que contenha arquivos, incluindo arquivos
ocultos ou do sistema. Se você tentar fazer isso, a seguinte mensagem será
exibida:

The directory is not empty

Use o comando dir /a para listar todos os arquivos (incluindo arquivos ocultos e
do sistema). Em seguida, use o comando attrib com -h para remover os atributos
de arquivo ocultos, -s para remover os atributos de arquivo do sistema ou -h -s
para remover os atributos de arquivo ocultos e do sistema. Depois que os
atributos ocultos e de arquivo forem removidos, você poderá excluir os arquivos.

Não é possível usar o comando rmdir para excluir o diretório atual. Se tentar
excluir o diretório atual, a seguinte mensagem de erro será exibida:

The process can't access the file because it is being used by another
process.

Se você vir essa mensagem de erro, deverá mudar para um diretório diferente (não
um subdiretório do diretório atual) e tentar novamente.

Exemplos
Para mudar para o diretório-pai para que você possa remover com segurança o
diretório desejado, digite:

cd ..

Para remover um diretório chamado test (e todos os seus subdiretórios e arquivos) do


diretório atual, digite:

rmdir /s test

Para executar o exemplo anterior no modo silencioso, digite:

rmdir /s /q test
Links relacionados
Chave da sintaxe de linha de comando
robocopy
Artigo • 05/06/2023

Copia dados de um arquivo de um local para outro.

Syntax
Prompt de comando do Windows

robocopy <source> <destination> [<file>[ ...]] [<options>]

Por exemplo, para copiar um arquivo chamado yearly-report.mov de c:\reports para


compartilhamento de arquivo em \\marketing\videos e habilitar o multi-thread para
obter melhor desempenho (com o parâmetro /mt) e a opção de reiniciar a transferência
caso ela seja interrompida (com o parâmetro /z ), digite:

Prompt de comando do Windows

robocopy c:\reports "\\marketing\videos" yearly-report.mov /mt /z

) Importante

Se algum dado for copiado da raiz de um dispositivo, o diretório de destino


adotará o atributo "oculto" durante o processo de cópia.

Parâmetros

Parâmetro Descrição

<source> Especifica o caminho para o diretório de origem.

<destination> Especifica o caminho para o diretório de destino.

<file> Selecione os arquivos a serem copiados. Você pode usar caracteres curinga (* ou
?). Se você não especificar esse parâmetro, o *.* será usado como o valor
padrão.

<options> Especifica as opções a serem usadas com o comando robocopy, incluindo as


opções cópia, arquivo, tentar novamente, registrar em log e tarefa.
Opções de cópia

Opção Descrição

/s Copia subdiretórios. Essa opção exclui automaticamente os diretórios


vazios.

/e Copia subdiretórios. Essa opção inclui automaticamente os diretórios


vazios.

/lev: <n> Copia apenas os n níveis superiores da árvore do diretório de origem.

/z Copia os arquivos no modo de reinicialização. No modo de reinicialização,


se uma cópia de arquivo for interrompida, o Robocopy continuará de onde
parou em vez de copiar novamente todo o arquivo.

/b Copia arquivos no modo de backup, permitindo que o Robocopy substitua


as configurações de permissão de arquivo e pasta (ACLs). Isso permite a
cópia de arquivos aos quais você pode não ter acesso, supondo que ele
esteja sendo executado em uma conta com privilégios suficientes.

/zb Copia os arquivos no modo de reinicialização. Se o acesso ao arquivo for


negado, mudará para o modo de backup.

/j Copia usando E/S não armazenada em buffer (recomendado para arquivos


grandes).

/efsraw Copia todos os arquivos criptografados no modo RAW do EFS.

/copy: <copyflags> Especifica quais propriedades do arquivo serão copiadas. Os valores


válidos para essa opção são:
D - Dados
A - Atributos
T - Carimbos de Data/Hora
X - Ignorar fluxos de dados alternativos
S - ACL (lista de controle de acesso) do NTFS
O - Informações do proprietário
U - Informações de auditoria

O valor padrão para a opção /COPY é DAT (dados, atributos e carimbos de


data/hora). O sinalização X é ignorado se /B ou /ZB é usado.

/dcopy: <copyflags> Especifica o que será copiado nos diretórios. Os valores válidos para essa
opção são:
D - Dados
A - Atributos
T - Carimbos de Data/Hora
E - Atributo estendido
X - Ignorar fluxos de dados alternativos

O valor padrão dessa opção é DA (dados e atributos).


Opção Descrição

/s Copia arquivos com segurança (equivalente a /copy:DATS).

/copyall Copia todas as informações do arquivo (equivalente a /copy:DATSOU).

/nocopy Não copia nenhuma informação do arquivo (útil com /purge).

/secfix Corrige a segurança do arquivo em todos os arquivos, até mesmo os


ignorados.

/timfix Corrige os tempos do arquivo em todos os arquivos, até mesmo os


ignorados.

/purge Exclui arquivos e diretórios de destino que não existem mais na origem.
Usar essa opção com a opção /e e um diretório de destino permite que as
configurações de segurança do diretório de destino não sejam
substituídas.

/mir Espelha uma árvore de diretório (equivalente a /e mais /purge). Usar essa
opção com a opção /e e um diretório de destino substitui as configurações
de segurança do diretório de destino.

/mov Move arquivos e os exclui da origem depois que são copiados.

/move Move arquivos e diretórios e os exclui da origem depois que são copiados.

/a+:[RASHCNET] Adiciona os atributos especificados aos arquivos copiados. Os valores


válidos para essa opção são:
R - Somente leitura
A - Arquivo
S - Sistema
H - Oculto
C - Compactado
N - Conteúdo não indexado
E - Criptografado
T - Temporário

/a-:[RASHCNETO] Remove os atributos especificados dos arquivos copiados. Os valores


válidos para essa opção são:
R - Somente leitura
A - Arquivo
S - Sistema
H - Oculto
C - Compactado
N - Conteúdo não indexado
E - Criptografado
T - Temporário
O - Offline
Opção Descrição

/create Cria apenas uma árvore de diretório e arquivos de tamanho zero.

/fat Cria arquivos de destino usando apenas nomes de arquivo FAT com
formato de caracteres 8.3.

/256 Desativa o suporte para caminhos com mais de 256 caracteres.

/mon: <n> Monitora a origem e é executado novamente quando mais do que n


alterações são detectadas.

/mot: <m> Monitora a origem e é executado novamente em m minutos se forem


detectadas alterações.

/rh:hhmm-hhmm Especifica os tempos de execução em que novas cópias podem ser


iniciadas.

/pf Verifica os tempos de execução por arquivo (não por passagem).

/Ipg: <n> Especifica a lacuna entre os pacotes para liberar largura de banda em
linhas lentas.

/sj Copia junções (links simbólicos) para o caminho de destino em vez dos
destinos de link.

sl Não gera links simbólicos, cria uma cópia do link.

/mt: <n> Cria cópias multi-thread com n threads. O n deve ser um número inteiro
entre 1 e 128. O valor padrão para n é 8. Para obter um melhor
desempenho, redirecione a saída usando a opção /log.

O parâmetro /mt não pode ser usado com os parâmetros /ipg e /efsraw.

/nodcopy Não copia nenhuma informação de diretório (é executado o padrão


/dcopy:DA).

/nooffload Copia arquivos sem usar o mecanismo de descarregamento de cópia do


Windows.

/compress Solicita compactação de rede durante a transferência de arquivos, quando


aplicável.

/sparse Habilita a retenção do estado esparso durante a cópia.

) Importante

Ao usar a opção de cópia /secfix, utilize uma das alternativas abaixo para
especificar o tipo de informações de segurança que você quer copiar:

/copyall
/copy:o
/copy:s
/copy:u
/sec

7 Observação

O parâmetro /mt começou a ser usado no Windows Server 2008 R2 e sua


funcionalidade se aplica às versões atuais do Windows Server.

Opções de limitação de cópia de arquivo

Opção Descrição

/iomaxsize: <n> [kmg] O tamanho máximo de e/s solicitado por ciclo de leitura/gravação em
nkilobytes, megabytes ou gigabytes.

/iorate: <n> [kmg] A taxa de e/s solicitada em nkilobytes megabytes ou gigabytes por
segundo.

/threshold: <n> [kmg] A limitação de tamanho de arquivo em nkilobytes, megabytes ou


gigabytes (veja Comentários).

Opções de seleção de arquivo

Opção Descrição

/a Copia somente arquivos para os quais o atributo Arquivo está definido.

/m Copia somente arquivos para os quais o atributo Arquivo está definido e


redefine o atributo Arquivo.

/ia: [RASHCNETO] Inclui apenas arquivos para os quais qualquer um dos atributos especificados
está definido. Os valores válidos para essa opção são:
R - Somente leitura
A - Arquivo
S - Sistema
H - Oculto
C - Compactado
N - Conteúdo não indexado
E - Criptografado
T - Temporário
O - Offline
Opção Descrição

/xa: [RASHCNETO] Inclui apenas arquivos para os quais qualquer um dos atributos especificados
está definido. Os valores válidos para essa opção são:
R - Somente leitura
A - Arquivo
S - Sistema
H - Oculto
C - Compactado
N - Conteúdo não indexado
E - Criptografado
T - Temporário
O - Offline

/xf <filename>[ Exclui arquivos que correspondem aos nomes ou caminhos especificados. Você
...] pode usar caracteres curinga (* e ?).

/xd <directory> Exclui diretórios que correspondem aos nomes e caminhos especificados.
[ ...]

/xc Exclui arquivos existentes com o mesmo carimbo de data/hora, mas com
tamanhos de arquivo diferentes.

/xn Os arquivos de diretório de origem mais recentes do que o destino são


excluídos da cópia.

/xo Os arquivos de diretório de origem mais antgos do que o destino são excluídos
da cópia.

/xx Exclui arquivos e diretórios extras presentes no destino, mas não a origem. A
exclusão de arquivos extras não removerá arquivos do destino.

/xl Exclui arquivos e diretórios "isolados" presentes na origem, mas não o destino.
A exclusão de arquivos isolados impede que novos arquivos sejam adicionados
ao destino.

/im Inclui arquivos modificados (tempos de alteração diferentes).

/is Inclui os mesmos arquivos. Os mesmos arquivos são idênticos em relação ao


nome, tamanho, hora e todos os atributos.

/it Inclui arquivos "ajustados". Os arquivos ajustados têm o mesmo nome,


tamanho e hora, mas atributos diferentes.

/max: <n> Especifica o tamanho máximo do arquivo (para excluir arquivos maiores do que
n bytes).

/min: <n> Especifica o tamanho mínimo do arquivo (para excluir arquivos menores do
que n bytes).
Opção Descrição

/maxage: <n> Especifica a idade máxima do arquivo (para excluir arquivos mais antigos do
que n dias ou data).

/minage: <n> Especifica a idade mínima do arquivo (para excluir arquivos mais recentes do
que n dias ou data).

/maxlad: <n> Especifica a data máxima de último acesso (exclui arquivos não utilizados
desde n).

/minlad: <n> Especifica a data mínima de último acesso (exclui arquivos usados desde n). Se
n for menor do que 1900, n especificará o número de dias. Caso contrário, n
especificará uma data no formato AAAAMMDD.

/xj Exclui pontos de junção, que normalmente são incluídos por padrão.

/fft Pressupõe tempos de arquivo FAT (precisão de dois segundos).

/dst Compensa a diferença de tempo de uma hora do DST.

/xjd Exclui pontos de junção de diretórios.

/xjf Exclui pontos de junção de arquivos.

Opções de nova tentativa

Opção Descrição

/r: <n> Especifica o número de repetições em cópias com falha. O valor padrão de n é
1.000.000 (um milhão de novas tentativas).

/w: <n> Especifica o tempo de espera entre as tentativas, em segundos. O valor padrão
de n é 30 (tempo de espera de 30 segundos).

/reg Salva os valores especificados nas opções /r e /w como configurações padrão


no registro.

/tbd Especifica que o sistema aguarda a definição dos nomes de compartilhamento


(erro de nova tentativa 67).

/lfsm Opera no modo de espaço livre baixo que permite copiar, pausar e retomar
(confira Comentários).

/lfsm: <n> [kmg] Especifica o tamanho do piso (inicial) em nkilobytes, megabytes ou gigabytes.

Opções de log
Opção Descrição

/l Especifica que os arquivos devem ser apenas listados (não devem ser
copiados, excluídos ou ter carimbo de data/hora).

/x Relata todos os arquivos extras, não apenas os selecionados.

/v Produz uma saída detalhada e mostra todos os arquivos ignorados.

/ts Inclui carimbos de data/hora do arquivo de origem na saída.

/fp Inclui os nomes de caminho completos dos arquivos na saída.

/bytes Imprime tamanhos como bytes.

/ns Especifica que os tamanhos de arquivo não devem ser registrados.

/nc Especifica que as classes de arquivo não devem ser registrados.

/nfl Especifica que os nomes de arquivo não devem ser registrados.

/ndl Especifica que os nomes de diretório não devem ser registrados.

/np Especifica que o progresso da operação de cópia (o número de arquivos ou


diretórios copiados até o momento) não será exibido.

/eta Mostra o ETA (tempo estimado de chegada) dos arquivos copiados.

/log: <logfile> Grava a saída de status no arquivo de log (substitui o arquivo de log
existente).

/log+: <logfile> Grava o status da saída no arquivo de log (anexa a saída ao arquivo de log
existente).

/unilog: <logfile> Grava o status da saída no arquivo de log como texto unicode (substitui o
arquivo de log existente).

/unilog+: <logfile> Grava o status da saída no arquivo de log como testo Unicode (anexa a
saída ao arquivo de log existente).

/tee Grava o status da saída na janela do console e no arquivo de log.

/njh Especifica que não há cabeçalho de tarefa.

/njs Especifica que não há resumo de tarefa.

/unicode Exibe o status da saída como texto unicode.

Opções de trabalho

Opção Descrição
Opção Descrição

/job: <jobname> Especifica que os parâmetros devem ser derivados do arquivo de tarefa
nomeado. Para executar /job:jobname , primeiro você deve executar o
parâmetro /save:jobname para criar o arquivo da tarefa.

/save: <jobname> Especifica que os parâmetros devem ser salvos no arquivo de tarefa nomeado.
Isso deve ser executado antes de executar o /job:jobname . Todas as opções de
cópia, nova tentativa e registro em log devem ser especificadas antes desse
parâmetro.

/quit Encerra após processar a linha de comando (para exibir os parâmetros).

/nosd Indica que nenhum diretório de origem foi especificado.

/nodd Indica que nenhum diretório de destino foi especificado.

/if Inclui os arquivos especificados.

Comentários

Anteriormente, o uso do /PURGE ou do /MIR no diretório raiz do volume fazia


com que o robocopy aplicasse a operação solicitada também nos arquivos dentro
do diretório Informações de Volume do Sistema. Esse não é mais o caso, pois se
um deles for especificado, o robocopy ignorará todos os arquivos ou diretórios
com esse nome nos diretórios de origem e destino de nível superior da sessão de
cópia.

A classificação de arquivos modificados só se aplica quando ambos os sistemas de


arquivos de origem e de destino suportam carimbos de data/hora de alteração,
como o NTFS, e os arquivos de origem e destino têm horários de alteração
diferentes, mas são iguais. Por padrão, esses arquivos não são copiados.
Especifique /IM para incluí-los.

O sinalizador /DCOPY:E solicita que a cópia de atributo estendido seja tentada


para diretórios. O Robocopy continuará se os EAs do diretório não puderem ser
copiados. Esse sinalizador não está incluído em /COPYALL.

Se /IoMaxSize ou /IoRate forem especificados, o robocopy habilitará a limitação


do arquivo de cópia para reduzir a carga do sistema. Ambos podem ser ajustados
para os valores ideais e para os parâmetros de cópia, mas o sistema e o robocopy
têm permissão para ajustá-los aos valores permitidos, conforme necessário.

Se /Threshold for usado, ele especificará um tamanho mínimo de arquivo para


ativar a limitação. Os arquivos abaixo desse tamanho não serão limitados. Os
valores para todos os três parâmetros podem ser seguidos por um caractere
opcional de sufixo, como [KMG] (quilo, mega, giga).

A utilização do /LFSM exige que o RoboCopy opere no "modo de pouco espaço


livre". Nesse modo, o robocopy pausará sempre que uma cópia de arquivo fizer
com que o espaço livre do volume de destino fique abaixo de um valor de "piso".
Esse valor pode ser especificado explicitamente usando o sinalizador
/LFSM:n[KMG].

Se o /LFSM for especificado sem nenhum valor explícito de piso, o piso será
definido como 10% do tamanho do volume do destino. O modo de pouco espaço
livre é incompatível com /MT e /EFSRAW.

Códigos de saída (retorno)

Valor Descrição

0 Nenhum arquivo foi copiado. Nenhuma falha foi encontrada. Todos os arquivos
corresponderam. Os arquivos já existem no diretório de destino, portanto, a operação de
cópia foi ignorada.

1 Todos os arquivos foram copiados com êxito.

2 Há alguns arquivos adicionais no diretório de destino que não estão presentes no


diretório de origem. Nenhum arquivo foi copiado.

3 Alguns arquivos foram copiados. Arquivos adicionais estavam presentes. Nenhuma falha
foi encontrada.

5 Alguns arquivos foram copiados. Alguns arquivos não corresponderam. Nenhuma falha
foi encontrada.

6 Existem arquivos adicionais e arquivos não correspondentes. Nenhum arquivo foi copiado
e nenhuma falha foi encontrada, o que significa que os arquivos já existem no diretório
de destino.

7 Os arquivos foram copiados, foram encontrados um arquivo não correspondente e alguns


arquivos adicionais.

8 Vários arquivos não foram copiados.

7 Observação

Qualquer valor igual ou maior do que 8 indica que houve pelo menos uma falha
durante a cópia.
Exemplos
É altamente recomendável ao executar o comando robocopy para criar um arquivo de
log que pode ser exibido depois que o processo for concluído verificando sua
integridade. Nos exemplos a seguir, cada um usa o parâmetro /LOG: . Para acrescentar
qualquer informação de log ao mesmo arquivo de log, use o parâmetro /LOG+: .

Para copiar todos os arquivos e subdiretórios, incluindo diretórios vazios, da pasta


"Registros" para a pasta "Backup" na unidade "D", digite o seguinte:

Prompt de comando do Windows

robocopy C:\Users\Admin\Records D:\Backup /E /ZB /LOG:C:\Logs\Backup.log

Para espelhar o conteúdo da pasta "Registros" para a pasta "Backup" na unidade "D",
remova todos os arquivos no destino que não existem na origem com 2 repetições e
aguardando 5 segundos entre cada repetição, digite o seguinte:

Prompt de comando do Windows

robocopy C:\Users\Admin\Records D:\Backup /MIR /R:2 /W:5


/LOG:C:\Logs\Backup.log

Para copiar todos os arquivos e subdiretórios que não estão vazios da pasta "Registros"
para a pasta "Backup" na unidade "D", retendo os dados de arquivo, atributos e
carimbos de data/hora com 16 operações de cópia de vários threads, digite o seguinte:

Prompt de comando do Windows

robocopy C:\Users\Admin\Records D:\Backup /S /E /COPY:DAT /MT:16


/LOG:C:\Logs\Backup.log

Para mover arquivos e subdiretórios, excluindo diretórios vazios, da pasta "Registros"


para a pasta "Backup" na unidade "D" e excluir arquivos com mais de 7 dias, digite o
seguinte:

Prompt de comando do Windows

robocopy C:\Users\Admin\Records D:\Backup /S /MAXAGE:7 /MOV


/LOG:C:\Logs\Backup.log

Para copiar todos os arquivos e subdiretórios, incluindo diretórios vazios, da pasta


"Registros" para a pasta "Backup" na unidade "D" mostrando o tempo estimado para
cada arquivo e excluir todos os arquivos e diretórios no destino que não existem da
origem, digite o seguinte:

Prompt de comando do Windows

robocopy C:\Users\Admin\Records D:\Backup /ETA /PURGE


/LOG:C:\Logs\Backup.log

Links relacionados
Chave da sintaxe de linha de comando
route
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows
Server 2012 R2 e Windows Server 2012

Exibe e modifica as entradas na tabela de roteamento de IP local. Se usado sem parâmetros, o


route exibe a ajuda no prompt de comando.

) Importante

Esse comando só estará disponível se o Protocolo de Internet (TCP/IP) estiver instalado como
um componente nas propriedades de um adaptador de rede em Conexões de Rede.

Sintaxe
Prompt de comando do Windows

route [/f] [/p] [<command> [<destination>] [mask <netmask>] [<gateway>] [metric


<metric>]] [if <interface>]]

Parâmetros

Parâmetro Descrição

/f Limpa a tabela de roteamento de todas as entradas que não são rotas de host (rotas com uma
máscara de rede de 255.255.255.255), a rota de rede de loopback (rotas com um destino de
127.0.0.0.0 e uma máscara de rede de 255.0.0.0) ou uma rota multicast (rotas com um destino de
224.0.0.0 e uma máscara de rede de 240.0.0.0). Se for usada em conjunto com um dos comandos
(como add, change ou delete), a tabela será limpa antes de executar o comando.

/p Quando usada com o comando add, a rota especificada é adicionada ao registro e é usada para
inicializar a tabela de roteamento de IP sempre que o protocolo TCP/IP é iniciado. Por padrão, as
rotas adicionadas não são preservadas quando o protocolo TCP/IP é iniciado. Quando usada com o
comando print, a lista de rotas persistentes é exibida. Esse parâmetro é ignorado para todos os
outros comandos. As rotas persistentes são armazenadas no local do registro
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters\PersistentRoutes.

<command> Especifica o comando que você deseja executar. Os comandos válidos incluem:
add – adiciona uma rota.
change – modifica uma rota existente.
delete: – exclui uma rota ou rotas.
print – imprime uma rota ou rotas.
Parâmetro Descrição

<destination> Especifica o destino de rede da rota. O destino pode ser um endereço de rede IP (em que os bits de
host do endereço de rede são definidos como 0), um endereço IP para uma rota de host ou 0.0.0.0
para a rota padrão.

<mask> Especifica o próximo parâmetro para o valor 'netmask'.

<netmask> Especifica o destino de rede da máscara de sub-rede. Se não for especificado, o padrão será
255.255.255.255.

<gateway> Especifica o endereço IP de encaminhamento ou do próximo salto sobre o qual o conjunto de


endereços definido pelo destino de rede e pela máscara de sub-rede está acessível. Para rotas de
sub-rede anexadas localmente, o endereço do gateway é o endereço IP atribuído à interface
anexada à sub-rede. Para rotas remotas, disponíveis em um ou mais roteadores, o endereço do
gateway é um endereço IP diretamente acessível atribuído a um roteador vizinho.

metric Especifica uma métrica de custo inteiro (variando de 1 a 9999) para a rota, que é usada ao escolher
<metric> entre várias rotas na tabela de roteamento que mais correspondem ao endereço de destino de um
pacote que está sendo encaminhado. A rota com a métrica mais baixa é escolhida. A métrica pode
refletir o número de saltos, a velocidade do caminho, a confiabilidade do caminho, a taxa de
transferência do caminho ou as propriedades administrativas.

if <interface> Especifica o índice de interface para a interface na qual o destino pode ser acessado. Para obter
uma lista de interfaces e seus índices de interface correspondentes, use a exibição do comando
route print. Você pode usar valores decimais ou hexadecimais para o índice de interface. Para
valores hexadecimais, preceda o número hexadecimal com 0x. Quando o parâmetro if é omitido, a
interface é determinada a partir do endereço do gateway.

/? Exibe a ajuda no prompt de comando.

Comentários

Valores grandes na coluna de métrica da tabela de roteamento são resultado da permissão


de TCP/IP para determinar automaticamente a métrica para rotas na tabela de roteamento
com base na configuração do endereço IP, da máscara de sub-rede e do gateway padrão
para cada interface LAN. A determinação automática da métrica de interface, habilitada por
padrão, determina a velocidade de cada interface e ajusta as métricas de rotas para cada
interface para que a interface mais rápida crie as rotas com a métrica mais baixa. Para
remover as métricas grandes, desabilite a determinação automática da métrica de interface
das propriedades avançadas do protocolo TCP/IP para cada conexão LAN.

Os nomes poderão ser usados para o destino se houver uma entrada apropriada no arquivo
local Redes armazenado na pasta systemroot\System32\Drivers\\ . Nomes podem ser usados
para o gateway, desde que possam ser resolvidos para um endereço IP por meio de técnicas
de resolução de nome de host padrão, como consultas DNS (Sistema de Nomes de
Domínio), uso do arquivo Hosts local armazenado na pasta systemroot\system32\drivers\\
e resolução de nomes NetBIOS.

Se o comando for print ou delete, o parâmetro de gateway poderá ser omitido e caracteres
curinga poderão ser usados para o destino e o gateway. O valor de destino pode ser um
valor curinga especificado por um asterisco (*) . Se o destino especificado contiver um
asterisco (*) ou um ponto de interrogação (?), ele será tratado como um curinga e somente
as rotas de destino correspondentes serão impressas ou excluídas. O asterisco corresponde
a qualquer cadeia de caracteres e o ponto de interrogação corresponde a um único
caractere. Por exemplo, 10.\*.1, 192.168.\* , 127.\* e \*224\* são todos usos válidos do
curinga asterisco.

O uso de uma combinação sem suporte de um valor de máscara de destino e sub-rede


(máscara de rede) exibe a mensagem de erro "Rota: máscara de rede de endereço de
gateway inválido". Essa mensagem de erro aparece quando o destino contém um ou mais
bits definidos como 1 em locais de bits em que o bit de máscara de sub-rede
correspondente é definido como 0. Para testar essa condição, expresse o destino e a
máscara de sub-rede usando notação binária. A máscara de sub-rede na notação binária
consiste em uma série de bits 1, representando a parte do endereço de rede do destino, e
uma série de bits 0, representando a parte do endereço do host do destino. Verifique se há
bits no destino definidos como 1 para a parte do destino que é o endereço do host
(conforme definido pela máscara de sub-rede).

Exemplos
Para exibir todo o conteúdo da tabela de roteamento de IP, digite:

Prompt de comando do Windows

route print

Para exibir as rotas na tabela de roteamento de IP que começam com 10, digite:

Prompt de comando do Windows

route print 10.*

Para adicionar uma rota padrão com o endereço de gateway padrão de 192.168.12.1, digite:

Prompt de comando do Windows

route add 0.0.0.0 mask 0.0.0.0 192.168.12.1

Para adicionar uma rota ao destino 10.41.0.0 com a máscara de sub-rede 255.255.0.0 e o
endereço do próximo salto de 10.27.0.1, digite:

Prompt de comando do Windows

route add 10.41.0.0 mask 255.255.0.0 10.27.0.1


Para adicionar uma rota persistente ao destino 10.41.0.0 com a máscara de sub-rede 255.255.0.0 e
o endereço do próximo salto de 10.27.0.1, digite:

Prompt de comando do Windows

route /p add 10.41.0.0 mask 255.255.0.0 10.27.0.1

Para adicionar uma rota ao destino 10.41.0.0 com a máscara de sub-rede 255.255.0.0, o endereço
do próximo salto de 10.27.0.1 e a métrica de custo 7, digite:

Prompt de comando do Windows

route add 10.41.0.0 mask 255.255.0.0 10.27.0.1 metric 7

Para adicionar uma rota ao destino 10.41.0.0 com a máscara de sub-rede 255.255.0.0, o endereço
do próximo salto de 10.27.0.1 e usar o índice de interface 0x3, digite:

Prompt de comando do Windows

route add 10.41.0.0 mask 255.255.0.0 10.27.0.1 if 0x3

Para excluir a rota para o destino 10.41.0.0 com a máscara de sub-rede 255.255.0.0, digite:

Prompt de comando do Windows

route delete 10.41.0.0 mask 255.255.0.0

Para excluir todas as rotas na tabela de roteamento de IP que começam com 10, digite:

Prompt de comando do Windows

route delete 10.*

Para alterar o endereço do próximo salto da rota com o destino de 10.41.0.0 e a máscara de sub-
rede de 255.255.0.0 de 10.27.0.1 para 10.27.0.25, digite:

Prompt de comando do Windows

route change 10.41.0.0 mask 255.255.0.0 10.27.0.25

Links relacionados
Chave da sintaxe de linha de comando
rpcinfo
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Lista os programas nos computadores remotos. O utilitário de linha de comando


rpcinfo faz uma RPC (chamada de procedimento remoto) para um servidor RPC e relata
o que ele encontra.

Sintaxe

rpcinfo [/p [<node>]] [/b <program version>] [/t <node program> [<version>]]
[/u <node program> [<version>]]

Parâmetros

Parâmetro Descrição

/p lista todos os programas registrados com o mapeador de portas no host


[<node>] especificado. Se você não especificar um nome de nó (computador), o programa
consultará o mapeador de portas no host local.

/b Solicita uma resposta de todos os nós de rede que têm o programa e a versão
<program especificados registrados com o mapeador de portas. Você deve especificar um
version> nome ou número do programa e um número de versão.

/t <node Usa o protocolo de transporte TCP para chamar o programa especificado. Você deve
program> especificar um nome de nó (computador) e um nome de programa. Se você não
[\ especificar uma versão, o programa chamará todas as versões.
<version>]

/u <node Usa o protocolo de transporte UDP para chamar o programa especificado. Você
program> deve especificar um nome de nó (computador) e um nome de programa. Se você
[\ não especificar uma versão, o programa chamará todas as versões.
<version>]

/? Exibe a ajuda no prompt de comando.


Exemplos
Para listar todos os programas registrados com o mapeador de portas, digite:

rpcinfo /p [<node>]

Para solicitar uma resposta de nós de rede que tenham um programa especificado,
digite:

rpcinfo /b <program version>

Para usar o Protocolo TCP para chamar um programa, digite:

rpcinfo /t <node program> [<version>]

Use o Protocolo UDP para chamar um programa:

rpcinfo /u <node program> [<version>]

Links relacionados
Chave da sintaxe de linha de comando
rpcping
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Confirma a conectividade RPC entre o computador que executa o Microsoft Exchange


Server e qualquer uma das estações de trabalho Cliente do Microsoft Exchange com
suporte na rede. Esse utilitário pode ser usado para verificar se os serviços do Microsoft
Exchange Server estão respondendo às solicitações RPC das estações de trabalho cliente
por meio da rede.

Sintaxe

rpcping [/t <protseq>] [/s <server_addr>] [/e <endpoint>


|/f <interface UUID>[,majorver]] [/O <interface object UUID]
[/i <#_iterations>] [/u <security_package_id>] [/a <authn_level>]
[/N <server_princ_name>] [/I <auth_identity>] [/C <capabilities>]
[/T <identity_tracking>] [/M <impersonation_type>]
[/S <server_sid>] [/P <proxy_auth_identity>] [/F <RPCHTTP_flags>]
[/H <RPC/HTTP_authn_schemes>] [/o <binding_options>]
[/B <server_certificate_subject>] [/b] [/E] [/q] [/c]
[/A <http_proxy_auth_identity>] [/U <HTTP_proxy_authn_schemes>]
[/r <report_results_interval>] [/v <verbose_level>] [/d]

Parâmetros

Parâmetro Descrição

/t <protseq> Especifica a sequência de protocolos a ser usada. Pode ser uma


das sequências de protocolos RPC padrão: ncacn_ip_tcp,
ncacn_np ou ncacn_http.
Se não for especificado, o padrão será ncacn_ip_tcp.

/s <server_addr> Especifica o endereço do servidor. Se não for especificado, o


computador local será executado em ping.

/e <endpoint> Especifica o ponto de extremidade que receberá ping. Se


nenhum for especificado, o mapeador de ponto de extremidade
no computador de destino terá ping executado.
Essa opção e a opção interface (/f) se excluem mutuamente.
Parâmetro Descrição

/o <binding_options> Especifica as opções de associação para o ping de RPC.

/f <interface UUID> Especifica a interface a receber ping. Essa opção e a opção de


[,Majorver] ponto de extremidade são mutuamente excludentes. A interface
é especificada como uma UUID.
Se majorver não for especificado, a versão 1 da interface será
procurada.

Quando a interface for especificada, rpcping consultará o


mapeador do ponto de extremidade no computador de destino
para recuperar o ponto de extremidade da interface
especificada. O mapeador de ponto de extremidade será
consultado usando as opções especificadas na linha de
comando.

/O <object UUID> Especifica o objeto UUID se a interface tiver registrado algum.

/i <#_iterations> Especifica o número de chamadas a serem feitas. O padrão é 1.


Essa opção será útil para medir a latência da conexão se várias
iterações forem especificadas.

/u <security_package_id> Especifica o RPC do pacote de segurança (provedor de


segurança) que será usado para fazer a chamada. O pacote de
segurança é identificado como um número ou um nome. Se um
número for usado, ele será o mesmo número da API
RpcBindingSetAuthInfoEx. Se você especificar essa opção,
precisará especificar um nível de autenticação diferente de
nenhum. Não há nenhum padrão para essa opção. Se não for
especificado, o RPC não usará a segurança no ping. A lista
abaixo mostra os nomes e números. Os nomes não diferenciam
maiúsculas de minúsculas:

Negociar/9 ou um de nego, snego ou negtotiate


NTLM/10 ou NTLM
SChannel/14 ou SChannel
Kerberos/16 ou Kerberos
Kernel/20 ou Kernel
Parâmetro Descrição

/a <authn_level> Especifica o nível de autenticação a ser usado. Se essa opção for


especificada, a ID do pacote de segurança (/u) também precisará
ser especificada. Se essa opção não for especificada, o RPC não
usará a segurança no ping. Não há nenhum padrão para essa
opção. Os valores possíveis são:

conectar
chamada
pkt
integridade
privacidade

/N <server_princ_name> Especifica um nome de entidade de segurança do servidor.


Esse campo só pode ser usado quando o nível de autenticação e
o pacote de segurança são selecionados.

/I <auth_identity> Permite que você especifique uma identidade alternativa para se


conectar ao servidor. A identidade está no formato usuário,
domínio, senha. Se o nome de usuário, domínio ou senha tiver
caracteres especiais que podem ser interpretados pelo shell,
coloque a identidade entre aspas duplas. Você pode especificar
\* em vez da senha, e o RPC solicitará que você insira a senha
sem ecoá-la na tela. Se esse campo não for especificado, a
identidade do usuário conectado será usada.

Esse campo só pode ser usado quando o nível de autenticação e


o pacote de segurança são selecionados.

/C <capabilities> Especifica uma máscara de bits hexadecimal de sinalizadores.


Esse campo só pode ser usado quando o nível de autenticação e
o pacote de segurança são selecionados.

/T <identity_tracking> Especifica estático ou dinâmico. Se não for especificado,


dinâmico será o padrão.
Esse campo só pode ser usado quando o nível de autenticação e
o pacote de segurança são selecionados.

/M <impersonation_type> Especifica anônimo, identificar, representar ou delegar. O padrão


é representar.
Esse campo só pode ser usado quando o nível de autenticação e
o pacote de segurança são selecionados.

/S <server_sid> Especifica o SID esperado do servidor.


Esse campo só pode ser usado quando o nível de autenticação e
o pacote de segurança são selecionados.
Parâmetro Descrição

/P <proxy_auth_identity> Especifica a identidade com a qual se autenticar no proxy


RPC/HTTP. Tem o mesmo formato da opção /I. Você precisará
especificar pacote de segurança (/u), nível de autenticação (/a) e
esquemas de autenticação (/H) para usar essa opção.

/F <RPCHTTP_flags> Especifica os sinalizadores a serem transmitidos para a


autenticação de front-end RPC/HTTP. Os sinalizadores podem
ser especificados como números ou nomes Os sinalizadores
reconhecidos no momento são:
Usar SSL/1 ou ssl ou use_ssl
Usar o primeiro esquema de autenticação/ 2 ou first ou
use_first

Você precisa especificar o pacote de segurança (/u) e o nível de


autenticação (/a) para usar essa opção.

/H <RPC/HTTP_authn_schemes> Especifica os esquemas de autenticação a serem usados para


autenticação de front-end RPC/HTTP. Essa opção é uma lista de
valores numéricos ou nomes separados por vírgula. Exemplo:
Básico,NTLM. Os valores reconhecidos são (os nomes não
diferenciam maiúsculas de minúsculas):
Básico/1 ou Básico
NTLM/2 ou NTLM
Certificado/65536 ou Cert

Você precisa especificar o pacote de segurança (/u) e o nível de


autenticação (/a) para usar essa opção.

/B Especifica a entidade do certificado do servidor. Você precisa


<server_certificate_subject> usar o SSL para que essa opção funcione.
Você precisa especificar o pacote de segurança (/u) e o nível de
autenticação (/a) para usar essa opção.

/b Recupera o titular do certificado do servidor do certificado


enviado pelo servidor e o imprime em uma tela ou em um
arquivo de log. Válido somente quando a opção Somente eco de
proxy (/E) e as opções de SSL de uso são especificadas.
Você precisa especificar o pacote de segurança (/u) e o nível de
autenticação (/a) para usar essa opção.

/R Especifica o proxy HTTP. Se nenhum, o proxy RPC será usado. O


valor padrão significa usar as configurações do IE no
computador cliente. Qualquer outro valor será tratado como o
proxy HTTP explícito. Se você não especificar esse sinalizador, o
valor padrão será assumido, ou seja, as configurações do IE
serão verificadas. Esse sinalizador só é válido quando o
sinalizador /E (somente eco) está habilitado.
Parâmetro Descrição

/E Restringe o ping somente ao proxy RPC/HTTP. O ping não chega


ao servidor. Útil ao tentar estabelecer se o proxy RPC/HTTP está
acessível. Para especificar um proxy HTTP, use o sinalizador /R.
Se um proxy HTTP for especificado no sinalizador /o, essa opção
será ignorada.
Você precisa especificar o pacote de segurança (/u) e o nível de
autenticação (/a) para usar essa opção.

/q Especifica o modo silencioso. Não emite nenhum prompt, exceto


senhas. Pressupõe a resposta Y para todas as consultas. Use essa
opção com cuidado.

/c Use o certificado de cartão inteligente. rpcping solicitará que o


usuário escolha o cartão inteligente.

/A Especifica a identidade com a qual autenticar no proxy HTTP.


Tem o mesmo formato da opção /I.
Você precisará especificar esquemas de autenticação (/U), pacote
de segurança (/u) e nível de autenticação (/a) para usar essa
opção.

/U Especifica os esquemas de autenticação a serem usados na


autenticação de proxy HTTP. Essa opção é uma lista de valores
numéricos ou nomes separados por vírgula. Exemplo:
Básico,NTLM. Os valores reconhecidos são (os nomes não
diferenciam maiúsculas de minúsculas):
Básico/1 ou Básico
NTLM/2 ou NTLM

Você precisa especificar o pacote de segurança (/u) e o nível de


autenticação (/a) para usar essa opção.

/r Se várias iterações forem especificadas, essa opção fará com que


rpcping exiba periodicamente as estatísticas de execução atuais
após a última chamada. O intervalo de relatório é dado em
segundos. O padrão é 15.

/v Informa a rpcping quão detalhada deve ser a saída. O valor


padrão é 1. 2 e 3 fornecem mais saída de rpcping.

/d Inicia a interface do usuário de diagnóstico de rede RPC.

/p Especifica a solicitação de credenciais se a autenticação falhar.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para descobrir se o Exchange Server que você conecta por meio de RPC/HTTP está
acessível, digite:

rpcping /t ncacn_http /s exchange_server /o RpcProxy=front_end_proxy /P


username,domain,* /H Basic /u NTLM /a connect /F 3

Links relacionados
Chave da sintaxe de linha de comando
rsh
Artigo • 11/04/2023

Executa comandos em computadores remotos que rodam o serviço RSH ou o daemon.

) Importante

O comando rexec foi preterido e não há garantia de que tenha suporte no


Windows.

Depois de instalar o subsistema para os aplicativos baseados em UNIX, você pode abrir
uma janela de comando do Shell C ou do Korn Shell e executar rsh. Para obter mais
informações, digite man rsh no prompt do Shell C ou do Korn Shell.
rundll32
Artigo • 11/04/2023

Carrega e executa DLLs (bibliotecas de link dinâmico) de 32 bits. Não há definições


configuráveis para Rundll32. As informações de ajuda são fornecidas para uma DLL
específica que você executa com o comando rundll32.

Você deve executar o comando rundll32 em um prompt de comando com privilégios


elevados. Para abrir um prompt de comandos com privilégios elevados, clique em
Iniciar, clique com o botão direito em Prompt de Comando, em seguida, clique em
Executar como administrador.

Sintaxe

rundll32 <DLLname>

Parâmetros

Parâmetro Descrição

Rundll32 printui.dll,PrintUIEntry Exibe a interface de usuário da impressora.

Comentários
Rundll32 só pode chamar as funções de uma DLL gravada explicitamente para ser
chamada por Rundll32.

Links relacionados
Chave da sintaxe de linha de comando
rundll32 printui.dll,PrintUIEntry
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Automatiza muitas tarefas de configuração de impressora. printui.dll é o arquivo


executável que contém as funções usadas pelas caixas de diálogo de configuração da
impressora. Essas funções também podem ser chamadas de dentro de um script ou de
um arquivo em lotes de linha de comando ou podem ser executadas interativamente no
prompt de comando.

Syntax

rundll32 printui.dll PrintUIEntry [baseparameter] [modificationparameter1]


[modificationparameter2] [modificationparameterN]

Você também pode usar as seguintes sintaxes alternativas, embora os exemplos neste
tópico usem a sintaxe anterior:

rundll32 printui.dll,PrintUIEntry [baseparameter] [modificationparameter1]


[modificationparameter2] [ModificationParameterN]

rundll32 printui PrintUIEntry [baseparameter] [modificationparameter1]


[modificationparameter2] [modificationparameterN]

rundll32 printui,PrintUIEntry [baseparameter] [modificationparameter1]


[modificationparameter2] [modificationparameterN]

Parâmetros
Há dois tipos de parâmetros: parâmetros base e parâmetros de modificação. Os
parâmetros base especificam a função que o comando deve executar. Somente um
desses parâmetros pode aparecer em uma determinada linha de comando. Em seguida,
você poderá modificar o parâmetro base usando um ou mais dos parâmetros de
modificação se eles forem aplicáveis ao parâmetro base (nem todos os parâmetros de
modificação têm suporte de todos os parâmetros base).

Parâmetros Descrição
base

/dl Exclui a impressora local.

/dn Exclui uma conexão de impressora de rede.

/dd Exclui um driver de impressora.

/e Exibe as preferências de impressão de uma determinada impressora.

/ga adiciona uma conexão por impressora de computador (a conexão está disponível
para qualquer usuário nesse computador quando ele faz logon).

/ge Exibe conexões de impressora por computador em um computador.

/gd Exclui uma conexão de impressora por computador (a conexão é excluída na


próxima vez que um usuário fizer logon).

/ia Instala um driver de impressora usando um arquivo .inf.

/id Instala o driver de impressora usando o assistente para adicionar driver de


impressora.

/if Instala uma impressora usando um arquivo .inf.

/ii Instala uma impressora usando o assistente adicionar impressora com um arquivo
.inf.

/il Instala uma impressora usando o assistente de adicionar impressora.

/in Conecta-se a uma impressora de rede remota.

/ip Instala uma impressora usando o Assistente de Instalação da impressora de rede


(disponível na interface do usuário do Gerenciamento de Impressão).

/k imprime uma página de teste em uma impressora.

/o Exibe a fila de uma impressora.

/p Exibe as propriedades de uma impressora. Ao usar esse parâmetro, você também


deve especificar um valor para o parâmetro de modificação /n[name].
Parâmetros Descrição
base

/s Exibe as propriedades de um servidor de impressão. Se você quiser exibir o


servidor de impressão local, não precisará usar um parâmetro de modificação. No
entanto, se você quiser exibir um servidor de impressão remoto, deverá especificar
o parâmetro de modificação /c[name].

/Ss Especifica que tipo de informação para uma impressora será armazenada. Se
nenhum dos valores de /Ss for especificado, o comportamento padrão será como
se todos eles fossem especificados. Use esse parâmetro base com os seguintes
valores colocados no final da linha de comando:

2: armazena as informações contidas na estrutura de printER_INFO_2 da


impressora. Essa estrutura contém as informações básicas sobre a
impressora, como seu nome, nome do servidor, nome da porta e nome do
compartilhamento.
7: usado para armazenar as informações do serviço de diretório contidas na
estrutura printER_INFO_7.
c: armazena as informações de perfil de cor de uma impressora.
d: armazena dados específicos da impressora, como a ID de hardware da
impressora.
s: armazena o descritor de segurança da impressora.
g: armazena as informações na estrutura GLOBAL DEVmode da impressora.
m: armazena as configurações mínimas para a impressora. Isso é equivalente
a especificar 2d e g.
u: armazena as informações na estrutura DEVmode da impressora por
usuário.
Parâmetros Descrição
base

/Sr Especifica quais informações sobre uma impressora são restauradas e como os
conflitos nas configurações são tratados. Use com os seguintes valores colocados
no final da linha de comando:
2: amazena as informações contidas na estrutura de printER_INFO_2 da
impressora. Essa estrutura contém as informações básicas sobre a
impressora, como seu nome, nome do servidor, nome da porta e nome do
compartilhamento.
7: usado para armazenar as informações do serviço de diretório contidas na
estrutura printER_INFO_7.
c: restaura informações de perfil de cor de uma impressora.
d: restaura dados específicos da impressora, como a ID de hardware da
impressora.
s: restaura o descritor de segurança da impressora.
g: restaura as informações na estrutura GLOBAL DEVmode da impressora.
m: restaura as configurações mínimas para a impressora. Isso é equivalente a
especificar 2, d e g.
u: restaura as informações na estrutura DEVmode da impressora por usuário.
r: se o nome da impressora armazenado no arquivo for diferente do nome
da impressora que está sendo restaurada, use o nome da impressora atual.
Não pode ser especificado com f. Se nem r nem f forem especificados, e os
nomes não corresponderem, a restauração das configurações falhará.
f: se o nome da impressora armazenado no arquivo for diferente do nome
da impressora que está sendo restaurada, use o nome da impressora no
arquivo. Isso não pode ser especificado com r. Se nem f nem r forem
especificados e os nomes não corresponderem, a restauração das
configurações falhará.
p: se o nome da porta no arquivo do qual está sendo restaurado não
corresponder ao nome da porta atual da impressora que está sendo
restaurada, o nome da porta atual da impressora será usado.
h: Se a impressora que está sendo restaurada para não pôde ser
compartilhada usando o nome do compartilhamento de recursos no arquivo
de configurações salvas, tente compartilhar a impressora com o nome do
compartilhamento atual ou um novo nome de compartilhamento gerado se
nem H nem h forem especificados e a impressora que está sendo restaurada
para não puder ser compartilhada com o nome do compartilhamento salvo,
em seguida, a restauração falha.
h: se a impressora que está sendo restaurada para não puder ser
compartilhada com o nome do compartilhamento salvo, não compartilhe a
impressora. Se nem H nem h forem especificados e a impressora a ser
restaurada não puder ser compartilhada com o nome do compartilhamento
salvo, a restauração falhará.
i: se o driver no arquivo de configurações salvo não corresponder ao driver
para o qual a impressora está sendo restaurada, a restauração falhará.

/Xg Recupera as configurações de uma impressora.


Parâmetros Descrição
base

/Xs Define as configurações de uma impressora.

/y Define a impressora que está sendo instalada como a impressora padrão.

/? Exibe a ajuda no produto para o comando e seus parâmetros associados.

@[file] Especifica um arquivo de argumento de linha de comando e insere diretamente o


texto nesse arquivo na linha de comando.

Parâmetros Descrição
de
modificação

/a[file] Especifica o nome do arquivo binário.

/b[name] Especifica o nome da impressora base.

/c[name] Especifica o nome do computador se a ação a ser executada estiver em um


computador remoto.

/f[file] Espécie o caminho UNC (Convenção Universal de Nomenclatura) e o nome do


nome do arquivo .inf ou o nome do arquivo de saída, dependendo da tarefa
que você está executando. Use /F[file] para especificar um arquivo .inf
dependente.

/F[file] Especifica o caminho UNC e o nome de um arquivo .inf do qual o arquivo .inf
especificado com /f[file] depende.

/h[architecture] Especifica a arquitetura do driver. Use um dos seguintes: x86, x64 ou Itanium.

/j[provider] Especifica o nome do provedor de impressão.

/l[path] Especifica o caminho UNC em que os arquivos de driver de impressora que


você está usando estão localizados.

/m[model] Especifica o nome do modelo de driver. (Esse valor pode ser especificado no
arquivo .inf.)

/n[name] Especifica o nome da impressora.

/q Executa o comando sem notificações para o usuário.

/r[port] Especifica o nome da porta.

/u Especifica o uso do driver de impressora existente se ele já estiver instalado.

/t[#] Especifica a página de índice baseada em zero a ser iniciada.


Parâmetros Descrição
de
modificação

/v[version] Especifica a versão do driver. Se você também não especificar um valor para /K,
deverá especificar um dos seguintes valores: tipo 2 – modo Kernel ou tipo 3 –
Modo de usuário.

/w solicitará ao usuário um driver se o driver não for encontrado no arquivo .inf


especificado por /f.

/Y Especifica que os nomes de impressora não devem ser gerados


automaticamente.

/z Especifica não compartilhar automaticamente a impressora que está sendo


instalada.

/K altera o significado do parâmetro /h[architecture] para aceitar 2 no lugar de


x86, 3 no lugar de x64 ou 4 no lugar de Itanium. Ele também altera o valor do
parâmetro /v[version] para aceitar 2 no lugar do tipo 2 – modo Kernel e 3 no
lugar do tipo 3 – modo de usuário.

/Z Compartilha a impressora que está sendo instalada. Use somente com o


parâmetro /if.

/Mw[message] Exibe uma mensagem de aviso para o usuário antes de confirmar as alterações
especificadas na linha de comando.

/Mq[message] Exibe uma mensagem de confirmação para o usuário antes de confirmar as


alterações especificadas na linha de comando.

/W[flags] Especifica quaisquer parâmetros ou opções para o assistente para adicionar


impressora, o Assistente para Adicionar Driver de Impressora e o Assistente de
Instalação da impressora de rede.
r: permite que os assistentes sejam reiniciados da última página.

/G[flags] Especifica parâmetros globais e opções que você deseja usar.


w: suprime avisos de driver de instalação para o usuário.

Comentários
A palavra-chave PrintUIEntry diferencia maiúsculas de minúsculas e você deve
inserir a sintaxe desse comando com a capitalização exata mostrada nos exemplos
deste tópico.

Para obter mais exemplos, em um tipo de prompt de comando: rundll32


printui.dll,PrintUIEntry /?
Exemplos
Para adicionar uma nova impressora remota, printer1, para um computador, Client1, que
é visível para a conta de usuário em que esse comando é executado, digite:

rundll32 printui.dll PrintUIEntry /in /n\\client1\printer1

Para adicionar uma impressora usando o assistente adicionar impressora e usando um


arquivo .inf, InfFile.inf, localizado na unidade c: em Infpath, digite:

rundll32 printui.dll PrintUIEntry /ii /f c:\Infpath\InfFile.inf

Para excluir uma impressora existente, printer1, em um computador, Client1, digite:

rundll32 printui.dll PrintUIEntry /dn /n\\client1\printer1

Para adicionar uma conexão de impressora por computador, printer2, para todos os
usuários de um computador, Client2, digite (a conexão será aplicada quando um usuário
fizer logon):

rundll32 printui.dll PrintUIEntry /ga /n\\client2\printer2

Para adicionar uma conexão de impressora por computador, printer2, para todos os
usuários de um computador, Client2, digite (a conexão será aplicada quando um usuário
fizer logon):

rundll32 printui.dll PrintUIEntry /gd /n\\client2\printer2

Para exibir as propriedades do servidor de impressão, printServer1, digite:

rundll32 printui.dll PrintUIEntry /s /t1 /c\\printserver1


Para exibir as propriedades de uma impressora, printer3, digite:

rundll32 printui.dll PrintUIEntry /p /n\\printer3

Links relacionados
rundll32

Referência aos comandos print


rwinsta
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Redefine (exclui) uma sessão em um servidor Host da Sessão da Área de Trabalho


Remota.

7 Observação

Esse comando é igual a comando reset session.

7 Observação

Para descobrir as novidades da última versão, veja Novidades nos Serviços de Área
de Trabalho Remota do Windows Server.

Links relacionados
reset session

Chave da sintaxe de linha de comando

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
san
Artigo • 10/05/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe ou define a política de SAN (rede de área de armazenamento) para o sistema


operacional. Se usado sem parâmetros, a política de SAN atual será exibida.

Sintaxe

san [policy={onlineAll | offlineAll | offlineShared}] [noerr]

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

policy= Define a política de SAN para o sistema operacional


{onlineAll|offlineAll|offlineShared}] inicializado no momento. A política de SAN determina se um
disco recém-descoberto está online ou permanece offline e
se ele se torna de leitura/gravação ou permanece somente
leitura. Quando um disco está offline, o layout do disco pode
ser lido, mas nenhum dispositivo de volume é exibido por
meio de Plug and Play. Quando offline, nenhum sistema de
arquivos pode ser montado no disco. Quando um disco está
online, um ou mais dispositivos de volume são instalados
para o disco. O seguinte parâmetro pode ser definido:
onlineAll. Especifica que todos os discos recém-
descobertos são colocados online e se tornam de
leitura/gravação. IMPORTANTE: especificar onlineAll
em um servidor que compartilha discos pode
corromper os dados. Portanto, você não deverá definir
essa política se os discos forem compartilhados entre
servidores, a menos que o servidor faça parte de um
cluster.
offlineAll. Especifica que todos os discos descobertos
recentemente, exceto o disco de inicialização, estão
offline e somente leitura por padrão.
offlineShared. Especifica que todos os discos recém-
descobertos que não residem em um barramento
compartilhado (como SCSI e iSCSI) são colocados
online e transformados em leitura/gravação. Os discos
que são deixados offline são somente leitura por
padrão.

Para obter mais informações, confira Enumeração do


VDS_san_POLICY.

noerr Usado somente para scripts. Quando um erro é encontrado,


o DiskPart continua a processar os comandos como se o erro
não tivesse ocorrido. Sem esse parâmetro, um erro faz com
que o DiskPart saia com um código de erro.

Exemplos
Para exibir a política atual, digite:

san
Para que todos os discos recém-descobertos, exceto o disco de inicialização, estejam
offline e sejam somente leitura por padrão, digite:

san policy=offlineAll

Links relacionados
Chave da sintaxe de linha de comando
sc.exe config
Artigo • 17/04/2023

Modifica o valor das entradas de um serviço no registro e no banco de dados do


Gerenciador de Controle de Serviço.

Sintaxe

sc.exe [<servername>] config [<servicename>] [type= {own | share | kernel |


filesys | rec | adapt | interact type= {own | share}}] [start= {boot |
system | auto | demand | disabled | delayed-auto}] [error= {normal | severe
| critical | ignore}] [binpath= <binarypathname>] [group= <loadordergroup>]
[tag= {yes | no}] [depend= <dependencies>] [obj= {<accountname> |
<objectname>}] [displayname= <displayname>] [password= <password>]

Parâmetros

Parâmetro Descrição

<servername> Especifica o nome do servidor remoto no qual o serviço está localizado. O


nome deve usar o formato UNC (Convenção de Nomenclatura Universal) (por
exemplo, \myserver). Para executar SC.exe localmente, não use esse
parâmetro.

<servicename> Especifica o nome do serviço retornado pela operação getkeyname.


Parâmetro Descrição

type= {own | Especifica o tipo de serviço. As opções incluem:


share | kernel | own: especifica um serviço que é executado em seu próprio processo.
filesys | rec | Ele não compartilha um arquivo executável com outros serviços. Esse é
adapt | interact o valor padrão.
type= {own | share: especifica um serviço que é executado como um processo
share}} compartilhado. Ele compartilha um arquivo executável com outros
serviços.
kernel: especifica um driver.
filesys: especifica um driver do sistema de arquivos.
rec: especifica um driver reconhecido pelo sistema de arquivos que
identifica os sistemas de arquivos usados no computador.
adapt: especifica um driver de adaptador que identifica dispositivos de
hardware, como teclados, mouses e unidades de disco.
interact: especifica um serviço que pode interagir com a área de
trabalho, recebendo as entradas dos usuários. Os serviços interativos
devem ser executados na conta LocalSystem. Esse tipo deve ser usado
em conjunto com type= own ou type= shared (por exemplo, type=
interacttype= own). Usar type= interact por si só gerará um erro.

start= {boot | Especifica o tipo de início para o serviço. As opções incluem:


system | auto | boot: especifica um driver de dispositivo carregado pelo carregador de
demand | disabled inicialização.
| delayed-auto} system: especifica um driver de dispositivo iniciado durante a
inicialização do kernel.
auto: especifica um serviço que é iniciado automaticamente sempre
que o computador é reiniciado e executado mesmo que ninguém faça
logon no computador.
demand: especifica um serviço que deve ser iniciado manualmente.
Esse será o valor padrão se start= não for especificado.
disabled: especifica um serviço que não pode ser iniciado. Para iniciar
um serviço desabilitado, altere o tipo de início para algum outro valor.
delayed-auto: especifica um serviço que é iniciado automaticamente
pouco tempo depois que outros serviços automáticos são iniciados.
Parâmetro Descrição

error= {normal | Especifica a gravidade do erro se o serviço não for iniciado quando o
severe | critical computador for iniciado. As opções incluem:
| ignore} normal: especifica que o erro é registrado e uma caixa de mensagem é
exibida, informando ao usuário que um serviço falhou ao iniciar. A
inicialização continuará. Essa é a configuração padrão.
grave: especifica que o erro é registrado (se possível). O computador
tenta reiniciar com a última configuração válida conhecida. Com isso,
talvez o computador possa ser reiniciado, mas o serviço ainda não ser
executado.
critical: especifica que o erro é registrado (se possível). O computador
tenta reiniciar com a última configuração válida conhecida. Se a última
configuração válida conhecida falhar, a inicialização também falhará e
o processo de inicialização será interrompido com um erro Parar.
ignore: especifica que o erro é registrado e a inicialização continua.
Nenhuma notificação é dada ao usuário além de registrar o erro no
Log de Eventos.

binpath= Especifica um caminho para o arquivo binário de serviço. Não há nenhum


<binarypathname> padrão para binpath=, e essa cadeia de caracteres deve ser fornecida.

Além disso, ntsd -d pode ser especificado na frente da cadeia de caracteres


para depuração. Para saber mais, confira Depurar usando CDB e NTSD.

group= Especifica o nome do grupo do qual esse serviço é membro. A lista de


<loadordergroup> grupos é armazenada no Registro, na subchave
HKLM\System\CurrentControlSet\Control\ServiceGroupOrder. O valor
padrão é nulo.

tag= {yes | no} Especifica se um TagID deve ou não ser obtido da chamada CreateService. As
marcas são usadas apenas para drivers de inicialização e inicialização do
sistema.

depend= Especifica os nomes de serviços ou grupos que devem ser iniciados antes
<dependencies> desse serviço. Os nomes são separados por barras (/).

obj= Especifica o nome de uma conta na qual um serviço será executado, ou


{<accountname> | especifica o nome do objeto de driver do Windows no qual o driver será
<objectname>} executado. A configuração padrão é LocalSystem.

displayname= Especifica um nome descritivo para identificar o serviço em programas de


<displayname> interface do usuário. Por exemplo, o nome da subchave de um serviço
específico é wuauserv, que tem um nome de exibição mais amigável de
Atualizações automáticas.

password= Especifica uma senha. Isso será necessário se uma conta diferente da conta
<password> LocalSystem for usada.
Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Comentários

Cada opção da linha de comando (parâmetro) deve incluir o sinal de igual como
parte do nome da opção.

Um espaço é necessário entre uma opção e seu valor (por exemplo, type= own. Se
o espaço for omitido, a operação falhará.

Exemplos
Para especificar um caminho binário para o serviço NewService, digite:

sc.exe config NewService binpath= c:\windows\system32\NewServ.exe

Links relacionados
Chave da sintaxe de linha de comando
sc.exe create
Artigo • 12/04/2023

Cria uma subchave e entradas para um serviço no registro e no banco de dados do


Service Control Manager.

Sintaxe

sc.exe [<servername>] create [<servicename>] [type= {own | share | kernel |


filesys | rec | interact type= {own | share}}] [start= {boot | system | auto
| demand | disabled | delayed-auto}] [error= {normal | severe | critical |
ignore}] [binpath= <binarypathname>] [group= <loadordergroup>] [tag= {yes |
no}] [depend= <dependencies>] [obj= {<accountname> | <objectname>}]
[displayname= <displayname>] [password= <password>]

Parâmetros

Parâmetro Descrição

<servername> Especifica o nome do servidor remoto no qual o serviço está localizado. O


nome deve usar o formato UNC (Convenção de Nomenclatura Universal) (por
exemplo, \myserver). Para executar SC.exe localmente, não use esse
parâmetro.

<servicename> Especifica o nome do serviço retornado pela operação getkeyname.

type= {own \| Especifica o tipo de serviço. As opções incluem:


share \| kernel own: especifica um serviço que é executado em seu próprio processo.
\| filesys \| Ele não compartilha um arquivo executável com outros serviços. Esse é
rec \| interact o valor padrão.
type= {own \| share: especifica um serviço que é executado como um processo
share}} compartilhado. Ele compartilha um arquivo executável com outros
serviços.
kernel: especifica um driver.
filesys: especifica um driver do sistema de arquivos.
rec: especifica um driver reconhecido pelo sistema de arquivos que
identifica os sistemas de arquivos usados no computador.
interact: especifica um serviço que pode interagir com a área de
trabalho, recebendo as entradas dos usuários. Os serviços interativos
devem ser executados na conta LocalSystem. Esse tipo deve ser usado
em conjunto com type= own ou type= shared (por exemplo, type=
interacttype= own). Usar type= interact por si só gerará um erro.
Parâmetro Descrição

start= {boot \| Especifica o tipo de início para o serviço. As opções incluem:


system \| auto boot: especifica um driver de dispositivo carregado pelo carregador de
\| demand \| inicialização.
disabled \| system: especifica um driver de dispositivo iniciado durante a
delayed-auto} inicialização do kernel.
auto: especifica um serviço que é iniciado automaticamente sempre
que o computador é reiniciado e executado mesmo que ninguém faça
logon no computador.
demand: especifica um serviço que deve ser iniciado manualmente.
Esse será o valor padrão se start= não for especificado.
disabled: especifica um serviço que não pode ser iniciado. Para iniciar
um serviço desabilitado, altere o tipo de início para algum outro valor.
delayed-auto: especifica um serviço que é iniciado automaticamente
pouco tempo depois que outros serviços automáticos são iniciados.

error= {normal Especifica a gravidade do erro se o serviço não for iniciado quando o
\| severe \| computador for iniciado. As opções incluem:
critical \| normal: especifica que o erro é registrado e uma caixa de mensagem é
ignore} exibida, informando ao usuário que um serviço falhou ao iniciar. A
inicialização continuará. Essa é a configuração padrão.
grave: especifica que o erro é registrado (se possível). O computador
tenta reiniciar com a última configuração válida conhecida. Com isso,
talvez o computador possa ser reiniciado, mas o serviço ainda não ser
executado.
critical: especifica que o erro é registrado (se possível). O computador
tenta reiniciar com a última configuração válida conhecida. Se a última
configuração válida conhecida falhar, a inicialização também falhará e o
processo de inicialização será interrompido com um erro Parar.
ignore: especifica que o erro é registrado e a inicialização continua.
Nenhuma notificação é dada ao usuário além de registrar o erro no
Log de Eventos.

binpath= Especifica um caminho para o arquivo binário de serviço. Não há nenhum


<binarypathname> padrão para binpath=, e essa cadeia de caracteres deve ser fornecida.

group= Especifica o nome do grupo do qual esse serviço é membro. A lista de grupos
<loadordergroup> é armazenada no Registro, na subchave
HKLM\System\CurrentControlSet\Control\ServiceGroupOrder. O valor
padrão é nulo.

tag= {yes \| no} Especifica se um TagID deve ou não ser obtido da chamada CreateService. As
marcas são usadas apenas para drivers de inicialização e inicialização do
sistema.

depend= Especifica os nomes de serviços ou grupos que devem ser iniciados antes
<dependencies> desse serviço. Os nomes são separados por barras (/).
Parâmetro Descrição

obj= Especifica o nome de uma conta na qual um serviço será executado, ou


{<accountname> especifica o nome do objeto de driver do Windows no qual o driver será
\| <objectname>} executado. A configuração padrão é LocalSystem.

displayname= Especifica um nome amigável para identificar o serviço em programas de


<displayname> interface do usuário. Por exemplo, o nome da subchave de um serviço
específico é wuauserv, que tem um nome de exibição mais amigável de
Atualizações automáticas.

password= Especifica uma senha. Isso será necessário se uma conta diferente da conta
<password> LocalSystem for usada.

/? Exibe a ajuda no prompt de comando.

Comentários

Cada opção da linha de comando (parâmetro) deve incluir o sinal de igual como
parte do nome da opção.

Um espaço é necessário entre uma opção e seu valor (por exemplo, type= own. Se
o espaço for omitido, a operação falhará.

Exemplos
Para criar e registrar um caminho binário para o serviço NewService, digite:

sc.exe \\myserver create NewService binpath= c:\windows\system32\NewServ.exe

sc.exe create NewService binpath= c:\windows\system32\NewServ.exe type=


share start= auto depend= +TDI NetBIOS

Para saber mais sobre o comando sc.exe , confira Comandos SC.

Links relacionados
Chave da sintaxe de linha de comando
sc.exe delete
Artigo • 17/04/2023

Exclui uma subchave de serviço do Registro. Se o serviço estiver em execução ou se


outro processo tiver um identificador aberto para o serviço, o serviço será marcado para
exclusão.

7 Observação

Não recomendamos que você use esse comando para excluir serviços internos do
sistema operacional, como DHCP, DNS ou Serviços de Informações da Internet.
Para instalar, remover ou reconfigurar funções, serviços e componentes do sistema
operacional, confira Instalar ou desinstalar funções, serviços de função ou
recursos

Sintaxe

sc.exe [<servername>] delete [<servicename>]

Parâmetros

Parâmetro Descrição

<servername> Especifica o nome do servidor remoto no qual o serviço está localizado. O nome
deve usar o formato UNC (Convenção de Nomenclatura Universal) (por exemplo,
\myserver). Para executar SC.exe localmente, não use esse parâmetro.

<servicename> Especifica o nome do serviço retornado pela operação getkeyname.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para excluir a subchave de serviço NewServ do Registro no computador local, digite:

sc.exe delete NewServ


Links relacionados
Chave da sintaxe de linha de comando
Sc.exe query
Artigo • 11/04/2023

Obtém e exibe informações sobre o serviço, o driver, o tipo de serviço ou o tipo de


driver especificado.

Sintaxe

sc.exe [<servername>] query [<servicename>] [type= {driver | service | all}]


[type= {own | share | interact | kernel | filesys | rec | adapt}] [state=
{active | inactive | all}] [bufsize= <Buffersize>] [ri= <Resumeindex>]
[group= <groupname>]

Parâmetros

Parâmetro Descrição

<servername> Especifica o nome do servidor remoto no qual o serviço está localizado. O nome
deve usar o formato UNC (Convenção de Nomenclatura Universal) (por exemplo,
\myserver). Para executar SC.exe localmente, não use esse parâmetro.

<servicename> Especifica o nome do serviço retornado pela operação getkeyname. Esse


parâmetro query não é usado em conjunto com outros parâmetros query
(exceto servername).

type= {driver Especifica o que enumerar. As opções incluem:


| service | driver: especifica que apenas os drivers são enumerados.
all} service: especifica que somente os serviços são enumerados. Esse é o
valor padrão.
all: especifica que os drivers e os serviços são enumerados.
Parâmetro Descrição

type= {own | Especifica o tipo de serviços ou drivers a serem enumerados. As opções incluem:
share | own: especifica um serviço que é executado em seu próprio processo. Ele
interact | não compartilha um arquivo executável com outros serviços. Esse é o valor
kernel | padrão.
filesys | rec share: especifica um serviço que é executado como um processo
| adapt} compartilhado. Ele compartilha um arquivo executável com outros
serviços.
kernel: especifica um driver.
filesys: especifica um driver do sistema de arquivos.
rec: especifica um driver reconhecido pelo sistema de arquivos que
identifica os sistemas de arquivos usados no computador.
interact: especifica um serviço que pode interagir com a área de trabalho,
recebendo as entradas dos usuários. Os serviços interativos devem ser
executados na conta LocalSystem. Esse tipo deve ser usado em conjunto
com type= own ou type= shared (por exemplo, type= interacttype=
own). Usar type= interact por si só gerará um erro.

state= Especifica o estado iniciado do serviço a ser enumerado. As opções incluem:


{active | active: especifica todos os serviços ativos. Esse é o valor padrão.
inactive | inactive: especifica todos os serviços pausados ou interrompidos.
all} all: especifica todos os serviços.

bufsize= Especifica o tamanho (em bytes) do buffer de enumeração. O tamanho de buffer


<Buffersize> padrão é de 1.024 bytes. Você deve aumentar o tamanho do buffer quando a
exibição resultante de uma consulta ultrapassar os 1.024 bytes.

ri= Especifica o número de índice no qual a enumeração deve ser iniciada ou


<Resumeindex> retomada. O valor padrão é 0 (zero). Se mais informações forem retornadas do
que o buffer padrão pode exibir, use esse parâmetro com bufsize= .

group= Especifica o grupo de serviços a ser enumerado. Por padrão, todos os grupos
<Groupname> são enumerados. Por padrão, todos os grupos são enumerados (**group= **).

/? Exibe a ajuda no prompt de comando.

Comentários

Cada opção da linha de comando (parâmetro) deve incluir o sinal de igual como
parte do nome da opção.

Um espaço é necessário entre uma opção e seu valor (por exemplo, type= own. Se
o espaço for omitido, a operação falhará.
A operação query exibe as seguintes informações sobre um serviço:
SERVICE_NAME (nome da subchave de registro do serviço), TYPE, STATE (bem
como os estados indisponíveis), WIN32_EXIT_B, SERVICE_EXIT_B, CHECKPOINT e
WAIT_HINT.

O parâmetro type= pode ser usado duas vezes em alguns casos. A primeira
apresentação do parâmetro type= especifica se é para consultar os serviços, os
drivers ou ambos (all). A segunda apresentação do parâmetro type= especifica um
tipo da operação create para restringir ainda mais o escopo de uma consulta.

Quando os resultados da exibição de um comando query excedem o tamanho do


buffer de enumeração, uma mensagem semelhante à seguinte é exibida:

Enum: more data, need 1822 bytes start resume at index 79

To display the remaining **query** information, rerun **query**,


setting **bufsize=** to be the number of bytes and setting **ri=** to
the specified index. For example, the remaining output would be
displayed by typing the following at the command prompt:

sc.exe query bufsize= 1822 ri= 79

Exemplos
Para exibir informações somente para os serviços ativos, digite um dos seguintes
comandos:

sc.exe query
sc.exe query type= service

Para exibir informações para os serviços ativos e especificar um tamanho de buffer de


2.000 bytes, digite:

sc.exe query type= all bufsize= 2000

Para exibir informações para o serviço wuauserv, digite:


sc.exe query wuauserv

Para exibir informações para todos os serviços (ativos e inativos), digite:

sc.exe query state= all

Para exibir informações para todos os serviços (ativos e inativos), começando na linha
56, digite:

sc.exe query state= all ri= 56

Para exibir informações para os serviços interativos, digite:

sc.exe query type= service type= interact

Para exibir informações somente para os drivers, digite:

sc.exe query type= driver

Para exibir informações para os drivers no grupo NDIS (Especificação da Interface do


Driver de Rede), digite:

sc.exe query type= driver group= NDIS

Links relacionados
Chave da sintaxe de linha de comando
comandos schtasks
Artigo • 17/04/2023

Agenda comandos e programas a serem executados periodicamente ou em um


momento específico, adiciona e remove tarefas do agendamento, inicia e interrompe
tarefas sob demanda e exibe e altera tarefas agendadas.

7 Observação

A ferramenta schtasks.exe executa as mesmas operações que Tarefas Agendadas


no Painel de Controle. Você pode usar essas ferramentas em conjunto e
intercambiavelmente.

Permissões necessárias
Para agendar, exibir e alterar todas as tarefas no computador local, você deve ser
membro do grupo Administradores.

Para agendar, exibir e alterar todas as tarefas no computador remoto, você deve
ser membro do grupo Administradores no computador remoto ou usar o
parâmetro /u para fornecer as credenciais de um Administrador do computador
remoto.

Você pode usar o parâmetro /u em uma operação /create ou /change se os


computadores locais e remotos estiverem no mesmo domínio ou se o computador
local estiver em um domínio confiável para o domínio do computador remoto.
Caso contrário, o computador remoto não poderá autenticar a conta de usuário
especificada e não poderá verificar se a conta é membro do grupo
Administradores.

A tarefa que você planeja executar deve ter a permissão apropriada. Essas
permissões variam de acordo com a tarefa. Por padrão, as tarefas são executadas
com as permissões do usuário atual do computador local ou com as permissões
do usuário especificadas pelo parâmetro /u, se houver um incluído. Para executar
uma tarefa com permissões de uma conta de usuário diferente ou com permissões
do sistema, use o parâmetro /ru.

Sintaxe
schtasks /change
schtasks /create
schtasks /delete
schtasks /end
schtasks /query
schtasks /run

Parâmetros

Parâmetro Descrição

schtasks- Altera uma ou mais das seguintes propriedades de uma tarefa:


change O programa que a tarefa executa (/tr)
A conta de usuário na qual a tarefa é executada (/ru)
A senha da conta do usuário (/rp)
Adiciona a propriedade somente interativa à tarefa (/it)

schtasks- Agenda uma nova tarefa.


create

schtasks- Exclui uma tarefa agendada.


delete

schtasks- Interrompe um programa iniciado por uma tarefa.


end

schtasks- Exibe tarefas agendadas para execução no computador.


query

schtasks Inicia uma tarefa agendada imediatamente. A operação run ignora o agendamento,
run mas usa o local do arquivo do programa, a conta de usuário e a senha salvas na
tarefa para executar a tarefa imediatamente.

Links relacionados
Chave da sintaxe de linha de comando
schtasks change
Artigo • 12/04/2023

Altera uma ou mais das seguintes propriedades de uma tarefa:

O programa que a tarefa executa (/tr)

A conta de usuário na qual a tarefa é executada (/ru)

A senha da conta do usuário (/rp)

Adiciona a propriedade somente interativa à tarefa (/it)

Permissões necessárias
Para agendar, exibir e alterar todas as tarefas no computador local, você deve ser
membro do grupo Administradores.

Para agendar, exibir e alterar todas as tarefas no computador remoto, você deve
ser membro do grupo Administradores no computador remoto ou usar o
parâmetro /u para fornecer as credenciais de um Administrador do computador
remoto.

Você pode usar o parâmetro /u em uma operação /create ou /change se os


computadores locais e remotos estiverem no mesmo domínio ou se o computador
local estiver em um domínio confiável para o domínio do computador remoto.
Caso contrário, o computador remoto não poderá autenticar a conta de usuário
especificada e não poderá verificar se a conta é membro do grupo
Administradores.

A tarefa que você planeja executar deve ter a permissão apropriada. Essas
permissões variam de acordo com a tarefa. Por padrão, as tarefas são executadas
com as permissões do usuário atual do computador local ou com as permissões
do usuário especificadas pelo parâmetro /u, se houver um incluído. Para executar
uma tarefa com permissões de uma conta de usuário diferente ou com permissões
do sistema, use o parâmetro /ru.

Sintaxe
schtasks /change /tn <Taskname> [/s <computer> [/u [<domain>\]<user> [/p
<password>]]] [/ru <username>] [/rp <password>] [/tr <Taskrun>] [/st
<Starttime>] [/ri <interval>] [/rl <level>] [{/et <Endtime> | /du
<duration>} [/k]] [/sd <Startdate>] [/ed <Enddate>] [/{ENABLE | DISABLE}]
[/it] [/z]

Parâmetros

Parâmetro Descrição

/tn Identifica a tarefa a ser alterada. Insira o nome da tarefa (Observação: os nomes de
<Taskname> tarefa que têm um espaço em seu nome devem ser colocados entre aspas duplas).

/s Especifica o nome ou o endereço IP de um computador remoto (com ou sem


<computer> barras invertidas). O padrão é o computador local.

/u Executa esse comando com as permissões da conta de usuário especificada. Por


[<domain>] padrão, o comando é executado com as permissões do usuário atual do
computador local. A conta de usuário especificada deve ser um membro do grupo
Administradores no computador remoto. Os parâmetros /u e /p são válidos
somente quando você usa /s.

/p Especifica a senha da conta de usuário especificada no parâmetro /u. Se você usar


<password> o parâmetro /u sem o parâmetro /p ou o argumento de senha, o comando
schtasks solicitará uma senha. Os parâmetros /u e /p são válidos somente quando
você usa /s.

/ru Altera o nome de usuário no qual a tarefa agendada deve ser executada. Para a
<username> conta do sistema, os valores válidos são "", "NT AUTHORITY\SYSTEM" ou "SYSTEM".

/rp Especifica uma nova senha para a conta de usuário existente ou a conta de usuário
<password> especificada pelo parâmetro /ru. Esse parâmetro é ignorado quando usado com a
conta do sistema local.

/tr Altera o programa executado pela tarefa. Insira o caminho totalmente qualificado
<Taskrun> e o nome de um arquivo executável, um arquivo de script ou um arquivo em lote.
Se você não adicionar o caminho, o schtasks pressupõe que o arquivo esteja no
diretório <systemroot>\System32 . O programa especificado substitui o programa
original executado pela tarefa.

/st Especifica a hora de início da tarefa, usando o formato de 24 horas, HH:mm. Por
<Starttime> exemplo, um valor de 14:30 é equivalente a 2:30 PM no sistema horário de 12
horas.

/ri Especifica o intervalo de repetição em minutos para a tarefa agendada. O intervalo


<interval> válido é de 1 a 599940 (599940 minutos = 9999 horas). Se os parâmetros /et ou
/du forem especificados, o padrão será 10 minutos.
Parâmetro Descrição

/rl <level> Especifica o Nível de Execução para o trabalho. Os valores aceitáveis são LIMITED
(as tarefas agendadas serão executadas com o menor nível de privilégios, como
contas de Usuário Padrão) e HIGHEST (tarefas agendadas serão executadas com o
nível mais alto de privilégios, como contas de Superusuário). (Observação: LIMITED
é o valor padrão).

/et Especifica a hora de término da tarefa, usando o formato de 24 horas, HH:mm. Por
<Endtime> exemplo, um valor de 14:30 é equivalente a 2:30 PM no sistema horário de 12
horas.

/du Um valor que especifica a duração para executar a tarefa. O formato de hora é
<duration> HH:mm (24 horas). Por exemplo, um valor de 14:30 é equivalente a 2:30 PM no
sistema horário de 12 horas.

/k Interrompe o programa executado pela tarefa no momento especificado por /et


ou /du. Sem /k, o schtasks não inicia o programa novamente depois que ele atinge
o tempo especificado por /et ou /du, nem interrompe o programa se ele ainda
estiver em execução. Esse parâmetro é opcional e válido apenas com um
agendamento MINUTE ou HOURLY.

/sd Especifica a primeira data em que a tarefa deve ser executada. O formato de data é
<Startdate> MM/DD/AAAA.

/ed Especifica a última data em que a tarefa deve ser executada. O formato é
<Enddate> MM/DD/AAAA.

/ENABLE Especifica para habilitar a tarefa agendada.

/DISABLE Especifica para desabilitar a tarefa agendada.

/it Especifica a execução da tarefa agendada somente quando “executar como


usuário” (a conta de usuário na qual a tarefa é executada) estiver conectado ao
computador. Esse parâmetro não tem efeito em tarefas executadas com
permissões do sistema ou tarefas que já têm a propriedade somente interativa
definida. Você não pode usar um comando de alteração para remover a
propriedade somente interativa de uma tarefa. Por padrão, “executar como
usuário” é o usuário atual do computador local quando a tarefa é agendada ou a
conta especificada pelo parâmetro /u, se um for usado. No entanto, se o comando
incluir o parâmetro /ru, o “executar como usuário” será a conta especificada pelo
parâmetro /ru.

/z Especifica a exclusão da tarefa após a conclusão de seu agendamento.

/? Exibe a ajuda no prompt de comando.

Comentários
Os parâmetros /tn e /s identificam a tarefa. Os parâmetros /tr, /ru e /rp
especificam as propriedades da tarefa que você pode alterar.

Os parâmetros /ru e /rp especificam as permissões sob as quais a tarefa é


executada. Os parâmetros /u e /p especificam as permissões usadas para alterar a
tarefa.

Para alterar tarefas em um computador remoto, o usuário deve estar conectado ao


computador local com uma conta que seja membro do grupo Administradores no
computador remoto.

Para executar um comando /change com as permissões de um usuário diferente


(/u, /p), o computador local deve estar no mesmo domínio que o computador
remoto ou deve estar em um domínio de confiança do domínio do computador
remoto.

A conta do Sistema não tem direitos de logon interativo. Os usuários não veem e
não podem interagir com os programas executados com permissões do sistema.
Para identificar tarefas com a propriedade /it, use uma consulta detalhada (/query
/v). Em uma exibição de consulta detalhada de uma tarefa com /it, o campo Modo
de Logon tem um valor Somente interativo.

Exemplos
Para alterar o programa executado pela tarefa Verificação de Vírus de VirusCheck.exe
para VirusCheck2.exe, digite:

schtasks /change /tn Virus Check /tr C:\VirusCheck2.exe

Esse comando usa o parâmetro /tn para identificar a tarefa e o parâmetro /tr para
especificar o novo programa para a tarefa. (Não é possível alterar o nome da tarefa.)

Para alterar a senha da conta de usuário para a tarefa RemindMe no computador


remoto, Svr01, digite:

schtasks /change /tn RemindMe /s Svr01 /rp p@ssWord3

Esse procedimento é necessário sempre que a senha de uma conta de usuário expira ou
é alterada. Se a senha salva em uma tarefa não for mais válida, a tarefa não será
executada. O comando usa o parâmetro /tn para identificar a tarefa e o parâmetro /s
para especificar o computador remoto. Ele usa o parâmetro /rp para especificar a nova
senha, p@ssWord3.

Para alterar a tarefa chkNews, que inicia o Notepad.exe todas as manhãs às 9h, para
iniciar o Internet Explorer, digite:

schtasks /change /tn ChkNews /tr c:\program files\Internet


Explorer\iexplore.exe /ru DomainX\Admin01

O comando usa o parâmetro /tn para identificar a tarefa. Ele usa o parâmetro /tr para
alterar o programa executado pela tarefa e o parâmetro /ru para alterar a conta de
usuário na qual a tarefa é executada. Os parâmetros /ru e /rp, que fornecem a senha
para a conta de usuário, não são usados. Você deve fornecer uma senha para a conta,
mas pode usar o parâmetro /ru e /rp e digitar a senha em texto não criptografado ou
aguardar SchTasks.exe solicitar uma senha e inseri-la em texto oculto.

Para alterar a tarefa SecurityScript para que ela seja executada com permissões da conta
do Sistema, digite:

schtasks /change /tn SecurityScript /ru

O comando usa o parâmetro /ru para indicar a conta do Sistema. Como as tarefas
executadas com permissões de conta do sistema não exigem uma senha, SchTasks.exe
não solicita uma.

Para adicionar a propriedade somente interativa ao MyApp, uma tarefa existente, digite:

schtasks /change /tn MyApp /it

Essa propriedade garante que a tarefa seja executada somente quando o “executar
como usuário”, ou seja, a conta de usuário na qual a tarefa é executada, estiver
conectada ao computador. O comando usa o parâmetro /tn para identificar a tarefa e o
parâmetro /it para adicionar a propriedade somente interativa à tarefa. Como a tarefa já
é executada com as permissões da minha conta de usuário, você não precisa alterar o
parâmetro /ru para a tarefa.
Links relacionados
Chave da sintaxe de linha de comando

Comando schtasks create

Comando schtasks delete

Comando schtasks end

Comando schtasks query

Comando schtasks run


schtasks create
Artigo • 10/04/2023

Agenda uma tarefa.

Sintaxe

schtasks /create /sc <scheduletype> /tn <taskname> /tr <taskrun> [/s


<computer> [/u [<domain>\]<user> [/p <password>]]] [/ru {[<domain>\]<user> |
system}] [/rp <password>] [/mo <modifier>] [/d <day>[,<day>...] | *] [/m
<month>[,<month>...]] [/i <idletime>] [/st <starttime>] [/ri <interval>]
[/rl <level>] [{/et <endtime> | /du <duration>} [/k]] [/sd <startdate>] [/ed
<enddate>] [/it] [/np] [/z] [/f]

Parâmetros

Parâmetro Descrição

/sc <scheduletype> Especifica o tipo de agendamento. Os valores válidos incluem:


MINUTE – especifica o número de minutos antes da tarefa ser
executada.
HOURLY – especifica o número de horas antes da tarefa ser
executada.
DAILY – especifica o número de dias antes da tarefa ser executada.
WEEKLY – especifica o número de semanas antes da tarefa ser
executada.
MONTHLY – especifica o número de meses antes da tarefa ser
executada.
ONCE – especifica que essa tarefa seja executada uma vez em uma
data e hora especificadas.
ONSTART – especifica que a tarefa seja executada sempre que o
sistema for iniciado. Você pode especificar uma data de início ou
executar a tarefa na próxima vez em que o sistema for iniciado.
ONLOGON – especifica que a tarefa seja executada sempre que um
usuário (qualquer usuário) fizer logon. Você pode especificar uma
data ou executar a tarefa na próxima vez em que o usuário fizer
logon.
ONIDLE – especifica que a tarefa seja executada sempre que o
sistema estiver ocioso por um período especificado. Você pode
especificar uma data ou executar a tarefa na próxima vez em que o
sistema estiver ocioso.
Parâmetro Descrição

/tn <taskname> Especifica um nome para a tarefa. Cada tarefa no sistema precisa ter um
nome exclusivo e precisa estar em conformidade com as regras para nomes
de arquivo, sem ultrapassar 238 caracteres. Use aspas para incluir nomes
que incluem espaços. Para armazenar a tarefa agendada em uma pasta
diferente, execute /tn <folder name\task name> .

/tr <Taskrun> Especifica o programa ou o comando executado pela tarefa. Digite o


caminho totalmente qualificado e o nome de um arquivo executável,
arquivo de script ou arquivo de lote. O nome do caminho não pode
exceder 262 caracteres. Se você não adicionar o caminho, schtasks
presumirá que o arquivo esteja no diretório <systemroot>\System32 .

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (com ou


sem barras invertidas). O padrão é o computador local.

/u [<domain>] Executa esse comando com as permissões da conta de usuário


especificada. O padrão são as permissões do usuário atual do computador
local. Os parâmetros /u e /p são válidos somente quando você usa /s. As
permissões da conta especificada são usadas para agendar a para executar
a tarefa. Para executar a tarefa com as permissões de um usuário diferente,
use o parâmetro /ru. A conta de usuário precisa ser um membro do grupo
Administradores no computador remoto. Além disso, o computador local
precisa estar no mesmo domínio que o computador remoto ou precisa
estar em um domínio de confiança do domínio do computador remoto.

/p <password> Especifica a senha da conta de usuário especificada no parâmetro /u. Se


você usar o parâmetro /u sem o parâmetro /p ou o argumento de senha,
schtasks solicitará uma senha. Os parâmetros /u e /p são válidos somente
quando você usa /s.

/ru {[ <domain> ] Executa a tarefa com permissões da conta de usuário especificada. Por
<user> | system} padrão, a tarefa é executada com as permissões do usuário atual do
computador local ou com a permissão do usuário especificado pelo
parâmetro /u, se houver um incluído. O parâmetro /ru é válido ao agendar
tarefas em computadores locais ou remotos. As opções válidas incluem:

Domain – especifica uma conta de usuário alternativa.


System – especifica a conta do sistema local, uma conta com
privilégios elevados usada pelo sistema operacional e pelos serviços
do sistema.

/rp <password> Especifica a senha para a conta de usuário existente ou a conta de usuário
especificada pelo parâmetro /ru. Se você não usar esse parâmetro ao
especificar uma conta de usuário, SchTasks.exe solicitará a senha na
próxima vez que você entrar. Não use o parâmetro /rp para tarefas
executadas com credenciais da conta de sistema (/ru System). A conta do
sistema não tem uma senha e SchTasks.exe não solicita uma.
Parâmetro Descrição

/mo <modifiers> Especifica a frequência com que a tarefa é executada dentro do tipo de
agendamento. As opções válidas incluem:
MINUTE – especifica que a tarefa seja executada a cada <n>
minutos. Você pode usar qualquer valor entre 1 e 1439 minutos. Por
padrão, é 1 minuto.
HOURLY – especifica que a tarefa seja executada a cada <n> horas.
Você pode usar qualquer valor entre 1 e 23 horas. Por padrão, é 1
hora.
DAILY – especifica que a tarefa seja executada a cada <n> dias. Você
pode usar qualquer valor entre 1 e 365 dias. Por padrão, é 1 dia.
WEEKLY – especifica que a tarefa seja executada a cada <n>
semanas. Você pode usar qualquer valor entre 1 e 52 semanas. Por
padrão, é 1 semana.
MONTHLY – especifica que a tarefa seja executada a cada <n>
meses. Você pode usar qualquer um dos valores a seguir:
Um número entre 1 e 12 meses
LASTDAY – para executar a tarefa no último dia do mês
FIRST, SECOND, THIRD ou FOURTH em conjunto com o
parâmetro /d <day> – especifica a semana e o dia específicos
para executar a tarefa. Por exemplo, na terceira quarta-feira do
mês.
ONCE – especifica que a tarefa seja executada uma vez.
ONSTART – especifica que a tarefa seja executada na inicialização.
ONLOGON – especifica que a tarefa seja executada quando o usuário
especificado pelo parâmetro /ru fizer logon.
ONIDLE – especifica que a tarefa seja executada após o sistema ficar
ocioso pelo número de minutos especificado pelo parâmetro /i

/d DAY[,DAY...] Especifica a frequência com que a tarefa é executada dentro do tipo de


agendamento. As opções válidas incluem:
WEEKLY – especifica que a tarefa seja executada semanalmente
fornecendo um valor entre 1 e 52 semanas. Opcionalmente, você
também pode adicionar um dia específico da semana adicionando
um valor de MON - SUN ou um intervalo de [MON - SUN...]).
MONTHLY – especifica que a tarefa seja executada semanalmente
todos os meses fornecendo um valor de FIRST, SECOND, THIRD,
FOURTH, LAST. Opcionalmente, você também pode adicionar um dia
específico da semana adicionando um valor de MON a SUN ou
fornecendo um número entre 1 a 12 meses. Se você usar essa opção,
também poderá adicionar um dia específico do mês fornecendo um
número entre 1 e 31.

NOTA: o valor de data de 1 a 31 é válido somente sem o parâmetro


/mo ou se o parâmetro /mo for mensal (1 a 12). O padrão é o dia 1
(o primeiro dia do mês).
Parâmetro Descrição

/m Especifica um mês ou meses do ano durante os quais a tarefa agendada


MONTH[,MONTH...] deve ser executada. As opções válidas incluem JAN – DEC e * (todos os
meses). O parâmetro /m é válido apenas com um agendamento MONTHLY.
É necessário quando o modificador LASTDAY é usado. Caso contrário, ele é
opcional e o valor padrão é * (todos os meses).

/i <Idletime> Especifica quantos minutos o computador está ocioso antes do início da


tarefa. Um valor válido é um número inteiro de 1 a 999. Esse parâmetro é
válido apenas com um agendamento ONIDLE, quando é necessário.

/st <Starttime> Especifica a hora de início da tarefa usando o formato de 24 horas, HH:mm.
O valor padrão é a hora atual no computador local. O parâmetro /st é
válido com agendamentos MINUTE, HOURLY, DAILY, WEEKLY, MONTHLY e
ONCE. Ele é obrigatório para um agendamento ONCE.

/ri <interval> Especifica o intervalo de repetição em minutos para a tarefa agendada. Não
se aplica aos tipos de agendamento: MINUTE, HOURLY, ONSTART,
ONLOGON e ONIDLE. O intervalo válido é de 1 a 599940 (599940 minutos
= 9999 horas). Se os parâmetros /et ou /du forem especificados, o padrão
será 10 minutos.

/rl <level> Especifica o nível de execução para o trabalho. Os valores aceitáveis são
LIMITED (as tarefas agendadas serão executadas com o menor nível de
privilégios, como contas de Usuário Padrão) e HIGHEST (as tarefas
agendadas serão executadas com o nível mais alto de privilégios, como
contas de Superusuário). (Observação: LIMITED é o valor padrão).

/et <Endtime> Especifica a hora do dia em que um agendamento de tarefa por minuto ou
por hora termina no formato de 24 horas <HH:MM>. Após a hora de
término especificada, schtasks não inicia a tarefa novamente até que a hora
de início se repita. Por padrão, os agendamentos de tarefa não têm hora de
término. Esse parâmetro é opcional e válido apenas com um agendamento
MINUTE ou HOURLY.

/du <duration> Especifica um período máximo para um agendamento por minuto ou por
hora no formato de 24 horas <HHHH:MM>. Após a hora especificada
passar, schtasks não iniciará a tarefa novamente até que a hora de início se
repita. Por padrão, agendamentos de tarefas não têm duração máxima.
Esse parâmetro é opcional e válido apenas com um agendamento MINUTE
ou HOURLY.

/k Interrompe o programa executado pela tarefa na hora especificada por /et


ou /du. Sem /k, schtasks não inicia o programa novamente depois que ele
atinge o tempo especificado por /et ou /du, nem interrompe o programa
se ele ainda estiver em execução. Esse parâmetro é opcional e válido
apenas com um agendamento MINUTE ou HOURLY.
Parâmetro Descrição

/sd <Startdate> Especifica a data em que o agendamento da tarefa é iniciado. O valor


padrão é a data atual no computador local. O formato de Startdate varia
de acordo com a localidade selecionada para o computador local nas
Opções Regionais e de Idioma. Somente um formato é válido para cada
localidade. Formatos de data válidos incluem (escolha o formato mais
semelhante ao selecionado para Data abreviada nas Opções regionais e
de idioma no computador local):

<MM>// – especifica o uso de formatos com o mês primeiro, como


inglês (Estados Unidos) e espanhol (Panamá).
<DD>// – especifica o uso de formatos com o dia primeiro, como
búlgaro e holandês (Países Baixos).
<YYYY>// – especifica o uso de formatos com o ano primeiro, como
sueco e francês (Canadá).

/ed <Enddate> Especifica a data em que o agendamento termina. Esse parâmetro é


opcional. Não é válido em um agendamento ONCE, ONSTART, ONLOGON
ou ONIDLE. Por padrão, os agendamentos não têm data de término. O
valor padrão é a data atual no computador local. O formato de Enddate
varia de acordo com a localidade selecionada para o computador local nas
Opções Regionais e de Idioma. Somente um formato é válido para cada
localidade. Formatos de data válidos incluem (escolha o formato mais
semelhante ao selecionado para Data abreviada nas Opções regionais e
de idioma no computador local):

<MM>// – especifica o uso de formatos com o mês primeiro, como


inglês (Estados Unidos) e espanhol (Panamá).
<DD>// – especifica o uso de formatos com o dia primeiro, como
búlgaro e holandês (Países Baixos).
<YYYY>// – especifica o uso de formatos com o ano primeiro, como
sueco e francês (Canadá).

/it Especifica a execução da tarefa agendada somente quando o usuário da


execução (a conta de usuário na qual a tarefa é executada) estiver
conectado ao computador. Esse parâmetro não tem efeito sobre tarefas
executadas com permissões de sistema nem tarefas que já têm a
propriedade somente interativa definida. Você não pode usar um comando
de alteração para remover a propriedade somente interativa de uma tarefa.
Por padrão, o usuário da execução é o usuário atual do computador local
quando a tarefa é agendada ou a conta especificada pelo parâmetro /u, se
um for usado. No entanto, se o comando incluir o parâmetro /ru, o usuário
da execução será a conta especificada pelo parâmetro /ru.

/np Nenhuma senha é armazenada. A tarefa é executada de modo não


interativo como o usuário determinado. Somente recursos locais ficam
disponíveis.
Parâmetro Descrição

/z Especifica a exclusão da tarefa após a conclusão de seu agendamento.

/f Especifica a criação da tarefa e a supressão de avisos se a tarefa


especificada já existe.

/? Exibe a ajuda no prompt de comando.

Para agendar uma tarefa para ser executada a


cada <n> minutos
Em um agendamento por minuto, o parâmetro /sc minute é necessário. O parâmetro
/mo (modificador) é opcional e especifica o número de minutos entre cada execução da
tarefa. O valor padrão para /mo é 1 (a cada minuto). Os parâmetros /et (hora de
término) e /du (duração) são opcionais e podem ser usados com ou sem o parâmetro /k
(tarefa final).

Exemplos
Para agendar um script de segurança, Sec.vbs, para ser executado a cada 20
minutos, digite:

schtasks /create /sc minute /mo 20 /tn "Security Script" /tr


\\central\data\scripts\sec.vbs

Como este exemplo não inclui uma data ou hora inicial, a tarefa começa 20
minutos após a conclusão do comando e depois disso é executada a cada 20
minutos, sempre que o sistema está em execução. Observe que o arquivo de
origem do script de segurança está localizado em um computador remoto, mas a
tarefa é agendada e executada no computador local.

Para agendar um script de segurança, Sec.vbs, para ser executado no computador


local a cada 100 minutos entre 17h e 7h59 todos os dias, digite:

schtasks /create /tn "Security Script" /tr sec.vbs /sc minute /mo 100
/st 17:00 /et 08:00 /k
Este exemplo usa o parâmetro /sc para especificar um agendamento de minutos e
o parâmetro /mo para especificar um intervalo de 100 minutos. Ele usa os
parâmetros /st e /et para especificar a hora de início e de término do
agendamento de cada dia. Ele também usará o parâmetro /k para interromper o
script se ele ainda estiver em execução às 7h59. Sem /k, schtasks não iniciaria o
script depois das 7h59, mas se a instância iniciada às 6h20 ainda estivesse em
execução, isso não a interromperia.

Para agendar uma tarefa para ser executada a


cada <n> horas
Em um agendamento por hora, o parâmetro /sc hourly é necessário. O parâmetro /mo
(modificador) é opcional e especifica o número de horas entre cada execução da tarefa.
O valor padrão para /mo é 1 (a cada hora). O parâmetro /k (tarefa final) é opcional e
pode ser usado com /et (terminar na hora especificada) ou /du (terminar após o
intervalo especificado).

Exemplos
Para agendar a execução do programa MyApp a cada cinco horas, começando no
primeiro dia de março de 2002, digite:

schtasks /create /sc hourly /mo 5 /sd 03/01/2002 /tn My App /tr
c:\apps\myapp.exe

Neste exemplo, o computador local usa a opção Inglês (Zimbábue) nas Opções
Regionais e de Idioma, portanto, o formato da data de início é MM/DD/AAAA
(03/01/2002).

Para agendar a execução do programa MyApp por hora, começando cinco


minutos após a meia-noite, digite:

schtasks /create /sc hourly /st 00:05 /tn MyApp /tr c:\apps\myapp.exe

Para agendar a execução do programa MyApp a cada 3 horas, por 10 horas no


total, digite:
schtasks /create /tn MyApp /tr myapp.exe /sc hourly /mo 3 /st 00:00 /du
0010:00

Neste exemplo, a tarefa é executada às 00h, 3h, 6h e 9h. Como a duração é de 10


horas, a tarefa não é executada novamente às 12h. Em vez disso, ela começa
novamente às 00h do dia seguinte. Além disso, como o programa é executado por
apenas alguns minutos, o parâmetro /k, que interrompe o programa se ele ainda
estiver em execução quando a duração expirar, não é necessário.

Para agendar uma tarefa para ser executada a


cada <n> dias
Em um agendamento diário, o parâmetro /sc daily é obrigatório. O parâmetro /mo
(modificador) é opcional e especifica o número de dias entre cada execução da tarefa. O
valor padrão para /mo é 1 (a cada dia).

Exemplos
Para agendar a execução do programa MyApp uma vez por dia, todos os dias, às
8h até 31 de dezembro de 2021, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc daily /st 08:00
/ed 31/12/2021

Neste exemplo, o sistema do computador local é configurado com a opção Inglês


(Reino Unido) nas Opções Regionais e de Idioma, portanto, o formato da data de
término é DD/MM/AAAA (31/12/2021). Além disso, como este exemplo não inclui
o parâmetro /mo, o intervalo padrão 1 é usado para executar o comando todos os
dias.

Para agendar a execução do programa MyApp a cada doze dias às 13h a partir de
31 de dezembro de 2021, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc daily /mo 12 /sd
12/31/2002 /st 13:00
Neste exemplo, o sistema está configurado como a opção Inglês (Zimbábue) nas
Opções Regionais e de Idioma, portanto, o formato da data de término é
MM/DD/AAAA (12/31/2021).

Para agendar um script de segurança, Sec.vbs, para ser executado a cada 70 dias,
digite:

schtasks /create /tn "Security Script" /tr sec.vbs /sc daily /mo 70 /it

Neste exemplo, o parâmetro /it é usado para especificar que a tarefa seja
executada somente quando o usuário em cuja conta a tarefa é executada estiver
conectado ao computador. Como a tarefa é executada com as permissões de uma
conta de usuário específica, essa tarefa só é executada quando o usuário está
conectado.

7 Observação

Para identificar tarefas com a propriedade somente interativa (/it), use uma
consulta detalhada (/query /v). Em uma exibição de consulta detalhada de
uma tarefa com /it, o campo Modo de Logon tem um valor Somente
interativo.

Para agendar uma tarefa para ser executada a


cada <n> semanas
Em um agendamento semanal, o parâmetro /sc weekly é obrigatório. O parâmetro /mo
(modificador) é opcional e especifica o número de semanas entre cada execução da
tarefa. O valor padrão para /mo é 1 (a cada semana).

Agendamentos semanais também têm um parâmetro /d opcional para agendar a


execução da tarefa em dias especificados da semana, ou todos os dias (). O padrão é
MON (segunda-feira). A opção todos os dias () é equivalente a agendar uma tarefa
diária.

Exemplos
Para agendar a execução do programa MyApp em um computador remoto a cada
seis semanas, digite:
schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc weekly /mo 6 /s
Server16 /u Admin01

Como este exemplo deixa o parâmetro /d de fora, a tarefa é executada às


segundas-feiras. Este exemplo também usa o parâmetro /s para especificar o
computador remoto e o parâmetro /u para executar o comando com as
permissões da conta de Administrador do usuário. Além disso, como o parâmetro
/p é deixado de fora, SchTasks.exe solicita ao usuário a senha da conta de
Administrador e, como o comando é executado remotamente, todos os caminhos
no comando, incluindo o caminho para MyApp.exe, se referem a caminhos no
computador remoto.

Para agendar uma tarefa para ser executada todas as sextas-feiras, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc weekly /mo 2 /d


FRI

Este exemplo usa o parâmetro /mo para especificar o intervalo de duas semanas e
o parâmetro /d para especificar o dia da semana. Para agendar uma tarefa que é
executada todas as sextas-feiras, deixe de fora o parâmetro /mo ou defina-o como
1.

Para agendar uma tarefa para ser executada a


cada <n> meses
Nesse tipo de agendamento, o parâmetro /sc monthly é necessário. O parâmetro /mo
(modificador), que especifica o número de meses entre cada execução da tarefa, é
opcional e o padrão é 1 (todos os meses). Esse tipo de agendamento também tem um
parâmetro /d opcional para agendar a tarefa para execução em uma data especificada
do mês. O padrão é 1 (o primeiro dia do mês).

Exemplos
Para agendar a execução do programa MyApp no primeiro dia de cada mês, digite:

schtasks /create /tn MyApp /tr myapp.exe /sc monthly


O valor padrão para o parâmetro /mo (modificador) e o parâmetro /d (dia) é 1,
portanto, você não precisa usar nenhum desses parâmetros para este exemplo.

Para agendar a execução do programa MyApp a cada três meses, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /mo 3

Este exemplo usa o parâmetro /mo para especificar um intervalo de 3 meses.

Para agendar a execução do programa MyApp a cada dois meses no 21º dia do
mês à meia-noite por um ano, de 2 de julho de 2002 a 30 de junho de 2003, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /mo 2 /d


21 /st 00:00 /sd 2002/07/01 /ed 2003/06/30

Este exemplo usa o parâmetro /mo para especificar o intervalo mensal (a cada dois
meses), o parâmetro /d para especificar a data, o parâmetro /st para especificar a
hora e os parâmetros /sd e /ed para especificar a data de início e a data de
término, respectivamente. Também neste exemplo, o computador local é
configurado com a opção Inglês (África do Sul) nas Opções Regionais e de
Idioma, portanto, as datas são especificadas no formato local, AAAA/MM/DD.

Para agendar uma tarefa para execução em um


dia específico da semana
O agendamento de dia da semana é uma variação do agendamento semanal. Em um
agendamento semanal, o parâmetro /sc weekly é obrigatório. O parâmetro /mo
(modificador) é opcional e especifica o número de semanas entre cada execução da
tarefa. O valor padrão para /mo é 1 (a cada semana). O parâmetro /d, que é opcional,
agenda a tarefa para execução em dias especificados da semana ou todos os dias (*). O
padrão é MON (segunda-feira). A opção todos os dias (/d *) é equivalente a agendar
uma tarefa diária.

Exemplos
Para agendar a execução do programa MyApp toda semana na quarta-feira, digite:
schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc weekly /d WED

Este exemplo usa o parâmetro /d para especificar o dia da semana. Como o


comando deixa o parâmetro /mo de fora, a tarefa é executada toda semana.

Para agendar uma tarefa para execução na segunda e na sexta-feira de cada oitava
semana, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc weekly /mo 8 /d


MON,FRI

Este exemplo usa o parâmetro /d para especificar os dias e o parâmetro /mo para
especificar o intervalo de oito semanas.

Para agendar uma tarefa para execução em


uma semana específica do mês
Nesse tipo de agendamento, o parâmetro /sc monthly, o parâmetro /mo (modificador)
e o parâmetro /d (dia) são obrigatórios. O parâmetro /mo (modificador) especifica a
semana em que a tarefa é executada. O parâmetro /d especifica o dia da semana. Você
pode especificar apenas um dia da semana para esse tipo de agendamento. Esse
agendamento também tem um parâmetro /m (mês) opcional que permite agendar a
tarefa para meses específicos ou para todos os meses (*). O padrão para o parâmetro
/m é todos os meses (*).

Exemplos
Para agendar a execução do programa MyApp no segundo domingo de cada mês,
digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /mo SECOND
/d SUN

Este exemplo usa o parâmetro /mo para especificar a segunda semana do mês e o
parâmetro /d para especificar o dia.
Para agendar a execução do programa MyApp na primeira segunda-feira de março
e setembro, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /mo FIRST
/d MON /m MAR,SEP

Este exemplo usa o parâmetro /mo para especificar a primeira semana do mês e o
parâmetro /d para especificar o dia. Ele usa o parâmetro /m para especificar o
mês, separando os argumentos de mês com uma vírgula.

Para agendar uma tarefa para execução em um


dia específico de cada mês
Nesse tipo de agendamento, o parâmetro /sc monthly e o parâmetro /d (dia) são
obrigatórios. O parâmetro /d especifica uma data do mês (1 a 31), não um dia da
semana, e você pode especificar apenas um dia no agendamento. O parâmetro /m
(mês) é opcional, com o padrão sendo todos os meses (), enquanto o parâmetro /mo
(modificador) não é válido com esse tipo de agendamento.

Schtasks.exe não permite agendar uma tarefa para uma data que não esteja em um mês
especificado pelo parâmetro /m. Por exemplo, tentar agendar o dia 31 de fevereiro. No
entanto, se você não usar o parâmetro /m e agendar uma tarefa para uma data que não
aparece todos os meses, a tarefa não será executada nos meses mais curtos. Para
agendar uma tarefa para o último dia do mês, use o tipo de agendamento de último
dia.

Exemplos
Para agendar a execução do programa MyApp no primeiro dia de cada mês, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly

Como o modificador padrão é none (nenhum modificador), esse comando usa o


dia padrão 1 e o mês padrão todos os meses, sem a necessidade de parâmetros
adicionais.
Para agendar a execução do programa MyApp em 15 de maio e 15 de junho às
15h, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /d 15 /m


MAY,JUN /st 15:00

Este exemplo usa o parâmetro /d para especificar a data e o parâmetro /m para


especificar os meses. Ele também usa o parâmetro /st para especificar a hora de
início.

Para agendar uma tarefa para agendamento no


último dia de um mês
No tipo de agendamento de último dia, o parâmetro /sc monthly, o parâmetro /mo
LASTDAY (modificador) e o parâmetro /m (mês) são necessários. O parâmetro /d (dia)
não é válido.

Exemplos
Para agendar a execução do programa MyApp no último dia de cada mês, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /mo


lastday /m *

Este exemplo usa o parâmetro /mo para especificar o último dia e o parâmetro /m
com o caractere curinga (*) para indicar que o programa é executado todos os
meses.

Para agendar a execução do programa MyApp no último dia de fevereiro e no


último dia de março às 18h, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /mo


lastday /m FEB,MAR /st 18:00

Este exemplo usa o parâmetro /mo para especificar o último dia, o parâmetro /m
para especificar os meses e o parâmetro /st para especificar a hora de início.
Para agendar a execução uma vez
No tipo de agendamento de execução única, o parâmetro /sc once é obrigatório. O
parâmetro /st, que especifica a hora em que a tarefa é executada, é obrigatório. O
parâmetro /sd, que especifica a data em que a tarefa é executada, é opcional, enquanto
os parâmetros /mo (modificador) e /ed (data de término) não são válidos.

Schtasks não permite que você agende uma tarefa para ser executada uma vez quando
a data e a hora especificadas estão no passado, com base na hora do computador local.
Para agendar uma tarefa que é executada uma vez em um computador remoto em um
fuso horário diferente, você precisa agendá-la antes que essa data e hora ocorram no
computador local.

Exemplo
Para agendar a execução do programa MyApp à meia-noite de 1º de janeiro de
2003, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc once /sd


01/01/2003 /st 00:00

Este exemplo usa o parâmetro /sc para especificar o tipo de agendamento e os


parâmetros /sd e /st para especificar a data e a hora. Também neste exemplo, o
computador local usa a opção Inglês (Estados Unidos) nas Opções Regionais e de
Idioma; o formato da data de início é MM/DD/AAAA.

Para agendar uma tarefa para execução sempre


que o sistema for iniciado
No tipo de agendamento no início, o parâmetro /sc onstart é obrigatório. O parâmetro
/sd (data de início) é opcional e o padrão é a data atual.

Exemplo
Para agendar a execução do programa MyApp sempre que o sistema for iniciado,
digite:
schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc onstart

Neste exemplo, o computador local usa a opção Inglês (Estados Unidos) nas
Opções Regionais e de Idioma; o formato da data de início é MM/DD/AAAA.

Para agendar uma tarefa para execução


quando um usuário faz logon
O tipo de agendamento no logon agenda uma tarefa que é executada sempre que
qualquer usuário faz logon no computador. No tipo de agendamento no logon, o
parâmetro /sc onlogon é obrigatório. O parâmetro /sd (data de início) é opcional e o
padrão é a data atual.

Exemplo
Para agendar uma tarefa que é executada quando um usuário faz logon em um
computador remoto, digite:

schtasks /create /tn "Start Web Site" /tr c:\myiis\webstart.bat /sc


onlogon /s Server23

Este exemplo agenda um arquivo em lote para ser executado sempre que um
usuário (qualquer usuário) faz logon no computador remoto. Ele usa o parâmetro
/s para especificar o computador remoto. Como o comando é remoto, todos os
caminhos nele, incluindo o caminho para o arquivo em lote, referem-se a um
caminho no computador remoto.

Para agendar uma tarefa para execução


quando o sistema está ocioso
O tipo de agendamento ocioso agenda uma tarefa que é executada sempre que não há
nenhuma atividade do usuário durante o período especificado pelo parâmetro /i. No
tipo de agendamento ocioso, os parâmetros /sc onidle e /i são obrigatórios. O /sd (data
de início) é opcional e o padrão é a data atual.

Exemplo
Para agendar a execução do programa MyApp sempre que o computador estiver
ocioso, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc onidle /i 10

Este exemplo usa o parâmetro obrigatório /i para especificar que o computador


precisa permanecer ocioso por dez minutos antes do início da tarefa.

Para agendar a execução de uma tarefa para


agora
Schtasks não tem uma opção Executar Agora, mas você pode simular essa opção
criando uma tarefa que é executada uma vez e é iniciada dentro de alguns minutos.

Exemplo
Para agendar uma tarefa para ser executada uma vez, em 13 de novembro de 2020
às 14h18, hora local, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc once /st 14:18 /sd
11/13/2002

Neste exemplo, o computador local usa a opção Inglês (Estados Unidos) nas
Opções Regionais e de Idioma, de modo que o formato da data de início é
MM/DD/AAAA.

Para agendar uma tarefa que é executada com


permissões diferentes
Você pode agendar tarefas de todos os tipos para serem executadas com permissões de
uma conta alternativa no computador local e em um computador remoto. Além dos
parâmetros obrigatórios para o tipo de agendamento específico, o parâmetro /ru é
obrigatório e o parâmetro /rp é opcional.

Exemplos
Para executar o programa MyApp no computador local, digite:

schtasks /create /tn MyApp /tr myapp.exe /sc weekly /d TUE /ru Admin06

Este exemplo usa o parâmetro /ru para especificar que a tarefa deve ser executada
com as permissões da conta de Administrador do usuário (Admin06). Também
neste exemplo, a tarefa está agendada para ser executada todas as terças-feiras,
mas você pode usar qualquer tipo de agendamento para a execução de uma
tarefa com permissões alternativas.

Em resposta, SchTasks.exe solicita a senha de execução da conta Admin06 e exibe


uma mensagem de êxito:

Please enter the run as password for Admin06: ********


SUCCESS: The scheduled task My App has successfully been created.

Para executar o programa MyApp no computador Marketing a cada quatro dias,


digite:

schtasks /create /tn MyApp /tr myapp.exe /sc daily /mo 4 /s Marketing
/u Marketing\Admin01 /ru Reskits\User01

Este exemplo usa o parâmetro /sc para especificar um agendamento diário e o


parâmetro /mo para especificar um intervalo de quatro dias. Além disso, o
exemplo usa o parâmetro /s para fornecer o nome do computador remoto e o
parâmetro /u para especificar uma conta com permissão para agendar uma tarefa
no computador remoto (Admin01 no computador Marketing). Por fim, o exemplo
usa o parâmetro /ru para especificar que a tarefa deve ser executada com as
permissões da conta do usuário que não é de Administrador (User01 no domínio
Reskits). Sem o parâmetro /ru, a tarefa seria executada com as permissões da conta
especificada por /u.

Ao executar este exemplo, Schtasks primeiro solicita a senha do usuário nomeado


pelo parâmetro /u (para executar o comando) e solicita a senha do usuário
nomeado pelo parâmetro /ru (para executar a tarefa). Depois de autenticar as
senhas, schtasks exibe uma mensagem indicando que a tarefa foi agendada:
Type the password for Marketing\Admin01:********
Please enter the run as password for Reskits\User01: ********
SUCCESS: The scheduled task My App has successfully been created.

Para agendar a execução do programa deAdminCheck.exe no computador Público


todas as sextas-feiras às 4h, mas somente se o administrador do computador
estiver conectado, digite:

schtasks /create /tn "Check Admin" /tr AdminCheck.exe /sc weekly /d FRI
/st 04:00 /s Public /u Domain3\Admin06 /ru Public\Admin01 /it

Este exemplo usa o parâmetro /sc para especificar um agendamento semanal, o


parâmetro /d para especificar o dia e o parâmetro /st para especificar a hora de
início. Ele também usa o parâmetro /s para fornecer o nome do computador
remoto, o parâmetro /u para especificar uma conta com permissão para agendar
uma tarefa no computador remoto, o parâmetro /ru para configurar a tarefa para
ser executada com as permissões do administrador do computador Público
(Public\Admin01) e o parâmetro /it para indicar que a tarefa seja executada
somente quando a conta Public\Admin01 estiver conectada.

7 Observação

Para identificar tarefas com a propriedade somente interativa (/it), use uma
consulta detalhada ( /query /v ). Em uma exibição de consulta detalhada de
uma tarefa com /it, o campo Modo de Logon tem o valor Somente
interativo.

Para agendar uma tarefa que é executada com


permissões do sistema
Tarefas de todos os tipos podem ser executadas com permissões da conta de Sistema
no computador local e remoto. Além dos parâmetros obrigatórios para o tipo de
agendamento específico, o parâmetro /ru system (ou /ru) é obrigatório, enquanto o
parâmetro /rp não é válido.

) Importante
A conta de Sistema não tem direitos de logon interativo. Os usuários não podem
ver nem interagir com programas ou tarefas executadas com permissões do
sistema. O parâmetro /ru determina as permissões sob as quais a tarefa é
executada, não as permissões usadas para agendar a tarefa. Somente
Administradores podem agendar tarefas, independentemente do valor do
parâmetro /ru.

Para identificar tarefas executadas com permissões do sistema, use uma consulta
detalhada ( /query /v ). Em uma exibição de consulta detalhada de uma tarefa
executada pelo sistema, o campo Executar como Usuário tem o valor NT
AUTHORITY\SYSTEM e o campo Modo de Logon tem o valor Somente em
segundo plano.

Exemplos
Para agendar a execução do programa MyApp no computador local com
permissões da conta de Sistema, digite:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /d 15 /ru


System

Neste exemplo, a tarefa está agendada para ser executada no décimo quinto dia
de cada mês, mas você pode usar qualquer tipo de agendamento para uma tarefa
executada com permissões do sistema. Além disso, este exemplo usa o parâmetro
/ru System para especificar o contexto de segurança do sistema. Como tarefas do
sistema não usam senha, o parâmetro /rp é deixado de fora.

Em resposta, SchTasks.exe exibe uma mensagem informativa e uma mensagem de


êxito, sem solicitar uma senha:

INFO: The task will be created under user name (NT AUTHORITY\SYSTEM).
SUCCESS: The Scheduled task My App has successfully been created.

Para agendar a execução do programa MyApp no computador Finance01 todas as


manhãs às 4h usando permissões do sistema, digite:
schtasks /create /tn MyApp /tr myapp.exe /sc daily /st 04:00 /s
Finance01 /u Admin01 /ru System

Este exemplo usa o parâmetro /tn para nomear a tarefa e o parâmetro /tr para
especificar a cópia remota do programa MyApp, o parâmetro /sc para especificar
um agendamento diário, mas deixa de fora o parâmetro /mo porque 1 (todos os
dias) é o padrão. Este exemplo também usa o parâmetro /st para especificar a hora
de início, que também é a hora em que a tarefa será executada todos os dias, o
parâmetro /s para fornecer o nome do computador remoto, o parâmetro /u para
especificar uma conta com permissão para agendar uma tarefa no computador
remoto e o parâmetro /ru para especificar que a tarefa deve ser executada na
conta de Sistema. Sem o parâmetro /ru, a tarefa seria executada usando as
permissões da conta especificada pelo parâmetro /u.

Schtasks.exe solicita a senha do usuário nomeado pelo parâmetro /u e, depois de


autenticar a senha, exibe uma mensagem indicando que a tarefa foi criada e será
executada com permissões da conta de Sistema:

Type the password for Admin01:**********

INFO: The Schedule Task My App will be created under user name (NT
AUTHORITY\
SYSTEM).
SUCCESS: The scheduled task My App has successfully been created.

Para agendar uma tarefa que executa mais de


um programa
Cada tarefa executa apenas um programa. No entanto, você pode criar um arquivo em
lote que executa vários programas e agendar uma tarefa para executar o arquivo em
lote.

1. Usando um editor de texto, como o Bloco de Notas, crie um arquivo em lote que
inclua o nome e o caminho totalmente qualificado para o arquivo .exe necessário
para iniciar os programas Visualizador de Eventos (Eventvwr.exe) e Monitor do
Sistema (Perfmon.exe).
C:\Windows\System32\Eventvwr.exe
C:\Windows\System32\Perfmon.exe

2. Salve o arquivo como MyApps.bat, abra schtasks.exe e crie uma tarefa para
executar MyApps.bat digitando:

schtasks /create /tn Monitor /tr C:\MyApps.bat /sc onlogon /ru


Reskit\Administrator

Esse comando cria a tarefa Monitor, que é executada sempre que alguém faz
logon. Ele usa o parâmetro /tn para nomear a tarefa, o parâmetro /tr para executar
MyApps.bat, o parâmetro /sc para indicar o tipo de agendamento OnLogon e o
parâmetro /ru para executar a tarefa com as permissões da conta de
Administrador do usuário.

Como resultado desse comando, sempre que um usuário faz logon no


computador, a tarefa inicia o Visualizador de Eventos e o Monitor do Sistema.

Para agendar uma tarefa que é executada em


um computador remoto
Para agendar uma tarefa para execução em um computador remoto, adicione-a ao
agendamento do computador remoto. Tarefas de todos os tipos podem ser agendadas
em um computador remoto, mas as seguintes condições precisam ser atendidas:

Você precisa ter permissão para agendar a tarefa. Sendo assim, você precisa estar
conectado ao computador local com uma conta que seja membro do grupo
Administradores no computador remoto ou precisa usar o parâmetro /u para
fornecer as credenciais de um Administrador do computador remoto.

Você pode usar o parâmetro /u somente quando os computadores local e remoto


estão no mesmo domínio ou quando o computador local está em um domínio de
confiança do domínio do computador remoto. Caso contrário, o computador
remoto não poderá autenticar a conta de usuário especificada nem poderá
verificar se a conta é membro do grupo Administradores.

A tarefa precisa ter permissão suficiente para ser executada no computador


remoto. As permissões necessárias variam de acordo com a tarefa. Por padrão, a
tarefa é executada com a permissão do usuário atual do computador local ou, se o
parâmetro /u for usado, ela será executada com a permissão da conta especificada
pelo parâmetro /u. No entanto, você pode usar o parâmetro /ru para executar a
tarefa com permissões de uma conta de usuário diferente ou com permissões do
sistema.

Exemplos
Para agendar a execução do programa MyApp (como administrador) no
computador remoto SRV01 a cada dez dias, começando imediatamente, digite:

schtasks /create /s SRV01 /tn MyApp /tr c:\program


files\corpapps\myapp.exe /sc daily /mo 10

Este exemplo usa o parâmetro /s para fornecer o nome do computador remoto.


Como o usuário atual local é um Administrador do computador remoto, o
parâmetro /u, que fornece permissões alternativas para agendar a tarefa, não é
necessário.

7 Observação

Ao agendar tarefas em um computador remoto, todos os parâmetros se


referem a ele. Portanto, o arquivo especificado pelo parâmetro /tr refere-se à
cópia de MyApp.exe no computador remoto.

Para agendar o programa MyApp (como usuário) para execução no computador


remoto SRV06 a cada três horas, digite:

schtasks /create /s SRV06 /tn MyApp /tr c:\program


files\corpapps\myapp.exe /sc hourly /mo 3 /u reskits\admin01 /p
R43253@4$ /ru SRV06\user03 /rp MyFav!!Pswd

Como permissões de Administrador são necessárias para agendar uma tarefa, o


comando usa os parâmetros /u e /p para fornecer as credenciais da conta de
Administrador do usuário (Admin01 no domínio Reskits). Por padrão, essas
permissões também são usadas para executar a tarefa. No entanto, como a tarefa
não precisa de permissões de Administrador para ser executada, o comando inclui
os parâmetros /u e /rp para substituir o padrão e executar a tarefa com a
permissão da conta de usuário não Administrador no computador remoto.
Para agendar o programa MyApp (como usuário) para execução no computador
remoto SRV02 no último dia de cada mês.

schtasks /create /s SRV02 /tn MyApp /tr c:\program


files\corpapps\myapp.exe /sc monthly /mo LASTDAY /m * /u
reskits\admin01

Como o usuário atual local (user03) não é um Administrador do computador


remoto, o comando usa o parâmetro /u para fornecer as credenciais da conta de
Administrador do usuário (Admin01 no domínio Reskits). As permissões da conta
de Administrador serão usadas para agendar e para executar a tarefa.

Como o comando não incluiu o parâmetro /p (senha), schtasks solicita a senha. Em


seguida, ele exibe uma mensagem de êxito e, nesse caso, um aviso:

Type the password for reskits\admin01:********

SUCCESS: The scheduled task MyApp has successfully been created.


WARNING: The scheduled task MyApp has been created, but may not run
because the account information could not be set.

Esse aviso indica que o domínio remoto não pôde autenticar a conta especificada
pelo parâmetro /u. Nesse caso, o domínio remoto não pôde autenticar a conta de
usuário porque o computador local não é membro de um domínio no qual o
domínio do computador remoto confia. Quando isso ocorre, o trabalho da tarefa
aparece na lista de tarefas agendadas, mas a tarefa na verdade está vazia e não
será executada.

A exibição a seguir de uma consulta detalhada expõe o problema com a tarefa. Na


exibição, observe que o valor de Hora da Próxima Execução é Nunca e que o valor
de Executar como Usuário é Não foi possível recuperar do banco de dados do
agendador de tarefas.

Se esse computador fosse membro do mesmo domínio ou de um domínio


confiável, a tarefa teria sido agendada com êxito e teria sido executada conforme
especificado.

HostName: SRV44
TaskName: MyApp
Next Run Time: Never
Status:
Logon mode: Interactive/Background
Last Run Time: Never
Last Result: 0
Creator: user03
Schedule: At 3:52 PM on day 31 of every month, start
starting 12/14/2001
Task To Run: c:\program files\corpapps\myapp.exe
Start In: myapp.exe
Comment: N/A
Scheduled Task State: Disabled
Scheduled Type: Monthly
Start Time: 3:52:00 PM
Start Date: 12/14/2001
End Date: N/A
Days: 31
Months: JAN,FEB,MAR,APR,MAY,JUN,JUL,AUG,SEP,OCT,NO
V,DEC
Run As User: Could not be retrieved from the task sched
uler database
Delete Task If Not Rescheduled: Enabled
Stop Task If Runs X Hours and X Mins: 72:0
Repeat: Every: Disabled
Repeat: Until: Time: Disabled
Repeat: Until: Duration: Disabled
Repeat: Stop If Still Running: Disabled
Idle Time: Disabled
Power Management: Disabled

Comentários
Para executar o comando /create com as permissões de um usuário diferente, use
o parâmetro /u. O parâmetro /u é válido apenas para agendar tarefas em
computadores remotos.

Para exibir mais exemplos de schtasks /create , digite schtasks /create /? em


um prompt de comando.

Para agendar uma tarefa que é executada com permissões de um usuário


diferente, use o parâmetro /ru. O parâmetro /ru é válido para tarefas em
computadores locais e remotos.

Para usar o parâmetro /u, o computador local precisa estar no mesmo domínio
que o computador remoto ou precisa estar em um domínio em que o computador
remoto confia. Caso contrário, a tarefa não será criada ou o trabalho da tarefa
estará vazio e a tarefa não será executada.
Schtasks sempre solicita uma senha, a menos que você forneça uma, mesmo
quando você agenda uma tarefa no computador local usando a conta de usuário
atual. Esse é um comportamento normal para schtasks.

Schtasks não verifica os locais de arquivo do programa nem as senhas da conta de


usuário. Se você não inserir o local do arquivo correto ou a senha correta para a
conta de usuário, a tarefa será criada, mas não será executada. Além disso, se a
senha de uma conta for alterada ou expirar e você não alterar a senha salva na
tarefa, a tarefa não será executada.

A conta de Sistema não tem direitos de logon interativo. Os usuários não veem e
não podem interagir com programas executados com permissões de sistema.

Cada tarefa executa apenas um programa. No entanto, você pode criar um arquivo
em lote que inicia várias tarefas e agendar uma tarefa que executa o arquivo em
lote.

Você pode testar uma tarefa assim que a cria. Use a operação de execução para
testar a tarefa e verifique se há erros no arquivo SchedLgU.txt
(SystemRoot\SchedLgU.txt).

Links relacionados
Chave da sintaxe de linha de comando

Comando schtasks change

Comando schtasks delete

Comando schtasks end

Comando schtasks query

Comando schtasks run


schtasks delete
Artigo • 12/04/2023

Exclui uma tarefa agendada do agendamento. Esse comando não exclui o programa que
a tarefa executa nem interrompe um programa em execução.

Sintaxe

schtasks /delete /tn {<taskname> | *} [/f] [/s <computer> [/u [<domain>\]


<user> [/p <password>]]]

Parâmetros

Parâmetro Descrição

/tn Identifica a tarefa a ser excluída. Se você usar o * , esse comando excluirá todas as
{<taskname> tarefas agendadas para o computador, não apenas as tarefas agendadas pelo
| *} usuário atual.

/f Suprime a mensagem de confirmação. A tarefa é excluída sem aviso.

/s Especifica o nome ou o endereço IP de um computador remoto (com ou sem


<computer> barras invertidas). O padrão é o computador local.

/u Executa esse comando com as permissões da conta de usuário especificada. Por


[<domain>] padrão, o comando é executado com as permissões do usuário atual do
computador local. A conta de usuário especificada deve ser um membro do grupo
Administradores no computador remoto. Os parâmetros /u e /p são válidos
somente quando você usa /s.

/p Especifica a senha da conta de usuário especificada no parâmetro /u. Se você usar


<password> o parâmetro /u sem o parâmetro /p ou o argumento de senha, schtasks solicitará
uma senha. Os parâmetros /u e /p são válidos somente quando você usa /s.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para excluir a tarefa Iniciar Email do agendamento de um computador remoto.
schtasks /delete /tn Start Mail /s Svr16

Esse comando usa o parâmetro /s para identificar o computador remoto.

Para excluir todas as tarefas do agendamento do computador local, incluindo as tarefas


agendadas por outros usuários.

schtasks /delete /tn * /f

Esse comando usa o parâmetro /tn * para representar todas as tarefas no computador e
o parâmetro /f para suprimir a mensagem de confirmação.

Links relacionados
Chave da sintaxe de linha de comando

comando schtasks change

comando schtasks create

comando schtasks end

comando schtasks query

comando schtasks run


schtasks end
Artigo • 12/04/2023

Interrompe apenas as instâncias de um programa iniciado por uma tarefa agendada.


Para interromper outros processos, você deve usar o comando TaskKill.

Sintaxe

schtasks /end /tn <taskname> [/s <computer> [/u [<domain>\]<user> [/p


<password>]]]

Parâmetros

Parâmetro Descrição

/tn Identifica a tarefa que iniciou o programa. Este parâmetro é necessário.


<taskname>

/s Especifica o nome ou o endereço IP de um computador remoto (com ou sem barras


<computer> invertidas). O padrão é o computador local.

/u Executa esse comando com as permissões da conta de usuário especificada. Por


[<domain>] padrão, o comando é executado com as permissões do usuário atual do
computador local. A conta de usuário especificada deve ser um membro do grupo
Administradores no computador remoto. Os parâmetros /u e /p são válidos
somente quando você usa /s.

/p Especifica a senha da conta de usuário especificada no parâmetro /u. Se você usar o


<password> parâmetro /u sem o parâmetro /p ou o argumento de senha, schtasks solicitará
uma senha. Os parâmetros /u e /p são válidos somente quando você usa /s.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para interromper a instância do Notepad.exe iniciada pela tarefa Meu Bloco de Notas,
digite:

schtasks /end /tn "My Notepad"


Para interromper a instância do Internet Explorer iniciada pela tarefa InternetOn no
computador remoto, digite Svr01:

schtasks /end /tn InternetOn /s Svr01

Links relacionados
Chave da sintaxe de linha de comando

comando schtasks change

comando schtasks create

comando schtasks delete

comando schtasks query

comando schtasks run


schtasks query
Artigo • 12/04/2023

Lista todas as tarefas agendadas a serem executadas no computador.

Sintaxe

schtasks [/query] [/fo {TABLE | LIST | CSV}] [/nh] [/v] [/s <computer> [/u
[<domain>\]<user> [/p <password>]]]

Parâmetros

Parâmetro Descrição

/Query Opcionalmente, especifica o nome da operação. Usar essa consulta sem parâmetros
executa uma consulta.

/fo Especifica o formato de saída. Os valores válidos são TABLE, LIST ou CSV.
<format>

/nh Remove os cabeçalhos de coluna da exibição da tabela. Esse parâmetro é válido


com os formatos de saída TABLE ou CSV.

/v Adiciona as propriedades avançadas da tarefa à exibição. Esse parâmetro é válido


com os formatos de saída LIST ou CSV.

/s Especifica o nome ou o endereço IP de um computador remoto (com ou sem barras


<computer> invertidas). O padrão é o computador local.

/u Executa esse comando com as permissões da conta de usuário especificada. Por


[<domain>] padrão, o comando é executado com as permissões do usuário atual do
computador local. A conta de usuário especificada deve ser um membro do grupo
Administradores no computador remoto. Os parâmetros /u e /p são válidos
somente quando você usa /s.

/p Especifica a senha da conta de usuário especificada no parâmetro /u. Se você usar o


<password> parâmetro /u sem o parâmetro /p ou o argumento de senha, schtasks solicitará
uma senha. Os parâmetros /u e /p são válidos somente quando você usa /s.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para listar todas as tarefas agendadas para o computador local, digite:

schtasks
schtasks /query

Esses comandos geram o mesmo resultado e podem ser usados alternadamente.

Para solicitar uma exibição detalhada das tarefas no computador local, digite:

schtasks /query /fo LIST /v

Esse comando usa o parâmetro /v para solicitar uma exibição detalhada (minuciosa) e o
parâmetro /fo LIST para formatar a exibição como uma lista para facilitar a leitura. Você
pode usar esse comando para verificar se uma tarefa criada tem o padrão de recorrência
pretendido.

Para solicitar uma lista de tarefas agendadas para um computador remoto e adicionar as
tarefas a um arquivo de log separado por vírgulas no computador local, digite:

schtasks /query /s Reskit16 /fo csv /nh >> \\svr01\data\tasklogs\p0102.csv

Você pode usar esse formato de comando para coletar e acompanhar tarefas
agendadas para vários computadores. Esse comando usa o parâmetro /s para identificar
o computador remoto, Reskit16 e o parâmetro /fo para especificar o formato e o
parâmetro /nh para suprimir os títulos de coluna. O símbolo de acréscimo >>
redireciona a saída para o log de tarefas, p0102.csv, no computador local, Svr01. Como o
comando é executado no computador remoto, o caminho do computador local deve
ser totalmente qualificado.

Links relacionados
Chave da sintaxe de linha de comando

comando schtasks change

comando schtasks create


comando schtasks delete

comando schtasks end

comando schtasks run


schtasks run
Artigo • 17/04/2023

Inicia uma tarefa agendada imediatamente. A operação run ignora o agendamento, mas
usa o local do arquivo do programa, a conta de usuário e a senha salvas na tarefa para
executar a tarefa imediatamente. A execução de uma tarefa não afeta o agendamento
de tarefas e não altera o próximo tempo de execução agendado para a tarefa.

Sintaxe

schtasks /run /tn <taskname> [/s <computer> [/u [<domain>\]<user> [/p


<password>]]]

Parâmetros

Parâmetro Descrição

/tn Identifica a tarefa a ser iniciada. Este parâmetro é necessário.


<taskname>

/s Especifica o nome ou o endereço IP de um computador remoto (com ou sem barras


<computer> invertidas). O padrão é o computador local.

/u Executa esse comando com as permissões da conta de usuário especificada. Por


[<domain>] padrão, o comando é executado com as permissões do usuário atual do
computador local. A conta de usuário especificada deve ser um membro do grupo
Administradores no computador remoto. Os parâmetros /u e /p são válidos
somente quando você usa /s.

/p Especifica a senha da conta de usuário especificada no parâmetro /u. Se você usar o


<password> parâmetro /u sem o parâmetro /p ou o argumento de senha, schtasks solicitará
uma senha. Os parâmetros /u e /p são válidos somente quando você usa /s.

/? Exibe a ajuda no prompt de comando.

Comentários

Use essa operação para testar suas tarefas. Se uma tarefa não for executada,
verifique se há erros no log <Systemroot>\SchedLgU.txt de transações do Serviço
Agendador de Tarefas.
Para executar uma tarefa remotamente, a tarefa precisará ser agendada no
computador remoto. Quando você executa a tarefa, ela é executada somente no
computador remoto. Para verificar se uma tarefa está em execução em um
computador remoto, use o Gerenciador de Tarefas ou o log de transações do
Serviço Agendador de Tarefas, <Systemroot>\SchedLgU.txt .

Exemplos
Para iniciar a tarefa Script de Segurança, digite:

schtasks /run /tn Security Script

Para iniciar a tarefa Atualizar em um computador remoto, Svr01, digite:

schtasks /run /tn Update /s Svr01

Links relacionados
Chave da sintaxe de linha de comando

Comando schtasks change

comando schtasks create

Comando schtasks delete

Comando schtasks end

Comando schtasks query


scwcmd
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2 e
Windows Server 2012

A ferramenta de linha de comando Scwcmd.exe incluída no SCW (Assistente de


Configuração de Segurança) pode ser usada para executar as seguintes tarefas:

Analise um ou muitos servidores com uma política gerada por SCW.

Configure um ou muitos servidores com uma política gerada pelo SCW.

Registre uma extensão do Banco de Dados de Configuração de Segurança com o


SCW.

Reverta as políticas do SCW.

Transforme uma política gerada pelo SCW em arquivos nativos compatíveis com a
Política de Grupo.

Veja os resultados da análise no formato HTML.

7 Observação

Se você usar o scwcmd para configurar, analisar ou reverter uma política em um


servidor remoto, o SCW deverá ser instalado no servidor remoto.

Sintaxe

scwcmd analyze
scwcmd configure
scwcmd register
scwcmd rollback
scwcmd transform
scwcmd view

Parâmetros
Parâmetro Descrição

scwcmd Determina se um computador está em conformidade com uma política.


analyze

scwcmd Aplica uma política de segurança gerada pelo SCW a um computador.


configure

scwcmd Estende ou personaliza o Banco de Dados de Configuração de Segurança do SCW,


register registrando um arquivo de Banco de Dados de Configuração de Segurança que
contém definições de função, tarefa, serviço ou porta.

scwcmd Aplica a política de reversão mais recente disponível, então exclui essa política.
rollback

scwcmd Transforma um arquivo de política de segurança gerado usando o SCW em um


transform novo GPO (Objeto de Política de Grupo) no Active Directory Domain Services.

scwcmd Renderiza um arquivo .xml usando uma transformação .xsl especificada.


view

Links relacionados
Chave da sintaxe de linha de comando
scwcmd analyze
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2 e
Windows Server 2012

Determina se um computador está em conformidade com uma política. Os resultados


retornam em um arquivo .xml.

Esse comando também aceita uma lista de nomes de computador como entrada. Para
exibir os resultados no navegador, use o modo de exibição scwcmd e especifique
%windir%\security\msscw\TransformFiles\scwanalysis.xsl como a transformação .xsl.

Sintaxe

scwcmd analyze [[[/m:<computername> | /ou:<OuName>] /p:<policy>] | /i:


<computerlist>] [/o:<resultdir>] [/u:<username>] [/pw:<password>] [/t:
<threads>] [/l] [/e]

Parâmetros

Parâmetro Descrição

/m: <computername> Especifica o nome NetBIOS, nome DNS ou endereço IP do computador a ser
analisado. Se o parâmetro /m for especificado, o parâmetro /p também
deverá ser especificado.

/ou: <OuName> Especifica o FQDN (nome de domínio totalmente qualificado) de uma UO


(unidade organizacional) no Active Directory Domain Services. Se o
parâmetro /ou for especificado, o parâmetro /p também deverá ser
especificado. Todos os computadores na UO serão configurados em relação
à política fornecida.

/p: <policy> Especifica o caminho e o nome do arquivo do .xml arquivo de política a ser
usado para executar a análise.

/i: <computerlist> Especifica o caminho e o nome de um arquivo .xml que contém uma lista de
computadores juntamente com os arquivos de política esperados. Todos os
computadores no arquivo .xml serão analisados em relação aos arquivos de
política correspondentes. Um arquivo .xml de exemplo é
%windir%\security\SampleMachineList.xml .
Parâmetro Descrição

/o: <resultdir> Especifica o caminho e o diretório em que os arquivos de resultado da


análise devem ser salvos. O padrão é o diretório atual.

/u: <username> Especifica uma credencial de usuário alternativa a ser usada ao executar a
análise em um computador remoto. O padrão é o usuário conectado.

/pw: <password> Especifica uma credencial de usuário alternativa a ser usada ao executar a
análise em um computador remoto. O padrão é a senha do usuário
conectado.

/t: <threads> Especifica o número de operações de análise pendentes simultâneas que


devem ser mantidas durante a análise. O intervalo de valores é de 1 a 1000,
e o valor padrão é 40.

/l Faz com que o processo de análise seja registrado. Um arquivo de log será
gerado para cada computador que está sendo analisado. Os arquivos de log
serão armazenados no mesmo diretório que os arquivos de resultado. Use a
opção /o para especificar o diretório para os arquivos de resultado.

/e Registre um evento no log de Eventos do Aplicativo, se uma


incompatibilidade for encontrada.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para analisar uma política de segurança no arquivo webpolicy.xml, digite:

scwcmd analyze /p:webpolicy.xml

Para analisar uma política de segurança para o computador chamado webserver no


arquivo webpolicy.xml usando as credenciais da conta webadmin, digite:

scwcmd analyze /m:webserver /p:webpolicy.xml /u:webadmin

Para analisar uma política de segurança no arquivo webpolicy.xml, com um máximo de


100 threads e gerar os resultados em um arquivo chamado results no compartilhamento
resultserver, digite:
scwcmd analyze /i:webpolicy.xml /t:100 /o:\\resultserver\results

Para analisar uma política de segurança para a UO WebServers no arquivo webpolicy.xml,


usando as credenciais DomainAdmin, digite:

scwcmd analyze /ou:OU=WebServers,DC=Marketing,DC=ABCCompany,DC=com


/p:webpolicy.xml /u:DomainAdmin

Links relacionados
Chave da sintaxe de linha de comando

Comando scwcmd configure

Comando scwcmd register

comando scwcmd rollback

comando scwcmd transform

comando scwcmd view


scwcmd configure
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2 e
Windows Server 2012

Aplica uma política de segurança gerada pelo SCW (Assistente de Configuração de


Segurança) a um computador. Essa ferramenta de linha de comando também aceita
uma lista de nomes de computador como entrada.

Sintaxe

scwcmd configure [[[/m:<computername> | /ou:<OuName>] /p:<policy>] | /i:


<computerlist>] [/u:<username>] [/pw:<password>] [/t:<threads>]

Parâmetros

Parâmetro Descrição

/m: <computername> Especifica o nome NetBIOS, nome DNS ou endereço IP do computador a ser
configurado. Se o parâmetro /m for especificado, o parâmetro /p também
deverá ser especificado.

/ou: <OuName> Especifica o FQDN (nome de domínio totalmente qualificado) de uma UO


(unidade organizacional) no Active Directory Domain Services. Se o
parâmetro /ou for especificado, o parâmetro /p também deverá ser
especificado. Todos os computadores na UO serão configurados em relação
à política fornecida.

/p: <policy> Especifica o caminho e o nome do arquivo do .xml arquivo de política a ser
usado para executar a configuração.

/i: <computerlist> Especifica o caminho e o nome de um arquivo .xml que contém uma lista de
computadores juntamente com os arquivos de política esperados. Todos os
computadores no arquivo .xml serão analisados em relação aos arquivos de
política correspondentes. Um arquivo .xml de exemplo é
%windir%\security\SampleMachineList.xml .

/u: <username> Especifica uma credencial de usuário alternativa a ser usada ao executar a
configuração em um computador remoto. O padrão é o usuário conectado.
Parâmetro Descrição

/pw: <password> Especifica uma credencial de usuário alternativa a ser usada ao executar a
configuração em um computador remoto. O padrão é a senha do usuário
conectado.

/t: <threads> Especifica o número de operações de configuração pendentes simultâneas


que devem ser mantidas durante a análise. O intervalo de valores é de 1 a
1000, e o valor padrão é 40.

/l Faz com que o processo de análise seja registrado. Um arquivo de log será
gerado para cada computador que está sendo analisado. Os arquivos de log
serão armazenados no mesmo diretório que os arquivos de resultado. Use a
opção /o para especificar o diretório para os arquivos de resultado.

/e Registre um evento no log de Eventos do Aplicativo, se uma


incompatibilidade for encontrada.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para configurar uma política de segurança no arquivo webpolicy.xml, digite:

scwcmd configure /p:webpolicy.xml

Para configurar uma política de segurança para o computador em 172.16.0.0 no arquivo


webpolicy.xml, usando as credenciais da conta webadmin, digite:

scwcmd configure /m:172.16.0.0 /p:webpolicy.xml /u:webadmin

Para configurar uma política de segurança em todos os computadores na lista


campusmachines.xml, com no máximo 100 threads, digite:

scwcmd configure /i:campusmachines.xml /t:100

Para configurar uma política de segurança para a UO WebServers no arquivo


webpolicy.xml, usando as credenciais DomainAdmin, digite:
scwcmd configure /ou:OU=WebServers,DC=Marketing,DC=ABCCompany,DC=com
/p:webpolicy.xml /u:DomainAdmin

Links relacionados
Chave da sintaxe de linha de comando

comando scwcmd analyze

comando scwcmd register

comando scwcmd rollback

comando scwcmd transform

comando scwcmd view


scwcmd register
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2 e
Windows Server 2012

Estende ou personaliza o Banco de Dados de Configuração de Segurança do SCW


(Assistente de Configuração de Segurança), registrando um arquivo de Banco de Dados
de Configuração de Segurança que contém definições de função, tarefa, serviço ou
porta.

Sintaxe

scwcmd register /kbname:<MyApp> [/kbfile:<kb.xml>] [/kb:<path>] [/d]

Parâmetros

Parâmetro Descrição

/kbname: <MyApp> Especifica o nome no qual a extensão do Banco de Dados de Configuração de


Segurança será registrada. Esse parâmetro precisa ser especificado.

/kbfile: <kb.xml> Especifica o caminho e o nome do arquivo do Banco De Dados De


Configuração de Segurança usado para estender ou personalizar o banco de
dados base de configuração de segurança. Para validar se o arquivo do Banco
de Dados de Configuração de Segurança está em conformidade com o
esquema SCW, use o arquivo de definição de esquema
%windir%\security\KBRegistrationInfo.xsd . Essa opção precisa ser fornecida,
a menos que o parâmetro /d seja especificado.

/kb: <path> Especifica o caminho para o diretório que contém os arquivos do Banco de
Dados de Configuração de Segurança do SCW a serem atualizados. Se essa
opção não for especificada, %windir%\security\msscw\kbs será usado.

/d Cancela o registro de uma extensão do Banco de Dados de Configuração de


Segurança do Banco de Dados de Configuração de Segurança. A extensão
para cancelar o registro é especificada pelo parâmetro /kbname. (O
parâmetro /kbfile não deve ser especificado.) O Banco de Dados de
Configuração de Segurança do qual cancelar o registro da extensão é
especificado pelo parâmetro /kb.
Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Exemplos
Para registrar o arquivo do Banco de Dados de Configuração de Segurança chamado
SCWKBForMyApp.xml sob o nome MyApp no local \\kbserver\kb , digite:

scwcmd register /kbfile:d:\SCWKBForMyApp.xml /kbname:MyApp /kb:\\kbserver\kb

Para cancelar o registro do Banco de Dados de Configuração de Segurança MyApp,


localizado em \\kbserver\kb , digite:

scwcmd register /d /kbname:MyApp /kb:\\kbserver\kb

Links relacionados
Chave da sintaxe de linha de comando

Comando scwcmd analyze

Comando scwcmd configure

Comando scwcmd rollback

Comando scwcmd transform

comando scwcmd view


scwcmd rollback
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2 e
Windows Server 2012

Aplica a política de reversão mais recente disponível, então exclui essa política.

Sintaxe

scwcmd rollback /m:<computername> [/u:<username>] [/pw:<password>]

Parâmetros

Parâmetro Descrição

/m: <computername> Especifica o nome NetBIOS, o nome DNS ou o endereço IP de um


computador em que a operação de reversão deve ser executada.

/u: <username> Especifica uma conta de usuário alternativa a ser usada ao executar uma
reversão remota. O padrão é o usuário conectado.

/pw: <password> Especifica uma credencial de usuário alternativa a ser usada ao executar
uma reversão remota. O padrão é o usuário conectado.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para reverter a política de segurança em um computador no endereço IP 172.16.0.0,
digite:

scwcmd rollback /m:172.16.0.0

Links relacionados
Chave da sintaxe de linha de comando

comando scwcmd analyze

comando scwcmd configure

comando scwcmd register

comando scwcmd transform

comando scwcmd view


scwcmd transform
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2 e
Windows Server 2012

Transforma um arquivo de política de segurança gerado usando o SCW (Assistente de


Configuração de Segurança) em um novo GPO (Objeto de Política de Grupo) no Active
Directory Domain Services. A operação de transformação não altera as configurações no
servidor em que é executada. Após a conclusão da operação de transformação, um
administrador deve vincular o GPO às UOs desejadas para implantar a política nos
servidores.

) Importante

As credenciais de administrador de domínio são necessárias para concluir a


operação de transformação.

As configurações de política de segurança do IIS (Serviços de Informações da


Internet) não podem ser implantadas usando a Política de Grupo.

As políticas de firewall que listam os aplicativos aprovados não devem ser


implantadas em servidores, a menos que o serviço firewall do Windows seja
iniciado automaticamente quando o servidor foi iniciado pela última vez.

Sintaxe

scwcmd transform /p:<policyfile.xml> /g:<GPOdisplayname>

Parâmetros

Parâmetro Descrição

/p: <policyfile.xml> Especifica o caminho e o nome do arquivo de política .xml que deve ser
aplicado. Esse parâmetro deve ser especificado.
Parâmetro Descrição

/g: <GPOdisplayname> Especifica o nome de exibição do GPO. Esse parâmetro deve ser
especificado.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para criar um GPO chamado FileServerSecurity em um arquivo chamado
FileServerPolicy.xml, digite:

scwcmd transform /p:FileServerPolicy.xml /g:FileServerSecurity

Links relacionados
Chave da sintaxe de linha de comando

comando scwcmd analyze

comando scwcmd configure

comando scwcmd register

comando scwcmd rollback

comando scwcmd view


scwcmd view
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2 e
Windows Server 2012

Renderiza um arquivo .xml usando uma transformação .xsl especificada. Esse comando
pode ser útil para exibir arquivos .xml do SCW (Assistente de Configuração de
Segurança) usando exibições diferentes.

Sintaxe

scwcmd view /x:<Xmlfile.xml> [/s:<Xslfile.xsl>]

Parâmetros

Parâmetro Descrição

/x: <Xmlfile.xml> Especifica o arquivo .xml a ser exibido. Esse parâmetro precisa ser
especificado.

/s: <Xslfile.xsl> Especifica a transformação .xsl a ser aplicada ao arquivo .xml como parte do
processo de renderização. Esse parâmetro é opcional para arquivos .xml do
SCW. Quando o comando view for usado para renderizar um arquivo .xml do
SCW, ele tentará carregar automaticamente a transformação padrão correta
para o arquivo .xml especificado. Se uma transformação .xsl for especificada,
ela deverá ser gravada sob a suposição de que o arquivo .xml está no mesmo
diretório que a transformação .xsl.

/? Exibe a ajuda no prompt de comando.

Exemplo
Para exibir Policyfile.xml usando a transformação Policyview.xsl, digite:

scwcmd view /x:C:\policies\Policyfile.xml /s:C:\viewers\Policyview.xsl


Links relacionados
Chave da sintaxe de linha de comando

Comando scwcmd analyze

Comando scwcmd configure

Comando scwcmd register

Comando scwcmd rollback

Comando scwcmd transform


comandos secedit
Artigo • 12/04/2023

Configuram e analisam a segurança do sistema, comparando a configuração de


segurança atual com os modelos de segurança especificados.

7 Observação

O MMC (Console de Gerenciamento Microsoft) e o snap-in Configuração e Análise


de Segurança não estão disponíveis no Server Core.

Sintaxe

secedit /analyze
secedit /configure
secedit /export
secedit /generaterollback
secedit /import
secedit /validate

Parâmetros

Parâmetro Descrição

secedit /analyze Permite que você analise as configurações de sistemas atuais em relação às
configurações de linha de base armazenadas em um banco de dados. Os
resultados da análise são armazenados em uma área separada do banco de
dados e podem ser exibidos no snap-in Configuração e Análise de Segurança.

secedit Permite que você defina um sistema com configurações de segurança


/configure armazenadas em um banco de dados.

secedit /export Permite exportar as configurações de segurança armazenadas em um banco


de dados.

secedit Permite gerar um modelo de reversão relacionado a um modelo de


/generaterollback configuração.

secedit /import Permite importar um modelo de segurança para um banco de dados para
que as configurações especificadas no modelo possam ser aplicadas a um
sistema ou analisadas em relação a um sistema.
Parâmetro Descrição

secedit /validate Permite validar a sintaxe de um modelo de segurança.

Comentários
Se não houver um caminho de arquivo especificado, todos os nomes de arquivo
usarão como padrão o diretório atual.

Os resultados da análise são armazenados em uma área separada do banco de


dados e podem ser exibidos no snap-in Configuração e Análise de Segurança para
o MMC.

Se os modelos de segurança forem criados usando o snap-in Modelo de


Segurança e se você executar o snap-in Configuração e Análise de Segurança
nesses modelos, os seguintes arquivos serão criados:

Arquivo Descrição

scesrv.log Local: %windir%\security\logs


Criado por: sistema operacional
Tipo de arquivo: Texto
Taxa de atualização: substituído quando secedit analyze , secedit
configure , secedit export ou secedit import é executado.
Conteúdo: contém os resultados da análise agrupada por tipo de política.

user- Local: %windir%\<user account>\Documents\Security\Database


selected Criado por: executando o snap-in Configuração e Análise de Segurança
name.sdb Tipo de arquivo: proprietário
Taxa de atualização: atualizado sempre que um novo modelo de segurança
é criado.
Conteúdo: políticas de segurança locais e modelos de segurança criados
pelo usuário.

user- Local: definido pelo usuário, mas o padrão é %windir%\<user


selected account>\Documents\Security\Logs
name.log Criado por: executando os comandos secedit analyze ou secedit
configure ou usando o snap-in Configuração e Análise de Segurança.
Tipo de arquivo: Texto
Taxa de atualização: substituído quando secedit analyze ou secedit
configure é executado ou usando o snap-in Configuração e Análise de
Segurança.
Conteúdo: nome do arquivo de log, data e hora e os resultados da análise
ou investigação.
Arquivo Descrição

user- Local: %windir%\*<user account>\Documents\Security\Templates


selected Criado por: executando o snap-in Modelo de Segurança.
name.inf Tipo de arquivo: Texto
Taxa de atualização: substituído sempre que o modelo de segurança é
atualizado.
Conteúdo: contém as informações de configuração do modelo de cada
política selecionada usando o snap-in.

Links relacionados
Chave da sintaxe de linha de comando
secedit /analyze
Artigo • 12/04/2023

Permite que você analise as configurações de sistemas atuais em relação às


configurações de linha de base armazenadas em um banco de dados.

Sintaxe

secedit /analyze /db <database file name> [/cfg <configuration file name>]
[/overwrite] [/log <log file name>] [/quiet}]

Parâmetros

Parâmetro Descrição

/db Obrigatórios. Especifica o caminho e o nome do arquivo do banco de dados que


contém a configuração armazenada na qual a análise é executada. Se o nome do
arquivo especificar um banco de dados que não tem um modelo de segurança
(conforme representado pelo arquivo de configuração) associado, a opção /cfg
<configuration file name> também deverá ser especificada.

/cfg Especifica o caminho e o nome do arquivo do modelo de segurança que será


importado para o banco de dados para análise. Esta opção só é válida quando
usada com o parâmetro /db <database file name> . Se esse parâmetro também não
for especificado, a análise será executada em relação a qualquer configuração já
armazenada no banco de dados.

/overwrite Especifica se o modelo de segurança no parâmetro /cfg deve substituir qualquer


modelo ou o modelo composto armazenado no banco de dados, em vez de
acrescentar os resultados ao modelo armazenado. Essa opção só é válida quando o
parâmetro /cfg <configuration file name> também é usado. Se esse parâmetro
também não for especificado, o modelo no parâmetro /cfg será acrescentado ao
modelo armazenado.

/log Especifica o caminho e o nome do arquivo de log a ser usado no processo. Se você
não especificar um local de arquivo, o arquivo de log padrão
<systemroot>\Documents and Settings\<UserAccount>\My Documents\Security\Logs\
<databasename>.log será usado.

/quiet Suprime a saída da tela. Você ainda pode exibir os resultados da análise usando o
snap-in de Configuração e Análise de Segurança para o MMC (Console de
Gerenciamento da Microsoft).
Exemplos
Para executar a análise dos parâmetros de segurança no banco de dados de segurança,
SecDbContoso.sdb e direcionar a saída para o arquivo SecAnalysisContosoFY11, incluindo
os prompts para verificar se o comando foi executado corretamente, digite:

secedit /analyze /db C:\Security\FY11\SecDbContoso.sdb /log


C:\Security\FY11\SecAnalysisContosoFY11.log

Para incorporar as alterações exigidas pelo processo de análise no arquivo


SecContoso.inf e direcionar a saída para o arquivo existente, SecAnalysisContosoFY11,
sem avisar, digite:

secedit /analyze /db C:\Security\FY11\SecDbContoso.sdb /cfg SecContoso.inf


/overwrite /log C:\Security\FY11\SecAnalysisContosoFY11.xml /quiet

Links relacionados
Chave da sintaxe de linha de comando

secedit /configure

secedit /export

secedit /generaterollback

secedit /import

secedit /validate
secedit /configure
Artigo • 12/04/2023

Permite definir as configurações atuais do sistema usando as configurações de


segurança armazenadas em um banco de dados.

Sintaxe

secedit /configure /db <database file name> [/cfg <configuration file name>]
[/overwrite] [/areas [securitypolicy | group_mgmt | user_rights | regkeys |
filestore | services]] [/log <log file name>] [/quiet]

Parâmetros

Parâmetro Descrição

/db Obrigatórios. Especifica o caminho e o nome do arquivo do banco de dados que


contém a configuração armazenada. Se o nome do arquivo especificar um banco de
dados que não tem um modelo de segurança (conforme representado pelo arquivo
de configuração) associado, a opção /cfg <configuration file name> também
deverá ser especificada.

/cfg Especifica o caminho e o nome do arquivo do modelo de segurança que será


importado para o banco de dados para análise. Esta opção só é válida quando
usada com o parâmetro /db <database file name> . Se esse parâmetro também não
for especificado, a análise será executada em relação a qualquer configuração já
armazenada no banco de dados.

/overwrite Especifica se o modelo de segurança no parâmetro /cfg deve substituir qualquer


modelo ou o modelo composto armazenado no banco de dados, em vez de
acrescentar os resultados ao modelo armazenado. Essa opção só é válida quando o
parâmetro /cfg <configuration file name> também é usado. Se esse parâmetro
também não for especificado, o modelo no parâmetro /cfg será acrescentado ao
modelo armazenado.
Parâmetro Descrição

/areas Especifica as áreas de segurança a serem aplicadas ao sistema. Se esse parâmetro


não for especificado, todas as configurações de segurança definidas no banco de
dados serão aplicadas ao sistema. Para configurar várias áreas, separe cada área
usando um espaço. Há suporte para as seguintes áreas de segurança:
securitypolicy: política local e política de domínio do sistema, incluindo
políticas de conta, políticas de auditoria, opções de segurança e assim por
diante.
group_mgmt: configurações de grupo restritas para todos os grupos
especificados no modelo de segurança.
user_rights: direitos de logon do usuário e concessão de privilégios.
regkeys: segurança nas chaves do registro local.
filestore: segurança no armazenamento de arquivos local.
services: segurança para todos os serviços definidos.

/log Especifica o caminho e o nome do arquivo de log a ser usado no processo. Se você
não especificar um local de arquivo, o arquivo de log padrão
<systemroot>\Documents and Settings\<UserAccount>\My Documents\Security\Logs\
<databasename>.log será usado.

/quiet Suprime a tela e a saída do log. Você ainda pode exibir os resultados da análise
usando o snap-in de Configuração e Análise de Segurança para o MMC (Console de
Gerenciamento da Microsoft).

Exemplos
Para executar a análise dos parâmetros de segurança no banco de dados de segurança,
SecDbContoso.sdb e direcionar a saída para o arquivo SecAnalysisContosoFY11, incluindo
os prompts para verificar se o comando foi executado corretamente, digite:

secedit /analyze /db C:\Security\FY11\SecDbContoso.sdb /log


C:\Security\FY11\SecAnalysisContosoFY11.log

Para incorporar as alterações exigidas pelo processo de análise no arquivo


SecContoso.inf e direcionar a saída para o arquivo existente, SecAnalysisContosoFY11,
sem avisar, digite:

secedit /configure /db C:\Security\FY11\SecDbContoso.sdb /cfg SecContoso.inf


/overwrite /log C:\Security\FY11\SecAnalysisContosoFY11.xml /quiet
Links relacionados
Chave da sintaxe de linha de comando

secedit /analyze

secedit /export

secedit /generaterollback

secedit /import

secedit /validate
secedit /export
Artigo • 17/04/2023

Exporta as configurações de segurança armazenadas em um banco de dados


configurado com modelos de segurança. Você pode usar esse comando para fazer
backup de suas políticas de segurança em um computador local, além de importar as
configurações para outro computador.

Sintaxe

secedit /export /db <database file name> [/mergedpolicy] /cfg <configuration


file name> [/areas [securitypolicy | group_mgmt | user_rights | regkeys |
filestore | services]] [/log <log file name>] [/quiet]

Parâmetros

Parâmetro Descrição

/db Obrigatórios. Especifica o caminho e o nome do arquivo do banco de dados que


contém a configuração armazenada na qual a exportação é executada. Se o
nome do arquivo especificar um banco de dados que não tem um modelo de
segurança (conforme representado pelo arquivo de configuração) associado, a
opção /cfg <configuration file name> também deverá ser especificada.

/mergedpolicy Mescla e exporta configurações de segurança de política local e de domínio.

/cfg Obrigatórios. Especifica o caminho e o nome do arquivo do modelo de


segurança que será importado para o banco de dados para análise. Esta opção
só é válida quando usada com o parâmetro /db <database file name> . Se esse
parâmetro também não for especificado, a análise será executada em relação a
qualquer configuração já armazenada no banco de dados.
Parâmetro Descrição

/areas Especifica as áreas de segurança a serem aplicadas ao sistema. Se esse


parâmetro não for especificado, todas as configurações de segurança definidas
no banco de dados serão aplicadas ao sistema. Para configurar várias áreas,
separe cada área usando um espaço. Há suporte para as seguintes áreas de
segurança:
securitypolicy: política local e política de domínio do sistema, incluindo
políticas de conta, políticas de auditoria, opções de segurança e assim por
diante.
group_mgmt: configurações de grupo restritas para todos os grupos
especificados no modelo de segurança.
user_rights: direitos de logon do usuário e concessão de privilégios.
regkeys: segurança nas chaves do registro local.
filestore: segurança no armazenamento de arquivos local.
services: segurança para todos os serviços definidos.

/log Especifica o caminho e o nome do arquivo de log a ser usado no processo. Se


você não especificar um local de arquivo, o arquivo de log padrão
<systemroot>\Documents and Settings\<UserAccount>\My
Documents\Security\Logs\<databasename>.log será usado.

/quiet Suprime a tela e a saída do log. Você ainda pode exibir os resultados da análise
usando o snap-in de Configuração e Análise de Segurança para o MMC (Console
de Gerenciamento da Microsoft).

Exemplos
Para exportar o banco de dados de segurança e as políticas de segurança de domínio
para um arquivo .inf e, em seguida, importar esse arquivo para um banco de dados
diferente para replicar as configurações de política de segurança em outro computador,
digite:

secedit /export /db C:\Security\FY11\SecDbContoso.sdb /mergedpolicy /cfg


SecContoso.inf /log C:\Security\FY11\SecAnalysisContosoFY11.log /quiet

Para importar o arquivo de exemplo para um banco de dados diferente em outro


computador, digite:

secedit /import /db C:\Security\FY12\SecDbContoso.sdb /cfg SecContoso.inf


/log C:\Security\FY11\SecAnalysisContosoFY12.log /quiet
Links relacionados
Chave da sintaxe de linha de comando

secedit /analyze

secedit /configure

secedit /generaterollback

secedit /import

secedit /validate
secedit /generaterollback
Artigo • 12/04/2023

Permite gerar um modelo de reversão para um modelo de configuração especificado. Se


já existir um modelo de reversão, executar esse comando novamente substituirá as
informações existentes.

A execução bem-sucedida desse comando registra as incompatibilidades entre o


modelo de segurança especificado e configuração da política de segurança no arquivo
scesrv.log.

Sintaxe

secedit /generaterollback /db <database file name> /cfg <configuration file


name> /rbk <rollback template file name> [/log <log file name>] [/quiet]

Parâmetros

Parâmetro Descrição

/db Obrigatórios. Especifica o caminho e o nome do arquivo do banco de dados que


contém a configuração armazenada na qual a análise é executada. Se o nome do
arquivo especificar um banco de dados que não tem um modelo de segurança
(conforme representado pelo arquivo de configuração) associado, a opção /cfg
<configuration file name> também deverá ser especificada.

/cfg Obrigatórios. Especifica o caminho e o nome do arquivo do modelo de segurança


que será importado para o banco de dados para análise. Esta opção só é válida
quando usada com o parâmetro /db <database file name> . Se esse parâmetro
também não for especificado, a análise será executada em relação a qualquer
configuração já armazenada no banco de dados.

/rbk Obrigatórios. Especifica um modelo de segurança no qual as informações de


reversão são gravadas. Os modelos de segurança são criados usando o snap-in
Modelos de Segurança. Os arquivos de reversão podem ser criados com esse
comando.

/log Especifica o caminho e o nome do arquivo de log a ser usado no processo. Se você
não especificar um local de arquivo, o arquivo de log padrão
<systemroot>\Documents and Settings\<UserAccount>\My Documents\Security\Logs\
<databasename>.log será usado.
Parâmetro Descrição

/quiet Suprime a tela e a saída do log. Você ainda pode exibir os resultados da análise
usando o snap-in de Configuração e Análise de Segurança para o MMC (Console de
Gerenciamento da Microsoft).

Exemplos
Para criar o arquivo de configuração de reversão para o arquivo SecTmplContoso.inf
criado anteriormente e, ao mesmo tempo, salvar as configurações originais e, em
seguida, gravar a ação no arquivo de log SecAnalysisContosoFY11, digite:

secedit /generaterollback /db C:\Security\FY11\SecDbContoso.sdb /cfg


sectmplcontoso.inf /rbk sectmplcontosoRBK.inf /log
C:\Security\FY11\SecAnalysisContosoFY11.log

Links relacionados
Chave da sintaxe de linha de comando

secedit /analyze

secedit /configure

secedit /export

secedit /import

secedit /validate
secedit /import
Artigo • 12/04/2023

Importa as configurações de segurança (arquivo .inf), exportadas anteriormente do


banco de dados configurado com os modelos de segurança.

) Importante

Antes de importar um arquivo .inf para outro computador, você deve executar o
comando secedit /generaterollback no banco de dados no qual a importação
será executada.

Você também deve executar o comando secedit /validate no arquivo de


importação para verificar sua integridade.

Sintaxe

secedit /import /db <database file name> /cfg <configuration file name>
[/overwrite] [/areas [securitypolicy | group_mgmt | user_rights | regkeys |
filestore | services]] [/log <log file name>] [/quiet]

Parâmetros

Parâmetro Descrição

/db Obrigatórios. Especifica o caminho e o nome do arquivo do banco de dados que


contém a configuração armazenada na qual a importação é executada. Se o nome
do arquivo especificar um banco de dados que não tem um modelo de segurança
(conforme representado pelo arquivo de configuração) associado, a opção /cfg
<configuration file name> também deverá ser especificada.

/overwrite Especifica se o modelo de segurança no parâmetro /cfg deve substituir qualquer


modelo ou o modelo composto armazenado no banco de dados, em vez de
acrescentar os resultados ao modelo armazenado. Essa opção só é válida quando o
parâmetro /cfg <configuration file name> também é usado. Se esse parâmetro
também não for especificado, o modelo no parâmetro /cfg será acrescentado ao
modelo armazenado.
Parâmetro Descrição

/cfg Obrigatórios. Especifica o caminho e o nome do arquivo do modelo de segurança


que será importado para o banco de dados para análise. Esta opção só é válida
quando usada com o parâmetro /db <database file name> . Se esse parâmetro
também não for especificado, a análise será executada em relação a qualquer
configuração já armazenada no banco de dados.

/areas Especifica as áreas de segurança a serem aplicadas ao sistema. Se esse parâmetro


não for especificado, todas as configurações de segurança definidas no banco de
dados serão aplicadas ao sistema. Para configurar várias áreas, separe cada área
usando um espaço. Há suporte para as seguintes áreas de segurança:
securitypolicy: política local e política de domínio do sistema, incluindo
políticas de conta, políticas de auditoria, opções de segurança e assim por
diante.
group_mgmt: configurações de grupo restritas para todos os grupos
especificados no modelo de segurança.
user_rights: direitos de logon do usuário e concessão de privilégios.
regkeys: segurança nas chaves do registro local.
filestore: segurança no armazenamento de arquivos local.
services: segurança para todos os serviços definidos.

/log Especifica o caminho e o nome do arquivo de log a ser usado no processo. Se você
não especificar um local de arquivo, o arquivo de log padrão
<systemroot>\Documents and Settings\<UserAccount>\My Documents\Security\Logs\
<databasename>.log será usado.

/quiet Suprime a tela e a saída do log. Você ainda pode exibir os resultados da análise
usando o snap-in de Configuração e Análise de Segurança para o MMC (Console de
Gerenciamento da Microsoft).

Exemplos
Para exportar o banco de dados de segurança e as políticas de segurança de domínio
para um arquivo .inf e, em seguida, importar esse arquivo para um banco de dados
diferente para replicar as configurações de política em outro computador, digite:

secedit /export /db C:\Security\FY11\SecDbContoso.sdb /mergedpolicy /cfg


NetworkShare\Policies\SecContoso.inf /log
C:\Security\FY11\SecAnalysisContosoFY11.log /quiet

Para importar apenas a parte de políticas de segurança do arquivo para um banco de


dados diferente em outro computador, digite:
secedit /import /db C:\Security\FY12\SecDbContoso.sdb /cfg
NetworkShare\Policies\SecContoso.inf /areas securitypolicy /log
C:\Security\FY11\SecAnalysisContosoFY12.log /quiet

Links relacionados
Chave da sintaxe de linha de comando

secedit /analyze

secedit /configure

secedit /export

secedit /generaterollback

secedit /validate
secedit /validate
Artigo • 11/04/2023

Valida as configurações de segurança armazenadas em um modelo de segurança


(arquivo .inf). Validar modelos de segurança pode ajudar você a determinar se um deles
está corrompido ou definido inadequadamente. Modelos de segurança corrompidos ou
configurados inadequadamente não são aplicados.

Sintaxe

secedit /validate <configuration file name>

Parâmetros

Parâmetro Descrição

<configuration Obrigatórios. Especifica o caminho e o nome do arquivo para o modelo de


file name> segurança que será validado. Os arquivos de log não são atualizados por este
comando.

Exemplos
Para verificar se o arquivo .inf de reversão, secRBKcontoso.inf, ainda é válido após a
reversão, digite:

secedit /validate secRBKcontoso.inf

Links relacionados
Chave da sintaxe de linha de comando

secedit /analyze

secedit /configure

secedit /export
secedit /generaterollback

secedit /import
comandos select
Artigo • 12/04/2023

Mudam o foco para um disco, uma partição, um volume ou um VHD (disco rígido
virtual).

Sintaxe

select disk
select partition
select vdisk
select volume

Parâmetros

Parâmetro Descrição

Select disk Muda o foco para um disco.

Select partition Muda o foco para uma partição.

Select vdisk Muda o foco para um VHD.

Select volume Muda o foco para um volume.

Comentários

Se um volume for selecionado com uma partição correspondente, a partição será


selecionada automaticamente.

Se uma partição for selecionada com um volume correspondente, o volume será


selecionado automaticamente.

Links relacionados
Chave da sintaxe de linha de comando
select disk
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Seleciona o disco especificado e muda o foco para ele.

Sintaxe

select disk={<n>|<disk path>|system|next}

Parâmetros

Parâmetro Descrição

<n> Especifica o número do disco que receberá o foco. Você pode exibir os números de
todos os discos no computador usando o comando list disk em DiskPart.

OBSERVAÇÃO
Ao configurar sistemas com vários discos, não use select disk=0 para especificar o
disco do sistema. O computador pode reatribuir os números de disco quando você
reinicializa e computadores diferentes com a mesma configuração de disco podem
ter números de disco diferentes.

<disk Especifica o local do disco para receber o foco, por exemplo,


path> PCIROOT(0)#PCI(0F02)#atA(C00T00L00) . Para exibir o caminho de localização de um
disco, selecione-o e digite detail disk.

sistema Nos computadores BIOS, essa opção especifica que o disco 0 recebe o foco. Nos
computadores EFI, o disco que contém a partição do sistema EFI (ESP), usada para a
inicialização atual, recebe o foco. Nos computadores EFI, o comando falhará se não
houver ESP, se houver mais de um ESP ou se o computador for inicializado a partir
do Windows PE (Ambiente de Pré-Instalação do Windows).

Próximo Depois que um disco é selecionado, essa opção itera todos os discos na lista de
discos. Quando você executa essa opção, o próximo disco na lista recebe o foco.

Exemplos
Para mudar o foco para o disco 1, digite:

select disk=1

Para selecionar um disco usando seu caminho de localização, digite:

select disk=PCIROOT(0)#PCI(0100)#atA(C00T00L01)

Para mudar o foco para o disco do sistema, digite:

select disk=system

Para mudar o foco para o próximo disco no computador, digite:

select disk=next

Links relacionados
Chave da sintaxe de linha de comando

comando select partition

comando select vdisk

comando select volume


select partition
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Seleciona a partição especificada e muda o foco para ela. Esse comando também pode
ser usado para exibir a partição que tem atualmente o foco no disco selecionado.

Sintaxe

select partition=<n>

Parâmetros

Parâmetro Descrição

partition= <n> O número da partição que deve receber o foco. Você pode exibir os números de
todas as partições no disco selecionado atualmente, usando o comando list
partition no DiskPart.

Comentários
Antes de selecionar uma partição, primeiro selecione um disco usando o comando
select disk.

Se nenhum número de partição for especificado, essa opção exibirá a partição


que tem atualmente o foco no disco selecionado.

Se um volume for selecionado com uma partição correspondente, a partição


será selecionada automaticamente.

Se uma partição for selecionada com um volume correspondente, o volume


será selecionado automaticamente.

Exemplos
Para mudar o foco para a partição 3, digite:

select partitition=3

Para exibir a partição que tem atualmente o foco no disco selecionado, digite:

select partition

Links relacionados
Chave da sintaxe de linha de comando

comando create partition efi

comando create partition extended

comando create partition logical

comando create partition msr

comando create partition primary

comando delete partition

comando detail partition

comando select disk

comando select vdisk

comando select volume


select vdisk
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Seleciona o VHD (disco rígido virtual) especificado e muda o foco para ele.

Sintaxe

select vdisk file=<full path> [noerr]

Parâmetros

Parâmetro Descrição

file= <full Especifica o caminho completo e o nome de um arquivo VHD existente.


path>

noerr Usando somente para scripts. Quando um erro é encontrado, DiskPart continua a
processar os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro,
um erro faz com que DiskPart saia com um código de erro.

Exemplos
Para mudar o foco para o VHD chamado c:\test\test.vhd, digite:

select vdisk file=c:\test\test.vhd

Links relacionados
Chave da sintaxe de linha de comando

attach vdisk
compact vdisk

detach vdisk

detail vdisk

expand vdisk

merge vdisk

list

comando select disk

comando select partition

comando select volume


select volume
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Seleciona o volume especificado e muda o foco para ele. Esse comando também pode
ser usado para exibir o volume que tem atualmente o foco no disco selecionado.

Sintaxe

select volume={<n>|<d>}

Parâmetros

Parâmetro Descrição

<n> O número do volume que deve receber o foco. Você pode exibir os números de
todos os volumes no disco selecionado atualmente, usando o comando list volume
no DiskPart.

<d> A letra da unidade ou o caminho do ponto de montagem do volume que deve


receber o foco.

Comentários
Se nenhum volume for especificado, esse comando exibirá o volume que tem
atualmente o foco no disco selecionado.

Em um disco básico, selecionar um volume também coloca o foco na partição


correspondente.

Se um volume for selecionado com uma partição correspondente, a partição


será selecionada automaticamente.

Se uma partição for selecionada com um volume correspondente, o volume


será selecionado automaticamente.
Exemplos
Para mudar o foco para o volume 2, digite:

select volume=2

Para mudar o foco para a Unidade C, digite:

select volume=c

Para mudar o foco para o volume montado em uma pasta chamada c:\mountpath,
digite:

select volume=c:\mountpath

Para exibir o volume que tem atualmente o foco no disco selecionado, digite:

select volume

Links relacionados
Chave da sintaxe de linha de comando

comando add volume

comando attributes volume

comando create volume mirror

comando create volume raid

comando create volume simple

comando create volume stripe

comando delete volume


comando detail volume

comando fsutil volume

comando list volume

comando offline volume

comando online volume

comando select disk

comando select partition

comando select vdisk


serverceipoptin
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Permite que você participe do Programa de Aperfeiçoamento da Experiência do Usuário.

Sintaxe

serverceipoptin [/query] [/enable] [/disable]

Parâmetros

Parâmetro Descrição

/Query Verifica sua configuração atual.

/enable Ativa sua participação no Programa de Aperfeiçoamento da Experiência do Usuário.

/disable Desativa sua participação no Programa de Aperfeiçoamento da Experiência do


Usuário.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para verificar as configurações atuais, digite:

serverceipoptin /query

Para ativar sua participação, digite:

serverceipoptin /enable
Para desativar sua participação, digite:

serverceipoptin /disable

Links relacionados
Chave da sintaxe de linha de comando
servermanagercmd
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Instala e remove funções, serviços de função e recursos. Também exibe a lista de todas
as funções, os serviços de função e os recursos disponíveis e mostra quais estão
instalados neste computador.

) Importante

O comando servermanagercmd foi preterido e não há garantia de que tenha


suporte em versões futuras do Windows. Recomendamos que você use os cmdlets
do Windows PowerShell disponíveis para o Gerenciador do Servidor. Para mais
informações, consulte Instalar ou desinstalar funções, Serviços de função ou
Recursos.

Sintaxe

servermanagercmd -query [[[<drive>:]<path>]<query.xml>] [-logpath


[[<drive>:]<path>]<log.txt>]
servermanagercmd -inputpath [[[<drive>:]<path>]<answer.xml>] [-resultpath
<result.xml> [-restart] | -whatif] [-logpath [[<drive>:]<path>]<log.txt>]
servermanagercmd -install <id> [-allSubFeatures] [-resultpath [[<drive>:]
<path>]<result.xml> [-restart] | -whatif] [-logpath [[<Drive>:]<path>]
<log.txt>]
servermanagercmd -remove <id> [-resultpath <result.xml> [-restart] | -
whatif] [-logpath [[<drive>:]<path>]<log.txt>]
servermanagercmd [-help | -?]
servermanagercmd -version

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

-query Exibe uma lista de todas as funções, os serviços de função e os recursos


[[[<drive>:] instalados e disponíveis para instalação no servidor. Você também pode usar a
<path>] forma abreviada desse parâmetro, -q. Para que os resultados da consulta sejam
<query.xml>] salvos em um arquivo XML, especifique um arquivo XML para substituir
<query.xml> .

-inputpath Instala ou remove as funções, os serviços de função e os recursos especificados


[[[<drive>:] em um arquivo de resposta XML representado por <answer.xml> . Você também
<path>] pode usar a forma abreviada desse parâmetro, -p.
<answer.xml>]
Parâmetro Descrição

-install <id> Instala a função, o serviço de função ou o recurso especificado por <id> . Os
identificadores diferenciam maiúsculas de minúsculas. Várias funções, serviços de
função e recursos precisam ser separados por espaços. Os seguintes parâmetros
opcionais são usados com o parâmetro -install:

-setting <SettingName>=<SettingValue> – especifica as configurações


obrigatórias para a instalação.
-allSubFeatures – especifica a instalação de todos os serviços e recursos
subordinados, juntamente com a função pai, o serviço de função ou o
recurso nomeado no valor <id> .

OBSERVAÇÃO
Alguns contêineres de função não têm um identificador de linha de
comando para permitir a instalação de todos os serviços de função. Esse é
o caso quando serviços de função não podem ser instalados na mesma
instância do comando do Gerenciador do Servidor. Por exemplo, o serviço
de função Serviço de Federação do Active Directory Federation Services e
o serviço de função Proxy do Serviço de Federação não podem ser
instalados usando a mesma instância de comando do Gerenciador do
Servidor.
-resultpath <result.xml> – salva os resultados da instalação em um
arquivo XML representado por <result.xml> . Você também pode usar a
forma abreviada desse parâmetro, -r.

OBSERVAÇÃO
Você não pode executar servermanagercmd com os parâmetros -
resultpath e -whatif especificados.
-restart – reinicia o computador automaticamente quando a instalação é
concluída (se a reinicialização for necessária para as funções ou os recursos
instalados).
-whatif – exibe as operações especificadas para o parâmetro -install. Você
também pode usar a forma abreviada do parâmetro -whatif, -w. Você não
pode executar servermanagercmd com os parâmetros -resultpath e -
whatif especificados.
-logpath <[[<drive>:]<path>]<log.txt>> – especifica um nome e um local
para o arquivo de log diferentes do padrão,
%windir%\temp\servermanager.log .
Parâmetro Descrição

-remove <id> Remove a função, o serviço de função ou o recurso especificado por <id> . Os
identificadores diferenciam maiúsculas de minúsculas. Várias funções, serviços de
função e recursos precisam ser separados por espaços. Os seguintes parâmetros
opcionais são usados com o parâmetro -remove:

-resultpath <[[<drive>:]<path>]result.xml> – salva os resultados da


remoção em um arquivo XML representado por <result.xml> . Você
também pode usar a forma abreviada desse parâmetro, -r.

OBSERVAÇÃO
Você não pode executar servermanagercmd com os parâmetros -
resultpath e -whatif especificados.
-restart – reinicia o computador automaticamente quando a remoção é
concluída (se a reinicialização for necessária para as funções ou os recursos
restantes).
-whatif – exibe as operações especificadas para o parâmetro -remove.
Você também pode usar a forma abreviada do parâmetro -whatif, -w. Você
não pode executar servermanagercmd com os parâmetros -resultpath e -
whatif especificados.
-logpath <[[<Drive>:]<path>]<log.txt>> – especifica um nome e um local
para o arquivo de log diferentes do padrão,
%windir%\temp\servermanager.log .

-version Exibe o número da versão do Gerenciador do Servidor. Também é possível usar a


forma abreviada, -v.

-help Exibe a ajuda na janela do prompt de Comando. Também é possível usar a forma
abreviada, -?.

Exemplos
Para exibir uma lista de todas as funções, serviços de função e recursos disponíveis e
quais funções, serviços de função e recursos estão instalados no computador, digite:

servermanagercmd -query

Para instalar a função de Servidor Web (IIS) e salvar os resultados da instalação em um


arquivo XML representado por installResult.xml, digite:

servermanagercmd -install Web-Server -resultpath installResult.xml


Para exibir informações detalhadas sobre as funções, os serviços de função e os recursos
que seriam instalados ou removidos com base nas instruções especificadas em um
arquivo de resposta XML representado por install.xml, digite:

servermanagercmd -inputpath install.xml -whatif

Links relacionados
Chave da sintaxe de linha de comando

Visão geral do Gerenciador do Servidor


serverweroptin
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Permite habilitar o relatório de erros.

Sintaxe

serverweroptin [/query] [/detailed] [/summary]

Parâmetros

Parâmetro Descrição

/Query Verifica sua configuração atual.

/ detalhadas Especifica o envio automático de relatórios detalhados.

Resumo Especifica o envio automático de relatórios de resumo.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para verificar a configuração atual, digite:

serverweroptin /query

Para enviar automaticamente relatórios detalhados, digite:

serverweroptin /detailed
Para enviar automaticamente os relatórios de resumo, digite:

serverweroptin /summary

Links relacionados
Chave da sintaxe de linha de comando
Ferramentas de linha de comando dos
Serviços para Sistema de Arquivos de
Rede
Artigo • 12/04/2023

Os Serviços para NFS (Network File System) fornecem uma solução de


compartilhamento de arquivos que permite transferir arquivos entre computadores que
executam sistemas operacionais Windows Server e UNIX usando o protocolo NFS.

Informações e links para cada uma das ferramentas de linha de comando associadas do
NFS:

Comando Descrição

mapadmin Gerencie o Mapeamento de Nomes de Usuário dos Serviços Microsoft para


Sistema de Arquivos de Rede.

mount Monte os compartilhamentos de rede do NFS (Sistema de Arquivos de Rede).

nfsadmin Gerencie o Servidor para NFS e o Cliente para NFS.

nfsshare Controle os compartilhamentos do NFS (Sistema de Arquivos de Rede).

nfsstat Exiba ou redefina as contagens de chamadas feitas ao Servidor para NFS.

rpcinfo Liste os programas nos computadores remotos.

showmount Exiba os diretórios montados.

Links relacionados
Chave da sintaxe de linha de comando
set (variável de ambiente)
Artigo • 12/04/2023

Exibe, define ou remove variáveis de ambiente de cmd.exe. Se usado sem parâmetros,


set exibe as configurações atuais da variável de ambiente.

7 Observação

Este comando requer extensões de comando, que são habilitadas por padrão.

O comando set também pode ser executado no Console de Recuperação do Windows,


usando parâmetros diferentes. Para obter mais informações, consulte WinRE (Ambiente
de Recuperação do Windows).

Sintaxe

set [<variable>=[<string>]]
set [/p] <variable>=[<promptString>]
set /a <variable>=<expression>

Parâmetros

Parâmetro Descrição

<variable> Especifica a variável de ambiente a ser definida ou modificada.

<string> Especifica a cadeia de caracteres a ser associada à variável de ambiente


especificada.

/p Define o valor de <variable> como uma linha de entrada inserida pelo usuário.

<promptstring> Especifica uma mensagem para solicitar entrada ao usuário. Este parâmetro
deve ser usado com o parâmetro /p.

/a Define <string> como uma expressão numérica avaliada.

<expression> Especifica uma expressão numérica.

/? Exibe a ajuda no prompt de comando.


Comentários
Se as extensões de comando estiverem habilitadas (o padrão) e você executar set
com um valor, ele exibirá todas as variáveis que começam com esse valor.

Os caracteres < , > , | , & e ^ são especiais do Shell de comando e devem ser
precedidos pelo caractere de escape ( ^ ) ou colocados entre aspas quando usados
em <string> (por exemplo, "StringContaining&Symbol"). Se você usar aspas para
incluir uma cadeia de caracteres que contenha um dos caracteres especiais, as
aspas serão definidas como parte do valor da variável de ambiente.

Use variáveis de ambiente para controlar o comportamento de alguns arquivos e


programas em lotes e para controlar a maneira como o Windows e o subsistema
MS-DOS aparecem e funcionam. O comando set geralmente é usado no arquivo
Autoexec.nt para definir variáveis de ambiente.

Se você usar o comando set sem parâmetros, as configurações de ambiente atuais


serão exibidas. Essas configurações geralmente incluem as variáveis de ambiente
COMSPEC e PATH, que são usadas para ajudar a localizar programas em disco.
Duas outras variáveis de ambiente usadas pelo Windows são PROMPT e DIRCMD.

Se você especificar valores para <variable> e <string> , o valor <variable>


especificado será adicionado ao ambiente e <string> será associado a essa
variável. Se a variável já existir no ambiente, o novo valor de cadeia de caracteres
substituirá o valor antigo de cadeia de caracteres.

Se você especificar apenas uma variável e um sinal de igual (sem <string> ) para o
comando set, o valor <string> associado à variável será limpo (como se a variável
não estivesse lá).

Se você usar o parâmetro /a, os seguintes operadores serão compatíveis, em


ordem decrescente de precedência:

Operador Operação executada

( ) Agrupamento

! ~ - Unário

* / % Aritmético

+ - Aritmético

<< >> Deslocamento lógico


Operador Operação executada

& AND bit a bit

^ OR exclusivo bit a bit

= *= /= %= += -= &= ^= = <<= >>=

, Separador de expressão

Se você usar operadores lógicos ( && ou || ) ou de módulos (%), coloque a cadeia


de caracteres de expressão entre aspas. Todas as cadeias de caracteres não
numéricas na expressão são consideradas nomes de variáveis de ambiente, e seus
valores são convertidos em números antes de serem processados. Se você
especificar um nome de variável de ambiente que não esteja definido no ambiente
atual, um valor zero será alocado, o que permitirá que você execute a aritmética
com valores de variáveis de ambiente sem usar o % para recuperar um valor.

Se você executar set /a na linha de comando fora de um script de comando, ele


exibirá o valor final da expressão.

Valores numéricos são números decimais, a menos que prefixados por 0× para
números hexadecimais ou 0 para números octais. Portanto, 0×12 é o mesmo que
18, que é o mesmo que 022.

O suporte à expansão de variável de ambiente atrasada está desabilitado por


padrão, mas você pode habilitá-lo ou desabilitá-lo usando cmd /v.

Ao criar arquivos em lotes, você pode usar set para criar variáveis e usá-las da
mesma forma que usaria as variáveis numeradas %0 a %9. Você também pode
usar as variáveis %0 a %9 como entrada para set.

Se você chamar um valor de variável de um arquivo em lotes, coloque o valor


entre sinais de porcentagem (%). Por exemplo, se o programa em lotes criar uma
variável de ambiente chamada BAUD, você poderá usar a cadeia de caracteres
associada a BAUD como um parâmetro substituível digitando %baud% no prompt
de comando.

Exemplos
Para definir o valor TEST^1 para a variável de ambiente chamada testVar , digite:
set testVar=test^^1

O comando set atribui tudo o que segue o sinal de igual (=) ao valor da variável.
Portanto, se você digitar set testVar=test^1 , obterá o seguinte resultado,
testVar=test1 .

Para definir o valor TEST&1 para a variável de ambiente testVar , digite:

set testVar=test^&1

Para definir uma variável de ambiente chamada INCLUDE para que a cadeia de
caracteres c:\directory esteja associada a ela, digite:

set include=c:\directory

Em seguida, você pode usar a cadeia de caracteres c:\directory nos arquivos em lotes
colocando o nome INCLUDE entre sinais de porcentagem (%). Por exemplo, você pode
usar dir %include% em um arquivo em lotes para exibir o conteúdo do diretório
associado à variável de ambiente INCLUDE. Após o processamento desse comando, a
cadeia de caracteres c:\directory substitui %include%.

Para usar o comando set em um programa em lotes para adicionar um novo diretório à
variável de ambiente PATH, digite:

@echo off
rem ADDPATH.BAT adds a new directory
rem to the path environment variable.
set path=%1;%path%
set

Para exibir uma lista de todas as variáveis de ambiente que começam com a letra P,
digite:

set p
Links relacionados
Chave da sintaxe de linha de comando
comandos set (criação da cópia de
sombra)
Artigo • 12/04/2023

Definem o contexto, as opções, o modo detalhado e o arquivo de metadados para a


criação da cópia de sombra. Se usado sem parâmetros, o set lista todas as
configurações atuais.

Sintaxe

set
set context
set option
set verbose
set metadata

Parâmetros

Parâmetros Descrição

set context Define o contexto para a criação da cópia de sombra.

set metadata Define o nome e o local do arquivo de metadados da criação de sombra.

set option Define as opções para a criação da cópia de sombra.

set verbose Ativa ou desativa o modo de saída detalhado.

/? Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
Set context
Artigo • 12/04/2023

Define o contexto para a criação da cópia de sombra. Se usado sem parâmetros, o set
context exibe a ajuda no prompt de comando.

Sintaxe

set context {clientaccessible | persistent [nowriters] | volatile


[nowriters]}

Parâmetros

Parâmetro Descrição

clientaccessible Especifica que a cópia de sombra é utilizável por versões de cliente do


Windows. Esse contexto é persistente por padrão.

persistent Especifica que a cópia de sombra persiste na saída, redefinição ou


reinicialização do programa.

volatile Exclui a cópia de sombra ao sair ou redefinir.

nowriters Especifica que todos os gravadores sejam excluídos.

Exemplos
Para impedir que cópias de sombra sejam excluídas quando você sair do DiskShadow,
digite:

set context persistent

Links relacionados
Chave da sintaxe de linha de comando

comando set metadata


comando set option

comando set verbose


set id (Diskpart)
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera o campo de tipo de partição para a partição com foco. Esse comando não
funciona em discos dinâmicos ou partições reservadas da Microsoft.

) Importante

Esse comando deve ser usado apenas por OEM (fabricante original do
equipamento). Alterar os campos de tipo de partição com esse parâmetro pode
fazer com que o computador falhe ou não consiga inicializar. A menos que você
seja um OEM ou tenha experiência com discos GPT, não deve alterar os campos de
tipo de partição em discos GPT usando esse parâmetro. Em vez disso, sempre use o
comando create partition efi para criar partições do sistema EFI, o comando create
partition msr para criar partições reservadas da Microsoft e o comando create
partition primary sem o parâmetro ID para criar partições primárias em discos GPT.

Sintaxe

set id={ <byte> | <GUID> } [override] [noerr]

Parâmetros

Parâmetro Descrição

<byte> Para discos MBR (registro mestre de inicialização), especifica o novo valor do campo
de tipo, no formato hexadecimal, para a partição. Qualquer byte de tipo de partição
pode ser especificado com esse parâmetro, exceto para o tipo 0x42, que especifica
uma partição LDM. Observe que o 0x à esquerda é omitido ao especificar o tipo de
partição hexadecimal.
Parâmetro Descrição

<GUID> Para discos GPT (tabela de partição de GUID), especifica o novo valor de GUID para
o campo de tipo da partição. Os GuiDs reconhecidos incluem:
Partição do sistema EFI: c12a7328-f81f-11d2-ba4b-00a0c93ec93b
Partição de dados básica: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7

Qualquer GUID de tipo de partição pode ser especificado com esse parâmetro,
exceto o seguinte:

Partição reservada da Microsoft: e3c9e316-0b5c-4db8-817d-f92df00215ae


Partição de metadados LDM em um disco dinâmico: 5808c8aa-7e8f-42e0-
85d2-e1e90434cfb3
Partição de dados LDM em um disco dinâmico: af9b60a0-1431-4f62-bc68-
3311714a69ad
Partição de metadados de cluster: db97dba9-0840-4bae-97f0-ffb9a327c7e1

override força o sistema de arquivos no volume a desmontar, antes de alterar o tipo de


partição. Quando você executa o comando set id, o DiskPart tenta bloquear e
desmontar o sistema de arquivos no volume. Se a override não for especificado e a
chamada para bloquear o sistema de arquivos falhar (por exemplo, porque há um
identificador aberto), a operação falhará. Se override for especificada, o DiskPart
forçará a desmontagem mesmo que a chamada para bloquear o sistema de
arquivos falhe e todos os identificadores abertos para o volume deixarão de ser
válidos.

noerr Usado somente para scripts. Quando um erro é encontrado, o DiskPart continua a
processar os comandos como se o erro não tivesse ocorrido. Sem esse parâmetro,
um erro faz com que o DiskPart saia com um código de erro.

Comentários
Além das limitações mencionadas anteriormente, o DiskPart não verifica a validade
do valor especificado (exceto para garantir que ele seja um byte no formato
hexadecimal ou um GUID).

Exemplos
Para definir o campo de tipo como 0x07 e forçar o sistema de arquivos a desmontar,
digite:

set id=0x07 override


Para definir o campo de tipo como uma partição de dados básica, digite:

set id=ebd0a0a2-b9e5-4433-87c0-68b6b72699c7

Links relacionados
Chave da sintaxe de linha de comando
set metadata
Artigo • 12/04/2023

Define o nome e o local do arquivo de metadados da criação de sombra usado para


transferir cópias de sombra de um computador para outro. Se usado sem parâmetros, o
set metadata exibe a ajuda no prompt de comando.

Sintaxe

set metadata [<drive>:][<path>]<metadata.cab>

Parâmetros

Parâmetro Descrição

[<drive>:] Especifica o local para criar o arquivo de metadados.


[<path>]

<metadata.cab> Especifica o nome do arquivo cab para armazenar os metadados da criação


de sombra.

Links relacionados
Chave da sintaxe de linha de comando

domando set context

comando set option

comando set verbose


set option
Artigo • 12/04/2023

Define as opções para a criação da cópia de sombra. Se usado sem parâmetros, o set
option exibe a ajuda no prompt de comando.

Sintaxe

set option {[differential | plex] [transportable] [[rollbackrecover]


[txfrecover] | [noautorecover]]}

Parâmetros

Parâmetro Descrição

[differential] Especifica a criação de um instantâneo pontual de volumes especificados.

[plex] Especifica a criação de uma cópia de clone pontual dos dados em um volume
especificado.

[transportable] Especifica que a cópia de sombra ainda não deve ser importada. Os
metadados do arquivo .cab podem ser usados posteriormente para importar a
cópia de sombra para o mesmo computador ou para um computador
diferente.

[rollbackrecover] Sinaliza os gravadores para usar o autorecover durante o evento


PostSnapshot. Será útil se a cópia de sombra for usada para reversão (por
exemplo, com mineração de dados).

[txfrecover] Solicita ao VSS que torne a cópia de sombra transacionalmente consistente


durante a criação.

[noautorecover] Impede que os gravadores e o sistema de arquivos executem alterações de


recuperação na cópia de sombra para um estado transacionalmente
consistente. O noautorecover não pode ser usado com o txfrecover ou
rollbackrecover.

Links relacionados
Chave da sintaxe de linha de comando
comando set context

comando set metadata

comando set verbose


Set verbose
Artigo • 17/04/2023

Especifica se a saída detalhada é fornecida durante a criação da cópia de sombra. Se


usado sem parâmetros, set verbose exibirá a ajuda na solicitação de comando.

Sintaxe

set verbose {on | off}

Parâmetros

Parâmetro Descrição

on Ativa o registro em log de saída detalhado durante o processo de criação da cópia


de sombra. Se o modo detalhado estiver ativado, set fornecerá detalhes da inclusão
ou exclusão do gravador e detalhes da compactação e extração de metadados.

Desligar Desativa o registro em log de saída detalhado durante o processo de criação da


cópia de sombra.

Links relacionados
Chave da sintaxe de linha de comando

comando set context

comando set metadata

comando set option


setx
Artigo • 11/04/2023

Cria ou modifica variáveis de ambiente no ambiente do usuário ou do sistema, sem a


necessidade de programação ou script. O comando Setx também recupera os valores
das chaves do Registro e os grava em arquivos de texto.

7 Observação

Esse comando fornece a única forma programática ou de linha de comando para


definição de valores de ambiente do sistema de forma direta e permanente. As
variáveis de ambiente do sistema podem ser configuradas manualmente por meio
do Painel de Controle ou por meio de um editor do registro. O comando set, que é
interno no interpretador de comandos (Cmd.exe), define variáveis de ambiente do
usuário apenas para a janela do console atual.

Sintaxe

setx [/s <computer> [/u [<domain>\]<user name> [/p [<password>]]]]


<variable> <value> [/m]
setx [/s <computer> [/u [<domain>\]<user name> [/p [<password>]]]]
<variable>] /k <path> [/m]
setx [/s <computer> [/u [<domain>\]<user name> [/p [<password>]]]] /f
<filename> {[<variable>] {/a <X>,<Y> | /r <X>,<Y> <String>} [/m] | /x} [/d
<delimiters>]

Parâmetros

Parâmetro Descrição

/s <computer> Especifica o nome ou endereço IP de um computador remoto. Não use barras invertidas.
O valor padrão é o nome do computador local.

/u Executa o script com as credenciais da conta de usuário especificada. O valor padrão é as


[<domain>\] permissões do sistema.
<user name>

/p Especifica a senha da conta de usuário especificada no parâmetro /u.


[ <password> ]
Parâmetro Descrição

<variable> Especifica o nome da variável de ambiente que você deseja definir.

<value> Especifica o valor para o qual você deseja definir a variável de ambiente.

/k <path> Especifica que a variável é definida com base nas informações de uma chave do registro.
O caminho usa a seguinte sintaxe: \\<HIVE>\<KEY>\...\<Value> . Por exemplo, você pode
especificar o seguinte caminho:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName

/f <filename> Especifica o arquivo que você deseja usar.

/a <X>,<Y> Especifica coordenadas absolutas e deslocamento como parâmetros de pesquisa.

/r <X>,<Y> Especifica coordenadas relativas e deslocamento de String como parâmetros de pesquisa.


<String>

/m Especifica a definição da variável no ambiente do sistema. A configuração padrão é o


ambiente local.

/x Exibe coordenadas de arquivo, ignorando as opções de linha de comando /a, /r e /d.

/d Especifica delimitadores como , ou \ a serem usados além dos quatro delimitadores


<delimiters> internos SPACE, TAB, ENTER e LINEFEED. Delimitadores válidos incluem qualquer caractere
ASCII. O número máximo de delimitadores é 15, incluindo delimitadores internos.

/? Exibe a ajuda no prompt de comando.

Comentários
Esse comando é semelhante ao utilitário UNIX SETENV.

Você pode usar esse comando a fim de definir valores para variáveis de ambiente
do usuário e do sistema de uma das três fontes (modos): Modo de Linha de
Comando, Modo de Registro ou Modo de Arquivo.

Esse comando grava variáveis no ambiente mestre no registro. Variáveis definidas


com variáveis setx ficam disponíveis apenas em janelas de comando futuras, não
na janela de comando atual.

HKEY_CURRENT_USER e HKEY_LOCAL_MACHINE são os únicos hives com suporte.


REG_DWORD, REG_EXPAND_SZ, REG_SZ e REG_MULTI_SZ são os tipos de dados
RegKey válidos.

Se você obtiver acesso a valores REG_MULTI_SZ no registro, somente o primeiro


item será extraído e usado.
Você não pode usar esse comando para remover valores adicionados aos
ambientes locais ou do sistema. Você pode usar esse comando com um nome de
variável e sem valor para remover um valor correspondente do ambiente local.

Os valores do registro REG_DWORD são extraídos e usados no modo hexadecimal.

O modo de arquivo dá suporte apenas à análise de arquivos de texto CRLF


(retorno de carro e alimentação de linha).

A execução desse comando em uma variável existente remove todas as referências


de variáveis e usa valores expandidos.

Por exemplo, se a variável %PATH% tiver uma referência a %JAVADIR%, e %PATH%


for manipulada usando setx, %JAVADIR% será expandida e seu valor será atribuído
diretamente à variável de destino %PATH%. Isso significa que as atualizações
futuras para %JAVADIR% não serão refletidas na variável %PATH%.

Lembre-se de que há um limite de 1024 caracteres na atribuição de conteúdo a


uma variável usando setx.

Isso significa que o conteúdo será cortado se você ultrapassar 1024 caracteres e
que o texto cortado é o que é aplicado à variável de destino. Se esse texto cortado
for aplicado a uma variável existente, isso poderá resultar na perda de dados
anteriormente mantidos pela variável de destino.

Exemplos
Para definir a variável de ambiente MACHINE no ambiente local com o valor Brand1,
digite:

setx MACHINE Brand1

Para definir a variável de ambiente MACHINE no ambiente do sistema com o valor


Brand1 Computer, digite:

setx MACHINE Brand1 Computer /m

Para definir a variável de ambiente MYPATH no ambiente local e usar o caminho de


pesquisa definido na variável de ambiente PATH, digite:
setx MYPATH %PATH%

Para definir a variável de ambiente MYPATH no ambiente local e usar o caminho de


pesquisa definido na variável de ambiente PATH depois de substituir ~ por %, digite:

setx MYPATH ~PATH~

Para definir a variável de ambiente MACHINE no ambiente local como Brand1 em um


computador remoto chamado computer1, digite:

setx /s computer1 /u maindom\hiropln /p p@ssW23 MACHINE Brand1

Para definir a variável de ambiente MYPATH no ambiente local e usar o caminho de


pesquisa definido na variável de ambiente PATH em um computador remoto chamado
computer1, digite:

setx /s computer1 /u maindom\hiropln /p p@ssW23 MYPATH %PATH%

Para definir a variável de ambiente TZONE no ambiente local com o valor encontrado na
chave do Registro
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\Sta
ndardName, digite:

setx TZONE /k
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\Stan
dardName

Para definir a variável de ambiente TZONE no ambiente local de um computador remoto


chamado computer1 com o valor encontrado na chave do registro
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\Sta
ndardName, digite:
setx /s computer1 /u maindom\hiropln /p p@ssW23 TZONE /k
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\Stan
dardName

Para definir a variável de ambiente BUILD no ambiente do sistema com o valor


encontrado na chave do registro
HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuil
dNumber, digite:

setx BUILD /k
HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildN
umber /m

Para definir a variável de ambiente BUILD no ambiente do sistema de um computador


remoto chamado Computer1 com o valor encontrado na chave do Registro
HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuil
dNumber, digite:

setx /s computer1 /u maindom\hiropln /p p@ssW23 BUILD /k


HKEY_LOCAL_MACHINE\Software\Microsoft\Windows
NT\CurrentVersion\CurrentBuildNumber /m

Para exibir o conteúdo de um arquivo chamado Ipconfig.out, juntamente com as


coordenadas correspondentes do conteúdo, digite:

setx /f ipconfig.out /x

Para definir a variável de ambiente IPADDR no ambiente local com o valor encontrado
na coordenada 5,11 no arquivo Ipconfig.out, digite:

setx IPADDR /f ipconfig.out /a 5,11

Para definir a variável de ambiente OCTET1 no ambiente local com o valor encontrado
na coordenada 5,3 no arquivo Ipconfig.out com delimitadores #$*., digite:
setx OCTET1 /f ipconfig.out /a 5,3 /d #$*.

Para definir a variável de ambiente IPGATEWAY no ambiente local com o valor


encontrado na coordenada 0,7 em relação à coordenada do Gateway no arquivo
Ipconfig.out, digite:

setx IPGATEWAY /f ipconfig.out /r 0,7 Gateway

Para exibir o conteúdo do arquivo Ipconfig.out, juntamente com as coordenadas


correspondentes do conteúdo, em um computador chamado computer1, digite:

setx /s computer1 /u maindom\hiropln /p p@ssW23 /f ipconfig.out /x

Links relacionados
Chave da sintaxe de linha de comando
sfc
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Examina e verifica a integridade de todos os arquivos de sistema protegidos e substitui


as versões incorretas pelas versões corretas. Se esse comando descobrir que um arquivo
protegido foi substituído, ele recuperará a versão correta do arquivo na pasta
systemroot\ e substituirá o arquivo incorreto.

) Importante

Você deve estar conectado como membro do grupo Administradores para executar
este comando.

Sintaxe

sfc [/scannow] [/verifyonly] [/scanfile=<file>] [/verifyfile=<file>]


[/offwindir=<offline windows directory> /offbootdir=<offline boot directory>
/offlogfile=<log file path>]

Parâmetros

Parâmetro Descrição

/scannow Examina a integridade de todos os arquivos de sistema protegidos e


repara os arquivos com problemas, quando possível.

/verifyonly Examina a integridade de todos os arquivos de sistema protegidos, sem


executar reparos.

/scanfile <file> Examina a integridade do arquivo especificado (caminho completo e nome


do arquivo) e tenta reparar os problemas, se forem detectados.

/verifyfile <file> Verifica a integridade do arquivo especificado (caminho completo e nome


do arquivo), sem executar reparos.
Parâmetro Descrição

/offwindir <offline Especifica o local do diretório do Windows offline para reparo offline.
windows directory>

/offbootdir <offline Especifica o local do diretório de inicialização offline para reparo offline.
boot directory>

/offlogfile= <log Especifica um local para armazenar o arquivo de log diferente do padrão.
file path>

/? Exibe a ajuda no prompt de comando.

Exemplos
Para verificar o arquivo kernel32.dll, digite:

sfc /verifyfile=c:\windows\system32\kernel32.dll

Para configurar o reparo offline do arquivo kernel32.dll com um diretório de inicialização


offline definido como D: e um diretório offline do Windows definido como D:\Windows,
digite:

sfc /scanfile=D:\windows\system32\kernel32.dll /offbootdir=D:\


/offwindir=d:\windows

Links relacionados
Chave da sintaxe de linha de comando
shadow
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Permite controlar remotamente uma sessão ativa de outro usuário em um servidor host
da Sessão da Área de Trabalho Remota.

Sintaxe

shadow {<sessionname> | <sessionID>} [/server:<servername>] [/v]

Parâmetros

Parâmetro Descrição

<sessionname> Especifica o nome da sessão que você deseja controlar remotamente.

<sessionID> Especifica a ID da sessão que você deseja controlar remotamente. Use o


query user para exibir a lista de sessões e as IDs de sessão.

/server: <servername> Especifica o servidor host da Sessão da Área de Trabalho Remota que
contém a sessão que você deseja controlar remotamente. Por padrão, o
servidor Host4 da Sessão da Área de Trabalho Remota atual será usado.

/v Exibe as informações sobre as ações sendo executadas.

/? Exibe a ajuda no prompt de comando.

Comentários
Você pode exibir ou controlar ativamente a sessão. Se você optar por controlar
ativamente a sessão de um usuário, poderá inserir ações de teclado e mouse na
sessão.

Você sempre pode controlar remotamente suas próprias sessões (exceto a sessão
atual), mas precisa ter permissão de Controle Total ou permissão de acesso
especial de Controle Remoto para controlar remotamente outra sessão.
Você também pode iniciar o controle remoto usando o Gerenciador de Serviços de
Área de Trabalho Remota.

Antes do início do monitoramento, o servidor avisa ao usuário que a sessão está


prestes a ser controlada remotamente, a menos que esse aviso esteja desabilitado.
Pode parecer que a sessão está paralisada por alguns segundos, enquanto
aguarda uma resposta do usuário. Para configurar o controle remoto para usuários
e sessões, use a ferramenta Configuração de Serviços de Área de Trabalho Remota
ou as extensões dos Serviços de Área de Trabalho Remota para os Usuários e
Grupos Locais e os usuários e computadores do Active Directory.

Sua sessão deve ser compatível com a resolução de vídeo usada na sessão que
você está controlando remotamente ou a operação falhará.

A sessão do console não pode controlar remotamente outra sessão nem pode ser
controlada remotamente por outra sessão.

Quando quiser encerrar o controle remoto (sombreamento), pressione CTRL+ *


(usando * somente no teclado numérico).

Exemplos
Para sombrear a sessão 93, digite:

shadow 93

Para sombrear a sessão ACCTG01, digite:

shadow ACCTG01

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
shift
Artigo • 11/04/2023

Altera a posição dos parâmetros de lote em um arquivo em lote.

Sintaxe

shift [/n <N>]

Parâmetros

Parâmetro Descrição

/n <N> Especifica para começar a mudar no argumento N, em que N é qualquer valor de 0


a 8. Requer extensões de comando, que são habilitadas por padrão.

/? Exibe a ajuda no prompt de comando.

Comentários
O comando shift altera os valores dos parâmetros de lote %0 a %9 copiando cada
parâmetro para o anterior; o valor %1 é copiado para %0, o valor %2 é copiado
para %1 e assim por diante. Isso é útil para gravar um arquivo em lote que executa
a mesma operação em qualquer quantidade de parâmetros.

Se as extensões de comando estiverem habilitadas, o comando shift terá suporte


para a opção da linha de comando /n. A opção /n especifica para começar a
alterar no argumento N, em que N é qualquer valor de 0 a 8. Por exemplo, SHIFT
/2 mudaria %3 para %2, %4 para %3 etc., sem afetar %0 e %1. As extensões de
comando são ativadas por padrão.

Você pode usar o comando shift para criar um arquivo em lote que pode aceitar
mais de 10 parâmetros de lote. Se você especificar mais de 10 parâmetros na linha
de comando, aqueles que aparecerem após o décimo (%9) serão deslocados um
de cada vez para %9.

O comando shift não tem nenhum efeito sobre o parâmetro de lote %*.
Não há nenhum comando shift inverso. Depois de implementar o comando shift,
você não poderá recuperar o parâmetro de lote (%0) que existia antes do
deslocamento.

Exemplos
Para usar um arquivo em lote, chamado Mycopy.bat, para copiar uma lista de arquivos
para um diretório específico, digite:

@echo off
rem MYCOPY.BAT copies any number of files
rem to a directory.
rem The command uses the following syntax:
rem mycopy dir file1 file2 ...
set todir=%1
:getfile
shift
if "%1"=="" goto end
copy %1 %todir%
goto getfile
:end
set todir=
echo All done

Links relacionados
Chave da sintaxe de linha de comando
showmount
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Você pode usar showmount para exibir informações sobre os sistemas de arquivos
montados e exportados pelo servidor para NFS em um computador especificado. Se
você não especificar um servidor, esse comando exibirá informações sobre o
computador no qual o comando showmount é executado.

Sintaxe

showmount {-e|-a|-d} <server>

Parâmetros

Parâmetro Descrição

-E Exibe todos os sistemas de arquivos exportados no servidor.

-a Exibe todos os clientes NFS (Sistema de Arquivos de Rede) e os diretórios no


servidor que cada um deles montou.

-d Exibe todos os diretórios no servidor que estão montados atualmente pelos clientes
NFS.

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos dos Serviços para Network File System


shrink
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

O comando DiskPart shrink reduz o tamanho do volume selecionado pelo valor


especificado. Esse comando disponibiliza espaço livre em disco no espaço não utilizado
no fim do volume.

Um volume deve ser selecionado para que essa operação seja bem-sucedida. Use o
comando select volume para selecionar um volume e mudar o foco para ele.

7 Observação

Esse comando funciona em volumes básicos e em volumes dinâmicos simples ou


estendidos. Ele não funciona em partições OEM (fabricante original do
equipamento), partições do sistema EFI ou partições de recuperação.

Sintaxe

shrink [desired=<n>] [minimum=<n>] [nowait] [noerr]


shrink querymax [noerr]

Parâmetros

Parâmetro Descrição

desired= <n> Especifica a quantidade desejada de espaço em megabytes (MB) para reduzir o
tamanho do volume.

minimum= <n> Especifica a quantidade mínima de espaço em MB para reduzir o tamanho do


volume.

querymax Retorna a quantidade máxima de espaço em MB pela qual o volume pode ser
reduzido. Esse valor poderá ser alterado, se os aplicativos estiverem acessando o
volume no momento.
Parâmetro Descrição

nowait Força o comando a retornar imediatamente, enquanto o processo de redução


ainda está em andamento.

noerr Somente para script. Quando um erro é encontrado, o DiskPart continua a


processar os comandos como se o erro não tivesse ocorrido. Sem esse
parâmetro, um erro faz com que o DiskPart saia com um código de erro.

Comentários
Você só poderá reduzir o tamanho de um volume, se ele for formatado usando o
sistema de arquivos NTFS ou se ele não tiver um sistema de arquivos.

Se um valor desejado não for especificado, o volume será reduzido pelo valor
mínimo (se especificado).

Se um valor mínimo não for especificada, o volume será reduzido pelo valor
desejado (se especificado).

Se nem um valor mínimo nem um valor desejado forem especificados, o volume


será reduzido pelo máximo possível.

Se um valor mínimo for especificado, mas não houver espaço livre suficiente
disponível, o comando falhará.

Exemplos
Para reduzir o tamanho do volume selecionado pelo maior valor possível entre 250 e
500 megabytes, digite:

shrink desired=500 minimum=250

Para exibir o número máximo de MB pelo qual o volume pode ser reduzido, digite:

shrink querymax

Links relacionados
Chave da sintaxe de linha de comando

Resize-Partition
shutdown
Artigo • 25/05/2023

Permite desligar ou reiniciar computadores locais ou remotos um por vez.

Sintaxe

shutdown [/i | /l | /s | /sg | /r | /g | /a | /p | /h | /e | /o] [/hybrid]


[/fw] [/f] [/m \\computer][/t xxx][/d [p|u:]xx:yy [/c "comment"]]

Parâmetros

Parâmetro Descrição

/i Exibe a caixa Desligamento Remoto. A opção /i deve ser o primeiro parâmetro


após o comando. Se /i for especificado, todas as outras opções serão ignoradas.

/l Faz logoff do usuário atual imediatamente, sem período de tempo limite. Não é
possível usar /l com /m ou /t.

/s Desliga o computador.

/sg Desliga o computador. Na próxima inicialização, se o Logon de Reinicialização


Automática estiver habilitado, o dispositivo será conectado automaticamente e
será bloqueado com base no último usuário interativo. Depois de entrar, ele
reinicia todos os aplicativos registrados.

/r Reinicia o computador após o desligamento.

/g Desliga o computador. Na próxima reinicialização, se o Logon de


Reinicialização Automática estiver habilitado, o dispositivo será conectado
automaticamente e será bloqueado com base no último usuário interativo.
Depois de entrar, ele reinicia todos os aplicativos registrados.

/a Anula um desligamento do sistema. Isso só pode ser usado durante o período


de tempo limite. Combine com /fw para limpar as inicializações pendentes no
firmware.

/p Desativa apenas o computador local (não um computador remoto), sem


nenhum período de tempo limite ou aviso. Você pode usar /p somente com /d
ou /f. Se o computador não dá suporte à funcionalidade de desligamento, ele
desliga quando você usar /p, mas a energia do computador permanecerá
ativada.
Parâmetro Descrição

/h Coloca o computador local em hibernação, se a hibernação estiver habilitada. A


opção /f pode ser usada com a opção /h.

/hybrid Desliga o dispositivo e o prepara para a inicialização rápida. Essa opção deve ser
usada com a opção /s.

/fw Combinar essa opção com uma opção de desligamento faz com que a próxima
reinicialização vá para a interface do usuário do firmware.

/e Permite documentar o motivo de um desligamento inesperado de um


computador no Rastreador de Eventos de Desligamento.

/o Vai para o menu Opções de inicialização avançadas e reinicia o dispositivo. Essa


opção deve ser usada com a opção /s.

/f Força o fechamento dos aplicativos em execução sem avisar os usuários.


Cuidado: usar a opção /f pode resultar em perda de dados não salvos.

/m \\ Especifica o computador de destino. Não pode ser usado com a opção /l.
<computername>

/t <xxx> Define o período de tempo limite antes do desligamento em xxx segundos. O


intervalo válido é de 0 a 315360000 (10 anos), com um valor padrão de 30. Se o
período de tempo limite for maior que 0, o parâmetro /f estará implícito.

/d [p \| u:] Lista o motivo da reinicialização ou desligamento do sistema. Os valores de


<xx>:<yy> parâmetro com suporte são:
P – Indica que a reinicialização ou desligamento está planejado.
U – Indica que o motivo é definido pelo usuário.

OBSERVAÇÃO
Se p ou u não forem especificados, a reinicialização ou o desligamento
não será planejado.
xx – Especifica o número principal do motivo (um inteiro positivo, menor
que 256).
yy – Especifica o número secundário do motivo (um inteiro positivo,
menor que 65536).

/c <comment> Permite que você explique detalhadamente a razão do desligamento. Primeiro,


você deve fornecer um motivo usando a opção /d e deve colocar seus
comentários entre aspas. É possível usar até 511 caracteres.

/? Exibe a ajuda no prompt de comando, incluindo uma lista dos motivos


principais e secundários definidos no computador local.

Comentários
Os usuários devem receber o direito de uso de desligar o do sistema para desligar
um computador local ou administrado remotamente que esteja usando o
comando de desligamento.

Os usuários devem ser membros do grupo de Administradores para anotar um


desligamento inesperado de um computador local ou administrado remotamente.
Se o computador de destino estiver em um domínio, é possível que os membros
do grupo de Administradores de Domínio possam executar esse procedimento.
Para obter mais informações, consulte:

Grupos locais padrão

Grupos padrão

Se você quiser desligar mais de um computador por vez, poderá chamar o


desligamento de cada computador usando um script ou pode usar o
desligamento/i para exibir a caixa Desligamento Remoto.

Se você especificar códigos de motivo principais e secundários, primeiro defina


esses códigos de motivo em cada computador em que planeja usar os motivos. Se
os códigos de motivo não estiverem definidos no computador de destino, o
Rastreador de Eventos de Desligamento não poderá registrar o texto correto do
motivo.

Lembre-se de indicar que um desligamento está planejado usando o parâmetro p.


Não usar o parâmetro p indica que o desligamento não foi planejado.

O uso do parâmetro p ao longo do código de motivo para um desligamento


não planejado faz com que o desligamento falhe.

Não usar o parâmetro p e fornecer apenas o código de motivo para um


desligamento planejado também faz com que o desligamento falhe.

Exemplos
Para forçar os aplicativos a fechar e reiniciar o computador local após um atraso de um
minuto, com o motivo Aplicativo: Manutenção (Planejado) e o comentário
“Reconfigurando myapp.exe”, digite:

shutdown /r /t 60 /c "Reconfiguring myapp.exe" /f /d p:4:1


Para reiniciar o computador remoto myremoteserver com os mesmos parâmetros do
exemplo anterior, digite:

shutdown /r /m \\myremoteserver /t 60 /c "Reconfiguring myapp.exe" /f /d


p:4:1

Para reiniciar o computador remoto myremoteserver em 5 minutos devido a uma


atualização de segurança e incluir esse motivo no rastreador de eventos de
desligamento, digite:

shutdown /r /t 300 /e /c "Security Update" /m \\myremoteserver

Links relacionados
Chave da sintaxe de linha de comando
Simulate restore
Artigo • 17/04/2023

Testa se o envolvimento do gravador em sessões de restauração será bem-sucedido no


computador sem emitir eventos PreRestore ou PostRestore para gravadores.

7 Observação

Um arquivo de metadados DiskShadow precisa ser selecionado para que o


comando simulate restore seja bem-sucedido. Use o comando load metadata a
fim de carregar os gravadores e componentes selecionados para a restauração.

Syntax

simulate restore

Links relacionados
Chave da sintaxe de linha de comando

Comando load metadata


sort
Artigo • 12/04/2023

Lê a entrada, classifica os dados e grava os resultados na tela, em um arquivo ou em


outro dispositivo.

Sintaxe

sort [/r] [/+<N>] [/m <kilobytes>] [/l <locale>] [/rec <characters>]


[[<drive1>:][<path1>]<filename1>] [/t [<drive2>:][<path2>]] [/o [<drive3>:]
[<path3>]<filename3>]

Parâmetros

Parâmetro Descrição

/r Inverte a ordem de classificação (ou seja, classifica de Z para A e de 9 a 0).

/+<N> Especifica o número da posição do caractere em que o comando sort iniciará


cada comparação. N pode ser qualquer inteiro válido.

/m Especifica a quantidade de memória principal a ser usada para a classificação em


<kilobytes> quilobytes (KB).

/l <locale> Substitui a ordem de classificação de caracteres definida pela localidade padrão


do sistema (ou seja, o idioma e o País/Região selecionados durante a instalação).

/rec Especifica o número máximo de caracteres em um registro ou uma linha do


<characters> arquivo de entrada (o valor padrão é 4.096 e o máximo é 65.535).

[<drive1>:] Especifica o arquivo a ser classificado. Se nenhum nome de arquivo for


[<path1>] especificado, a entrada padrão será classificada. Especificar o arquivo de entrada
<filename1> é mais rápido do que redirecionar o mesmo arquivo como entrada padrão.

/t Especifica o caminho do diretório para manter o armazenamento em


[<drive2>:] funcionamento do comando sort se os dados não se ajustarem à memória
[<path2>] principal. Por padrão, é usado o diretório temporário do sistema.

/o Especifica o arquivo no qual armazenar a entrada classificada. Se não estiver


[<drive3>:] especificado, os dados são gravados na saída padrão. Especificar o arquivo de
[<path3>] saída é mais rápido do que redirecionar a saída padrão para o mesmo arquivo.
<filename3>
Parâmetro Descrição

/unique Retorna apenas resultados exclusivos.

/? Exibe a ajuda no prompt de comando.

Comentários

Por padrão, as comparações começam no primeiro caractere de cada linha. A


opção /+ da linha de comando inicia comparações no caractere especificado por
N. Por exemplo, /+3 indica que cada comparação deve começar no terceiro
caractere de cada linha. Linhas com menos de N caracteres são agrupadas antes
de outras linhas.

A memória usada é sempre um mínimo de 160 KB. Se o tamanho da memória for


especificado, a quantidade especificada exata será usada para a classificação (deve
ser de pelo menos 160 KB), independentemente da quantidade de memória
principal disponível.

O tamanho máximo de memória padrão quando nenhum tamanho for


especificado é 90% da memória principal disponível se a entrada e a saída forem
arquivos ou, caso contrário, 45% da memória principal. A configuração padrão
geralmente oferece o melhor desempenho.

Atualmente, a única alternativa à localidade padrão é a localidade C, que é mais


rápida do que a classificação de linguagem natural (classifica caracteres de acordo
com suas codificações binárias).

Você pode usar o símbolo de pipe ( | ) para direcionar dados de entrada para o
comando sort de outro comando ou para direcionar a saída classificada para outro
comando. Você pode especificar arquivos de entrada e saída usando símbolos de
redirecionamento ( < ou > ). Pode ser mais rápido e eficiente (especialmente com
arquivos grandes) especificar o arquivo de entrada diretamente (conforme
definido por filename1 na sintaxe de comando) e especificar o arquivo de saída
usando o parâmetro /o.

O comando sort não distingue entre letras maiúsculas e minúsculas e não tem
limite no tamanho do arquivo.

O programa de classificação usa a tabela de sequência de ordenação que


corresponde às configurações de código País/Região e página de código.
Caracteres maiores que o código ASCII 127 são classificados com base em
informações no arquivo Country.sys ou em um arquivo alternativo especificado
pelo comando country no arquivo Config.nt.

Se a classificação se ajustar ao tamanho máximo da memória (conforme definido


por padrão ou conforme especificado pelo parâmetro /m ), a classificação será
executada em uma única passagem. Caso contrário, a classificação é executada em
duas passagens de classificação e mesclagem separadas, e as quantidades de
memória usadas para ambas as passagens são iguais. Quando duas passagens são
executadas, os dados parcialmente classificados são armazenados em um arquivo
temporário no disco. Se não houver memória suficiente para executar a
classificação em duas passagens, será emitido um erro em tempo de execução. Se
a opção de linha de comando /m for usada para especificar mais memória do que
está realmente disponível, poderá ocorrer degradação de desempenho ou erro em
tempo de execução.

Exemplos
Para classificar e exibir, em ordem inversa, as linhas em um arquivo chamado
expenses.txt, digite:

sort /r expenses.txt

Para pesquisar um arquivo grande chamado maillist.txt pelo texto Jones e


classificar os resultados da pesquisa usando o pipe ( | ) para direcionar a saída de
um comando find para o comando sort, digite:

find Jones maillist.txt | sort

O comando produz uma lista classificada de linhas que contêm o texto


especificado.

Para classificar a entrada do teclado e exibir os resultados em ordem alfabética na


tela, primeiro você pode usar o comando sort sem parâmetros digitando:

sort
Em seguida, digite o texto que você deseja classificar e pressione ENTER no final
de cada linha. Quando terminar de digitar o texto, pressione CTRL+Z e, em
seguida, ENTER. O comando sort exibe o texto digitado, classificado em ordem
alfabética.

Links relacionados
Chave da sintaxe de linha de comando
iniciar
Artigo • 12/04/2023

Inicia uma janela separada Prompt de Comando para executar um programa ou


comando especificado.

Syntax

start ["title"] [/d <path>] [/i] [{/min | /max}] [{/separate | /shared}]


[{/low | /normal | /high | /realtime | /abovenormal | /belownormal}] [/node
<NUMA node>] [/affinity <hexaffinity>] [/wait] [/b] [/machine
<x86|amd64|arm|arm64>] [<command> [<parameter>... ] | <program>
[<parameter>... ]]

7 Observação

O parâmetro machine está atualmente na VERSÃO PRÉVIA apenas para o Windows


11. O parâmetro está disponível a partir do Windows 11 Insider, compilação de
pré-visualização 22557 . Estas informações estão relacionadas a um produto de
pré-lançamento, que pode ser bastante modificado antes de ser lançado. A
Microsoft não faz nenhuma garantia, expressa ou implícita, com relação às
informações fornecidas aqui.

Parâmetros

Parâmetro Descrição

<"title"> Especifica o título a ser exibido na barra de título da janela Prompt


de Comando.

/d <path> Especifica o diretório de inicialização.

/i Passa o ambiente de inicialização Cmd.exe para a nova janela


Prompt de Comando. Se /i não for especificado, o ambiente atual
será usado.

{/min \| /max} Especifica para minimizar ( /min ) ou maximizar ( /max ) a nova janela
Prompt de Comando.
Parâmetro Descrição

{/separate \| /shared} Inicia programas de 16 bits em um espaço de memória separado


( /separate ) ou espaço de memória compartilhado (/shared). Essas
opções não têm suporte em plataformas de 64 bits.

{/low \| /normal \| Inicia um aplicativo na classe de prioridade especificada.


/high \| /realtime \|
/abovenormal \|
/belownormal}

/node <NUMA node> Especifica o nó NUMA (Arquitetura de Memória Não Uniforme)


preferencial como um inteiro decimal.

/affinity <hexaffinity> Aplica a máscara de afinidade de processador especificada (expressa


como um número hexadecimal) ao novo aplicativo.

/wait Inicia um aplicativo e aguarda que ele termine.

/b Inicia um aplicativo sem abrir uma nova janela Prompt de Comando.


A manipulação de CTRL+C é ignorada, a menos que o aplicativo
habilite o processamento CTRL+C. Use CTRL+BREAK para
interromper o aplicativo.

/machine Especifica a arquitetura do computador do processo do aplicativo.


<x86\|amd64\|arm\|arm64>

[<command> Especifica o comando ou programa a ser iniciado.


[<parameter>... ] \|
<program>
[<parameter>... ]]

<parameter> Especifica parâmetros a serem passados para o comando ou o


programa.

/? Exibe a ajuda no prompt de comando.

Comentários

Você pode executar arquivos não executáveis por meio de sua associação de
arquivos digitando o nome do arquivo como um comando.

Se você executar um comando que contém o CMD da cadeia de caracteres como


o primeiro token sem um qualificador de extensão ou caminho, o CMD será
substituído pelo valor da variável COMSPEC. Isso impede que os usuários
selecionem cmd no diretório atual.
Se você executar um aplicativo GUI (interface gráfica do usuário) de 32 bits, cmd
não aguardará que o aplicativo seja encerrado antes de retornar ao prompt de
comando. Esse comportamento não ocorrerá se você executar o aplicativo de um
script de comando.

Se você executar um comando que usa um primeiro token que não seja um
comando ou o caminho do arquivo para um arquivo existente com uma extensão,
Cmd.exe usará o valor da variável de ambiente PATHEXT para determinar quais
extensões procurar e em qual ordem. O valor padrão para a variável PATHEXT é
.COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH;.MSC

Observe que a sintaxe é igual à variável PATH, com ponto e vírgula (;) separando
cada extensão.

start pesquisa um arquivo executável especificado e, se encontrado, o executável


será iniciado independentemente do diretório de trabalho atual. Ao pesquisar um
arquivo executável, se não houver correspondência em nenhuma extensão, start
verifica se o nome corresponde a um nome de diretório. Se isso acontecer, start
abre Explorer.exe nesse caminho.

Exemplos
Para iniciar o programa Myapp no prompt de comando e manter o uso da janela atual
Prompt de Comando, digite:

Prompt de comando do Windows

start Myapp

Para exibir o tópico da ajuda da linha de comando start em uma janela maximizada
separada Prompt de Comando, digite:

Prompt de comando do Windows

start /max start /?

Links relacionados
Chave da sintaxe de linha de comando
subst
Artigo • 11/04/2023

Associa um caminho a uma letra de unidade. Se usado sem parâmetros, subst exibe os
nomes das unidades virtuais em vigor.

Sintaxe

subst [<drive1>: [<drive2>:]<path>]


subst <drive1>: /d

Parâmetros

Parâmetro Descrição

<drive1>: Especifica a unidade virtual à qual você deseja atribuir um caminho.

[<drive2>:] Especifica a unidade física e o caminho que você deseja atribuir a uma
<path> unidade virtual.

/d Exclui uma unidade (virtual) substituída.

/? Exibe a ajuda no prompt de comando.

Comentários
Os comandos a seguir não funcionam e não devem ser usados nas unidades
especificadas no comando subst:

comando chkdsk

comando diskcomp

comando diskcopy

comando format

comando label

comando recover
O parâmetro <drive1> deve estar dentro do intervalo especificado pelo comando
lastdrive. Caso contrário, subst exibe a seguinte mensagem de erro: Invalid
parameter - drive1:

Exemplos
Para criar uma unidade virtual z para o caminho b:\user\betty\forms, digite:

subst z: b:\user\betty\forms

Em vez de digitar o caminho completo, você pode acessar esse diretório digitando a
letra da unidade virtual seguida de dois pontos como a seguir:

z:

Links relacionados
Chave da sintaxe de linha de comando
sxstrace
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Diagnostica problemas lado a lado.

Sintaxe

sxstrace [{[trace -logfile:<filename> [-nostop]|[parse -logfile:<filename> -


outfile:<parsedfile> [-filter:<appname>]}]

Parâmetros

Parâmetro DESCRIÇÃO

rastreamento Habilita o rastreamento lado a lado.

-logfile Especifica o arquivo de log bruto.

<filename> Salva o log de rastreamento em <filename .

-nostop Especifica que você não deve receber um prompt para interromper o
rastreamento.

analisar Converte o arquivo de rastreamento bruto.

-outfile Especifica o nome do arquivo de saída.

<parsedfile> Especifica o nome do arquivo analisado.

-filter Permite que a saída seja filtrada.

<appname> Especifica o nome do aplicativo.

stoptrace Interrompe o rastreamento, se ainda não foi interrompido.

-? Exibe a ajuda no prompt de comando.

Exemplos
Para habilitar o rastreamento e salvar o arquivo de rastreamento em sxstrace.etl, digite:

sxstrace trace -logfile:sxstrace.etl

Para converter o arquivo de rastreamento bruto em um formato legível e salvar o


resultado como emsxstrace.txt, digite:

sxstrace parse -logfile:sxstrace.etl -outfile:sxstrace.txt

Links relacionados
Chave da sintaxe de linha de comando
sysocmgr
Artigo • 12/04/2023

O comando sysocmger foi preterido e não há garantia de que tenha suporte nas
versões futuras do Windows.
systeminfo
Artigo • 12/04/2023

Exibe as informações detalhadas de configuração sobre um computador e seu sistema


operacional, incluindo configuração do sistema operacional, informações de segurança,
ID do produto e propriedades de hardware (como RAM, espaço em disco e cartões de
rede).

Sintaxe

systeminfo [/s <computer> [/u <domain>\<username> [/p <password>]]] [/fo


{TABLE | LIST | CSV}] [/nh]

Parâmetros

Parâmetro Descrição

/s Especifica o nome ou o endereço IP de um computador remoto (não use barras


<computer> invertidas). O padrão é o computador local.

/u Executa o comando com as permissões de conta da conta de usuário especificada.


<domain>\ Se /u não for especificado, esse comando usará as permissões do usuário
<username> conectado ao computador que está emitindo o comando.

/p Especifica a senha da conta de usuário especificada no parâmetro /u.


<password>

/fo Especifica o formato de saída com um dos seguintes valores:


<format> TABLE – Exibe a saída em uma tabela.
LIST – Exibe a saída em uma lista.
CSV – Exibe a saída no formato de valores separados por vírgulas (.csv).

/nh Suprime os cabeçalhos de coluna na saída. Válido quando o parâmetro /fo é


definido como TABLE ou CSV.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para exibir as informações de configuração de um computador chamado Srvmain,
digite:

systeminfo /s srvmain

Para exibir remotamente as informações de configuração de um computador chamado


Srvmain2, localizado no domínio Maindom, digite:

systeminfo /s srvmain2 /u maindom\hiropln

Para exibir remotamente as informações de configuração (no formato de lista) de um


computador chamado Srvmain2, localizado no domínio Maindom, digite:

systeminfo /s srvmain2 /u maindom\hiropln /p p@ssW23 /fo list

Links relacionados
Chave da sintaxe de linha de comando
takeown
Artigo • 11/04/2023

Permite que um administrador recupere o acesso a um arquivo que foi negado


anteriormente, transformando-o no proprietário do arquivo. Esse comando
normalmente é usado em arquivos em lote.

Sintaxe

takeown [/s <computer> [/u [<domain>\]<username> [/p [<password>]]]] /f


<filename> [/a] [/r [/d {Y|N}]]

Parâmetros

Parâmetro Descrição

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (não use barras


invertidas). O valor padrão é o computador local. Esse parâmetro se aplica a
todos os arquivos e pastas especificados no comando.

/u Executa o script com as permissões da conta de usuário especificada. O valor


[<domain>\] padrão são as permissões do sistema.
<username>

/p Especifica a senha da conta de usuário especificada no parâmetro /u.


[<[password>]

/f <filename> Especifica o nome de arquivo ou o padrão do nome de diretório. Você pode usar
o caractere * curinga ao especificar o padrão. Também pode usar a sintaxe
<sharename>\<filename> .

/a Fornece a propriedade ao grupo Administradores em vez do usuário atual. Se


você não especificar essa opção, a propriedade do arquivo será dada ao usuário
que está conectado ao computador no momento.

/r Executa uma operação recursiva em todos os arquivos no diretório e nos


subdiretórios especificados.
Parâmetro Descrição

/d {Y | N} Omite o prompt de confirmação que é exibido quando o usuário atual não tem
a permissão Listar Pasta em um diretório especificado e, em vez disso, usa o
valor padrão especificado. Os valores válidos para a opção /d são:

Y: Assuma a propriedade do diretório.


N: Ignore o diretório.

OBSERVAÇÃO
Você deve usar essa opção junto com /r.

/? Exibe a ajuda no prompt de comando.

Comentários
Não há suporte para os padrões mistos usando (? e *) pelo comando takeown.

Depois de excluir o bloqueio com takeown, talvez seja necessário usar o Windows
Explorer para conceder a si mesmo permissões completas para os arquivos e os
diretórios antes de poder excluí-los.

Exemplos
Para assumir a propriedade de um arquivo chamado Lostfile, digite:

takeown /f lostfile

Links relacionados
Chave da sintaxe de linha de comando
tapicfg
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Criam, removem ou exibem uma partição de diretório de aplicativo TAPI ou definem


uma partição de diretório de aplicativo TAPI padrão. Os clientes do TAPI 3.1 podem usar
as informações nesta partição de diretório de aplicativo com o serviço localizador de
serviço de diretório para localizar e se comunicar com diretórios TAPI. Você também
pode usar o tapicfg para criar ou remover pontos de conexão de serviço, o que permite
que os clientes TAPI localizem com eficiência as partições de diretório de aplicativo TAPI
em um domínio.

Essa ferramenta da linha de comando pode ser executada em qualquer computador


membro do domínio.

Sintaxe

tapicfg install
tapicfg remove
tapicfg publishscp
tapicfg removescp
tapicfg show
tapicfg makedefault

Parâmetros

Parâmetros Descrição

tapicfg install Cria uma partição de diretório do aplicativo TAPI.

tapicfg remove Remove uma partição de diretório do aplicativo TAPI.

tapicfg Cria um ponto de conexão de serviço para publicar uma partição de diretório
publishscp do aplicativo TAPI.

tapicfg Remove um ponto de conexão de serviço para uma partição de diretório do


removescp aplicativo TAPI.
Parâmetros Descrição

tapicfg show Exibe os nomes e locais das partições de diretório de aplicativo TAPI no
domínio.

tapicfg Define a partição de diretório de aplicativo TAPI padrão do domínio.


makedefault

Comentários
Você deve ser membro do grupo Administradores Corporativos no Active
Directory para executar o tapicfg install (para criar uma partição de diretório de
aplicativos TAPI) ou o tapicfg remove (para remover uma partição do diretório de
aplicativos TAPI).

O texto fornecido pelo usuário (como os nomes de domínios, servidores e


partições de diretório do aplicativo TAPI) com caracteres Internacionais ou Unicode
só será exibido corretamente se o suporte a idiomas e fontes apropriadas
estiverem instalados.

Você ainda poderá usar servidores ILS (Serviço de Localizador de Internet) na


organização, se o ILS for necessário para dar suporte a determinados aplicativos,
pois os clientes TAPI que executam o Windows XP ou um sistema operacional
Windows Server 2003 podem consultar os servidores ILS ou as partições de
diretório do aplicativo TAPI.

Você pode usar tapicfg para criar ou remover pontos de conexão do serviço. Se a
partição de diretório do aplicativo TAPI for renomeada por qualquer motivo (por
exemplo, se você renomear o domínio no qual reside), será necessário remover o
ponto de conexão de serviço existente e criar um que contenha o novo nome DNS
da partição de diretório do aplicativo TAPI a ser publicada. Caso contrário, os
clientes TAPI não poderão localizar nem acessar a partição de diretório do
aplicativo TAPI. Você também pode remover um ponto de conexão de serviço para
fins de manutenção ou segurança (por exemplo, caso não queira expor os dados
TAPI em uma partição de diretório do aplicativo TAPI específica).

Links relacionados
Chave da sintaxe de linha de comando

tapicfg install

tapicfg remove
tapicfg publishscp

tapicfg removescp

tapicfg show

tapicfg makedefault
tapicfg install
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria uma partição de diretório do aplicativo TAPI.

) Importante

Você deve ser membro do grupo administradores corporativos no Active Directory


para executar esse comando.

Sintaxe

tapicfg install /directory:<partitionname> [/server:<DCname>]


[/forcedefault]

Parâmetros

Parâmetro Descrição

install Obrigatórios. Especifica o nome DNS da partição de diretório do aplicativo


/directory: TAPI a ser criada. Esse nome deve ser um nome de domínio totalmente
<partitionname> qualificado.

/server: Especifica o nome DNS do controlador de domínio no qual a partição de


<DCname> diretório do aplicativo TAPI é criada. Se o nome do controlador de domínio
não for especificado, o nome do computador local será usado.

/forcedefault Especifica que esse diretório é a partição de diretório do aplicativo TAPI padrão
para o domínio. Pode haver várias partições de diretório do aplicativo TAPI em
um domínio.
se esse diretório for a primeira partição de diretório do aplicativo TAPI criada
no domínio, ele será definido automaticamente como o padrão,
independentemente de você usar a opção /forcedefault.

/? Exibe a ajuda no prompt de comando.


Comentários
Essa ferramenta da linha de comando pode ser executada em qualquer
computador que seja membro do domínio.

O texto fornecido pelo usuário (como os nomes de partições de diretório do


aplicativo TAPI, servidores e domínios) com caracteres Internacionais ou Unicode
só será exibido corretamente se as fontes apropriadas e suporte a idiomas
estiverem instalados.

Você ainda pode usar servidores ILS (Serviço de Localizador de Internet) em sua
organização, se o ILS for necessário para dar suporte a determinados aplicativos,
pois os clientes TAPI que executam o Windows XP ou um sistema operacional
Windows Server 2003 podem consultar os servidores ILS ou as partições de
diretório do aplicativo TAPI.

Você pode usar tapicfg para criar ou remover os pontos de conexão do serviço. Se
a partição de diretório do aplicativo TAPI for renomeada por qualquer motivo (por
exemplo, se você renomear o domínio no qual reside), será necessário remover o
ponto de conexão de serviço existente e criar um novo que contenha o novo nome
DNS da partição de diretório do aplicativo TAPI a ser publicada. Caso contrário, os
clientes TAPI não poderão localizar nem acessar a partição de diretório do
aplicativo TAPI. Você também pode remover um ponto de conexão de serviço para
fins de manutenção ou segurança (por exemplo, se não quiser expor os dados TAPI
em uma partição de diretório do aplicativo TAPI específica).

Exemplos
Para criar uma partição de diretório do aplicativo TAPI chamada
tapifiction.testdom.microsoft.com em um servidor chamado testdc.testdom.microsoft.com
e defini-la como a partição padrão de diretório do aplicativo TAPI para o novo domínio,
digite:

tapicfg install /directory:tapifiction.testdom.microsoft.com


/server:testdc.testdom.microsoft.com /forcedefault

Links relacionados
Chave da sintaxe de linha de comando
tapicfg remove

tapicfg publishscp

tapicfg removescp

tapicfg show

tapicfg makedefault
tapicfg remove
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Remove uma partição de diretório do aplicativo TAPI.

) Importante

Você deve ser membro do grupo administradores corporativos no Active Directory


para executar esse comando.

Sintaxe

tapicfg remove /directory:<partitionname>

Parâmetros

Parâmetro Descrição

remova Obrigatórios. Especifica o nome DNS da partição de diretório do aplicativo


/directory: TAPI a ser removida. Observe que esse nome deve ser um nome de domínio
<partitionname> totalmente qualificado.

/? Exibe a ajuda no prompt de comando.

Comentários
Essa ferramenta da linha de comando pode ser executada em qualquer
computador membro do domínio.

O texto fornecido pelo usuário (como os nomes de domínios, servidores e


partições de diretório do aplicativo TAPI) com caracteres Internacionais ou Unicode
só será exibido corretamente se o suporte a idiomas e fontes apropriadas
estiverem instalados.
Você ainda poderá usar servidores ILS (Serviço de Localizador de Internet) na
organização, se o ILS for necessário para dar suporte a determinados aplicativos,
pois os clientes TAPI que executam o Windows XP ou um sistema operacional
Windows Server 2003 podem consultar os servidores ILS ou as partições de
diretório do aplicativo TAPI.

Você pode usar tapicfg para criar ou remover pontos de conexão do serviço. Se a
partição de diretório do aplicativo TAPI for renomeada por qualquer motivo (por
exemplo, se você renomear o domínio no qual reside), será necessário remover o
ponto de conexão de serviço existente e criar um que contenha o novo nome DNS
da partição de diretório do aplicativo TAPI a ser publicada. Caso contrário, os
clientes TAPI não poderão localizar nem acessar a partição de diretório do
aplicativo TAPI. Você também pode remover um ponto de conexão de serviço para
fins de manutenção ou segurança (por exemplo, caso não queira expor os dados
TAPI em uma partição de diretório do aplicativo TAPI específica).

Links relacionados
Chave da sintaxe de linha de comando

tapicfg install

tapicfg publishscp

tapicfg removescp

tapicfg show

tapicfg makedefault
tapicfg publishscp
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria um ponto de conexão de serviço para publicar uma partição de diretório do


aplicativo TAPI.

Sintaxe

tapicfg publishscp /directory:<partitionname> [/domain:<domainname>]


[/forcedefault]

Parâmetros

Parâmetro Descrição

publishscp Obrigatórios. Especifica o nome DNS da partição de diretório do aplicativo


/directory: TAPI que o ponto de conexão de serviço publicará.
<partitionname>

/domain: Especifica o nome DNS do domínio no qual o ponto de conexão de serviço é


<domainname> criado. Se o nome de domínio não for especificado, o nome do domínio local
será usado.

/forcedefault Especifica que esse diretório é a partição de diretório do aplicativo TAPI


padrão para o domínio. Pode haver várias partições de diretório do aplicativo
TAPI em um domínio.

/? Exibe a ajuda no prompt de comando.

Comentários
Essa ferramenta da linha de comando pode ser executada em qualquer
computador membro do domínio.

O texto fornecido pelo usuário (como os nomes de domínios, servidores e


partições de diretório do aplicativo TAPI) com caracteres Internacionais ou Unicode
só será exibido corretamente se o suporte a idiomas e fontes apropriadas
estiverem instalados.

Você ainda poderá usar servidores ILS (Serviço de Localizador de Internet) na


organização, se o ILS for necessário para dar suporte a determinados aplicativos,
pois os clientes TAPI que executam o Windows XP ou um sistema operacional
Windows Server 2003 podem consultar os servidores ILS ou as partições de
diretório do aplicativo TAPI.

Você pode usar tapicfg para criar ou remover pontos de conexão do serviço. Se a
partição de diretório do aplicativo TAPI for renomeada por qualquer motivo (por
exemplo, se você renomear o domínio no qual reside), será necessário remover o
ponto de conexão de serviço existente e criar um que contenha o novo nome DNS
da partição de diretório do aplicativo TAPI a ser publicada. Caso contrário, os
clientes TAPI não poderão localizar nem acessar a partição de diretório do
aplicativo TAPI. Você também pode remover um ponto de conexão de serviço para
fins de manutenção ou segurança (por exemplo, caso não queira expor os dados
TAPI em uma partição de diretório do aplicativo TAPI específica).

Links relacionados
Chave da sintaxe de linha de comando

tapicfg install

tapicfg remove

tapicfg removescp

tapicfg show

tapicfg makedefault
tapicfg removescp
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Remove um ponto de conexão de serviço para uma partição de diretório do aplicativo


TAPI.

Sintaxe

tapicfg removescp /directory:<partitionname> [/domain:<domainname>]

Parâmetros

Parâmetro Descrição

removescp Obrigatórios. Especifica o nome DNS da partição de diretório do aplicativo


/directory: TAPI em que um ponto de conexão de serviço é removido.
<partitionname>

/domain: Especifica o nome DNS do domínio do qual o ponto de conexão de serviço é


<domainname> removido. Se o nome de domínio não for especificado, o nome do domínio
local será usado.

/? Exibe a ajuda no prompt de comando.

Comentários
Essa ferramenta da linha de comando pode ser executada em qualquer
computador membro do domínio.

O texto fornecido pelo usuário (como os nomes de domínios, servidores e


partições de diretório do aplicativo TAPI) com caracteres Internacionais ou Unicode
só será exibido corretamente se o suporte a idiomas e fontes apropriadas
estiverem instalados.

Você ainda poderá usar servidores ILS (Serviço de Localizador de Internet) na


organização, se o ILS for necessário para dar suporte a determinados aplicativos,
pois os clientes TAPI que executam o Windows XP ou um sistema operacional
Windows Server 2003 podem consultar os servidores ILS ou as partições de
diretório do aplicativo TAPI.

Você pode usar tapicfg para criar ou remover pontos de conexão do serviço. Se a
partição de diretório do aplicativo TAPI for renomeada por qualquer motivo (por
exemplo, se você renomear o domínio no qual reside), será necessário remover o
ponto de conexão de serviço existente e criar um que contenha o novo nome DNS
da partição de diretório do aplicativo TAPI a ser publicada. Caso contrário, os
clientes TAPI não poderão localizar nem acessar a partição de diretório do
aplicativo TAPI. Você também pode remover um ponto de conexão de serviço para
fins de manutenção ou segurança (por exemplo, caso não queira expor os dados
TAPI em uma partição de diretório do aplicativo TAPI específica).

Links relacionados
Chave da sintaxe de linha de comando

tapicfg install

tapicfg remove

tapicfg publishscp

tapicfg show

tapicfg makedefault
tapicfg show
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe os nomes e locais das partições de diretório de aplicativo TAPI no domínio.

Sintaxe

tapicfg show [/defaultonly] [/domain:<domainname>]

Parâmetros

Parâmetro Descrição

/default only Exibe os nomes e locais apenas das partições de diretório de aplicativo TAPI
padrão no domínio.

/domain: Especifica o nome DNS do domínio para o qual as partições de diretório do


<domainname> aplicativo TAPI são exibidas. Se o nome de domínio não for especificado, o nome
do domínio local será usado.

/? Exibe a ajuda no prompt de comando.

Comentários
Essa ferramenta da linha de comando pode ser executada em qualquer
computador membro do domínio.

O texto fornecido pelo usuário (como os nomes de domínios, servidores e


partições de diretório do aplicativo TAPI) com caracteres Internacionais ou Unicode
só será exibido corretamente se o suporte a idiomas e fontes apropriadas
estiverem instalados.

Você ainda poderá usar servidores ILS (Serviço de Localizador de Internet) na


organização, se o ILS for necessário para dar suporte a determinados aplicativos,
pois os clientes TAPI que executam o Windows XP ou um sistema operacional
Windows Server 2003 podem consultar os servidores ILS ou as partições de
diretório do aplicativo TAPI.

Você pode usar tapicfg para criar ou remover pontos de conexão do serviço. Se a
partição de diretório do aplicativo TAPI for renomeada por qualquer motivo (por
exemplo, se você renomear o domínio no qual reside), será necessário remover o
ponto de conexão de serviço existente e criar um que contenha o novo nome DNS
da partição de diretório do aplicativo TAPI a ser publicada. Caso contrário, os
clientes TAPI não poderão localizar nem acessar a partição de diretório do
aplicativo TAPI. Você também pode remover um ponto de conexão de serviço para
fins de manutenção ou segurança (por exemplo, caso não queira expor os dados
TAPI em uma partição de diretório do aplicativo TAPI específica).

Exemplo
Para exibir o nome da partição de diretório de aplicativo TAPI padrão para o novo
domínio, digite:

tapicfg show /defaultonly

Links relacionados
Chave da sintaxe de linha de comando

tapicfg install

tapicfg remove

tapicfg publishscp

tapicfg removescp

tapicfg makedefault
tapicfg makedefault
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Define a partição de diretório de aplicativo TAPI padrão do domínio.

Sintaxe

tapicfg makedefault /directory:<partitionname> [/domain:<domainname>]

Parâmetros

Parâmetro Descrição

makedefault Obrigatórios. Especifica o nome DNS do conjunto de partições do diretório do


/directory: aplicativo TAPI como a partição padrão do domínio. Esse nome deve ser um
<partitionname> nome de domínio totalmente qualificado.

/domain: Especifica o nome DNS do domínio para o qual a partição do aplicativo TAPI é
<domainname> definida como o padrão. Se o nome de domínio não for especificado, o nome
do domínio local será usado.

/? Exibe a ajuda no prompt de comando.

Comentários
Essa ferramenta da linha de comando pode ser executada em qualquer
computador membro do domínio.

O texto fornecido pelo usuário (como os nomes de domínios, servidores e


partições de diretório do aplicativo TAPI) com caracteres Internacionais ou Unicode
só será exibido corretamente se o suporte a idiomas e fontes apropriadas
estiverem instalados.

Você ainda poderá usar servidores ILS (Serviço de Localizador de Internet) na


organização, se o ILS for necessário para dar suporte a determinados aplicativos,
pois os clientes TAPI que executam o Windows XP ou um sistema operacional
Windows Server 2003 podem consultar os servidores ILS ou as partições de
diretório do aplicativo TAPI.

Você pode usar tapicfg para criar ou remover pontos de conexão do serviço. Se a
partição de diretório do aplicativo TAPI for renomeada por qualquer motivo (por
exemplo, se você renomear o domínio no qual reside), será necessário remover o
ponto de conexão de serviço existente e criar um que contenha o novo nome DNS
da partição de diretório do aplicativo TAPI a ser publicada. Caso contrário, os
clientes TAPI não poderão localizar nem acessar a partição de diretório do
aplicativo TAPI. Você também pode remover um ponto de conexão de serviço para
fins de manutenção ou segurança (por exemplo, caso não queira expor os dados
TAPI em uma partição de diretório do aplicativo TAPI específica).

Links relacionados
Chave da sintaxe de linha de comando

tapicfg install

tapicfg remove

tapicfg publishscp

tapicfg removescp

tapicfg show
taskkill
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Termina uma ou mais tarefas ou processos. Os processos podem ser encerrados pela
identificação do processo ou nome da imagem. Você pode usar o comando tasklist para
determinar a PID (ID do processo) para que o processo seja encerrado.

7 Observação

Esse comando substitui a ferramenta kill.

Sintaxe

taskkill [/s <computer> [/u [<domain>\]<username> [/p [<password>]]]] {[/fi


<filter>] [...] [/pid <processID> | /im <imagename>]} [/f] [/t]

Parâmetros

Parâmetro Descrição

/s Especifica o nome ou o endereço IP de um computador remoto (não use barras


<computer> invertidas). O padrão é o computador local.

/u Executa o comando com as permissões de conta do usuário especificado por


<domain>\ <username> ou <domain>\<username> . O parâmetro /u só poderá ser especificado se
<username> /s também for. O padrão são as permissões do usuário conectado ao computador
que está emitindo o comando.

/p Especifica a senha da conta de usuário especificada no parâmetro /u.


<password>

/fi <filter> Aplica um filtro para selecionar um conjunto de tarefas. Você pode usar mais de
um filtro ou o caractere curinga ( * ) para especificar todas as tarefas ou nomes de
imagem. Os filtros válidos estão listados na seção Nomes, operadores e valores de
filtro deste artigo.
Parâmetro Descrição

/pid Especifica a ID do processo a ser encerrado.


<processID>

/im Especifica o nome da imagem do processo a ser encerrado. Use o caractere


<imagename> curinga ( * ) para especificar todos os nomes de imagem.

/f Especifica que os processos sejam encerrados obrigatoriamente. Esse parâmetro é


ignorado para processos remotos; todos os processos remotos são encerrados
obrigatoriamente.

/t Encerra o processo especificado e todos os processos filho iniciados por ele.

Nomes, operadores e valores de filtro

Nome do Operadores Valores válidos


filtro válidos

STATUS eq, ne RUNNING | NOT RESPONDING | UNKNOWN

IMAGENAME eq, ne Nome da imagem

PID eq, ne, gt, lt, Valor da PID


ge, le

SESSION eq, ne, gt, lt, Número da sessão


ge, le

CPUtime eq, ne, gt, lt, Hora da CPU no formato HH:MM:SS, em que MM e SS estão entre
ge, le 0 e 59 e HH é qualquer número sem sinal

MEMUSAGE eq, ne, gt, lt, Utilização de memória em KB


ge, le

USERNAME eq, ne Qualquer nome de usuário válido ( <user> ou <domain\user> )

SERVICES eq, ne Nome do serviço

WINDOWTITLE eq, ne Título da janela

MODULES eq, ne Nome da DLL

Comentários
Não há suporte para os filtros WINDOWTITLE e STATUS quando um sistema
remoto é especificado.
O caractere curinga ( * ) é aceito para a opção */im somente quando um filtro é
aplicado.

O encerramento de um processo remoto sempre é realizado obrigatoriamente,


seja a opção /f especificada ou não.

Fornecer um nome de computador para o filtro de nome do host causa um


desligamento, encerrando todos os processos.

Exemplos
Para encerrar os processos com as IDs de processo 1230, 1241 e 1253, digite:

taskkill /pid 1230 /pid 1241 /pid 1253

Para encerrar o processo Notepad.exe obrigatoriamente se ele foi iniciado pelo sistema,
digite:

taskkill /f /fi "USERNAME eq NT AUTHORITY\SYSTEM" /im notepad.exe

Para encerrar todos os processos no computador remoto Srvmain com um nome de


imagem iniciado por note, enquanto usa as credenciais da conta de usuário Hiropln,
digite:

taskkill /s srvmain /u maindom\hiropln /p p@ssW23 /fi "IMAGENAME eq note*"


/im *

Para encerrar o processo com a ID de processo 2134 e todos os processos filho iniciados
por ele, mas somente se esses processos foram iniciados pela conta de Administrador,
digite:

taskkill /pid 2134 /t /fi "username eq administrator"

Para encerrar todos os processos que têm uma ID de processo maior ou igual a 1000,
independentemente dos nomes de imagem, digite:
taskkill /f /fi "PID ge 1000" /im *

Links relacionados
Chave da sintaxe de linha de comando

Comando tasklist
tasklist
Artigo • 17/04/2023

Exibe uma lista de processos em execução atualmente no computador local ou em um


computador remoto. A Lista de tarefas substitui a ferramenta tlist.

7 Observação

Esse comando substitui a ferramenta tlist.

Sintaxe

tasklist [/s <computer> [/u [<domain>\]<username> [/p <password>]]] [{/m


<module> | /svc | /v}] [/fo {table | list | csv}] [/nh] [/fi <filter> [/fi
<filter> [ ... ]]]

Parâmetros

Parâmetro Descrição

/s Especifica o nome ou o endereço IP de um computador remoto (não use barras


<computer> invertidas). O padrão é o computador local.

/u Executa o comando com as permissões de conta do usuário especificado por


<domain>\ <username> ou <domain>\<username> . O parâmetro /u só poderá ser especificado se
<username> /s também for. O padrão são as permissões do usuário conectado ao computador
que está emitindo o comando.

/p Especifica a senha da conta de usuário especificada no parâmetro /u.


<password>

/m Lista todas as tarefas com módulos de DLL carregados que correspondem ao nome
<module> de padrão fornecido. Se o nome do módulo não for especificado, essa opção
exibirá todos os módulos carregados por cada tarefa.

svc Lista todas as informações de serviço para cada processo sem truncamento. Válido
quando o parâmetro /fo é definido como table.

/v Exibe informações detalhadas da tarefa na saída. Para obter uma saída detalhada
completa sem truncamento, use /v e /svc juntos.
Parâmetro Descrição

/fo {table Especifica o formato a ser usado para a saída. Os valores válidos são table, list e csv.
| list | O formato padrão para saída é table.
csv}

/nh Suprime os cabeçalhos de coluna na saída. Válido quando o parâmetro /fo é


definido como table ou csv.

/fi Especifica os tipos de processos a serem incluídos ou excluídos da consulta. Você


<filter> pode usar mais de um filtro ou o caractere curinga ( \ ) para especificar todas as
tarefas ou nomes de imagem. Os filtros válidos estão listados na seção Nomes,
operadores e valores de filtro deste artigo.

/? Exibe a ajuda no prompt de comando.

Nomes, operadores e valores de filtro

Nome do Operadores Valores válidos


filtro válidos

STATUS eq, ne RUNNING | NOT RESPONDING | UNKNOWN . Esse filtro não terá suporte
se você especificar um sistema remoto.

IMAGENAME eq, ne Nome da imagem

PID eq, ne, gt, lt, Valor da PID


ge, le

SESSION eq, ne, gt, lt, Número da sessão


ge, le

SESSIONNAME eq, ne Nome da sessão

CPUtime eq, ne, gt, lt, Hora da CPU no formato HH:MM:SS, em que MM e SS estão entre
ge, le 0 e 59 e HH é qualquer número sem sinal

MEMUSAGE eq, ne, gt, lt, Utilização de memória em KB


ge, le

USERNAME eq, ne Qualquer nome de usuário válido ( <user> ou <domain\user> )

SERVIÇOS eq, ne Nome do serviço

WINDOWTITLE eq, ne Título da janela. Esse filtro não terá suporte se você especificar
um sistema remoto.

MÓDULOS eq, ne Nome da DLL


Exemplos
Para listar todas as tarefas com uma ID de processo maior que 1000 e exibi-las no
formato csv, digite:

tasklist /v /fi "PID gt 1000" /fo csv

Para listar os processos do sistema que estão em execução no momento, digite:

tasklist /fi "USERNAME ne NT AUTHORITY\SYSTEM" /fi "STATUS eq running"

Para listar informações detalhadas para todos os processos que estão em execução no
momento, digite:

tasklist /v /fi "STATUS eq running"

Para listar todas as informações de serviço para processos no computador remoto


srvmain, que tem um nome de DLL começando com ntdll, digite:

tasklist /s srvmain /svc /fi "MODULES eq ntdll*"

Para listar os processos no computador remoto srvmain, usando as credenciais da sua


conta de usuário conectada no momento, digite:

tasklist /s srvmain

Para listar os processos no computador remoto srvmain, usando as credenciais da conta


de usuário Hiropln, digite:

tasklist /s srvmain /u maindom\hiropln /p p@ssW23


Links relacionados
Chave da sintaxe de linha de comando
tcmsetup
Artigo • 12/04/2023

Configura ou desabilita o cliente TAPI. Para que o TAPI funcione corretamente, você
deve executar esse comando para especificar os servidores remotos que serão usados
por clientes TAPI.

) Importante

Para usar esse comando, você deve ser membro do grupo Administradores no
computador local ou deve ter recebido a autoridade apropriada. Se o computador
estiver em um domínio, é possível que os membros do grupo Administradores de
Domínio possam executar esse procedimento. Como prática recomendada de
segurança, considere o uso de Executar como para executar esse procedimento.

Sintaxe

tcmsetup [/q] [/x] /c <server1> [<server2> …]


tcmsetup [/q] /c /d

Parâmetros

Parâmetro Descrição

/q Impede a exibição de caixas de mensagem.

/x Especifica que os retornos de chamada orientados à conexão serão usados para


redes de tráfego intensivo em que a perda de pacotes é alta. Quando esse
parâmetro for omitido, serão usados retornos de chamada sem conexão.

/c Obrigatórios. Especifica a configuração do cliente.

<server1> Obrigatórios. Especifica o nome do servidor remoto que tem os provedores de


serviços TAPI que o cliente usará. O cliente usará as linhas e os telefones dos
provedores de serviços. O cliente deve estar no mesmo domínio que o servidor ou
em um domínio que tenha uma relação de confiança bidirecional com o domínio
que contém o servidor.
Parâmetro Descrição

<server2>… Especifica todos os servidores ou servidores adicionais que estarão disponíveis para
esse cliente. Se você especificar uma lista de servidores, use um espaço para separar
os nomes do servidor.

/d Limpa a lista de servidores remotos. Desabilita o cliente TAPI impedindo que ele use
os provedores de serviços TAPI que estão nos servidores remotos.

/? Exibe a ajuda no prompt de comando.

Comentários

Antes que um usuário cliente possa usar um telefone ou uma linha em um servidor
TAPI, o administrador do servidor de telefonia deve atribuir o usuário ao telefone
ou à linha.

A lista de servidores de telefonia criada por esse comando substitui qualquer lista
existente de servidores de telefonia disponíveis para o cliente. Você não pode usar
esse comando para adicionar à lista existente.

Links relacionados
Chave da sintaxe de linha de comando

Visão geral do shell de comando

Especificar servidores de telefonia em um computador cliente

Atribuir um usuário de telefonia a uma linha ou um telefone


telnet
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Comunica-se com um computador que executa o serviço de servidor telnet. A execução


desse comando sem parâmetros permite que você insira o contexto telnet, conforme
indicado pela solicitação telnet (Microsoft telnet>). Na solicitação telnet, você pode
usar comandos telnet para gerenciar o computador que executa o cliente telnet.

) Importante

Você precisará instalar o software cliente telnet antes de executar esse comando.
Para obter mais informações, consulte Instalando o telnet.

Sintaxe

telnet [/a] [/e <escapechar>] [/f <filename>] [/l <username>] [/t {vt100 |
vt52 | ansi | vtnt}] [<host> [<port>]] [/?]

Parâmetros

Parâmetro Descrição

/a Tenta logon automático. Igual à opção /l, exceto que ela usa o nome do usuário
conectado no momento.

/e Especifica o caractere de escape usado para inserir a solicitação do cliente


<escapechar> telnet.

/f <filename> Especifica o nome do arquivo usado para o log do lado do cliente.

/l <username> Especifica o nome de usuário com o qual fazer logon no computador remoto.

/t {vt100 | Especifica o tipo de terminal. Os tipos de terminal com suporte são vt100, vt52,
vt52 | ansi | ansie vtnt.
vtnt}
Parâmetro Descrição

<host> Especifica o nome do host ou o endereço IP do computador remoto ao qual se


[<port>] conectar e, opcionalmente, a porta TCP a ser usada (o padrão é a porta TCP 23).

/? Exibe a ajuda no prompt de comando.

Exemplos
Para usar telnet e se conectar ao computador que executa o Serviço de Servidor telnet
em telnet.microsoft.com, digite:

telnet telnet.microsoft.com

Para usar telnet, se conectar ao computador que executa o Serviço de Servidor telnet
em telnet.microsoft.com na porta TCP 44 e registrar a atividade de sessão em um arquivo
local chamado telnetlog.txt, digite:

telnet /f telnetlog.txt telnet.microsoft.com 44

Links relacionados
Chave da sintaxe de linha de comando

Instalando o telnet

Referência Técnica de telnet


telnet: close
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Fecha a conexão atual.

Sintaxe

c[lose]

Exemplos
Para fechar a conexão telnet atual, digite:

Links relacionados
Chave da sintaxe de linha de comando
telnet: display
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe os parâmetros operacionais.

Sintaxe

d[isplay]

Exemplos
Para exibir os parâmetros operacionais, digite:

Links relacionados
Chave da sintaxe de linha de comando
telnet: open
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Conecta-se a um servidor telnet.

Sintaxe

o[pen] <hostname> [<port>]

Parâmetros

Parâmetro Descrição

<hostname> Especifica o nome do computador ou o endereço IP.

[<port>] Especifica a porta TCP na qual o servidor telnet está escutando. O padrão é a porta
TCP 23.

Exemplos
Para se conectar a um servidor telnet em telnet.microsoft.com, digite:

o telnet.microsoft.com

Links relacionados
Chave da sintaxe de linha de comando
telnet: quit
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Sai do telnet.

Sintaxe

q[uit]

Exemplos
Para sair do telnet, digite:

Links relacionados
Chave da sintaxe de linha de comando
telnet: send
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Envia os comandos telnet para o servidor telnet.

Sintaxe

sen {ao | ayt | brk | esc | ip | synch | <string>} [?]

Parâmetros

Parâmetro Descrição

ao Envia o comando telnet Abort Output.

ayt Envia o comando telnet Are You There?

brk Envia o comando telnet brk.

esc Envia o caractere de escape do telnet atual.

ip Envia o comando telnet Interrupt Process.

synch Envia o comando telnet synch.

<string> Envia qualquer cadeia de caracteres que você digitar para o servidor telnet.

? Exibe a ajuda associada a esse comando.

Exemplo
Para enviar o comando Are you there? para o servidor telnet, digite:

sen ayt
Links relacionados
Chave da sintaxe de linha de comando
telnet: set
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Define opções. Você pode usar o comando telnet unset para desativar uma opção que
foi definida anteriormente.

Sintaxe

set [bsasdel] [crlf] [delasbs] [escape <char>] [localecho] [logfile


<filename>] [logging] [mode {console | stream}] [ntlm] [term {ansi | vt100 |
vt52 | vtnt}] [?]

Parâmetros

Parâmetro Descrição

bsasdel Envia o backspace como delete.

crlf Envia o CR & LF (0x0D, 0x 0A) quando a tecla Enter é pressionada. Conhecido
como Novo modo de linha.

delasbs Envia delete como backspace.

escape Define o caractere de escape usado para inserir o prompt do cliente telnet. O
<character> caractere de escape pode ser um único caractere ou pode ser uma combinação da
tecla CTRL mais um caractere. Para definir uma combinação de tecla de controle,
mantenha pressionada a tecla CTRL enquanto digita o caractere que deseja
atribuir.

localecho Ativa o eco local.

logfile Registra a sessão telnet atual no arquivo local. O log começa automaticamente
<filename> quando você define essa opção.

registro em Ativa o log. Se nenhum arquivo de log estiver definido, uma mensagem de erro
log será exibida.
Parâmetro Descrição

mode Define o modo de operação.


{console |
stream}

ntlm Ativa a autenticação NTLM

term {ansi Define o tipo de terminal.


| vt100 |
vt52 |
vtnt}

? Exibe a ajuda para esse comando.

Comentários
Em versões do telnet que não estão em inglês, o codeset <option> está disponível.
O codeset <option> define o código atual configurado como opção, que pode ser
qualquer uma das seguintes opções: shift JIS, JAPANESE EUC, JIS Kanji, JIS Kanji
(78), DEC Kanji, NEC Kanji. Você deve definir o mesmo conjunto de códigos no
computador remoto.

Exemplo
Para definir o arquivo de log e começar a fazer logon no arquivo local tnlog.txt, digite:

set logfile tnlog.txt

Links relacionados
Chave da sintaxe de linha de comando
telnet: status
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe informações de status.

Sintaxe

st[atus]

Exemplo
Para exibir informações de status, digite:

st

Links relacionados
Chave da sintaxe de linha de comando
telnet: unset
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Desativa as opções definidas anteriormente.

Sintaxe

u {bsasdel | crlf | delasbs | escape | localecho | logging | ntlm} [?]

Parâmetros

Parâmetro Descrição

bsasdel Envia backspace como um backspace.

crlf Envia a tecla Enter como um CR. Também conhecido como modo de avanço de
linha.

delasbs Envia delete como delete.

escape Remove a configuração do caractere de escape.

localecho Desativa localecho.

registro em Desliga o log.


log

ntlm Desativa a autenticação NTLM

? Exibe a ajuda para esse comando.

Exemplo
Desativa o registro em log.

u logging
Links relacionados
Chave da sintaxe de linha de comando
tftp
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Transfere arquivos em um computador remoto, normalmente um computador com o


UNIX, que está executando o serviço tftp (Trivial File Transfer Protocol) ou daemon.
Normalmente, o tftp é usado pelos dispositivos ou sistemas inseridos que recuperam o
firmware, informações de configuração ou uma imagem do sistema durante o processo
de inicialização de um servidor tftp.

[IMPORTANTE] O protocolo tftp não oferece suporte a mecanismos de autenticação


ou criptografia e, sendo assim, pode oferecer risco de segurança quando presente.
A instalação do cliente tftp não é recomendada para sistemas conectados à Internet.
A Microsoft não oferece mais um serviço de servidor tftp por motivos de segurança.

Sintaxe

tftp [-i] [<host>] [{get | put}] <source> [<destination>]

Parâmetros

Parâmetro Descrição

-i Especifica o modo de transferência de imagem binária (também chamado de


modo octeto). No modo de imagem binária, o arquivo é transferido em
unidades de um byte. Use esse modo ao transferir arquivos binários. Se você não
usar a opção -i, o arquivo será transferido no modo ASCII. Esse é o modo de
transferência padrão. Esse modo converte os caracteres EOL (fim de linha) em
um formato apropriado para o computador especificado. Use esse modo ao
transferir arquivos de texto. Se uma transferência de arquivo for bem-sucedida, a
taxa de transferência de dados será exibida.

<host> Especifica o computador local ou remoto.

get Transfere o destino do arquivo no computador remoto para a origem do arquivo


no computador local.
Parâmetro Descrição

put Transfere a origem do arquivo no computador local para o destino do arquivo no


computador remoto. Como o protocolo tftp não dá suporte à autenticação de
usuário, o usuário deve estar conectado ao computador remoto e os arquivos
devem ser graváveis no computador remoto.

<source> Especifica o arquivo a ser transferido.

<destination> Especifica para onde transferir o arquivo.

Exemplos
Para copiar o arquivo boot.img do computador remoto Host1, digite:

tftp -i Host1 get boot.img

Links relacionados
Chave da sintaxe de linha de comando
time
Artigo • 17/04/2023

Exibe ou define a hora do sistema. Se usado sem parâmetros, time exibirá a hora atual
do sistema e solicitará que você insira uma nova hora.

7 Observação

Você precisa ser um administrador para alterar a hora atual.

Sintaxe

time [/t | [<HH>[:<MM>[:<SS>]] [am|pm]]]

Parâmetros

Parâmetro Descrição

<HH>[:<MM> Define o tempo do sistema como o novo horário especificado, em que HH


[:<SS>[. representa horas (obrigatório), MM representa minutos e SS representa segundos.
<NN>]]] NN pode ser usado para especificar centésimos de segundo. Você precisa separar
[am | pm] valores para HH, MM e SS com dois pontos (:). SS e NN precisam estar separados
por um ponto (.).

Se am ou pm não for especificado, time usará o formato de 24 horas por padrão.

/t Exibe a hora atual sem solicitar uma nova hora.

/? Exibe a ajuda no prompt de comando.

Comentários

Valores HH válidos vão de 0 a 24.

Valores MM e SS válidos vão de 0 a 59.

Exemplos
Se as extensões de comando estiverem habilitadas, para exibir a hora atual do sistema,
digite:

time /t

Para alterar a hora atual do sistema para 17:30, digite um dos seguintes:

time 17:30:00
time 5:30 pm

Para exibir a hora atual do sistema, seguido por uma solicitação para inserir uma nova
hora, digite:

The current time is: 17:33:31.35


Enter the new time:

Para manter a hora atual e retornar a solicitação de comando, pressione ENTER. Para
alterar a hora atual, digite a nova hora e pressione ENTER.

Links relacionados
Chave da sintaxe de linha de comando
tempo limite
Artigo • 21/12/2022

Pausa o processador de comandos para o número especificado de segundos. Esse


comando normalmente é usado em arquivos em lotes.

Sintaxe

timeout /t <timeoutinseconds> [/nobreak]

Parâmetros

Parâmetro Descrição

/t Especifica o número decimal de segundos (entre -1 e 99999) para aguardar


<timeoutinseconds> antes que o processador de comandos continue o processamento. O valor
-1 faz com que o computador aguarde indefinidamente por um tecla de
tecla.

/nóak Especifica para ignorar traços de chave de usuário.

/? Exibe a ajuda no prompt de comando.

Comentários

Um controle de teclas de usuário retoma a execução do processador de comandos


imediatamente, mesmo que o período de tempo-tempo não tenha expirado.

Quando usado em conjunto com a ferramenta Sleep do kit de recursos, o


tempoout é semelhante ao comando pause.

Exemplos
Para pausar o processador de comandos por dez segundos, digite:

timeout /t 10
Para pausar o processador de comandos por 100 segundos e ignorar qualquer tecla de
tecla, digite:

timeout /t 100 /nobreak

Para pausar o processador de comandos indefinidamente até que uma chave seja
pressionada, digite:

timeout /t -1

Referências adicionais
Chave da sintaxe de linha de comando
título
Artigo • 12/04/2023

Cria um título para a janela Prompt de Comando.

Sintaxe

title [<string>]

Parâmetros

Parâmetro Descrição

<string> Especifica o texto a ser exibido como o título da janela Prompt de Comando.

/? Exibe a ajuda no prompt de comando.

Comentários
Para criar o título da janela para programas em lote, inclua o comando title no
início de um programa em lote.

Depois que um título de janela for definido, você poderá só redefini-lo usando o
comando title.

Exemplos
Para alterar o título da janela Prompt de Comando para Atualização de Arquivos,
enquanto o arquivo em lote executa o comando copy e, em seguida, para retornar o
título ao Prompt de Comando, digite o seguinte script:

@echo off
title Updating Files
copy \\server\share\*.xls c:\users\common\*.xls
echo Files Updated.
title Command Prompt
Links relacionados
Chave da sintaxe de linha de comando
tlntadmn
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Administra um computador local ou remoto que está executando o Serviço de Servidor


telnet. Se usado sem parâmetros, o tlntadmn exibe as configurações atuais do servidor.

Esse comando exige que você faça logon no computador local com credenciais
administrativas. Para administrar um computador remoto, você também deve fornecer
as credenciais administrativas do computador remoto. Você pode fazer isso entrando no
computador local com uma conta que tenha as credenciais administrativas do
computador local e do computador remoto. Se não for possível usar esse método, você
pode usar os parâmetros -u e -p para fornecer as credenciais administrativas do
computador remoto.

Sintaxe

tlntadmn [<computername>] [-u <username>] [-p <password>] [{start | stop |


pause | continue}] [-s {<sessionID> | all}] [-k {<sessionID> | all}] [-m
{<sessionID> | all} <message>] [config [dom = <domain>] [ctrlakeymap = {yes
| no}] [timeout = <hh>:<mm>:<ss>] [timeoutactive = {yes | no}] [maxfail =
<attempts>] [maxconn = <connections>] [port = <number>] [sec {+ | -}NTLM {+
| -}passwd] [mode = {console | stream}]] [-?]

Parâmetros

Parâmetro Descrição

<computername> Especifica o nome do servidor a ser conectado. O padrão é o computador local.

-u <username> Especifica as credenciais administrativas de um servidor remoto que você


-p <password> deseja administrar. Esse parâmetro será necessário se você quiser administrar
um servidor remoto ao qual não está conectado com credenciais
administrativas.

iniciar inicia o Serviço de Servidor telnet.

parar Interrompe o Serviço de Servidor telnet


Parâmetro Descrição

pause Pausa o Serviço de Servidor telnet. Novas conexões não serão permitidas.

continue Retoma o Serviço de Servidor telnet.

-s {<sessionID> Exibe as sessões telnet ativas.


| all}

-k Encerra as sessões telnet. Digite a ID da Sessão para encerrar uma sessão


{<sessionID> | específica ou digite all para encerrar todas as sessões.
all}

-m Envia uma mensagem para uma ou mais sessões. Digite a ID da sessão para
{<sessionID> | enviar uma mensagem para uma sessão específica ou digite all para enviar uma
all} <message> mensagem a todas as sessões. digite a mensagem que você deseja enviar entre
aspas.

config dom = Configura o domínio padrão do servidor.


<domain>

config Especifica se você deseja que o servidor telnet interprete CTRL+A como ALT.
ctrlakeymap = Digite yes para mapear a chave de atalho ou digite no para impedir o
{yes | no} mapeamento.

config timeout Define o tempo limite em horas, minutos e segundos.


= <hh>:<mm>:
<ss>

config Habilita o tempo limite da sessão ociosa.


timeoutactive
= {yes | no}

config maxfail Define o número máximo de tentativas de logon com falha, antes de
= <attempts> desconectar.

config Define o número máximo de conexões.


maxconn =
<connections>

config port = Define a porta telnet. Você deve especificar a porta com um inteiro menor que
<number> 1024.

config sec {+ | Especifica se você deseja usar o NTLM, uma senha ou ambos para autenticar as
-}NTLM {+ | tentativas de logon. Para usar um tipo específico de autenticação, digite um
-}passwd sinal de mais (+) antes desse tipo de autenticação. Para impedir o uso de um
tipo específico de autenticação, digite um sinal de menos (-) antes desse tipo
de autenticação.
Parâmetro Descrição

config mode = Especifica o modo de operação.


{console |
stream}

-? Exibe a ajuda no prompt de comando.

Exemplos
Para configurar o tempo limite de sessão ociosa como 30 minutos, digite:

tlntadmn config timeout=0:30:0

Para exibir as sessões de telnet ativas, digite:

tlntadmn -s

Links relacionados
Chave da sintaxe de linha de comando

Guia de operações telnet


tpmtool
Artigo • 12/04/2023

Esse utilitário pode ser usado para obter as informações sobre o TPM (Trusted Platform
Module).

) Importante

Algumas informações podem estar relacionadas ao produto de pré-lançamento, o


qual poderá ser substancialmente modificado antes do lançamento comercial. A
Microsoft não oferece garantias, expressas ou implícitas, das informações aqui
fornecidas.

Sintaxe

tpmtool /parameter [<arguments>]

Parâmetros

Parâmetro Descrição

getdeviceinformation Exibe as informações básicas do TPM. Confira o artigo parâmetros do


método Win32_Tpm::IsReadyInformation para obter detalhes sobre os
valores do sinalizador de informações.

gatherlogs [output Coleta os logs do TPM e os coloca no diretório especificado. Se esse


directory path] diretório não existir, será criado. Por padrão, os arquivos de log são
colocados no diretório atual. Os arquivos possíveis gerados são:
TpmEvents.evtx
TpmInformation.txt
SRTMBoot.dat
SRTMResume.dat
DRTMBoot.dat
DRTMResume.dat

drivertracing [start Inicia ou interrompe a coleta de rastreamentos de driver do TPM. O log


| stop] de rastreamento, TPMTRACE.etl, é criado e colocado no diretório atual.

/? Exibe a ajuda no prompt de comando.


Exemplos
Para exibir as informações básicas do TPM, digite:

tpmtool getdeviceinformation

Para coletar os logs do TPM e colocá-los no diretório atual, digite:

tpmtool gatherlogs

Para coletar os logs do TPM e colocá-los em C:\Users\Public , digite:

tpmtool gatherlogs C:\Users\Public

Para coletar os rastreamentos de driver do TPM, digite:

tpmtool drivertracing start


# Run scenario
tpmtool drivertracing stop

Links relacionados
Chave da sintaxe de linha de comando

Códigos de Erro COM (TPM, PLA, FVE)


tpmvscmgr
Artigo • 12/04/2023

A ferramenta de linha de comando tpmvscmgr permite que usuários com credenciais


administrativas criem e excluam cartões inteligentes virtuais do TPM em um
computador.

Syntax

tpmvscmgr create [/name] [/adminkey DEFAULT | PROMPT | RANDOM] [/PIN DEFAULT


| PROMPT] [/PUK DEFAULT | PROMPT] [/generate] [/machine] [/?]

tpmvscmgr destroy [/instance <instanceID>] [/?]

Criar parâmetros
O comando Criar configura novos cartões inteligentes virtuais no sistema do usuário. Ele
também retorna a ID da instância do cartão recém-criado para referência posterior, caso
a exclusão seja necessária. A ID da instância está no formato
ROOT\SMARTCARDREADER\000n, em que n começa de 0 e é aumentada em 1 sempre
que você cria um novo cartão inteligente virtual.

Parâmetro Descrição

/name Obrigatórios. Indica o nome do novo cartão inteligente virtual.

/adminkey Indica a chave de administrador desejada que pode ser usada para redefinir o PIN
do cartão caso o usuário esqueça o PIN. São elas:
DEFAULT – Especifica o valor padrão de
010203040506070801020304050607080102030405060708.
PROMPT – Solicita que o usuário insira um valor para a chave de
administrador.
RANDOM – Resulta em uma configuração aleatória para a chave de
administrador de um cartão que não é retornado ao usuário. Isso cria um
cartão que pode não ser gerenciável usando ferramentas de gerenciamento
de cartão inteligente. Ao usar a opção RANDOM, a chave de administrador
deve ser inserida como 48 caracteres hexadecimais.
Parâmetro Descrição

/PIN Indica o valor de PIN do usuário desejado.


DEFAULT – Especifica o PIN padrão de 12345678.
PROMPT – Solicita que o usuário insira um PIN na linha de comando. O PIN
deve ter no mínimo oito caracteres e pode conter numerais, caracteres e
caracteres especiais.

/PUK Indica o valor de PUK (Chave de Desbloqueio do PIN) desejado. O valor de PUK
deve ter no mínimo oito caracteres e pode conter numerais, caracteres e caracteres
especiais. Se o parâmetro for omitido, o cartão será criado sem um PUK. As opções
incluem:
DEFAULT – Especifica o PUK padrão de 12345678.
PROMPT – Solicita que o usuário insira um PUK na linha de comando.

/generate Gera os arquivos necessários no armazenamento para que o cartão inteligente


virtual funcione. Se o parâmetro /generate não for usado, será como se você tivesse
criado o cartão sem o sistema de arquivos subjacente. Um cartão sem um sistema
de arquivos só pode ser gerenciado por um sistema de gerenciamento de cartão
inteligente, como o Microsoft Configuration Manager.

/machine Permite especificar o nome de um computador remoto no qual o cartão inteligente


virtual pode ser criado. Isso só pode ser usado em um ambiente de domínio e
depende do DCOM. Para que o comando tenha êxito na criação de um cartão
inteligente virtual em um computador diferente, o usuário que executa esse
comando deve ser um membro no grupo de administradores locais no computador
remoto.

/? Exibe a Ajuda para esse comando.

Destruir parâmetros
O comando Destruir exclui com segurança um cartão inteligente virtual do computador
do usuário.

2 Aviso

Se um cartão inteligente virtual for excluído, ele não poderá ser recuperado.

Parâmetro Descrição

/instance Especifica a ID da instância do cartão inteligente virtual a ser removido. A instanceID


foi gerada como saída por tpmvscmgr.exe quando o cartão foi criado. O parâmetro
/instance é um campo obrigatório para o comando Destruir.
Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Comentários
Para entradas alfanuméricas, o conjunto ASCII completo de 127 caracteres é
permitido.

Exemplos
Para criar um cartão inteligente virtual que pode ser gerenciado posteriormente por
uma ferramenta de gerenciamento de cartão inteligente iniciada de outro computador,
digite:

tpmvscmgr.exe create /name VirtualSmartCardForCorpAccess /AdminKey DEFAULT


/PIN PROMPT

Como alternativa, em vez de usar uma chave de administrador padrão, você pode criar
uma chave de administrador na linha de comando. O comando a seguir mostra como
criar uma chave de administrador.

tpmvscmgr.exe create /name VirtualSmartCardForCorpAccess /AdminKey PROMPT


/PIN PROMPT

Para criar um cartão inteligente virtual não gerenciado que possa ser usado para
registrar certificados, digite:

tpmvscmgr.exe create /name VirtualSmartCardForCorpAccess /AdminKey RANDOM


/PIN PROMPT /generate

Um cartão inteligente virtual é criado com uma chave de administrador aleatória. A


chave é descartada automaticamente depois que o cartão é criado. Isso significa que, se
o usuário esquecer o PIN ou quiser alterar o PIN, precisará excluir o cartão e criá-lo
novamente.
Para excluir o cartão, digite:

tpmvscmgr.exe destroy /instance <instance ID>

Em que <instanceID> é o valor impresso na tela quando o usuário criou o cartão.


Especificamente, para o primeiro cartão criado, a ID da instância é
ROOT\SMARTCARDREADER\0000.

Links relacionados
Chave da sintaxe de linha de comando
tracerpt
Artigo • 12/04/2023

O comando tracerpt analisa os logs de rastreamento de eventos, arquivos de log


gerados pelo Monitor de Desempenho e provedores de Rastreamento de Eventos em
tempo real. Ele também gera arquivos de despejo, arquivos de relatório e esquemas de
relatório.

Sintaxe

tracerpt <[-l] <value [value [...]]>|-rt <session_name [session_name


[...]]>> [options]

Parâmetros

Parâmetros Descrição

-config Especifica quais configurações o arquivo deve carregar, o que inclui as opções de
<filename> comando.

-y Especifica a resposta sim para todas as perguntas, sem solicitar.

-f <XML | Especifica o formato do arquivo de relatório.


HTML>

-of <CSV | Especifica o formato do arquivo de despejo. O padrão é *XML.


EVTX | XML>

-df Especifica a criação de um arquivo de esquema de contagem/relatório específico


<filename> da Microsoft.

-int Especifica o despejo da estrutura de eventos interpretada para o arquivo


<filename> especificado.

-rts Especifica que o carimbo de data/hora bruto do relatório deve ser adicionado no
cabeçalho de rastreamento de eventos. Só pode ser usado com -o. Não há
suporte para ele com -report ou -summary.

-tmf Especifica qual arquivo de definição de Formato de Mensagem de Rastreamento


<filename> deve ser usado.
Parâmetros Descrição

-tp <value> Especifica o caminho de pesquisa do arquivo TMF. Vários caminhos podem ser
usados, separados por um ponto e vírgula (;).

-i <value> Especifica o caminho da imagem do provedor. O PDB correspondente estará


localizado no Servidor de Símbolos. Vários caminhos podem ser usados,
separados por um ponto e vírgula (;).

-pdb <value> Especifica o caminho do servidor de símbolos. Vários caminhos podem ser
usados, separados por um ponto e vírgula (;).

-gmt Especifica que os carimbos de data/hora da carga do WPP devem ser


convertidos em Greenwich Mean Time.

-rl <value> Especifica o Nível de Relatório do Sistema de 1 a 5. O padrão é 1.

-summary Especifica a criação de um arquivo de texto de relatório de resumo. O nome do


[filename] arquivo, se não especificado, será summary.txt.

-o [filename] Especifica a criação de um arquivo de saída de texto. O nome do arquivo, se não


especificado, será dumpfile.xml.

-report Especifica a criação de um arquivo de relatório de saída de texto. O nome do


[filename] arquivo, se não especificado, será workload.xml.

-lr Especifica que seja menos restritivo. Usa os melhores esforços para eventos que
não correspondem ao esquema de eventos.

-export Especifica a criação de um arquivo de exportação do Esquema de Eventos. O


[filename] nome do arquivo, se não especificado, será schema.man.

[-l] <value Especifica o arquivo de log do Rastreamento de Eventos a ser processado.


[value […]]>

-rt Especifica as fontes de dados da Sessão de Rastreamento de Eventos em Tempo


<session_name Real.
[session_name
[…]]>

-? Exibe a ajuda no prompt de comando.

Exemplos
Para criar um relatório com base nos dois logs de eventos logfile1.etl e logfile2.etl e para
criar o arquivo de despejo logdump.xml no formato XML, digite:
tracerpt logfile1.etl logfile2.etl -o logdump.xml -of XML

Para criar um relatório com base no log de eventos logfile.etl, para criar o arquivo de
despejo logdmp.xml no formato XML, para usar os melhores esforços para identificar os
eventos que não estão no esquema e para produzir um arquivo de relatório de resumo
logdump.txt e um arquivo de relatório, logrpt.xml, digite:

tracerpt logfile.etl -o logdmp.xml -of XML -lr -summary logdmp.txt -report


logrpt.xml

Para usar os dois logs de eventos logfile1.etl e logfile2.etl para produzir um arquivo de
despejo e relatar o arquivo com os nomes de arquivo padrão, digite:

tracerpt logfile1.etl logfile2.etl -o -report

Para usar o log de eventos logfile.etl e o contador de log de desempenho file.blg para
produzir o arquivo de relatório logrpt.xml e o arquivo de esquema XML específico da
Microsoft schema.xml, digite:

tracerpt logfile.etl counterfile.blg -report logrpt.xml -df schema.xml

Para ler o Agente do Kernel NT da Sessão de Rastreamento de Eventos em tempo real e


para produzir o arquivo de despejo logfile.csv no formato CSV, digite:

tracerpt -rt NT Kernel Logger -o logfile.csv -of CSV

Links relacionados
Chave da sintaxe de linha de comando
tracert
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Esta ferramenta de diagnóstico determina o caminho usado para um destino enviando


mensagens do ICMPv6 ou de solicitação de eco do protocolo ICMP para o destino com
valores de campo TTL (vida útil) que aumentam de modo incremental. Cada roteador ao
longo do caminho é necessário para diminuir o TTL em um pacote IP em pelo menos 1
antes de encaminhá-lo. Efetivamente, o TTL é um contador de link máximo. Quando o
TTL em um pacote atinge 0, espera-se que o roteador retorne uma mensagem de
tempo de ICMP excedido para o computador de origem.

Esse comando determina o caminho enviando a primeira mensagem de solicitação de


eco com um TTL de 1 e incrementando o TTL em 1 em cada transmissão subsequente
até que o destino responda ou o número máximo de saltos seja atingido. O número
máximo de saltos é 30 por padrão e pode ser especificado usando o parâmetro /h.

O caminho é determinado examinando as mensagens de tempo excedido do ICMP


retornadas por roteadores intermediários e a mensagem de resposta de eco retornada
pelo destino. No entanto, alguns roteadores não retornam mensagens de tempo
excedido para pacotes com valores TTL expirados e são invisíveis para o comando
tracert. Nesse caso, uma linha de asteriscos ( * ) é exibida para esse salto. O caminho
exibido é a lista de interfaces de roteador próximas/laterais dos roteadores no caminho
entre um host de origem e um destino. A interface próxima/lateral é a interface do
roteador que está mais próxima do host de envio no caminho.

) Importante

Esse comando só estará disponível se o protocolo TCP/IP estiver instalado como


um componente nas propriedades de um adaptador de rede em Conexões de
Rede.

Para rastrear um caminho e fornecer latência de rede e perda de pacotes para cada
roteador e link no caminho, use o comando pathping.

Sintaxe
tracert [/d] [/h <maximumhops>] [/j <hostlist>] [/w <timeout>] [/R] [/S
<srcaddr>] [/4][/6] <targetname>

Parâmetros

Parâmetro Descrição

/d Interrompe as tentativas de resolver os endereços IP de roteadores


intermediários para seus nomes. Isso pode acelerar o retorno dos resultados.

/h Especifica o número máximo de saltos no caminho para pesquisar o destino. O


<maximumhops> padrão corresponde a 30 saltos.

/j <hostlist> Especifica que as mensagens de solicitação de eco usam a opção Rota de


Origem Flexível no cabeçalho IP com o conjunto de destinos intermediários
especificados em <hostlist> . Com o roteamento de origem flexível, os destinos
intermediários sucessivos podem ser separados por um ou vários roteadores. O
número máximo de endereços ou nomes na lista é 9. O <hostlist> é uma série
de endereços IP (em notação decimal pontilhada) separados por espaços. Use
esse parâmetro somente ao rastrear endereços IPv4.

/w <timeout> Especifica o tempo em milissegundos para aguardar a mensagem de resposta de


eco ou de tempo excedido do ICMP correspondente a uma determinada
mensagem de solicitação de eco a ser recebida. Se não for recebida dentro do
tempo limite, um asterisco ( * ) será exibido. O valor de tempo limite padrão é
4000 (4 segundos).

/R Especifica que o cabeçalho da extensão de Roteamento IPv6 seja usado para


enviar uma mensagem de solicitação de eco para o host local, usando o destino
como um destino intermediário e testando a rota inversa.

/S <srcaddr> Especifica o endereço de origem a ser usado nas mensagens de solicitação de


eco. Use esse parâmetro somente ao rastrear endereços IPv6.

/4 Especifica que tracert.exe pode usar apenas IPv4 para esse rastreamento.

/6 Especifica que tracert.exe pode usar apenas IPv6 para esse rastreamento.

<targetname> Especifica o destino identificado pelo endereço IP ou pelo nome do host.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para rastrear o caminho para o host chamado corp7.microsoft.com, digite:
tracert corp7.microsoft.com

Para rastrear o caminho para o host chamado corp7.microsoft.com e impedir a resolução


de cada endereço IP para seu nome, digite:

tracert /d corp7.microsoft.com

Para rastrear o caminho para o host chamado corp7.microsoft.com e usar a rota de


origem flexível 10.12.0.1/10.29.3.1/10.1.44.1, digite:

tracert /j 10.12.0.1 10.29.3.1 10.1.44.1 corp7.microsoft.com

Links relacionados
Chave da sintaxe de linha de comando

comando pathping
tree
Artigo • 12/04/2023

Exibe a estrutura de diretório de um caminho ou do disco em uma unidade


graficamente. A estrutura exibida por esse comando depende dos parâmetros
especificados no prompt de comando. Se você não especificar uma unidade ou um
caminho, esse comando exibirá a estrutura de árvore começando com o diretório atual
da unidade atual.

Sintaxe

tree [<drive>:][<path>] [/f] [/a]

Parâmetros

Parâmetro Descrição

<drive>: Especifica a unidade que contém o disco para o qual você deseja exibir a estrutura
de diretório.

<path> Especifica o diretório para o qual você deseja exibir a estrutura do diretório.

/f Exibe os nomes dos arquivos em cada diretório.

/a Especifica o uso de caracteres de texto, em vez de caracteres gráficos para mostrar


as linhas que vinculam os subdiretórios.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para exibir os nomes de todos os subdiretórios no disco na unidade atual, digite:

tree \

Para exibir, uma tela de cada vez, os arquivos em todos os diretórios na unidade C,
digite:
tree c:\ /f | more

Para imprimir uma lista de todos os diretórios na unidade C para um arquivo, digite:

tree c:\ /f > <driveletter>:\<filepath>\filename.txt

Links relacionados
Chave da sintaxe de linha de comando
tscon
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Conecta-se a outra sessão em um servidor host da Sessão da Área de Trabalho Remota.

) Importante

Você deve ter a permissão de acesso de Controle Total ou a permissão de acesso


especial de Conexão para se conectar a outra sessão.

7 Observação

Para descobrir as novidades da última versão, confira Novidades nos Serviços de


Área de Trabalho Remota do Windows Server.

Sintaxe

tscon {<sessionID> | <sessionname>} [/dest:<sessionname>] [/password:<pw> |


/password:*] [/v]

Parâmetros

Parâmetro Descrição

<sessionID> Especifica a ID da sessão à qual você deseja se conectar. Se você usar o


parâmetro opcional /dest:<sessionname> , também poderá especificar o
nome da sessão atual.

<sessionname> Especifica o nome da sessão à qual você deseja se conectar.

/dest: <sessionname> Especifica o nome da sessão atual. Esta sessão será desconectada quando
você se conectar à nova sessão. Você também pode usar esse parâmetro
para conectar a sessão de outro usuário a uma sessão diferente.
Parâmetro Descrição

/password: <pw> Especifica a senha do usuário que detém a sessão à qual você deseja se
conectar. Essa senha é necessária quando o usuário conectado não detém
a sessão.

/password: * Solicita a senha do usuário que detém a sessão à qual você deseja se
conectar.

/v Exibe as informações sobre as ações sendo executadas.

/? Exibe a ajuda no prompt de comando.

Comentários
Esse comando falhará se você não especificar uma senha no parâmetro /password
e a sessão de destino pertencer a um usuário diferente do atual.

Você não pode se conectar à sessão do console.

Exemplos
Para se conectar à Sessão 12 no servidor host da Sessão dos Serviços de Área de
Trabalho Remota atual e desconectar a sessão atual, digite:

tscon 12

Para se conectar à Sessão 23 no servidor host da Sessão dos Serviços de Área de


Trabalho Remota atual usando a senha mypass e desconectar a sessão atual, digite:

tscon 23 /password:mypass

Para conectar a sessão chamada TERM03 à sessão chamada TERM05 e desconectar a


sessão TERM05, digite:

tscon TERM03 /v /dest:TERM05


Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
tsdiscon
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Desconecta uma sessão de um servidor Host da Sessão da Área de Trabalho Remota. Se


você não especificar uma ID de sessão ou um nome de sessão, esse comando
desconectará a sessão atual.

) Importante

Você deve ter permissão de acesso de Controle Total ou a permissão de Acesso


especial para desconectar, para desconectar outro usuário de uma sessão.

7 Observação

Para descobrir as novidades da última versão, confira Novidades nos Serviços de


Área de Trabalho Remota do Windows Server.

Sintaxe

tsdiscon [<sessionID> | <sessionname>] [/server:<servername>] [/v]

Parâmetros

Parâmetro Descrição

<sessionID> Especifica a ID da sessão a ser desconectada.

<sessionname> Especifica o nome da sessão a ser desconectada.

/server: <servername> Especifica o servidor de terminal que contém a sessão que você deseja
desconectar. Caso contrário, o servidor Host da Sessão da Área de
Trabalho Remota atual será usado. Esse parâmetro só será necessário se
você executar o comando tsdiscon em um servidor remoto.
Parâmetro Descrição

/v Exibe informações sobre as ações sendo executadas.

/? Exibe a ajuda no prompt de comando.

Comentários
Todos os aplicativos em execução quando você desconectou a sessão são
executados automaticamente, quando você se reconecta a essa sessão, sem perda
de dados. Você pode usar o comando reset session para encerrar os aplicativos em
execução da sessão desconectada, mas isso pode resultar em perda de dados na
sessão.

A sessão do console não pode ser desconectada.

Exemplos
Para desconectar a sessão atual, digite:

tsdiscon

Para desconectar a Sessão 10, digite:

tsdiscon 10

Para desconectar a sessão chamada TERM04, digite:

tsdiscon TERM04

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
comando reset session
tsecimp
Artigo • 11/04/2023

Importa informações de atribuição de um arquivo XML (Extensible Markup Language)


para o arquivo de segurança do servidor TAPI (Tsec.ini). Você também pode usar esse
comando para exibir a lista de provedores TAPI e os dispositivos de linhas associados a
cada um deles, validar a estrutura do arquivo XML sem importar o conteúdo e verificar a
associação de domínio.

Sintaxe

tsecimp /f <filename> [{/v | /u}]


tsecimp /d

Parâmetros

Parâmetro Descrição

/f Obrigatórios. Especifica o nome do arquivo XML que contém as informações de


<filename> atribuição que você deseja importar.

/v Valida a estrutura do arquivo XML sem importar as informações para o arquivo


Tsec.ini.

/u Verifica se cada usuário é membro do domínio especificado no arquivo XML. O


computador no qual você usa esse parâmetro deve estar conectado à rede. Esse
parâmetro poderá reduzir significativamente o desempenho se você estiver
processando uma grande quantidade de informações de atribuição de usuário.

/d Exibe uma lista de provedores de telefonia instalados. Para cada provedor de


telefonia, os dispositivos de linha associados são listados, bem como os endereços
e usuários associados a cada dispositivo de linha.

/? Exibe a ajuda no prompt de comando.

Comentários
O arquivo XML do qual você deseja importar informações de atribuição deve seguir a
estrutura descrita abaixo:
XML

<UserList>
<User>
<LineList>
<Line>

<Userlist element> – O elemento superior do arquivo XML.

<User element> – Contém informações sobre um usuário que é membro de um

domínio. Cada usuário pode receber um ou mais dispositivos de linha. Além disso,
cada elemento User pode ter um atributo chamado NoMerge. Quando esse
atributo é especificado, todas as atribuições de dispositivo de linha atuais para o
usuário são removidas antes que novas sejam feitas. Você pode usar esse atributo
para remover facilmente atribuições de usuário indesejadas. Por padrão, esse
atributo não está definido. O elemento User deve conter um único elemento
DomainUserName, que especifica o domínio e o nome de usuário do usuário. O
elemento User também pode conter um elemento FriendlyName, que especifica
um nome amigável para o usuário. O elemento User pode conter um elemento
LineList. Se um elemento LineList não estiver presente, todos os dispositivos de
linha para esse usuário serão removidos.

<LineList element> – Contém informações sobre cada linha ou dispositivo que

pode ser atribuído ao usuário. Cada elemento LineList pode conter mais de um
elemento Line.

<Line element> – Especifica um dispositivo de linha. Você deve identificar cada

dispositivo de linha adicionando um elemento Address ou um elemento


PermanentID sob o elemento Line. Para cada elemento Line, você pode definir o
atributo Remove. Se você definir esse atributo, o usuário não receberá mais esse
dispositivo de linha. Se esse atributo não estiver definido, o usuário obterá acesso
a esse dispositivo de linha. Nenhum erro será apresentado se o dispositivo de linha
não estiver disponível para o usuário.

Saída de exemplo para o parâmetro /d

Essa saída de exemplo é exibida depois de executar o parâmetro /d para exibir a


configuração atual do TAPI. Para cada provedor de telefonia, os dispositivos de linha
associados são listados, bem como os endereços e usuários associados a cada
dispositivo de linha.
NDIS Proxy TAPI Service Provider
Line: WAN Miniport (L2TP)
Permanent ID: 12345678910

NDIS Proxy TAPI Service Provider


Line: LPT1DOMAIN1\User1
Permanent ID: 12345678910

Microsoft H.323 Telephony Service Provider


Line: H323 Line
Permanent ID: 123456
Addresses:
BLDG1-TAPI32

Exemplos
Para remover todos os dispositivos de linha atribuídos ao User1, digite:

XML

<UserList>
<User NoMerge=1>
<DomainUser>domain1\user1</DomainUser>
</User>
</UserList>

Para remover todos os dispositivos de linha atribuídos ao User1, antes de atribuir uma
linha com o endereço 99999, digite:

XML

<UserList>
<User NoMerge=1>
<DomainUser>domain1\user1</DomainUser>
<FriendlyName>User1</FriendlyName>
<LineList>
<Line>
<Address>99999</Address>
</Line>
</LineList>
</User>
</UserList>

Neste exemplo, o User1 não tem nenhum outro dispositivo de linha atribuído,
independentemente de qualquer dispositivo de linha ter sido atribuído anteriormente.
Para adicionar um dispositivo de linha para User1, sem excluir nenhum dispositivo de
linha atribuído anteriormente, digite:

XML

<UserList>
<User>
<DomainUser>domain1\user1</DomainUser>
<FriendlyName>User1</FriendlyName>
<LineList>
<Line>
<Address>99999</Address>
</Line>
</LineList>
</User>
</UserList>

Para adicionar o endereço de linha 99999 e remover o endereço de linha 88888 do


acesso do User1, digite:

XML

<UserList>
<User>
<DomainUser>domain1\user1</DomainUser>
<FriendlyName>User1</FriendlyName>
<LineList>
<Line>
<Address>99999</Address>
</Line>
<Line Remove=1>
<Address>88888</Address>
</Line>
</LineList>
</User>
</UserList>

Para adicionar o dispositivo permanente 1000 e remover a linha 88888 do acesso do


User1, digite:

XML

<UserList>
<User>
<DomainUser>domain1\user1</DomainUser>
<FriendlyName>User1</FriendlyName>
<LineList>
<Line>
<PermanentID>1000</PermanentID>
</Line>
<Line Remove=1>
<Address>88888</Address>
</Line>
</LineList>
</User>
</UserList>

Links relacionados
Chave da sintaxe de linha de comando

Visão geral do shell de comando


tskill
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Encerra um processo em execução em uma sessão em um servidor Host da Sessão da


Área de Trabalho Remota.

7 Observação

Você pode usar esse comando para encerrar somente os processos que pertencem
a você, a menos que seja um administrador. Administradores têm acesso total a
todas as funções tskill e podem encerrar processos em execução em outras sessões
de usuário.

Para descobrir as novidades da última versão, confira Novidades nos Serviços de


Área de Trabalho Remota do Windows Server.

Sintaxe

tskill {<processID> | <processname>} [/server:<servername>] [/id:<sessionID>


| /a] [/v]

Parâmetros

Parâmetro Descrição

<processID> Especifica a ID do processo que você deseja encerrar.

<processname> Especifica o nome do processo que você deseja encerrar. Esse parâmetro
pode incluir caracteres curinga.

/server: <servername> Especifica o servidor de terminal que contém o processo que você deseja
encerrar. Se /server não for especificado, o servidor Host da Sessão da
Área de Trabalho Remota atual será usado.

/id: <sessionID> Encerra o processo em execução na sessão especificada.


Parâmetro Descrição

/a Encerra o processo em execução em todas as sessões.

/v Exibe informações sobre as ações sendo executadas.

/? Exibe a ajuda no prompt de comando.

Comentários
Quando todos os processos em execução em uma sessão são encerrados, a sessão
também é encerrada.

Se você usar os parâmetros <processname> e /server:<servername> , também


precisará especificar o parâmetro /id:<sessionID> ou /a.

Exemplos
Para encerrar o processo 6543, digite:

tskill 6543

Para encerrar o gerenciador de processos em execução na sessão 5, digite:

tskill explorer /id:5

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
tsprof
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Copia as informações de configuração do usuário dos Serviços de Área de Trabalho


Remota de um usuário para outro. As informações de configuração do usuário dos
Serviços de Área de Trabalho Remota são exibidas nas extensões dos Serviços de Área
de Trabalho Remota para Usuários e Grupos Locais e Usuários e Computadores do
Active Directory.

7 Observação

Você também pode usar o comando tsprof para definir o caminho do perfil para
um usuário.

Para descobrir as novidades da última versão, confira Novidades nos Serviços de


Área de Trabalho Remota do Windows Server.

Sintaxe

tsprof /update {/domain:<Domainname> | /local} /profile:<path> <username>


tsprof /copy {/domain:<Domainname> | /local} [/profile:<path>] <src_user>
<dest_user>
tsprof /q {/domain:<Domainname> | /local} <username>

Parâmetros

Parâmetro Descrição

/update Atualiza informações de caminho de perfil para <username> no domínio


<domainname> para <profilepath> .

/domain: <Domainname> Especifica o nome do domínio no qual a operação é aplicada.

/local Aplica a operação somente a contas de usuário locais.


Parâmetro Descrição

/profile: <path> Especifica o caminho do perfil, conforme exibido nas extensões dos
Serviços de Área de Trabalho Remota em Usuários e Grupos Locais e
Usuários e Computadores do Active Directory.

<username> Especifica o nome do usuário para quem você deseja atualizar ou


consultar o caminho do perfil do servidor.

/copy Copia as informações de configuração do usuário de <src_user> para


<dest_user> e atualiza as informações de caminho do perfil de
<dest_user> para <profilepath> . <src_user> e <dest_user> devem ser
locais ou devem estar no domínio <domainname> .

<src_user> Especifica o nome do usuário de quem você deseja copiar as


informações de configuração do usuário. Também conhecido como
usuário de origem.

<dest_user> Especifica o nome do usuário de quem você deseja copiar as


informações de configuração do usuário. Também conhecido como o
usuário de origem.

/q Exibe o caminho de perfil atual do usuário para quem você deseja


consultar o caminho do perfil do servidor.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para copiar as informações de configuração do usuário de LocalUser1 para LocalUser2,
digite:

tsprof /copy /local LocalUser1 LocalUser2

Para definir o caminho de perfil dos Serviços de Área de Trabalho Remota para
LocalUser1 como um diretório chamado c:\profiles, digite:

tsprof /update /local /profile:c:\profiles LocalUser1

Links relacionados
Chave da sintaxe de linha de comando

Referência aos comandos dos Serviços de Área de Trabalho Remota (Serviços de


Terminal)
tipo
Artigo • 17/04/2023

No shell de comando do Windows, type é um comando interno que exibe o conteúdo


de um arquivo de texto. Use o comando type para exibir um arquivo de texto sem
modificá-lo.

No PowerShell, type é um alias interno para o cmdlet Get-Content, que também exibe o
conteúdo de um arquivo, mas usando uma sintaxe diferente.

Sintaxe

type [<drive>:][<path>]<filename>

Parâmetros

Parâmetro Descrição

[<drive>:] Especifica o local e o nome do arquivo ou arquivos que você quer exibir. Se o seu
[<path>] <filename> contiver espaços, deverá colocá-los entre aspas (por exemplo, "Nome
<filename> de arquivo contendo espaços.txt"). Você também pode adicionar vários nomes de
arquivo adicionando espaços entre eles.

/? Exibe a ajuda no prompt de comando.

Comentários
Se você exibir um arquivo binário ou um arquivo criado por um programa, poderá
ver caracteres estranhos na tela, incluindo caracteres de formfeed e símbolos de
sequência de escape. Esses caracteres representam códigos de controle usados no
arquivo binário. Em geral, evite usar o comando type para exibir arquivos binários.

Exemplos
Para exibir o conteúdo de um arquivo chamado holiday.mar, digite:
type holiday.mar

Para exibir o conteúdo de um arquivo grande chamado holiday.mar, uma tela de cada
vez, digite:

type holiday.mar | more

Links relacionados
Chave da sintaxe de linha de comando
typeperf
Artigo • 15/06/2023

O comando typeperf grava dados de desempenho na janela de comando ou em um


arquivo de log. Para interromper o typeperf, pressione CTRL+C.

Sintaxe

typeperf <counter [counter ...]> [options]


typeperf -cf <filename> [options]
typeperf -q [object] [options]
typeperf -qx [object] [options]

Parâmetros

Parâmetro Descrição

<counter Especifica os contadores de desempenho a serem monitorados. O parâmetro


[counter <counter> é o nome completo de um contador de desempenho no formato
[...]]> \Computer\Object(Instance)\Counter, como \\Server1\Processor(0)\% User Time .

Opções

Opção Descrição

-f <CSV | TSV | Especifica o formato do arquivo de saída. O padrão é CSV.


BIN | SQL>

-cf <filename> Especifica um arquivo que contém uma lista de contadores de desempenho a
serem monitorados, com um contador por linha.

-si Especifica o intervalo de exemplo. O padrão é um segundo.


<[[hh:]mm:]ss>

-o <filename> Especifica o caminho para o arquivo de saída ou o banco de dados SQL. O


padrão é STDOUT (gravado na janela de comando).

-q [object] Exibe uma lista de contadores instalados (sem instâncias). Para listar os
contadores de um objeto, inclua o nome do objeto.
Opção Descrição

-qx [object] Exibe uma lista de contadores instalados com instâncias. Para listar os
contadores de um objeto, inclua o nome do objeto.

-sc <samples> Especifica o número de exemplos a serem coletados. O padrão é coletar dados
até que CTRL+C seja pressionado.

-config Especifica um arquivo de configurações que contém as opções de comando.


<filename>

-s Especifica um computador remoto a ser monitorado, se nenhum computador


<computer_name> for especificado no caminho do contador.

-y Responde sim a todas as perguntas sem solicitar.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para gravar os valores do contador de desempenho do computador local
\Processor(_Total)\% Processor Time na janela de comando, em um intervalo de
exemplo padrão de 1 segundo até que CTRL+C seja pressionado, digite:

typeperf \Processor(_Total)\% Processor Time

Para gravar os valores da lista de contadores no arquivo counters.txt, no arquivo


delimitado por tabulação domain2.tsv, em um intervalo de exemplo de 5 segundos até
que 50 amostras sejam coletadas, digite:

typeperf -cf counters.txt -si 5 -sc 50 -f TSV -o domain2.tsv

Para consultar os contadores instalados com instâncias do objeto de contador


PhysicalDisk e gravar a lista resultante no arquivo counters.txt, digite:

typeperf -qx PhysicalDisk -o counters.txt


Links relacionados
Chave da sintaxe de linha de comando
tzutil
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe o utilitário de Fuso Horário do Windows.

Sintaxe

tzutil [/?] [/g] [/s <timezoneID>[_dstoff]] [/l]

Parâmetros

Parâmetro Descrição

/g Exibe a ID do fuso horário atual.

/s Define o fuso horário atual usando a ID do fuso horário especificada. O sufixo


<timezoneID> _dstoff desabilita os ajustes do Horário de Verão para o fuso horário (quando
[_dstoff] aplicável). O valor deve ficar entre aspas.

/l Lista todas as IDs de fuso horário válidas e os nomes de exibição. A saída é exibida
como:
<display name>
<time zone ID>

/? Exibe a ajuda no prompt de comando.

Comentários
Um código de saída 0 indica que o comando foi concluído com êxito.

Exemplos
Para exibir a ID do fuso horário atual, digite:
tzutil /g

Para definir o fuso horário atual para a hora padrão do Pacífico, digite:

tzutil /s "Pacific Standard time"

Para definir o fuso horário atual para a hora padrão do Pacífico e desabilitar os ajustes
do Horário de Verão, digite:

tzutil /s "Pacific Standard time_dstoff"

Links relacionados
Chave da sintaxe de linha de comando
unexpose
Artigo • 12/04/2023

Cancela a publicação de uma cópia de sombra que foi exposta usando o comando
expose. A cópia de sombra exposta pode ser especificada pela ID de sombra, letra da
unidade, compartilhamento ou ponto de montagem.

Sintaxe

unexpose {<shadowID> | <drive:> | <share> | <mountpoint>}

Parâmetros

Parâmetro Descrição

<shadowID> Exibe a cópia de sombra especificada pela ID de Sombra fornecida. Você pode
usar um alias existente ou uma variável de ambiente no lugar de <shadowID> . Use
o comando add sem parâmetros para ver todos os aliases existentes.

<drive:> Exibe a cópia de sombra associada à letra da unidade especificada (por exemplo,
unidade P).

<share> Exibe a cópia de sombra associada ao compartilhamento especificado (por


exemplo, \\MachineName ).

<mountpoint> Exibe a cópia de sombra associada ao ponto de montagem especificado (por


exemplo, C:\shadowcopy\ ).

add Usado sem parâmetros mostrará os aliases existentes.

Exemplos
Para cancelar a publicação da cópia de sombra associada à *unidade P:*, digite:

unexpose P:

Links relacionados
Chave da sintaxe de linha de comando

comando add

comando expose
uniqueid
Artigo • 12/04/2023

Exibe ou define o identificador de GPT (tabela de partição de GUID) ou a assinatura MBR


(registro mestre de inicialização) do disco com foco. Um disco básico ou dinâmico deve
ser selecionado para que essa operação seja bem-sucedida. Use o comando select disk
para selecionar um disco e mudar o foco para ele.

Sintaxe

uniqueid disk [id={<dword> | <GUID>}] [noerr]

Parâmetros

Parâmetro Descrição

id= {<dword> Para discos MBR, esse parâmetro especifica um valor DWORD (4 bytes) no formato
| <GUID>} hexadecimal para a assinatura. Para discos GPT, esse parâmetro especifica um
GUID para o identificador.

noerr Somente para scripts. Quando um erro ocorre, o DiskPart continua a processar os
comandos como se o erro não tivesse ocorrido. Sem esse parâmetro, um erro faz
com que o DiskPart saia com um código de erro.

Exemplos
Para exibir a assinatura do disco MBR com foco, digite:

uniqueid disk

Para definir a assinatura do disco MBR com foco como o valor DWORD 5f1b2c36, digite:

uniqueid disk id=5f1b2c36


Para definir o identificador do disco GPT com foco como o valor GUID baf784e7-6bbd-
4cfb-aaac-e86c96e166ee, digite:

uniqueid disk id=baf784e7-6bbd-4cfb-aaac-e86c96e166ee

Links relacionados
Chave da sintaxe de linha de comando

comando select disk


unlodctr
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Remove Nomes de contador de desempenho e Texto explicativo para um driver de


serviço ou dispositivo do Registro do sistema.

2 Aviso

A edição incorreta do Registro pode causar danos graves ao sistema. Antes de


alterar o Registro, faça backup de todos os dados importantes do computador.

Sintaxe

unlodctr <drivername>

Parâmetros

Parâmetro Descrição

<drivername> Remove as configurações de Nome do contador de desempenho e o Texto


explicativo para driver ou serviço <drivername> do Registro do Windows Server.
Se o seu <drivername> incluir espaços, use aspas ao redor do texto, por exemplo,
"Nome do driver".

/? Exibe a ajuda no prompt de comando.

Exemplos
Para remover os Nomes de contador de desempenho atuais e o Texto explicativo do
serviço SMTP (Simple Mail Transfer Protocol), digite:

unlodctr SMTPSVC
Links relacionados
Chave da sintaxe de linha de comando
ver
Artigo • 12/04/2023

Exibe o número de versão do sistema operacional. Esse comando tem suporte no


prompt de Comando do Windows (Cmd.exe), mas não nas verões do PowerShell.

Sintaxe

ver

Parâmetros

Parâmetro Descrição

/? Exibe a ajuda no prompt de comando.

Exemplos
Para obter o número de versão do sistema operacional no shell de Comando (cmd.exe),
digite:

ver

Se você quiser obter o número de versão do sistema operacional por meio de Windows
PowerShell, digite:

PowerShell

$PSVersionTable.BuildVersion

Se você quiser obter o número de versão do sistema operacional por meio de


PowerShell 7.x.x, digite:

PowerShell

$PSVersionTable.OS
Links relacionados
Chave da sintaxe de linha de comando
verifier
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

O Driver Verifier monitora drivers gráficos e drivers no modo kernel do Windows para
detectar chamadas de função ilegais ou ações que podem corromper o sistema. O
Driver Verifier pode submeter drivers do Windows a uma variedade de pressões e testes
para encontrar comportamentos inadequados. Você pode configurar quais testes
executar, o que permite colocar um driver sob cargas de estresse pesadas ou realizar
testes mais simplificados. Você também pode executar o Driver Verifier em vários drivers
simultaneamente ou em um driver por vez.

) Importante

Você precisa estar no grupo Administradores no computador para usar o Driver


Verifier. A execução do Driver Verifier pode fazer com que o computador falhe, de
modo que você só deve executá-lo em computadores usados para teste e
depuração.

Sintaxe

verifier /standard /all


verifier /standard /driver NAME [NAME ...]
verifier /flags <options> /all
verifier /flags <options> /driver NAME [NAME ...]
verifier /rules [OPTION ...]
verifier /query
verifier /querysettings
verifier /bootmode [persistent | disableafterfail | oneboot]
verifier /reset
verifier /faults [Probability] [PoolTags] [Applications] [DelayMins]
verifier /faultssystematic [OPTION ...]
verifier /log LOG_FILE_NAME [/interval SECONDS]
verifier /volatile /flags <options>
verifier /volatile /adddriver NAME [NAME ...]
verifier /volatile /removedriver NAME [NAME ...]
verifier /volatile /faults [Probability] [PoolTags] [Applications]
[DelayMins]
verifier /domain <types> <options> /driver ... [/logging | /livedump]
verifier /logging
verifier /livedump
verifier /?
verifier /help

Parâmetros

Parâmetro Descrição

/all Direciona o utilitário Driver Verifier para verificar todos os drivers


instalados após a próxima inicialização.

/bootmode [persistent Controla se as configurações do utilitário Driver Verifier estão


\| disableafterfail \| habilitadas após uma reinicialização. Para definir ou alterar essa opção,
oneboot \| você precisa reinicializar o computador. Os seguintes métodos estão
resetonunusualshutdown] disponíveis:
persistent – garante que as configurações do Driver Verifier
persistam (permaneçam em vigor) após muitas reinicializações.
Essa é a configuração padrão.
disableafterfail – se a inicialização do Windows falhar, essa
configuração desabilitará o utilitário Driver Verifier para
reinicializações subsequentes.
oneboot – habilita as configurações do Driver Verifier apenas
para a próxima vez que o computador for iniciado. O utilitário
Driver Verifier é desabilitado para reinicializações subsequentes.
resetonunusualshutdown – o utilitário Driver Verifier persistirá
até que ocorra um desligamento incomum. A abreviação, 'rous',
pode ser usada.

/driver <driverlist> Especifica um ou mais drivers que serão verificados. O parâmetro


driverlist é uma lista de drivers por nome binário, como driver.sys. Use
um espaço para separar cada nome de driver. Não há suporte para
valores curinga, como n*.sys .

/driver.exclude Especifica um ou mais drivers que serão excluídos da verificação. Esse


<driverlist> parâmetro só será aplicável se todos os drivers forem selecionados
para verificação. O parâmetro driverlist é uma lista de drivers por
nome binário, como driver.sys. Use um espaço para separar cada nome
de driver. Não há suporte para valores curinga, como n*.sys .
Parâmetro Descrição

/faults Habilita o recurso Simulação de Poucos Recursos no utilitário Driver


Verifier. Você pode usar /faults no lugar de /flags 0x4 . No entanto,
você não pode usar /flags 0x4 com os subparâmetros de /faults.
Você pode usar os seguintes subparâmetros do parâmetro /faults para
configurar a Simulação de Poucos Recursos:

Probabilidade – especifica a probabilidade de que o utilitário


Driver Verifier falhe em uma determinada alocação. Digite um
número (no formato decimal ou hexadecimal) para representar
o número de chances em 10.000 de que o utilitário Driver
Verifier falhará na alocação. O valor padrão, 600, significa
600/10000, ou 6%.
Marcas de Pool – limita as alocações que o utilitário Driver
Verifier pode falhar em alocações com as marcas de pool
especificadas. Use um caractere curinga (*) para representar
várias marcas de pool. Para listar várias marcas de pool, separe
as marcas com espaços. Por padrão, todas as alocações podem
falhar.
Aplicativos – limita as alocações que o utilitário Driver Verifier
pode falhar em alocações para o programa especificado. Digite
o nome de um arquivo executável. Para listar programas, separe
os nomes dos programas com espaços. Por padrão, todas as
alocações podem falhar.
DelayMins – especifica o número de minutos após a
inicialização durante os quais o utilitário Driver Verifier não falha
intencionalmente em nenhuma alocação. Esse atraso permite
que os drivers sejam carregados e o sistema se estabilize antes
do início do teste. Digite um número (no formato decimal ou
hexadecimal). O valor padrão é 7 (minutos).
Parâmetro Descrição

/faultssystematic Especifica as opções para a simulação Recursos Baixos Sistemáticos.


Use o sinalizador 0x40000 para selecionar a opção de simulação
Recursos Baixos Sistemáticos. As seguintes opções estão disponíveis:

enableboottime – habilita injeções de falha em reinicializações


do computador.
disableboottime – desabilita injeções de falha nas
reinicializações do computador (essa é a configuração padrão).
recordboottime – habilita injeções de falha no modo what if
entre reinicializações do computador.
resetboottime – desabilita injeções de falha em reinicializações
do computador e limpa a lista de exclusões da pilha.
enableruntime – habilita injeções de falha dinamicamente.
disableruntime – desabilita injeções de falha dinamicamente.
recordruntime – habilita injeções de falha no modo what if
dinamicamente.
resetruntime – desabilita dinamicamente as injeções de falha e
limpa a lista de pilhas com falha anterior.
querystatistics – mostra as estatísticas atuais de injeção de
falha.
incrementcounter – incrementa o contador de aprovação de
teste usado para identificar quando uma falha foi injetada.
getstackid COUNTER – recupera o identificador de pilha
injetada indicado.
excludestack STACKID – exclui a pilha da injeção de falha.
Parâmetro Descrição

/flags <options> Ativa as opções especificadas após a próxima reinicialização. Esse


número pode ser inserido no formato decimal ou hexadecimal (com
um prefixo 0x). Qualquer combinação dos seguintes valores é
permitida:
Valor: 1 ou 0x1 (bit 0) - Verificação de pool especial
Valor: 2 ou 0x2 (bit 1) - Forçar verificação de IRQL
Valor: 4 ou 0x4 (bit 2) - Simulação de Poucos Recursos
Valor: 8 ou 0x8 (bit 3) - Acompanhamento de pool
Valor: 16 ou 0x10 (bit 4) - Verificação de E/S
Valor: 32 ou 0x20 (bit 5) - Detecção de deadlock
Valor: 64 ou 0x40 (bit 6) - Verificação de E/S aprimorada. Essa
opção é ativada automaticamente quando você seleciona
Verificação de E/S.
Valor: 128 ou 0x80 (bit 7) - Verificação de DMA
Valor: 256 ou 0x100 (bit 8) - Verificações de segurança
Valor: 512 ou 0x200 (bit 9) - Forçar solicitações de E/S
pendentes
Valor: 1024 ou 0x400 (bit 10) - Registro em log de IRP
Valor: 2048 ou 0x800 (bit 11) - Verificações diversas
Valor: 8192 ou 0x2000 (bit 13) - Verificação de MDL invariável
para a pilha
Valor: 16384 ou 0x4000 (bit 14) - Verificação de MDL invariável
para o driver
Valor: 32768 ou 0x8000 (bit 15) - Fuzzing de atraso do Power
Framework
Valor: 65536 ou 0x10000 (bit 16) – Verificação da interface de
porta/miniporta
Valor: 131072 ou 0x20000 (bit 17) - Verificação de conformidade
de DDI
Valor: 262144 ou 0x40000 (bit 18) - Simulação sistemática de
poucos recursos
Valor: 524288 ou 0x80000 (bit 19) - Verificação de
conformidade de DDI (adicional)
Valor: 2097152 ou 0x200000 (bit 21) - Verificação de NDIS/WIFI
Valor: 8388608 ou 0x800000 (bit 23) - Fuzzing de atraso de
sincronização de kernel
Valor: 16777216 ou 0x1000000 (bit 24) - Verificação do
comutador da VM
Valor: 33554432 ou 0x2000000 (bit 25) – Verificações de
integridade de código. Você não pode usar esse método para
ativar as opções de Verificação de SCSI ou Verificação de
Storport. Para obter mais informações, consulte Verificação de
SCSI e Verificação de Storport.
Parâmetro Descrição

/flags <volatileoptions> Especifica as opções do utilitário Driver Verifier que são alteradas
imediatamente sem reinicialização. Esse número pode ser inserido no
formato decimal ou hexadecimal (com um prefixo 0x). Qualquer
combinação dos seguintes valores é permitida:
Valor: 1 ou 0x1 (bit 0) – Pool especial
Valor: 2 ou 0x2 (bit 1) – Forçar verificação de IRQL
Valor: 4 ou 0x4 (bit 2) – Simulação de Poucos Recursos

<probability> Número entre 1 e 10.000 especificando a probabilidade de injeção de


falha. Por exemplo, especificar 100 significa uma probabilidade de
injeção de falha de 1% (100/10.000).
Se esse parâmetro não for especificado, a probabilidade padrão de 6%
será usada.

<tags> Especifica as marcas de pool que serão injetadas com falhas,


separadas por caracteres de espaço. Se esse parâmetro não for
especificado, qualquer alocação de pool poderá ser injetada com
falhas.

<apps> Especifica o nome do arquivo de imagem dos aplicativos que serão


injetados com falhas, separados por caracteres de espaço. Se esse
parâmetro não for especificado, a simulação de poucos recursos
poderá ocorrer em qualquer aplicativo.

<minutes> Um número positivo especificando a duração do período após a


reinicialização, em minutos, durante o qual nenhuma injeção de falha
ocorrerá. Se esse parâmetro não for especificado, a duração padrão de
8 minutos será usada.

/iolevel <level> Especifica o nível da Verificação de E/S. O valor de [nível] pode ser 1 –
Habilita a Verificação de E/S de Nível 1 (padrão) ou 2 – Habilita a
Verificação de E/S de Nível 1 e a Verificação de E/S de Nível 2. Se a
Verificação de E/S não estiver habilitada (usando /flags 0x10 ),
/iolevel será ignorado.

/log <logfilename> Cria um arquivo de log usando o nome especificado. O utilitário Driver
[/intervalseconds] Verifier grava periodicamente estatísticas nesse arquivo, com base no
intervalo definido opcionalmente. O intervalo padrão é 30 segundos.

Se um comando /log do verificador for digitado na linha de comando,


o prompt de comando não retornará. Para fechar o arquivo de log e
retornar um prompt, use CTRL+C. Após uma reinicialização, para criar
um log, você precisa enviar o comando /log ao verificador novamente.
Parâmetro Descrição

/rules <option> Opções para regras que podem ser desabilitadas, incluindo:
query – mostra o status atual das regras controláveis.
reset – redefine todas as regras para o estado padrão.
default ID – define a ID da regra como o estado padrão. Para as
regras com suporte, a ID da regra é o valor do parâmetro 1 da
Verificação de Bugs 0xC4
(DRIVER_VERIFIER_DETECTED_VIOLATION).
disable ID – desabilita a ID da regra especificada. Para as regras
com suporte, a ID da regra é o valor do parâmetro 1 da
Verificação de Bugs 0xC4
(DRIVER_VERIFIER_DETECTED_VIOLATION).

/standard Ativa as opções "padrão" do Driver Verifier após a próxima


reinicialização. As opções padrão são Pool Especial, Forçar Verificação
de IRQL, Acompanhamento de Pool, Verificação de E/S, Detecção de
Deadlock, Verificação de DMA, Verificações de Segurança, Verificações
Diversas e Verificação de conformidade de DDI. Isso é equivalente a
/flags 0x209BB .

[!OBSERVAÇÃO] Começando no Windows 10, em versões após a 1803,


o uso de /flags 0x209BB não habilitará mais a verificação do WDF
automaticamente. Use a sintaxe /standard para habilitar opções
padrão, com a verificação do WDF incluída.

/volatile Altera as configurações sem reinicializar o computador. Configurações


voláteis entram em vigor imediatamente.
Você pode usar o parâmetro /volatile com o parâmetro /flags para
habilitar e desabilitar algumas opções sem reinicializar. Você também
pode usar /volatile com os parâmetros /adddriver e /removedriver
para iniciar ou interromper a verificação de um driver sem reinicializar,
mesmo que o utilitário Driver Verifier não esteja em execução. Para
obter mais informações, consulte Usando configurações voláteis.

/adddriver Adiciona os drivers especificados das configurações voláteis. Para


<volatiledriverlist> especificar vários drivers, liste seus nomes separados por espaços. Não
há suporte para valores curinga, como n.sys.

/removedriver Remove os drivers especificados das configurações voláteis. Para


<volatiledriverlist> especificar vários drivers, liste seus nomes separados por espaços. Não
há suporte para valores curinga, como n.sys.

/reset Limpa todas as configurações do utilitário Driver Verifier. Após a


próxima reinicialização, nenhum driver será verificado.
Parâmetro Descrição

/querysettings Exibe um resumo das opções que serão ativadas e dos drivers que
serão verificados após a próxima inicialização. Essa exibição não inclui
drivers e opções adicionadas usando o parâmetro /volatile. Para
conhecer outras maneiras de exibir essas configurações, consulte
Exibindo configurações do Driver Verifier.

/Query Exibe um resumo da atividade atual do utilitário Driver Verifier. O


campo Nível na exibição é o valor hexadecimal das opções definidas
com o parâmetro /volatile. Para obter explicações sobre cada
estatística, consulte Monitorando contadores globais e Monitorando
contadores individuais.

/domain <types> Controla as configurações da extensão de verificador. Há suporte para


<options> os seguintes tipos de extensão de verificador:
wdm – habilita a extensão de verificador para drivers WDM.
ndis – habilita a extensão de verificador para drivers de rede.
ks – habilita a extensão de verificador para drivers de streaming
no modo kernel.
audio – habilita a extensão de verificador para drivers de áudio.

. Há suporte para as seguintes opções de extensão:

rules.default – habilita regras de validação padrão para a


extensão de verificador selecionada.
rules.all – habilita todas as regras de validação para a extensão
de verificador selecionada.

/logging Habilita o registro em log para regras violadas detectadas pelas


extensões de verificador selecionadas.

/livedump Habilita a coleta de despejo de memória ao vivo para regras violadas


detectadas pelas extensões de verificador selecionadas.

/? Exibe a ajuda da linha de comando.

Códigos de retorno
Os seguintes valores são retornados após a execução do verificador de driver:

0: EXIT_CODE_SUCCESS

1: EXIT_CODE_ERROR

2: EXIT_CODE_REBOOT_NEEDED

Comentários
Você pode usar o parâmetro /volatile com algumas das opções de /flags do
utilitário Driver Verifier e com /standard. Você não pode usar /volatile com as
opções de /flags para Verificação de conformidade de DDI, Fuzzing de atraso do
Power Framework, Verificação de Storport ou Verificação de SCSI. Para obter mais
informações, consulte Usando configurações voláteis.

Links relacionados
Chave da sintaxe de linha de comando

Driver Verifier

Controlando o Driver Verifier

Monitorando o Driver Verifier

Usando configurações voláteis


verificar
Artigo • 12/04/2023

Informa à ferramenta Prompt de Comando (cmd.exe) se os arquivos foram gravados


corretamente em um disco.

Sintaxe

verify [on | off]

Parâmetros

Parâmetro Descrição

[on \| off] Ativa ou desativa a configuração verify.

/? Exibe a ajuda no prompt de comando.

Exemplos
Para exibir a configuração verify atual, digite:

verify

Para ativar a configuração verify, digite:

verify on

Links relacionados
Chave da sintaxe de linha de comando
vol
Artigo • 10/04/2023

Exibe o rótulo do volume de disco e o número de série, se existirem. Se usado sem


parâmetros, vol exibe informações sobre a unidade atual.

Sintaxe

vol [<drive>:]

Parâmetros

Parâmetro Descrição

<drive>: Especifica a unidade que contém o disco para o qual você deseja exibir o rótulo de
volume e o número de série.

/? Exibe a ajuda no prompt de comando.

Links relacionados
Chave da sintaxe de linha de comando
vssadmin
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Windows 8.1,
Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows
Server 2008 R2 e Windows Server 2008

Exibe backups de cópia de sombra de volume atuais e todos os provedores e


gravadores de cópia de sombra instalados. Selecione um nome de comando na tabela a
seguir para exibir sua sintaxe de comando.

Comando Descrição Disponibilidade

vssadmin delete Exclui cópias de sombra de volume. Cliente e


shadows servidor

vssadmin list Lista cópias de sombra de volume existentes. Cliente e


shadows servidor

vssadmin list Lista todos os gravadores de cópia de sombra de Cliente e


writers volume inscritos no sistema. servidor

vssadmin resize Redimensiona o tamanho máximo para uma associação Cliente e


shadowstorage de armazenamento de cópia de sombra. servidor

Links relacionados
Chave da sintaxe de linha de comando
vssadmin delete shadows
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Windows 8.1,
Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows
Server 2008 R2 e Windows Server 2008

Exclui as cópias de sombra de um volume especificado. Você só pode excluir cópias de


sombra com o tipo client-accessible.

Sintaxe

vssadmin delete shadows /for=<ForVolumeSpec> [/oldest | /all | /shadow=


<ShadowID>] [/quiet]

Parâmetros

Parâmetro Descrição

/for= <ForVolumeSpec> Especifica qual cópia de sombra do volume será excluída.

/oldest Exclui somente a cópia de sombra mais antiga.

/all Exclui todas as cópias de sombra do volume especificado.

/shadow= <ShadowID> Exclui a cópia de sombra especificada por ShadowID. Para obter a ID da
cópia de sombra, use o comando vssadmin list shadows. Ao inserir uma
ID da cópia de sombra, use o seguinte formato em que cada X
representa um caractere hexadecimal:

XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

/quiet Especifica que o comando não exibirá mensagens durante a execução.

Exemplos
Para excluir a cópia de sombra mais antiga do volume C, digite:
vssadmin delete shadows /for=c: /oldest

Links relacionados
Chave da sintaxe de linha de comando

comando vssadmin

comando vssadmin list shadows


vssadmin list shadows
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Windows 8.1,
Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows
Server 2008 R2 e Windows Server 2008

Lista todas as cópias de sombra existentes de um volume especificado. Se você usar


esse comando sem parâmetros, ele exibirá todas as cópias de sombra de volume no
computador na ordem determinada pelo Conjunto de Cópias de Sombra.

Sintaxe

vssadmin list shadows [/for=<ForVolumeSpec>] [/shadow=<ShadowID>]

Parâmetros

Parâmetro Descrição

/for= <ForVolumeSpec> Especifica para qual volume as cópias de sombra serão listadas.

/shadow= <ShadowID> Lista a cópia de sombra especificada por ShadowID. Para obter a ID da
cópia de sombra, use o comando vssadmin list shadows. Ao digitar uma
ID da cópia de sombra, use o seguinte formato em que cada X
representa um caractere hexadecimal:

XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

Links relacionados
Chave da sintaxe de linha de comando

comando vssadmin

comando vssadmin list shadows


vssadmin list writers
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Windows 8.1,
Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows
Server 2008 R2 e Windows Server 2008

Lista os gravadores de cópia de sombra de volume inscritos.

Syntax

vssadmin list writers

Links relacionados
Chave da sintaxe de linha de comando

comando vssadmin
vssadmin resize shadowstorage
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows 10, Windows 8.1,
Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows
Server 2008 R2 e Windows Server 2008

Redimensiona a quantidade máxima de espaço de armazenamento que pode ser usada


para o armazenamento de cópias de sombra.

A quantidade mínima de espaço de armazenamento que pode ser usada para o


armazenamento de cópia de sombra pode ser especificada usando o valor do registro
MinDiffAreaFileSize. Para obter mais informações, confira MinDiffAreaFileSize.

2 Aviso

Redimensionar a associação de armazenamento pode fazer com que as cópias de


sombra desapareçam.

Sintaxe

vssadmin resize shadowstorage /for=<ForVolumeSpec> /on=<OnVolumeSpec>


[/maxsize=<MaxSizeSpec>]

Parâmetros

Parâmetro Descrição

/for= <ForVolumeSpec> Especifica o volume para o qual a quantidade máxima de espaço de


armazenamento deve ser redimensionada.

/on= <OnVolumeSpec> Especifica o ponto de extremidade de armazenamento.


Parâmetro Descrição

[/maxsize= <MaxSizeSpec> ] Especifica a quantidade máxima de espaço que pode ser usada para
armazenar cópias de sombra. Se nenhum valor for especificado para
/maxsize, não haverá limite estabelecido para a quantidade de
espaço de armazenamento que pode ser usada.

O valor MaxSizeSpec deve ser de 1 MB ou acima e deve ser expresso


em uma das seguintes unidades: KB, MB, GB, TB, PB ou EB. Se
nenhuma unidade for especificada, MaxSizeSpec usará bytes por
padrão.

Exemplos
Para redimensionar a cópia de sombra do volume C no volume D, com um tamanho
máximo de 900 MB, digite:

vssadmin resize shadowstorage /For=C: /On=D: /MaxSize=900MB

Para redimensionar a cópia de sombra do volume C no volume D, sem tamanho


máximo, digite:

vssadmin resize shadowstorage /For=C: /On=D: /MaxSize=UNBOUNDED

Para redimensionar a cópia de sombra do volume C em 20%, digite:

vssadmin resize shadowstorage /For=C: /On=C: /MaxSize=20%

Links relacionados
Chave da sintaxe de linha de comando

comando vssadmin
waitfor
Artigo • 12/04/2023

Envia ou aguarda um sinal em um sistema. Esse comando é usado para sincronizar


computadores em uma rede.

Sintaxe

waitfor [/s <computer> [/u [<domain>\]<user> [/p [<password>]]]] /si


<signalname>
waitfor [/t <timeout>] <signalname>

Parâmetros

Parâmetro Descrição

/s <computer> Especifica o nome ou o endereço IP de um computador remoto (não use barras


invertidas). O padrão é o computador local. Esse parâmetro se aplica a todos os
arquivos e pastas especificados no comando. Se você não usar esse parâmetro, o
sinal será transmitido para todos os sistemas em um domínio. Se você usar esse
parâmetro, o sinal será enviado somente para o sistema especificado.

/u Executa o script usando as credenciais da conta de usuário especificada. Por


[<domain>] padrão, waitfor usa as credenciais do usuário atual.
<user>

/p [\ Especifica a senha da conta de usuário especificada no parâmetro /u.


<password>]

/si Envia o sinal especificado pela rede. Esse parâmetro também permite ativar um
sinal manualmente.

/t <timeout> Especifica o número de segundos para aguardar um sinal. Por padrão, waitfor
aguarda indefinidamente.

<signalname> Especifica o sinal que waitfor aguarda ou envia. Esse parâmetro não diferencia
maiúsculas de minúsculas e não pode exceder 225 caracteres. Os caracteres
válidos incluem a-z, A-Z, 0-9 e o conjunto de caracteres estendidos ASCII (128-
255).

/? Exibe a ajuda no prompt de comando.


Comentários
Você pode executar várias instâncias do waitfor em um único computador, mas
cada instância do waitfor deve aguardar um sinal diferente. Apenas uma instância
do waitfor pode aguardar determinado sinal em determinado computador.

Os computadores só poderão receber os sinais, se estiverem no mesmo domínio


que o computador que envia o sinal.

Você pode usar esse comando ao testar os builds de software. Por exemplo, o
computador de compilação pode enviar um sinal para vários computadores que
executam o waitfor, depois que o compilador for concluído com êxito. Ao receber
o sinal, o arquivo em lote que inclui o waitfor pode instruir os computadores a
iniciar imediatamente a instalação de software ou a execução de testes no build
compilado.

Exemplos
Para aguardar até que o sinal espresso\build007 seja recebido, digite:

waitfor espresso\build007

Por padrão, waitfor aguarda indefinidamente por um sinal.

Para aguardar 10 segundos até que o sinal espresso\compile007 seja recebido, antes de
atingir o tempo limite, digite:

waitfor /t 10 espresso\build007

Para ativar o sinal espresso\build007 manualmente, digite:

waitfor /si espresso\build007

Links relacionados
Chave da sintaxe de linha de comando
wbadmin
Artigo • 12/04/2023

Permite fazer backup e restaurar o sistema operacional, volumes, arquivos, pastas e


aplicativos em um prompt de comando.

Para configurar um backup agendado regularmente usando esse comando, você deve
ser membro do grupo Administradores. Para realizar todas as outras tarefas com esse
comando, você deve ser membro do grupo Operadores de Backup ou do grupo
Administradores ou deve ter as permissões apropriadas.

Você deve executar wbadmin em um prompt de comandos com privilégios elevados,


clicando com o botão direito em Prompt de Comando e selecionando Executar como
administrador.

Parâmetros
Parâmetro Descrição

wbadmin delete Exclui o catálogo de backup no computador local. Use esse comando
catalog somente se o catálogo de backup neste computador estiver corrompido e
você não tiver backups armazenados em outro local que possa ser usado
para restaurar o catálogo.

wbadmin delete Exclui um ou mais backups de estado do sistema.


systemstatebackup

wbadmin disable Desabilita os backups diários.


backup

wbadmin enable Configura e habilita um backup agendado regularmente.


backup

wbadmin get disks Lista os discos que estão online no momento.

wbadmin get items Lista os itens incluídos em um backup.

wbadmin get status Mostra o status da operação de backup ou recuperação em execução no


momento.

wbadmin get Lista os detalhes de backups recuperáveis do computador local ou, se


versions outro local for especificado, de outro computador.

wbadmin restore Recupera um catálogo de backup de um local de armazenamento


catalog especificado, caso o catálogo de backup no computador local tenha sido
corrompido.
Parâmetro Descrição

wbadmin start Executa um backup único. Se usado sem parâmetros, usa as configurações
backup do agendamento de backup diário.

wbadmin start Executa uma recuperação dos volumes, aplicativos, arquivos ou pastas
recovery especificados.

wbadmin start Executa uma recuperação do sistema completo (pelo menos todos os
sysrecovery volumes que contêm o estado do sistema operacional). Esse comando só
estará disponível se você estiver usando o Ambiente de Recuperação do
Windows.

wbadmin start Executa um backup de estado do sistema.


systemstatebackup

wbadmin start Executa uma recuperação de estado do sistema.


systemstaterecovery

wbadmin stop job Interrompe a operação de backup ou recuperação em execução no


momento.

Links relacionados
Chave da sintaxe de linha de comando

Cmdlets do Backup do Windows Server no Windows PowerShell

WinRE (Ambiente de Recuperação do Windows)


wbadmin delete catalog
Artigo • 12/04/2023

Exclui o catálogo de backup armazenado no computador local. Use esse comando


quando o catálogo de backup tiver sido corrompido e você não puder restaurá-lo
usando o comando wbadmin restore catalog.

Para excluir um catálogo de backup usando esse comando, você deve ser membro do
grupo Operadores de Backup ou do grupo Administradores ou deve ter as permissões
apropriadas. Além disso, você deve executar wbadmin em um prompt de comandos
com privilégios elevados, clicando com o botão direito em Prompt de Comando e
selecionando Executar como administrador.

Sintaxe

wbadmin delete catalog [-quiet]

Parâmetros

Parâmetro Descrição

-quiet Executa o comando sem prompts para o usuário.

Comentários
Se você excluir o catálogo de backup de um computador, não poderá mais acessar
os backups criados para esse computador usando o snap-in Backup do Windows
Server. No entanto, se você puder acessar outro local de backup e executar o
comando wbadmin restore catalog, poderá restaurar o catálogo de backup nesse
local.

É altamente recomendável que você crie um novo backup depois de excluir um


catálogo de backup.

Links relacionados
Chave da sintaxe de linha de comando
comando wbadmin

comando wbadmin restore catalog

Remove-WBCatalog
wbadmin delete systemstatebackup
Artigo • 12/04/2023

Exclui os backups de estado do sistema especificados. Se o volume especificado contiver


backups diferentes dos backups de estado do sistema do servidor local, esses backups
não serão excluídos.

Para excluir um backup de estado do sistema usando esse comando, você deve ser
membro do grupo Operadores de Backup ou do grupo Administradores ou deve ter as
permissões apropriadas. Além disso, você deve executar wbadmin em um prompt de
comandos com privilégios elevados, clicando com o botão direito em Prompt de
Comando e selecionando Executar como administrador.

7 Observação

O Backup do Windows Server não faz backup nem recupera hives de usuário do
registro (HKEY_CURRENT_USER) como parte do backup de estado do sistema ou da
recuperação de estado do sistema.

Syntax

wbadmin delete systemstatebackup {-keepVersions:<numberofcopies> | -version:


<versionidentifier> | -deleteoldest} [-backupTarget:<volumename>] [-machine:
<backupmachinename>] [-quiet]

) Importante

Você deve especificar apenas um destes parâmetros: -keepVersions, -version ou -


deleteOldest.

Parâmetros

Parâmetro Descrição

- Especifica o número dos backups de estado do sistema mais recentes a serem


keepVersions mantidos. O valor deve ser um inteiro positivo. O valor do parâmetro -
keepversions:0 exclui todos os backups de estado do sistema.
Parâmetro Descrição

-version Especifica o identificador de versão do backup no formato MM/DD/AAAA-


HH:MM. Se você não souber o identificador de versão, execute o comando
wbadmin get versions.

As versões compostas exclusivamente por backups de estado do sistema podem


ser excluídas usando esse comando. Execute o comando wbadmin get items para
exibir o tipo de versão.

- Exclui o backup de estado do sistema mais antigo.


deleteOldest

- Especifica o local de armazenamento para o backup que você deseja excluir. O


backupTarget local de armazenamento dos backups de disco pode ser uma letra da unidade,
um ponto de montagem ou um caminho de volume baseado em GUID. Esse valor
só precisa ser especificado para localizar os backups que não estão no
computador local. As informações sobre backups para o computador local estão
disponíveis no catálogo de backup no computador local.

-machine Especifica o computador cujo backup de estado do sistema você deseja excluir.
Útil quando vários computadores foram submetidos a backup no mesmo local.
Deve ser usado quando o parâmetro -backupTarget for especificado.

-quiet Executa o comando sem prompts para o usuário.

Exemplos
Para excluir o backup de estado do sistema criado em 31 de março de 2013 às 10:00,
digite:

wbadmin delete systemstatebackup -version:03/31/2013-10:00

Para excluir todos os backups de estado do sistema, exceto os três mais recentes, digite:

wbadmin delete systemstatebackup -keepVersions:3

Para excluir o backup de estado do sistema mais antigo armazenado no disco f:, digite:

wbadmin delete systemstatebackup -backupTarget:f:\ -deleteOldest


Links relacionados
Chave da sintaxe de linha de comando

comando wbadmin

comando wbadmin get versions

comando wbadmin get items


wbadmin disable backup
Artigo • 10/04/2023

Interrompe a execução dos backups diários agendados existentes.

Para desabilitar um backup diário agendado usando esse comando, você precisa ser um
membro do grupo Administradores ou precisa ter as permissões apropriadas. Além
disso, você deve executar wbadmin em um prompt de comandos com privilégios
elevados, clicando com o botão direito em Prompt de Comando e selecionando
Executar como administrador.

Sintaxe

wbadmin disable backup [-quiet]

Parâmetros

Parâmetro Descrição

-quiet Executa o comando sem prompts para o usuário.

Links relacionados
Chave da sintaxe de linha de comando

Comando wbadmin

Comando wbadmin enable backup


wbadmin enable backup
Artigo • 12/04/2023

Cria e habilita um agendamento de backup diário ou modifica um agendamento de


backup existente. Sem parâmetros especificados, ele exibe as configurações de backup
agendadas no momento.

Para configurar ou modificar um agendamento de backup diário usando esse comando,


você precisa ser membro do grupo Operadores de Backup ou do grupo
Administradores. Além disso, você deve executar wbadmin em um prompt de
comandos com privilégios elevados, clicando com o botão direito em Prompt de
Comando e selecionando Executar como administrador.

Para exibir o valor do identificador de disco para seus discos, execute o comando
wbadmin get disks.

Sintaxe

wbadmin enable backup [-addtarget:<BackupTarget>] [-removetarget:


<BackupTarget>] [-schedule:<TimeToRunBackup>] [-include:<VolumesToInclude>]
[-nonRecurseInclude:<ItemsToInclude>] [-exclude:<ItemsToExclude>] [-
nonRecurseExclude:<ItemsToExclude>][-systemState] [-hyperv:
<HyperVComponentsToExclude>] [-allCritical] [-systemState] [-vssFull | -
vssCopy] [-user:<UserName>] [-password:<Password>] [-allowDeleteOldBackups]
[-quiet]

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

-addtarget Especifica o local de armazenamento para backups. Exige que você


especifique o local como um caminho de disco, volume ou UNC
(Universal Naming Convention) para uma pasta compartilhada remota
( \\<servername>\<sharename> ). Por padrão, o backup será salvo em: \\
<servername>\<sharename> WindowsImageBackup <ComputerBackedUp> . Se
você especificar um disco, o disco será formatado antes do uso e todos
os dados existentes nele serão apagados permanentemente. Se você
especificar uma pasta compartilhada, não poderá adicionar mais locais.
Você só pode especificar uma pasta compartilhada como um local de
armazenamento por vez.

Importante: se você salvar um backup em uma pasta compartilhada


remota, ele será substituído se você usar a mesma pasta para fazer
backup do mesmo computador novamente. Além disso, se a operação
de backup falhar, você poderá acabar sem backup porque o backup
mais antigo será substituído, mas o backup mais recente não será
utilizável. Você pode evitar isso criando subpastas na pasta
compartilhada remota para organizar seus backups. Se você fizer isso,
as subpastas precisarão do dobro do espaço da pasta pai.

Somente um local pode ser especificado em um comando. Vários locais


de armazenamento de backup de volume e disco podem ser
adicionados executando o comando novamente.

-removetarget Especifica o local de armazenamento que você deseja remover do


agendamento de backup existente. Exige que você especifique o local
como um identificador de disco.

-schedule Especifica as horas do dia para criar um backup, formatadas como


HH:MM e delimitadas por vírgulas.

-include Especifica a lista delimitada por vírgulas de itens a serem incluídos no


backup. Você pode incluir vários arquivos, pastas ou volumes. Os
caminhos de volume podem ser especificados usando letras de drive de
volume, pontos de montagem de volume ou nomes de volume com
base em GUID. Se você usa um nome de volume baseado em GUID, ele
deve terminar com uma barra invertida ( \ ). Você pode usar o caractere
curinga ( * ) no nome do arquivo ao especificar um caminho para o
arquivo.
Parâmetro Descrição

-nonRecurseInclude Especifica a lista de itens não recursivos e delimitados por vírgulas a


serem incluídos no backup. Você pode incluir vários arquivos, pastas ou
volumes. Os caminhos de volume podem ser especificados usando
letras de drive de volume, pontos de montagem de volume ou nomes
de volume com base em GUID. Se você usa um nome de volume
baseado em GUID, ele deve terminar com uma barra invertida ( \ ). Você
pode usar o caractere curinga ( * ) no nome do arquivo ao especificar
um caminho para o arquivo. Deve ser usado apenas quando o
parâmetro -backupTarget é usado.

-exclude Especifica a lista delimitada por vírgulas de itens a serem excluídos do


backup. Você pode excluir arquivos, pastas ou volumes. Os caminhos de
volume podem ser especificados usando letras de drive de volume,
pontos de montagem de volume ou nomes de volume com base em
GUID. Se você usa um nome de volume baseado em GUID, ele deve
terminar com uma barra invertida ( \ ). Você pode usar o caractere
curinga ( * ) no nome do arquivo ao especificar um caminho para o
arquivo.

-nonRecurseExclude Especifica a lista não recursiva e delimitada por vírgulas de itens a


serem excluídos do backup. Você pode excluir arquivos, pastas ou
volumes. Os caminhos de volume podem ser especificados usando
letras de drive de volume, pontos de montagem de volume ou nomes
de volume com base em GUID. Se você usa um nome de volume
baseado em GUID, ele deve terminar com uma barra invertida ( \ ). Você
pode usar o caractere curinga ( * ) no nome do arquivo ao especificar
um caminho para o arquivo.

-hyperv Especifica a lista delimitada por vírgulas de componentes a serem


incluídos no backup. O identificador pode ser um nome de
componente ou GUID de componente (com ou sem chaves).

-systemState Cria um backup que inclui o estado do sistema, além de outros itens
especificados com o parâmetro -include. O estado do sistema contém
arquivos de inicialização (Boot.ini, NDTLDR, NTDetect.com), o Registro
do Windows, incluindo configurações COM, o SYSVOL (Políticas de
Grupo e Scripts de Logon), o Active Directory e o NTDS.DIT em
controladores de domínio e, se o serviço de certificados estiver
instalado, o Repositório de Certificados. Se o servidor tiver a função de
servidor Web instalada, o Metadiretório do IIS será incluído. Se o
servidor fizer parte de um cluster, as informações do serviço de cluster
também serão incluídas.
Parâmetro Descrição

-allCritical Especifica que todos os volumes críticos (volumes que contêm o estado
do sistema operacional) sejam incluídos nos backups. Esse parâmetro
será útil se você estiver criando um backup para recuperação completa
do sistema ou do estado do sistema. Ele deve ser usado somente
quando -backupTarget for especificado; caso contrário, o comando
falhará. Pode ser usado com a opção -include.

Dica: O volume de destino para um backup de volume crítico pode ser


uma unidade local, mas não pode ser nenhum dos volumes incluídos
no backup.

-vssFull Executa um backup completo usando o VSS (Serviço de Cópias de


Sombra de Volume). Todos os arquivos são copiados em backup, o
histórico de cada arquivo é atualizado para refletir que foi feito backup
e os logs de backups anteriores podem ficar truncados. Se esse
parâmetro não for usado, o comando wbadmin start backup fará um
backup de cópia, mas o histórico de backup dos arquivos que estão
sendo copiados não será atualizado.

Cuidado: Não use esse parâmetro se você estiver usando um produto


diferente do Backup do Windows Server para fazer backup de
aplicativos que estão nos volumes incluídos no backup atual. Isso pode
potencialmente interromper os backups incrementais, diferenciais ou
outros tipos que o outro produto de backup está criando porque o
histórico em que eles estão confiando para determinar de quantos
dados fazer backup pode estar ausente e eles podem executar um
backup completo desnecessariamente.

-vssCopy Executa um backup de cópia usando o VSS. É feito o backup de todos


os arquivos, mas o histórico dos arquivos dos quais estão sendo feito o
backup não é atualizado. Portanto, você preserva todas as informações
sobre quais arquivos foram alterados, excluídos e assim por diante, bem
como todos os arquivos de log do aplicativo. O uso desse tipo de
backup não afeta a sequência de backups incrementais e diferenciais
que podem ocorrer independentemente desse backup de cópia. Esse é
o valor padrão.
Aviso: uma cópia de backup não pode ser usado para backups ou
restaurações incrementais ou diferenciais.

-user Especifica o usuário com permissão de gravação para o destino de


armazenamento de backup (se for uma pasta compartilhada remota). O
usuário precisa ser membro do grupo Administradores ou Operadores
de Backup no computador que está sendo submetido a backup.

-password Especifica a senha para o nome de usuário fornecido pelo parâmetro -


user.
Parâmetro Descrição

- Substitui todos os backups feitos antes da atualização do computador.


allowDeleteOldBackups

-quiet Executa o comando sem prompts para o usuário.

Exemplos
Para agendar backups diários às 9h e 18h para unidades de disco rígido E:,
D:\mountpoint e \\?\Volume{cc566d14-44a0-11d9-9d93-806e6f6e6963}\ , e para salvar os
arquivos no disco chamado DiskID, digite:

wbadmin enable backup -addtarget:DiskID -schedule:09:00,18:00 -


include:E:,D:\mountpoint,\\?\Volume{cc566d14-44a0-11d9-9d93-806e6f6e6963}\

Para agendar backups diários da pasta D:\documents às 00:00 às 19h para o local de
rede \\backupshare\backup1 , usando as credenciais de rede para o Operador de Backup
Aaren Ekelund (aekel), cuja senha é $3hM9^5lp e que é membro do domínio
CONTOSOEAST, usado para autenticar o acesso ao compartilhamento de rede, digite:

wbadmin enable backup –addtarget:\\backupshare\backup1 –include:


D:\documents –user:CONTOSOEAST\aekel –password:$3hM9^5lp –
schedule:00:00,19:00

Para agendar backups diários do volume T: e da pasta D:\documents à 1h do drive H:,


excluindo a pasta d:\documents\~tmp e executando um backup completo usando o
Serviço de Cópias de Sombra de Volume, digite:

wbadmin enable backup –addtarget:H: –include T:,D:\documents –exclude


D:\documents\~tmp –vssfull –schedule:01:00

Links relacionados
Chave da sintaxe de linha de comando
Comando wbadmin

Comando wbadmin enable backup

Comando wbadmin start backup

Comando wbadmin get disks


wbadmin get disks
Artigo • 12/04/2023

Lista os discos internos e externos que estão online no momento para o computador
local.

Para listar os discos online usando esse comando, você deve ser membro do grupo
Operadores de Backup ou do grupo Administradores ou deve ter as permissões
apropriadas. Além disso, você deve executar wbadmin em um prompt de comandos
com privilégios elevados, clicando com o botão direito em Prompt de Comando e
selecionando Executar como administrador.

Syntax

wbadmin get disks

Links relacionados
Chave da sintaxe de linha de comando

comando wbadmin

Get-WBDisk
wbadmin get items
Artigo • 12/04/2023

Lista os itens incluídos em um backup específico.

Para listar os itens incluídos em um backup específico usando esse comando, você deve
ser membro do grupo Operadores de Backup ou do grupo Administradores ou deve
ter as permissões apropriadas. Além disso, você deve executar wbadmin em um prompt
de comandos com privilégios elevados, clicando com o botão direito em Prompt de
Comando e selecionando Executar como administrador.

Sintaxe

wbadmin get items -version:<VersionIdentifier> [-backupTarget:


{<BackupDestinationVolume> | <NetworkSharePath>}] [-machine:
<BackupMachineName>]

Parâmetros

Parâmetro Descrição

-version Especifica a versão do backup no formato MM/DD/YYYY-HH:MM. Se você não


souber as informações de versão, execute o comando wbadmin get versions.

- Especifica o local de armazenamento que contém os backups para os quais você


backupTarget deseja obter os detalhes. Use para listar backups armazenados nesse local de
destino. Os locais de destino de backup podem ser uma unidade de disco
anexada localmente ou uma pasta compartilhada remota. Se esse comando for
executado no mesmo computador em que o backup foi criado, esse parâmetro
não será necessário. No entanto, esse parâmetro é necessário para obter
informações sobre um backup criado de outro computador.

-machine Especifica o nome do computador para o qual você deseja obter os detalhes do
backup. Útil quando vários computadores foram submetidos a backup no mesmo
local. Deve ser usado quando -backupTarget for especificado.

Exemplos
Para listar os itens do backup que foi executado em 31 de março de 2013 às 9h, digite:
wbadmin get items -version:03/31/2013-09:00

Para listar os itens do backup do server01 executado em 30 de abril de 2013 às 9h e


armazenados em \\<servername>\<share> , digite:

wbadmin get items -version:04/30/2013-09:00 -backupTarget:\\servername\share


-machine:server01

Links relacionados
Chave da sintaxe de linha de comando

comando wbadmin

comando wbadmin get versions

Get-WBBackupSet
wbadmin get status
Artigo • 11/04/2023

Relata o status da operação de backup ou recuperação em execução no momento.

Para obter o status da operação de backup ou recuperação em execução no momento


usando esse comando, você deve ser membro do grupo Operadores de Backup ou do
grupo Administradores, ou ter sido delegado com as permissões apropriadas. Além
disso, você deve executar wbadmin em um prompt de comandos com privilégios
elevados, clicando com o botão direito em Prompt de Comando e selecionando
Executar como administrador.

) Importante

Esse comando não é interrompido até que a operação de backup ou recuperação


seja concluída. O comando continua a ser executado mesmo quando você fecha a
janela de comando. Para interromper a operação de backup ou recuperação atual,
execute o comando wbadmin stop job.

Syntax

wbadmin get status

Links relacionados
Chave da sintaxe de linha de comando

comando wbadmin

comando wbadmin stop job

Get-WBJob
wbadmin get versions
Artigo • 17/04/2023

Lista detalhes sobre os backups disponíveis armazenados no computador local ou em


outro computador. Os detalhes fornecidos de um backup incluem o tempo de backup, o
local de armazenamento de backup, o identificador de versão e o tipo de recuperação
que você pode executar.

Para obter detalhes sobre backups disponíveis usando esse comando, você deve ser
membro do grupo Operadores de Backup, do grupo Administradores ou ter sido
delegado as permissões apropriadas. Além disso, você deve executar wbadmin em uma
solicitação de comandos com privilégios elevados, clicando com o botão direito em
Solicitação de Comando e selecionando Executar como administrador.

Se esse comando for usado sem parâmetros, ele listará todos os backups do
computador local, mesmo que esses backups não estejam disponíveis.

Sintaxe

wbadmin get versions [-backupTarget:{<BackupTargetLocation> |


<NetworkSharePath>}] [-machine:BackupMachineName]

Parâmetros

Parâmetro Descrição

- Especifica o local de armazenamento que contém os backups sobre os quais você


backupTarget deseja obter os detalhes. Use para listar backups armazenados nesse local de
destino. Os locais de destino de backup podem ser unidades de disco, volumes,
pastas compartilhadas remotas, mídia removível, como unidades de DVD, ou
outra mídia óptica. Se esse comando for executado no mesmo computador em
que o backup foi criado, esse parâmetro não será necessário. No entanto, esse
parâmetro é necessário para obter informações sobre um backup criado de outro
computador.

-machine Especifica o computador sobre o qual você deseja obter detalhes de backup. Use
quando backups de vários computadores forem armazenados no mesmo local.
Deve ser usado quando -backupTarget for especificado.
Exemplos
Para ver uma lista de backups disponíveis armazenados no volume H:, digite:

wbadmin get versions -backupTarget:H:

Para ver uma lista de backups disponíveis armazenados na pasta compartilhar remota
\\<servername>\<share> para o computador server01, digite:

wbadmin get versions -backupTarget:\\servername\share -machine:server01

Links relacionados
Chave da sintaxe de linha de comando

Comando wbadmin

comando wbadmin get items

Get-WBBackupTarget
wbadmin restore catalog
Artigo • 17/04/2023

Recupera um catálogo de backup para o computador local de um local de


armazenamento especificado.

Para recuperar um catálogo de backup incluído em um backup específico usando esse


comando, você deve ser membro do grupo Operadores de Backup ou do grupo
Administradores ou deve ter as permissões apropriadas. Além disso, você deve executar
wbadmin em uma solicitação de comandos com privilégios elevados, clicando com o
botão direito em Solicitação de Comando e selecionando Executar como
administrador.

7 Observação

Se o local (disco, DVD ou pasta compartilhada remota) em que você armazena seus
backups estiver danificado ou perdido e não puder ser usado para restaurar o
catálogo de backup, execute o comando wbadmin delete catalog para excluir o
catálogo corrompido. Nesse caso, recomendamos criar um novo backup depois
que o catálogo de backup for excluído.

Sintaxe

wbadmin restore catalog -backupTarget:{<BackupDestinationVolume> |


<NetworkShareHostingBackup>} [-machine:<BackupMachineName>] [-quiet]

Parâmetros

Parâmetro Descrição

- Especifica o local do catálogo de backup do sistema como estava no ponto após


backupTarget a criação do backup.

-machine Especifica o nome do computador para o qual você deseja recuperar o catálogo
de backup. Use quando os backups de vários computadores tiverem sido
armazenados no mesmo local. Deve ser usado quando -backupTarget for
especificado.

-quiet Executa o comando sem solicitações para o usuário.


Exemplos
Para restaurar um catálogo de um backup armazenado no disco D:, digite:

wbadmin restore catalog -backupTarget:D

Para restaurar um catálogo de um backup armazenado na pasta compartilhada \\


<servername>\<share> do server01, digite:

wbadmin restore catalog -backupTarget:\\servername\share -machine:server01

Links relacionados
Chave da sintaxe de linha de comando

Comando wbadmin

comando wbadmin delete catalog

Restore-WBCatalog
wbadmin start backup
Artigo • 12/04/2023

Cria um backup usando parâmetros especificados. Se nenhum parâmetro for


especificado e você tiver criado um backup diário agendado, esse comando criará o
backup usando as configurações do backup agendado. Se os parâmetros forem
especificados, ele criará um backup de cópia do VSS (Serviço de Cópias de Sombra de
Volume) e não atualizará o histórico dos arquivos cujo backup está sendo feito.

Para criar um backup único usando esse comando, você deve ser membro do grupo
Operadores de Backup, do grupo Administradores ou ter sido delegado as permissões
apropriadas. Além disso, você deve executar wbadmin em um prompt de comandos
com privilégios elevados, clicando com o botão direito em Prompt de Comando e
selecionando Executar como administrador.

Sintaxe
com

wbadmin start backup [-backupTarget:{<BackupTargetLocation> |


<TargetNetworkShare>}] [-include:<ItemsToInclude>] [-nonRecurseInclude:
<ItemsToInclude>] [-exclude:<ItemsToExclude>] [-nonRecurseExclude:
<ItemsToExclude>] [-allCritical] [-systemState] [-noVerify] [-user:
<UserName>] [-password:<Password>] [-noInheritAcl] [-vssFull | -vssCopy] [-
quiet]

Parâmetros

Parâmetro Descrição

-backupTarget Especifica o local de armazenamento para esse backup. Requer uma letra da
unidade do disco rígido (f:), um caminho baseado em GUID de volume no
formato de \\?\Volume{GUID} ou um caminho UNC (Convenção Universal
de Nomenclatura) para uma pasta compartilhada remota (\\<servername>\
<sharename>\) . Por padrão, o backup será salvo em: \\<servername>\
<sharename>\WindowsImageBackup\<ComputerBackedUp>\ .
Parâmetro Descrição

-include Especifica a lista delimitada por vírgulas de itens a serem incluídos no


backup. Você pode incluir vários arquivos, pastas ou volumes. Os caminhos
de volume podem ser especificados usando letras de drive de volume,
pontos de montagem de volume ou nomes de volume com base em GUID.
Se você usa um nome de volume baseado em GUID, ele deverá terminar
com uma barra invertida ( \ ). Você pode usar o caractere curinga ( * ) no
nome do arquivo ao especificar um caminho para o arquivo. O parâmetro -
include só deve ser usado em conjunto com o parâmetro -backupTarget.

-exclude Especifica a lista delimitada por vírgulas de itens a serem excluídos do


backup. Você pode excluir arquivos, pastas ou volumes. Os caminhos de
volume podem ser especificados usando letras de drive de volume, pontos
de montagem de volume ou nomes de volume com base em GUID. Se você
usa um nome de volume baseado em GUID, ele deverá terminar com uma
barra invertida ( \ ). Você pode usar o caractere curinga ( * ) no nome do
arquivo ao especificar um caminho para o arquivo. O parâmetro -exclude só
deve ser usado em conjunto com o parâmetro -backupTarget.

- Especifica a lista de itens não recursivos e delimitados por vírgulas a serem


nonRecurseInclude incluídos no backup. Você pode incluir vários arquivos, pastas ou volumes.
Os caminhos de volume podem ser especificados usando letras de drive de
volume, pontos de montagem de volume ou nomes de volume com base
em GUID. Se você usa um nome de volume baseado em GUID, ele deverá
terminar com uma barra invertida ( \ ). Você pode usar o caractere curinga
( * ) no nome do arquivo ao especificar um caminho para o arquivo. O
parâmetro -nonRecurseInclude só deve ser usado em conjunto com o
parâmetro -backupTarget.

- Especifica a lista não recursiva e delimitada por vírgulas de itens a serem


nonRecurseExclude excluídos do backup. Você pode excluir arquivos, pastas ou volumes. Os
caminhos de volume podem ser especificados usando letras de drive de
volume, pontos de montagem de volume ou nomes de volume com base
em GUID. Se você usa um nome de volume baseado em GUID, ele deverá
terminar com uma barra invertida ( \ ). Você pode usar o caractere curinga
( * ) no nome do arquivo ao especificar um caminho para o arquivo. O
parâmetro -nonRecurseExclude só deve ser usado em conjunto com o
parâmetro -backupTarget.

-allCritical Especifica que todos os volumes críticos (volumes que contêm o estado do
sistema operacional) sejam incluídos nos backups. Esse parâmetro será útil
se você estiver criando um backup para recuperação bare-metal. Ele deve
ser usado somente quando -backupTarget for especificado; caso contrário,
o comando falhará. Pode ser usado com a opção -include.

Dica: O volume de destino para um backup de volume crítico pode ser uma
unidade local, mas não pode ser nenhum dos volumes incluídos no backup.
Parâmetro Descrição

-systemState Cria um backup que inclui o estado do sistema, além de outros itens
especificados com o parâmetro -include. O estado do sistema contém
arquivos de inicialização (Boot.ini, NDTLDR, NTDetect.com), o Registro do
Windows, incluindo configurações COM, o SYSVOL (Políticas de Grupo e
Scripts de Logon), o Active Directory e o NTDS.DIT em Controladores de
Domínio e, se o serviço de certificados estiver instalado, o Repositório de
Certificados. Se o servidor tiver a função de servidor Web instalada, o
Metadiretório do IIS será incluído. Se o servidor fizer parte de um cluster, as
informações do Serviço de Cluster também serão incluídas.

-noVerify Especifica que os backups salvos em mídia removível (como um DVD) não
são verificados quanto a erros. Se você não usar esse parâmetro, os backups
salvos em mídia removível serão verificados quanto a erros.

-user Se o backup for salvo em uma pasta compartilhada remota, especificará o


nome de usuário com permissão de gravação na pasta.

-password Especifica a senha para o nome de usuário fornecido pelo parâmetro -user.

-noInheritAcl Aplica as permissões de ACL (lista de controle de acesso) que


correspondem às credenciais fornecidas pelos parâmetros -user e -
password para \\<servername>\<sharename>\WindowsImageBackup\
<ComputerBackedUp>\ (a pasta que contém o backup). Para acessar o backup
posteriormente, você deve usar essas credenciais, ser membro do grupo
Administradores ou do grupo Operadores de Backup no computador com a
pasta compartilhada. Se -noInheritAcl não for usado, as permissões de ACL
da pasta compartilhada remota serão aplicadas à pasta \
<ComputerBackedUp> por padrão para que qualquer pessoa com acesso à
pasta compartilhada remota possa acessar o backup.

-vssFull Executa um backup completo usando o VSS (Serviço de Cópias de Sombra


de Volume). Todos os arquivos são copiados em backup, o histórico de cada
arquivo é atualizado para refletir que foi feito backup e os logs de backups
anteriores podem ficar truncados. Se esse parâmetro não for usado, o
wbadmin start backup fará um backup de cópia, mas o histórico de backup
dos arquivos que estão sendo copiados não será atualizado.

Cuidado: Não use esse parâmetro se você estiver usando um produto


diferente do Backup do Windows Server para fazer backup de aplicativos
que estão nos volumes incluídos no backup atual. Isso pode potencialmente
interromper os backups incrementais, diferenciais ou outros tipos que o
outro produto de backup está criando porque o histórico em que eles estão
confiando para determinar de quantos dados fazer backup pode estar
ausente e eles podem executar um backup completo desnecessariamente.
Parâmetro Descrição

-vssCopy Executa um backup de cópia usando o VSS. É feito o backup de todos os


arquivos, mas o histórico dos arquivos dos quais estão sendo feito o backup
não é atualizado. Portanto, você preserva todas as informações sobre quais
arquivos foram alterados, excluídos e assim por diante, bem como todos os
arquivos de log do aplicativo. O uso desse tipo de backup não afeta a
sequência de backups incrementais e diferenciais que podem ocorrer
independentemente desse backup de cópia. Esse é o valor padrão.
Aviso: Um backup de cópia não pode ser usado para backups ou
restaurações incrementais ou diferenciais.

-quiet Executa o comando sem prompts para o usuário.

Comentários
Se você salvar o backup em uma pasta compartilhada remota e executar outro
backup no mesmo computador e na mesma pasta compartilhada remota,
substituirá o backup anterior.

Se a operação de backup falhar, você poderá acabar sem um backup porque o


backup mais antigo é substituído, mas o backup mais recente não é utilizável. Para
evitar isso, recomendamos criar subpastas na pasta compartilhada remota para
organizar seus backups. No entanto, devido a essa organização, você deve ter o
dobro do espaço disponível como a pasta pai.

Exemplos
Para criar um backup de volumes e:, d:\mountpoint e \\?\Volume{cc566d14-4410-11d9-
9d93-806e6f6e6963}\ para o volume f:, digite:

wbadmin start backup -backupTarget:f: -include:e:,d:\mountpoint,\\?


\Volume{cc566d14-44a0-11d9-9d93-806e6f6e6963}\

Para executar um backup único de f:\folder1 e h:\folder2 para o volume d:, para fazer
backup do estado do sistema e fazer um backup de cópia para que o backup diferencial
normalmente agendado não seja afetado, digite:

wbadmin start backup –backupTarget:d: -include:g\folder1,h:\folder2 –


systemstate -vsscopy
Para executar um backup único e não recursivo de d:\folder1 no local da rede
\\backupshare\backup1* e restringir o acesso aos membros do grupo Administradores

ou Operadores de Backup, digite:

wbadmin start backup –backupTarget: \\backupshare\backup1 -noinheritacl -


nonrecurseinclude:d:\folder1

Links relacionados
Chave da sintaxe de linha de comando

Comando wbadmin
wbadmin start recovery
Artigo • 17/04/2023

Executa uma operação de recuperação com base nos parâmetros especificados.

Para executar uma recuperação usando esse comando, você deve ser membro do grupo
Operadores de Backup ou do grupo Administradores ou deve ter as permissões
apropriadas. Além disso, você deve executar wbadmin em uma solicitação de comandos
com privilégios elevados, clicando com o botão direito em Solicitação de Comando e
selecionando Executar como administrador.

Sintaxe

wbadmin start recovery -version:<VersionIdentifier> -items:


{<VolumesToRecover> | <AppsToRecover> | <FilesOrFoldersToRecover>} -
itemtype:{Volume | App | File} [-backupTarget:{<VolumeHostingBackup> |
<NetworkShareHostingBackup>}] [-machine:<BackupMachineName>] [-
recoveryTarget:{<TargetVolumeForRecovery> | <TargetPathForRecovery>}] [-
recursive] [-overwrite:{Overwrite | CreateCopy | Skip}] [-notRestoreAcl] [-
skipBadClusterCheck] [-noRollForward] [-quiet]

Parâmetros

Parâmetro Descrição

-version Especifica o identificador de versão do backup a ser recuperado no


formato MM/DD/AAAA-HH:MM. Se você não souber o identificador de
versão, execute o comando wbadmin get versions.

-items Especifica uma lista delimitada por vírgulas de volumes, aplicativos,


arquivos ou pastas a serem recuperados. Você deve usar esse parâmetro
com o parâmetro -itemtype.
Parâmetro Descrição

-itemtype Especifica o tipo de itens a serem recuperados. Deve ser Volume,


Aplicativo ou Arquivo. Se -itemtype for Volume, você poderá especificar
apenas um único volume, fornecendo a letra da unidade de volume, o
ponto de montagem do volume ou o nome do volume baseado em GUID.
Se -itemtype for Aplicativo, você poderá especificar apenas um único
aplicativo ou usar o valor ADIFM para recuperar uma instalação do Active
Directory. Para ser recuperado, o aplicativo deve ter se registrado com o
Backup do Windows Server. Se -itemtype for Arquivo, você poderá
especificar arquivos ou pastas, mas eles devem fazer parte do mesmo
volume e devem estar na mesma pasta pai.

-backupTarget Especifica o local de armazenamento que contém o backup que você quer
recuperar. Esse parâmetro é útil quando o local é diferente de onde os
backups desse computador geralmente são armazenados.

-machine Especifica o nome do computador para o qual você deseja recuperar o


backup. Esse parâmetro deve ser usado quando o parâmetro -
backupTarget for especificado. O parâmetro -machine é útil quando
vários computadores foram submetidos a backup no mesmo local.

-recoveryTarget Especifica o local para o qual restaurar. Esse parâmetro será útil se esse
local for diferente do local que foi feito backup anteriormente. Ele
também pode ser usado para restaurações de volumes, arquivos ou
aplicativos. Se você estiver restaurando um volume, poderá especificar a
letra da unidade de volume do volume alternativo. Se você estiver
restaurando um arquivo ou aplicativo, poderá especificar um local de
recuperação alternativo.

-recursive Válido somente ao recuperar arquivos. Recupera os arquivos nas pastas e


todos os arquivos subordinados às pastas especificadas. Por padrão,
somente os arquivos que residem diretamente nas pastas especificadas
são recuperados.

-overwrite Válido somente ao recuperar arquivos. Especifica a ação a ser executada


quando um arquivo que está sendo recuperado já existe no mesmo local.
As opções válidas são:
Skip: faz com que o Backup do Windows Server ignore o arquivo
existente e continue com a recuperação do próximo arquivo.
CreateCopy - faz com que o Backup do Windows Server crie uma
cópia do arquivo existente para que o arquivo existente não seja
modificado.
Overwrite - faz com que o Backup do Windows Server substitua o
arquivo existente pelo arquivo do backup.
Parâmetro Descrição

-notRestoreAcl Válido somente ao recuperar arquivos. Especifica a não restauração das


ACLs (listas de controle de acesso) de segurança dos arquivos que estão
sendo recuperados do backup. Por padrão, as ACLs de segurança são
restauradas (o valor padrão é true). Se esse parâmetro for usado, as ACLs
dos arquivos restaurados serão herdadas do local para o qual os arquivos
estão sendo restaurados.

- Válido somente ao recuperar volumes. Ignora a verificação dos discos que


skipBadClusterCheck você está recuperando quanto a informações de cluster incorretas. Se
você estiver recuperando em um servidor ou hardware alternativo,
recomendamos que não use esse parâmetro. Você pode executar
manualmente o comando chkdsk /b nesses discos a qualquer momento,
para verificar se há clusters inválidos e atualizar as informações do sistema
de arquivos adequadamente.

Importante: até que você execute o chkdsk /b, os clusters incorretos


relatados no seu sistema recuperado podem não ser precisos.

-noRollForward Válido somente ao recuperar aplicativos. Permite a recuperação pontual


anterior de um aplicativo se você selecionar a versão mais recente dos
backups. A recuperação pontual anterior é feita como padrão para todas
as outras versões que não foram as últimas do aplicativo.

-quiet Executa o comando sem solicitações para o usuário.

Comentários
Para exibir uma lista de itens disponíveis para recuperação de uma versão de
backup específica, execute o comando wbadmin get items. Se um volume não tiver
um ponto de montagem ou uma letra de unidade no momento do backup, esse
comando retornará um nome de volume baseado em GUID que deve ser usado
para recuperar o volume.

Se você usar um valor de ADIFM para executar uma instalação da operação de


mídia para recuperar os dados relacionados necessários para o Active Directory
Domain Services, a ADIFM criará uma cópia do banco de dados do Active
Directory, do registro e do estado SYSVOL e salvará essas informações no local
especificado por -recoveryTarget. Use esse parâmetro somente quando -
recoveryTarget for especificado.

Exemplos
Para executar uma recuperação do backup a partir de 31 de março de 2020, realizada às
9h, do volume d:, digite:

wbadmin start recovery -version:03/31/2020-09:00 -itemType:Volume -items:d:

Para executar uma recuperação na unidade D do backup do Registro de 31 de março de


2020, realizado às 9h, digite:

wbadmin start recovery -version:03/31/2020-09:00 -itemType:App -


items:Registry -recoverytarget:d:\

Para executar uma recuperação do backup de 31 de março de 2020, realizado às 9h, da


pasta d:\ e pastas subordinadas para a pasta d:\, digite:

wbadmin start recovery -version:03/31/2020-09:00 -itemType:File -


items:d:\folder -recursive

Para executar uma recuperação do backup de 31 de março de 2020, realizado às 9h, do


volume \\?\Volume{cc566d14-44a0-11d9-9d93-806e6f6e6963}\ , digite:

wbadmin start recovery -version:03/31/2020-09:00 -itemType:Volume -items:\\?


\Volume{cc566d14-44a0-11d9-9d93-806e6f6e6963}\

Para executar uma recuperação do backup de 31 de abril de 2020, realizado às 9h, da


pasta compartilhada \\servername\share do servidor01, digite:

wbadmin start recovery -version:04/30/2020-09:00 -


backupTarget:\\servername\share -machine:server01

Links relacionados
Chave da sintaxe de linha de comando
Comando wbadmin

Start-WBFileRecovery

Start-WBHyperVRecovery

Start-WBSystemStateRecovery

Start-WBVolumeRecovery
wbadmin start sysrecovery
Artigo • 12/04/2023

Executa uma recuperação do sistema (recuperação bare-metal) usando os parâmetros


especificados.

Para realizar uma recuperação do sistema usando esse comando, você deve ser membro
do grupo Operadores de Backup ou do grupo Administradores ou deve ter as
permissões apropriadas.

) Importante

O comando wbadmin start sysrecovery deve ser executado no Console de


Recuperação do Windows e não está listado no texto de uso padrão da ferramenta
wbadmin. Para obter mais informações, confira WinRE (Ambiente de Recuperação
do Windows).

Sintaxe

wbadmin start sysrecovery -version:<VersionIdentifier> -backupTarget:


{<BackupDestinationVolume> | <NetworkShareHostingBackup>} [-machine:
<BackupMachineName>] [-restoreAllVolumes] [-recreateDisks] [-excludeDisks]
[-skipBadClusterCheck] [-quiet]

Parâmetros

Parâmetro Descrição

-version Especifica o identificador de versão do backup a ser recuperado no


formato MM/DD/AAAA-HH:MM. Se você não souber o identificador de
versão, execute o comando wbadmin get versions.

-backupTarget Especifica o local de armazenamento que contém os backups que você


deseja recuperar. Esse parâmetro é útil quando o local de armazenamento
é diferente de onde os backups desse computador geralmente são
armazenados.
Parâmetro Descrição

-machine Especifica o nome do computador para o qual você deseja recuperar o


backup. Esse parâmetro deve ser usado quando o parâmetro -
backupTarget for especificado. O parâmetro -machine é útil quando
vários computadores foram submetidos a backup no mesmo local.

-restoreAllVolumes Recupera todos os volumes do backup selecionado. Se esse parâmetro


não for especificado, somente volumes críticos (volumes que contêm o
estado do sistema e componentes do sistema operacional) serão
recuperados. Esse parâmetro é útil quando você precisa recuperar
volumes não críticos durante a recuperação do sistema.

-recreateDisks Recupera uma configuração de disco para o estado existente quando o


backup foi criado.
Aviso: esse parâmetro exclui todos os dados nos volumes que hospedam
componentes do sistema operacional. Também pode excluir dados dos
volumes de dados.

-excludeDisks Válido somente quando especificado com o parâmetro -recreateDisks e


deve ser inserido como uma lista de identificadores de disco delimitada
por vírgulas (conforme listado na saída do comando wbadmin get disks).
Os discos excluídos não são particionados ou formatados. Esse parâmetro
ajuda a preservar os dados nos discos que você não deseja modificar
durante a operação de recuperação.

- Válido somente ao recuperar volumes. Ignora a verificação dos discos que


skipBadClusterCheck você está recuperando quanto a informações de cluster incorretas. Se
você estiver recuperando em um servidor ou hardware alternativo,
recomendamos que não use esse parâmetro. Você pode executar
manualmente o comando chkdsk /b nesses discos a qualquer momento,
para verificar se há clusters inválidos e atualizar as informações do sistema
de arquivos adequadamente.

Importante: até que você execute o chkdsk /b, os clusters incorretos


relatados no seu sistema recuperado podem não ser precisos.

-quiet Executa o comando sem prompts para o usuário.

Exemplos
Para começar a recuperar as informações do backup que foi executado em 31 de março
de 2020 às 9h, localizado na unidade d:, digite:

wbadmin start sysrecovery -version:03/31/2020-09:00 -backupTarget:d:


Para começar a recuperar as informações do backup que foi executado em 30 de abril
de 2020 às 9h, localizado na pasta compartilhada \\servername\share do server01,
digite:

wbadmin start sysrecovery -version:04/30/2020-09:00 -


backupTarget:\\servername\share -machine:server01

Links relacionados
Chave da sintaxe de linha de comando

comando wbadmin

Get-WBBareMetalRecovery
wbadmin start systemstatebackup
Artigo • 12/04/2023

Cria um backup de estado do sistema do computador local e o armazena no local


especificado.

Para realizar um backup de estado do sistema usando esse comando, você deve ser
membro do grupo Operadores de Backup ou do grupo Administradores ou deve ter as
permissões apropriadas. Além disso, você deve executar wbadmin em um prompt de
comandos com privilégios elevados, clicando com o botão direito em Prompt de
Comando e selecionando Executar como administrador.

7 Observação

O Backup do Windows Server não faz backup nem recupera hives de usuário do
registro (HKEY_CURRENT_USER) como parte do backup de estado do sistema ou da
recuperação de estado do sistema.

Sintaxe

wbadmin start systemstatebackup -backupTarget:<VolumeName> [-quiet]

Parâmetros

Parâmetro Descrição

- Especifica o local em que você deseja armazenar o backup. O local de


backupTarget armazenamento exige uma letra da unidade ou um volume baseado em GUID do
formato: \\?\Volume{*GUID*} . Use o comando -
backuptarget:\\servername\sharedfolder\ para armazenar os backups de estado
do sistema.

-quiet Executa o comando sem prompts para o usuário.

Exemplos
Para criar um backup de estado do sistema e armazená-lo no volume f, digite:
wbadmin start systemstatebackup -backupTarget:f:

Links relacionados
Chave da sintaxe de linha de comando

comando wbadmin

Start-WBBackup
wbadmin start systemstaterecovery
Artigo • 12/04/2023

Executa uma recuperação de estado do sistema para um local e a partir de um backup


que você especifica.

Para realizar uma recuperação de estado do sistema usando esse comando, você deve
ser membro do grupo Operadores de Backup ou do grupo Administradores ou deve
ter as permissões apropriadas. Além disso, você deve executar wbadmin em um prompt
de comandos com privilégios elevados, clicando com o botão direito em Prompt de
Comando e selecionando Executar como administrador.

7 Observação

O Backup do Windows Server não faz backup nem recupera hives de usuário do
registro (HKEY_CURRENT_USER) como parte do backup de estado do sistema ou da
recuperação de estado do sistema.

Sintaxe

wbadmin start systemstaterecovery -version:<VersionIdentifier> -showsummary


[-backupTarget:{<BackupDestinationVolume> | <NetworkSharePath>}]
[-machine:<BackupMachineName>] [-recoveryTarget:<TargetPathForRecovery>] [-
authsysvol] [-autoReboot] [-quiet]

Parâmetros

Parâmetro Descrição

-version Especifica o identificador de versão do backup a ser recuperado no formato


MM/DD/AAAA-HH:MM. Se você não souber o identificador de versão, execute o
comando wbadmin get versions.

- Relata o resumo da última recuperação de estado do sistema (após a


showsummary reinicialização necessária para concluir a operação). Esse parâmetro não pode
ser acompanhado por nenhum outro parâmetro.
Parâmetro Descrição

-backupTarget Especifica o local de armazenamento com os backups que você deseja


recuperar. Esse parâmetro é útil quando o local de armazenamento é diferente
de onde os backups geralmente são armazenados.

-machine Especifica o nome do computador para o qual o backup deve ser recuperado.
Esse parâmetro deve ser usado quando o parâmetro -backupTarget for
especificado. O parâmetro -machine é útil quando vários computadores foram
submetidos a backup no mesmo local.

- Especifica para qual diretório se deve restaurar. Esse parâmetro será útil se o
recoveryTarget backup for restaurado para um local alternativo.

-authsysvol Executa uma restauração autoritativa do diretório compartilhado do sysvol


(Volume do Sistema).

-autoReboot Especifica a reinicialização do sistema no final da operação de recuperação de


estado do sistema. Esse parâmetro é válido apenas para uma recuperação para o
local original. Não recomendamos que você use esse parâmetro se precisar
executar etapas após a operação de recuperação.

-quiet Executa o comando sem prompts para o usuário.

Exemplos
Para iniciar uma recuperação de estado do sistema do backup de 31/03/2020 às 9h,
digite:

wbadmin start systemstaterecovery -version:03/31/2020-09:00

Para iniciar uma recuperação de estado do sistema do backup de 30/04/2020 às 9h, que
é armazenado no recurso \\servername\share compartilhado para server01, digite:

wbadmin start systemstaterecovery -version:04/30/2013-09:00 -


backupTarget:\\servername\share -machine:server01

Links relacionados
Chave da sintaxe de linha de comando
comando wbadmin

Start-WBSystemStateRecovery
wbadmin stop job
Artigo • 12/04/2023

Cancela a operação de backup ou recuperação em execução no momento.

) Importante

As operações canceladas não podem ser reiniciadas. Você deve executar uma
operação cancelada de backup ou recuperação novamente desde o início.

Para interromper uma operação de backup ou recuperação usando esse comando, você
deve ser membro do grupo Operadores de Backup ou do grupo Administradores, ou
ter sido delegado com as permissões apropriadas. Além disso, você deve executar
wbadmin em um prompt de comandos com privilégios elevados, clicando com o botão
direito em Prompt de Comando e selecionando Executar como administrador.

Sintaxe

wbadmin stop job [-quiet]

Parâmetros

Parâmetro Descrição

-quiet Executa o comando sem prompts para o usuário.

Links relacionados
Chave da sintaxe de linha de comando

comando wbadmin
wdsutil
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Wdsutil é um utilitário de linha de comando usado para gerenciar o servidor dos


Serviços de Implantação do Windows. Para executar esses comandos, clique em iniciar,
clique com o botão direito do mouse no Prompt de comando e clique em Executar
como administrador.

Comandos
Comando Descrição

Comando wdsutil Adiciona objetos ou prepara computadores.


add

Comando wdsutil Aprova computadores com aprovação de administrador pendente.


approve-
autoadddevices

Comando wdsutil Converte uma imagem de RIPrep (Preparação para Instalação remota)
convert- existente no formato de Imagem do Windows (.wim).
riprepimage

Comando wdsutil Copia uma imagem ou um grupo de drivers.


copy

Comando wdsutil Exclui computadores que estão no banco de dados de adição automática
delete- (que armazena informações sobre os computadores no servidor).
autoadddevices

Comando wdsutil Desabilita todos os Serviços de Implantação do Windows.


disable

Comando wdsutil Desconecta um cliente de um namespace ou de uma transmissão


disconnect-client multicast.

Comando wdsutil Habilita todos os Serviços de Implantação do Windows.


enable

Comando wdsutil Exporta uma imagem do repositório de imagens para um arquivo .wim.
export-image
Comando Descrição

Comando wdsutil Recupera as propriedades e os atributos sobre o objeto especificado.


get

Comando wdsutil Configura um servidor dos Serviços de Implantação do Windows para uso
initialize-server inicial.

Comando wdsutil Cria imagens de captura e descoberta, bem como transmissões multicast e
new namespaces.

Comando wdsutil Exibe o status de progresso enquanto um comando está sendo executado.
progress

Comando wdsutil Rejeita computadores com aprovação de administrador pendente.


reject-
autoadddevices

Comando wdsutil Remove objetos.


remove

Comando wdsutil Substitui uma imagem de inicialização ou instalação por uma nova versão
replace-image dessa imagem.

Comando wdsutil Define propriedades e atributos no objeto especificado.


set

Comando wdsutil Inicia todos os serviços no servidor dos Serviços de Implantação do


start server Windows, incluindo transmissões multicast, namespaces e o Servidor de
Transporte.

Comando wdsutil Para todos os serviços no servidor dos Serviços de Implantação do


stop server Windows.

Comando wdsutil Reverte as alterações feitas durante a inicialização do servidor.


uninitialize-server

Comando wdsutil Atualiza arquivos de servidor no compartilhamento remoteInstall.


update-serverfiles

Comando wdsutil Exibe a saída detalhada do comando especificado.


verbose
Comandos wdsutil add
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Parâmetros
Parâmetro Descrição

comando wdsutil add- Pré-prepara um computador no Active Directory.


device

comando wdsutil add- Adiciona imagens de inicialização ou instalação.


image

comando wdsutil add- Adiciona um grupo de imagens.


imagegroup

comando wdsutil add- Adiciona um pacote de drivers a um grupo de drivers.


drivergrouppackage

comando wdsutil add- Adiciona pacotes de drivers a um grupo de drivers.


drivergrouppackages

comando wdsutil add- Adiciona um pacote de drivers ao servidor.


driverpackage

comando wdsutil add- Adiciona um pacote de drivers que está no repositório de drivers a
imagedriverpackage uma imagem de inicialização existente no servidor.

comando wdsutil add- Adiciona pacotes de drivers do repositório de drivers a uma imagem
imagedriverpackages de inicialização no servidor.

subcomando wdsutil Adiciona pacotes de drivers de uma pasta a um servidor.


add-alldriverpackages

comando wdsutil add- Adiciona um grupo de drivers a um servidor.


drivergroup

comando wdsutil add- Adiciona um filtro a um grupo de drivers em um servidor.


drivergroupfilter

Links relacionados
Chave da sintaxe de linha de comando
cmdlets dos Serviços de Implantação do Windows
wdsutil add-alldriverpackages
Artigo • 12/04/2023

Adiciona todos os pacotes de drivers armazenados em uma pasta para um servidor.

Sintaxe

wdsutil /Add-AllDriverPackages /FolderPath:<folderpath> [/Server:


<servername>] [/Architecture:{x86 | ia64 | x64}] [/DriverGroup:<groupname>]

Parâmetros

Parâmetro Descrição

/FolderPath: <folderpath> Especifica o caminho completo para a pasta que contém os


arquivos .inf para os pacotes de drivers.

[/Server: <servername> ] Especifica o nome do servidor. Pode ser o nome NetBIOS ou


FQDN. Se um nome do servidor não é especificado, o servidor
local é usado.

[/Architecture: {x86|ia64|x64} ] Especifica o tipo de arquitetura do pacote de drivers.

[/DriverGroup: <groupname> ] Especifica o nome do grupo de drivers ao qual os pacotes


devem ser adicionados.

Exemplos
Para adicionar pacotes de drivers, digite:

wdsutil /verbose /Add-AllDriverPackages /FolderPath:C:\Temp\Drivers


/Architecture:x86

wdsutil /Add-AllDriverPackages /FolderPath:C:\Temp\Drivers\Printers


/DriverGroup:Printer Drivers
Links relacionados
Chave da sintaxe de linha de comando

cmdlets dos Serviços de Implantação do Windows

Add-WdsDriverPackage
wdsutil add device
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Prepara previamente um computador no AD DS (Active Directory Domain Services).


Computadores preparados previamente também são chamados de computadores
conhecidos. Isso permite que você configure propriedades para controlar a instalação do
cliente. Por exemplo, é possível configurar um programa de inicialização de rede e o
arquivo autônomo que o cliente deve receber, além do servidor do qual o cliente deve
baixar o programa de inicialização da rede.

Sintaxe

wdsutil /add-Device /Device:<Devicename> /ID:<UUID | MAC address>


[/ReferralServer:<Servername>] [/BootProgram:<Relativepath>]
[/WdsClientUnattend:<Relativepath>] [/User:<Domain\User | User@Domain>]
[/JoinRights:{JoinOnly | Full}] [/JoinDomain:{Yes | No}] [/BootImagepath:
<Relativepath>] [/OU:<DN of OU>] [/Domain:<Domain>]

Parâmetros

Parâmetro Descrição

/Device: <Devicename> Especifica o nome do dispositivo a ser adicionado.

/ID: <UUID|MAC address> Especifica o GUID/UUID ou o endereço MAC do


computador. Um GUID/UUID deve estar em um dos dois
formatos: cadeia de caracteres binária
( /ID:ACEFA3E81F20694E953EB2DAA1E8B1B6 ) ou cadeia de
caracteres GUID ( /ID:E8A3EFAC-201F-4E69-953E-
B2DAA1E8B1B6 ). Um endereço MAC deve estar no seguinte
formato: 00B056882FDC (sem traços) ou 00-B0-56-88-
2F-DC (com traços)

[/ReferralServer: <Servername> ] Especifica o nome do servidor a ser contatado para


baixar o programa de inicialização de rede e a imagem
de inicialização usando o tftp.
Parâmetro Descrição

[/BootProgram: <Relativepath> ] Especifica o caminho relativo da pasta remoteInstall para


o programa de inicialização de rede que este
computador deve receber. Por exemplo:
boot\x86\pxeboot.com

[/WdsClientUnattend: <Relativepath> ] Especifica o caminho relativo da pasta remoteInstall para


o arquivo de instalação autônoma que automatiza as
telas de instalação do cliente dos Serviços de
Implantação do Windows.

[/User: <Domain\User|User@Domain> ] Define permissões no objeto de conta do computador


para dar ao usuário especificado os direitos necessários
para ingressar o computador no domínio.

[/JoinRights: {JoinOnly|Full} ] Especifica o tipo de direitos a serem atribuídos ao


usuário.
JoinOnly – Exige que o administrador redefina a
conta do computador antes que o usuário possa
ingressar o computador no domínio.
Full – Dá acesso completo ao usuário, o que inclui
o direito de ingressar o computador no domínio.

[/JoinDomain: {Yes|No} ] Especifica se o computador deve ser ingressado no


domínio como esta conta de computador durante a
instalação do sistema operacional. O valor padrão é Sim.

[/BootImagepath: <Relativepath> ] Especifica o caminho relativo da pasta remoteInstall para


a imagem de inicialização e este computador deve usar.

[/OU: <DN of OU> ] O nome diferenciado da unidade organizacional em que


o objeto da conta de computador deve ser criado. Por
exemplo: OU=MyOU,CN=Test, DC=Domain,DC=com. O
local padrão é o contêiner do computador padrão.

[/Domain: <Domain> ] O domínio em que o objeto da conta de computador


deve ser criado. O local padrão é o domínio local.

Exemplos
Para adicionar um computador usando um endereço MAC, digite:

wdsutil /add-Device /Device:computer1 /ID:00-B0-56-88-2F-DC


Para adicionar um computador usando uma cadeia de caracteres GUID, digite:

wdsutil /add-Device /Device:computer1 /ID:{E8A3EFAC-201F-4E69-953F-


B2DAA1E8B1B6} /ReferralServer:WDSServer1
/BootProgram:boot\x86\pxeboot.com/WDSClientUnattend:WDSClientUnattend\unatte
nd.xml /User:Domain\MyUser/JoinRights:Full
/BootImagepath:boot\x86\images\boot.wim /OU:OU=MyOU,CN=Test,DC=Domain,DC=com

Links relacionados
Chave da sintaxe de linha de comando

Comando wdsutil get-alldevices

comando wdsutil get-device

Comando wdsutil set-device

cmdlets dos Serviços de Implantação do Windows

New-WdsClient
wdsutil add-drivergroup
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Adiciona um grupo de drivers ao servidor.

Sintaxe

wdsutil /add-DriverGroup /DriverGroup:<Groupname>\n\ [/Server:<Servername>]


[/Enabled:{Yes | No}] [/Applicability:{Matched | All}] [/Filtertype:
<Filtertype> /Policy:{Include | Exclude} /Value:<Value> [/Value:<Value>
...]]

Parâmetros

Parâmetro Descrição

/DriverGroup: <Groupname> Especifica o nome do novo grupo de drivers.

/Server: <Servername> Especifica o nome do servidor. Pode ser o nome NetBIOS ou


FQDN. Se nenhum nome do servidor for especificado, o servidor
local será usado.

/Enabled: {Yes|No} Habilita ou desabilita o pacote.

/Applicability: {Matched|All} Especifica quais pacotes devem ser instalados, se os critérios de


filtro forem atendidos. Matched significa instalar apenas os
pacotes de drivers que correspondem ao hardware de um cliente.
All significa instalar todos os pacotes para clientes,
independentemente do hardware.
Parâmetro Descrição

/Filtertype: <Filtertype> Especifica o tipo do filtro a ser adicionado ao grupo. Você pode
especificar vários tipos de filtro em um único comando. Cada tipo
de filtro deve ser seguido de /Policy e pelo menos um /Value. Os
valores válidos incluem:

BiosVendor
Biosversion
Chassistype
Fabricante
Uuid
Osversion
Osedition
OsLanguage

Para obter informações sobre como obter os valores de todos os


outros tipos de filtro, confira Filtros do Grupo de Drivers.

[/Policy: {Include|Exclude} ] Especifica a política a ser definida no filtro. Se /Policy estiver


definido como Include, os computadores cliente que
correspondem ao filtro poderão instalar os drivers nesse grupo. Se
/Policy estiver definido como Exclude, os computadores cliente
que correspondem ao filtro não poderão instalar os drivers nesse
grupo.

[/Value: <Value> ] Especifica o valor do cliente que corresponde a /Filtertype. Você


pode especificar vários valores para um único tipo. Para obter
informações sobre os valores de tipo de filtro aceitáveis, confira
Filtros do Grupo de Drivers.

Exemplos
Para adicionar um grupo de drivers, digite:

wdsutil /add-DriverGroup /DriverGroup:printerdrivers /Enabled:Yes

wdsutil /add-DriverGroup /DriverGroup:printerdrivers /Applicability:All


/Filtertype:Manufacturer /Policy:Include /Value:Name1
/Filtertype:Chassistype /Policy:Exclude /Value:Tower /Value:MiniTower
Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil add-drivergrouppackage

comando wdsutil add-drivergrouppackages

comando wdsutil add-drivergroupfilter

cmdlets dos Serviços de Implantação do Windows


add-DriverGroupFilter
Artigo • 12/04/2023

Adiciona um filtro a um grupo de drivers em um servidor.

Sintaxe

wdsutil /Add-DriverGroupFilter /DriverGroup:<Group Name> [/Server:<Server


name>] /FilterType:<Filter Type> /Policy:{Include | Exclude} /Value:<Value>
[/Value:<Value> ...]

Parâmetros

Parâmetro Descrição

/DriverGroup: <Groupname> Especifica o nome do novo grupo de drivers.

/Server: <Servername> Especifica o nome do servidor. Pode ser o nome NetBIOS ou FQDN.
Se nenhum nome do servidor for especificado, o servidor local será
usado.

/Filtertype: <Filtertype> Especifica o tipo do filtro a ser adicionado ao grupo. Você pode
especificar vários tipos de filtro em um único comando. Cada tipo
de filtro deve ser seguido de /Policy e pelo menos um /Value. Os
valores válidos incluem:

BiosVendor
Biosversion
Chassistype
Fabricante
Uuid
Osversion
Osedition
OsLanguage

Para obter informações sobre como obter os valores de todos os


outros tipos de filtro, confira Filtros do Grupo de Drivers.

[/Policy: {Include|Exclude} ] Especifica a política a ser definida no filtro. Se /Policy estiver


definido como Include, os computadores cliente que correspondem
ao filtro poderão instalar os drivers nesse grupo. Se /Policy estiver
definido como Exclude, os computadores cliente que
correspondem ao filtro não poderão instalar os drivers nesse grupo.
Parâmetro Descrição

[/Value: <Value> ] Especifica o valor do cliente que corresponde a /Filtertype. Você


pode especificar vários valores para um único tipo. Para obter
informações sobre os valores de tipo de filtro aceitáveis, confira
Filtros do Grupo de Drivers.

Exemplos
Para adicionar um filtro a um grupo de drivers, digite:

wdsutil /Add-DriverGroupFilter /DriverGroup:PrinterDrivers


/FilterType:Manufacturer /Policy:Include /Value:Name1 /Value:Name2

wdsutil /Add-DriverGroupFilter /DriverGroup:PrinterDrivers


/FilterType:Manufacturer /Policy:Include /Value:Name1
/FilterType:ChassisType /Policy:Exclude /Value:Tower /Value:MiniTower

Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil add-drivergrouppackage

comando wdsutil add-drivergrouppackages

comando wdsutil add-drivergroup

cmdlets dos Serviços de Implantação do Windows


wdsutil add-drivergrouppackage
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Adiciona um pacote de drivers a um grupo de drivers.

Sintaxe

wdsutil /add-DriverGroupPackage /DriverGroup:<Group Name> [/Server:<Server


Name>] {/DriverPackage:<Name> | /PackageId:<ID>}

Parâmetros

Parâmetro Descrição

/DriverGroup: <Groupname> Especifica o nome do novo grupo de drivers.

/Server: <Servername> Especifica o nome do servidor. Pode ser o nome NetBIOS ou FQDN.
Se nenhum nome do servidor for especificado, o servidor local será
usado.

/DriverPackage: <Name> Especifica o nome do pacote de drivers a ser adicionado ao grupo.


Você deverá especificar essa opção se o pacote de driver não puder
ser identificado exclusivamente pelo nome.

/PackageId: <ID> Especifica a ID de um pacote. Para localizar a ID do Pacote, selecione


o grupo de drivers em que está o pacote (ou no nó Todos os Pacotes
), clique com o botão direito do mouse no pacote e selecione
Propriedades. A ID do Pacote está listada na guia Geral, por
exemplo: {DD098D20-1850-4fc8-8E35-EA24A1BEFF5E}.

Exemplos
Para adicionar um pacote do grupo de drivers, digite:
wdsutil /add-DriverGroupPackage /DriverGroup:printerdrivers /PackageId:
{4D36E972-E325-11CE-Bfc1-08002BE10318}

wdsutil /add-DriverGroupPackage /DriverGroup:printerdrivers


/DriverPackage:XYZ

Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil add-drivergroupfilter

comando wdsutil add-drivergrouppackages

comando wdsutil add-drivergroup

cmdlets dos Serviços de Implantação do Windows


wdsutil add-drivergrouppackages
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Adiciona os pacotes de grupo de drivers.

Sintaxe

wdsutil /add-DriverGroupPackages /DriverGroup:<Group Name> [/Server:<Server


Name>] /Filtertype:<Filter type> /Operator:{Equal | NotEqual |
GreaterOrEqual | LessOrEqual | Contains} /Value:<Value> [/Value:<Value>]

Parâmetros

Parâmetro Descrição

/DriverGroup: <Groupname> Especifica o nome do novo


grupo de drivers.

/Server: <Servername> Especifica o nome do


servidor. Pode ser o nome
NetBIOS ou FQDN. Se
nenhum nome do servidor
for especificado, o servidor
local será usado.
Parâmetro Descrição

/Filtertype: <Filtertype> Especifica o tipo do pacote


de drivers a ser procurado.
Você pode especificar vários
atributos em um único
comando. Você também
deve especificar /Operator e
/Value com essa opção. Os
valores válidos incluem:

PackageId
PackageName
PackageEnabled
Packagedateadded
PackageInfFilename
PackageClass
PackageProvider
PackageArchitecture
PackageLocale
PackageSigned
PackagedatePublished
Packageversion
Driverdescription
DriverManufacturer
DriverHardwareId
DrivercompatibleId
DriverExcludeId
DriverGroupId
DriverGroupName**

/Operator: {Equal|NotEqual|GreaterOrEqual|LessOrEqual|Contains} Especifica a relação entre o


atributo e os valores. Você só
pode especificar Contains
com os atributos de cadeia
de caracteres. Você só pode
especificar Equal, NotEqual,
GreaterOrEqual and
LessOrEqual com os
atributos de data e versão.

/Value: <Value> Especifica o valor do cliente


correspondente a
/Filtertype. Você pode
especificar vários valores
para um único /Filtertype.
Os valores disponíveis para
cada filtro são:
Parâmetro Descrição

PackageId –
Especifique um GUID
válido. Por exemplo:
{4d36e972-e325-11ce-
bfc1-08002be10318}
PackageName –
Especifique qualquer
valor de cadeia de
caracteres
PackageEnabled –
Especifique Sim ou
Não
Packagedateadded –
Especifique a data no
seguinte formato:
YYYY/MM/DD
PackageInfFilename –
Especifique qualquer
valor de cadeia de
caracteres
PackageClass –
Especifique um GUID
de classe ou nome de
classe válido. Por
exemplo: DiskDrive,
Net ou {4d36e972-
e325-11ce-bfc1-
08002be10318}
PackageProvider –
Especifique qualquer
valor de cadeia de
caracteres
PackageArchitecture –
Especifique x86, x64
ou ia64
PckageLocale –
Especifique um
identificador de
idioma válido. Por
exemplo: en-US ou es-
ES
PackageSigned –
Especifique Sim ou
Não
PackagedatePublished
– Especifique a data no
seguinte formato:
YYYY/MM/DD
Parâmetro Descrição

Packageversion –
Especifique a versão
no seguinte formato:
a.b.x.y. Por exemplo:
6.1.0.0
Driverdescription –
Especifique qualquer
valor de cadeia de
caracteres
DriverManufacturer –
Especifique qualquer
valor de cadeia de
caracteres
DriverHardwareId –
Especifique qualquer
valor de cadeia de
caracteres
DrivercompatibleId –
Especifique qualquer
valor de cadeia de
caracteres
DriverExcludeId –
Especifique qualquer
valor de cadeia de
caracteres
DriverGroupId –
Especifique um GUID
válido. Por exemplo:
{4d36e972-e325-11ce-
bfc1-08002be10318}
DriverGroupName –
Especifique qualquer
valor de cadeia de
caracteres

Para obter mais informações


sobre esses valores, confira
Atributos de driver e pacote.

Exemplos
Para adicionar um pacote do grupo de drivers, digite:
wdsutil /verbose /add-DriverGroupPackages /DriverGroup:printerdrivers
/Filtertype:PackageClass /Operator:Equal /Value:printer
/Filtertype:DriverManufacturer /Operator:NotEqual /Value:Name1 /Value:Name2

wdsutil /verbose /add-DriverGroupPackages /DriverGroup:DisplayDriversX86


/Filtertype:PackageClass /Operator:Equal /Value:Display
/Filtertype:PackageArchitecture /Operator:Equal /Value:x86
/Filtertype:Packagedateadded /Operator:LessOrEqual /Value:2008/01/01

Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil add-driverpackage

comando wdsutil add-drivergrouppackage

comando wdsutil add-alldriverpackages

cmdlets dos Serviços de Implantação do Windows


add-DriverPackage
Artigo • 12/04/2023

Adiciona um pacote de drivers ao servidor.

Sintaxe

wdsutil /Add-DriverPackage /InfFile:<Inf File path> [/Server:<Server name>]


[/Architecture:{x86 | ia64 | x64}] [/DriverGroup:<Group Name>] [/Name:
<Friendly Name>]

Parâmetros

Parâmetro Descrição

/InfFile: <InfFilepath> Especifica o caminho completo do arquivo .inf a ser adicionado.

[/Server: <Servername> ] Especifica o nome do servidor. Pode ser o nome NetBIOS ou FQDN.
Se um nome do servidor não é especificado, o servidor local é
usado.

[/Architecture: {x86 | ia64 Especifica o tipo de arquitetura do pacote de drivers.


| x64} ]

[/DriverGroup: <groupname> ] Especifica o nome do grupo de drivers ao qual os pacotes devem


ser adicionados.

[/Name: <friendlyname> ] Especifica o nome amigável para o pacote de drivers.

Exemplos
Para adicionar um pacote de drivers, digite:

wdsutil /verbose /Add-DriverPackage /InfFile:C:\Temp\Display.inf

wdsutil /Add-DriverPackage /Server:MyWDSServer /InfFile:C:\Temp\Display.inf


/Architecture:x86 /DriverGroup:x86Drivers /Name:Display Driver
Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil add-drivergrouppackage

comando wdsutil add-alldriverpackages

cmdlets dos Serviços de Implantação do Windows


wdsutil add-image
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Adicione imagens a um servidor dos Serviços de Implantação do Windows.

Syntax
Para imagens de inicialização, use a seguinte sintaxe:

wdsutil /Add-Image /ImageFile:<wim file path> [/Server:<Server name>


/ImageType:Boot [/SkipVerify] [/Name:<Image name>] [/Description:<Image
description>] [/Filename:<New wim file name>]

Para imagens de instalação, use a seguinte sintaxe:

wdsutil /Add-Image /ImageFile:<wim filepath> [/Server:<Servername>]


/ImageType:Install [/SkipVerify] /ImageGroup:<Image group name>]
[/SingleImage:<Single image name>] [/Name:<Name>] [/Description:
<Description>] [/Filename:<File name>] [/UnattendFile:<Unattend file path>]

Parâmetros

Parâmetro Descrição

/ImageFile: <.wim filepath> Especifica o caminho completo e o nome do arquivo da


Imagem do Windows (.wim) que contém as imagens a
serem adicionadas.

[/Server: <Servername> ] Especifica o nome do servidor. Pode ser o nome NetBIOS


ou o FQDN (nome de domínio totalmente qualificado). Se
um nome do servidor não for especificado, o servidor local
será usado.

[/ImageType: {Boot \| Install} ] Especifica o tipo de imagens a ser adicionado.


Parâmetro Descrição

[/SkipVerify] Especifica que a verificação de integridade não será


executada no arquivo de imagem de origem, antes que a
imagem seja adicionada.

[/Name: <Name> ] Define o nome de exibição da imagem.

[/Description: <Description> ] Define a descrição da imagem.

[/Filename: <Filename> ] Especifica o novo nome de arquivo para o arquivo .wim.


Isso permite que você altere o nome do arquivo .wim ao
adicionar a imagem. Se você não especificar um nome de
arquivo, o nome do arquivo de imagem de origem será
usado. Em todos os casos, os Serviços de Implantação do
Windows verificam se o nome do arquivo é exclusivo no
repositório de imagens de inicialização do computador de
destino.

/ImageGroup: <Imagegroupname> ] Especifica o nome do grupo de imagens ao qual as imagens


devem ser adicionadas. Se houver mais de um grupo de
imagens no servidor, o grupo de imagens deve ser
especificado. Se você não especificar o grupo de imagens e
um grupo de imagens ainda não existir, um novo grupo de
imagens será criado. Caso contrário, o grupo de imagens
existente será usado.

[/SingleImage: <Singleimagename> ] Copia a imagem única especificada de um arquivo .wim e


[/Name: <Name> ] [/Description: define o nome de exibição e a descrição da imagem.
<Description> ]

[/UnattendFile: <Unattendfilepath> ] Especifica o caminho completo para o arquivo de instalação


autônomo a ser associado às imagens que estão sendo
adicionadas. Se /SingleImage não for especificado, o
mesmo arquivo autônomo será associado a todas as
imagens no arquivo .wim.

Exemplos
Para adicionar uma imagem de inicialização, digite:

wdsutil /Add-Image /ImageFile:"C:\MyFolder\Boot.wim" /ImageType:Boot


wdsutil /Verbose /Progress /Add-Image /ImageFile:\\MyServer\Share\Boot.wim
/Server:MyWDSServer /ImageType:Boot /Name:"My WinPE Image"
/Description:"WinPE Image containing the WDS Client" /Filename:WDSBoot.wim
Para adicionar uma imagem de instalação, digite uma das seguintes opções:

wdsutil /Add-Image /ImageFile:"C:\MyFolder\Install.wim" /ImageType:Install


wdsutil /Verbose /Progress /Add-Image
/ImageFile:\\MyServer\Share\Install.wim /Server:MyWDSServer
/ImageType:Install /ImageGroup:ImageGroup1
/SingleImage:"Windows Pro" /Name:"My WDS Image" /Description:"Windows Pro
image with Microsoft Office" /Filename:"Win Pro.wim"
/UnattendFile:"\\server\share\unattend.xml"

Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil copy-image

comando wdsutil export-image

comando wdsutil get-image

comando wdsutil remove-image

comando wdsutil replace-image

comando wdsutil set-image

cmdlets dos Serviços de Implantação do Windows


wdsutil add imagedriverpackage
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Adiciona um pacote de drivers que está no repositório de drivers a uma imagem de


inicialização existente no servidor.

Sintaxe

wdsutil /add-ImageDriverPackage [/Server:<Servername>] [media:<Imagename>]


[mediatype:Boot] [/Architecture:{x86 | ia64 | x64}] [/Filename:<Filename>]
{/DriverPackage:<Package Name> | /PackageId:<ID>}

Parâmetros

Parâmetro Descrição

[/Server: <Servername> ] Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN
(nome de domínio totalmente qualificado). Se um nome do servidor
não for especificado, o servidor local será usado.

[media: <Imagename> ] Especifica o nome da imagem à qual o driver deve ser adicionado.

[mediatype:Boot] Especifica o tipo de imagem à qual o driver deve ser adicionado. Os


pacotes de drivers só podem ser adicionados às imagens de
inicialização.

[/Architecture: {x86 | Especifica a arquitetura da imagem de inicialização. Como é possível ter


ia64 | x64} ] o mesmo nome de imagem para as imagens de inicialização em
arquiteturas diferentes, você deve especificar a arquitetura para garantir
que a imagem correta seja usada.

[/Filename: <Filename> ] Especifica o nome do arquivo. Se a imagem não puder ser identificada
exclusivamente pelo nome, o nome do arquivo deverá ser especificado.

[/DriverPackage: <Name> Especifica o nome do pacote de drivers a ser adicionado à imagem.


Parâmetro Descrição

[/PackageId: <ID> ] Especifica a ID dos Serviços de Implantação do Windows do pacote de


driver. Você precisará especificar essa opção se o pacote de drivers não
puder ser identificado exclusivamente pelo nome. Para localizar a ID do
Pacote, selecione o grupo de drivers em que está o pacote (ou no nó
Todos os Pacotes ), clique com o botão direito do mouse no pacote e
selecione Propriedades. A ID do Pacote está listada na guia Geral, por
exemplo: {DD098D20-1850-4fc8-8E35-EA24A1BEFF5E}.

Exemplos
Para adicionar um pacote de drivers a uma imagem de inicialização, digite:

wdsutil /add-ImageDriverPackagmedia:WinPE Boot Imagemediatype:Boot


/Architecture:x86 /DriverPackage:XYZ

wdsutil /verbose /add-ImageDriverPackagmedia:WinPE Boot Image


/Server:MyWDSServemediatype:Boot /Architecture:x64 /PackageId:{4D36E972-
E325-11CE-Bfc1-08002BE10318}

Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil add-imagedriverpackages

cmdlets dos Serviços de Implantação do Windows


wdsutil add-imagedriverpackages
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Adiciona pacotes de drivers do repositório de drivers a uma imagem de inicialização.

Sintaxe

wdsutil /add-ImageDriverPackages [/Server:<Server name>media:<Image


namemediatype:Boot /Architecture:{x86 | ia64 | x64} [/Filename:<File name>]
/Filtertype:<Filter type> /Operator:{Equal | NotEqual | GreaterOrEqual |
LessOrEqual | Contains} /Value:<Value> [/Value:<Value> ...]

Parâmetros

Parâmetro Descrição

[/Server: <Servername> ] Especifica o nome do


servidor. Pode ser o nome
NetBIOS ou o FQDN (nome
de domínio totalmente
qualificado). Se um nome do
servidor não for
especificado, o servidor local
será usado.

[media: <Imagename> ] Especifica o nome da


imagem à qual o driver deve
ser adicionado.

[mediatype:Boot] Especifica o tipo de imagem


à qual o driver deve ser
adicionado. Os pacotes de
drivers só podem ser
adicionados às imagens de
inicialização.
Parâmetro Descrição

[/Architecture: {x86 | ia64 | x64} ] Especifica a arquitetura da


imagem de inicialização.
Como é possível ter o
mesmo nome de imagem
para as imagens de
inicialização em arquiteturas
diferentes, você deve
especificar a arquitetura para
garantir que a imagem
correta seja usada.

[/Filename: <Filename> ] Especifica o nome do


arquivo. Se a imagem não
puder ser identificada
exclusivamente pelo nome, o
nome do arquivo deverá ser
especificado.
Parâmetro Descrição

/Filtertype: <Filtertype> Especifica o atributo do


pacote de drivers a ser
procurado. Você pode
especificar vários atributos
em um único comando. Você
também deve especificar
/Operator e /Value com essa
opção. Os valores válidos
incluem:

PackageId
PackageName
PackageEnabled
Packagedateadded
PackageInfFilename
PackageClass
PackageProvider
PackageArchitecture
PackageLocale
PackageSigned
PackagedatePublished
Packageversion
Driverdescription
DriverManufacturer
DriverHardwareId
DrivercompatibleId
DriverExcludeId
DriverGroupId
DriverGroupName**

/Operator: {Equal|NotEqual|GreaterOrEqual|LessOrEqual|Contains} Especifica a relação entre o


atributo e os valores. Você só
pode especificar Contains
com os atributos de cadeia
de caracteres. Você só pode
especificar GreaterOrEqual e
LessOrEqual com os
atributos de data e versão.

/Value: <Value> Especifica o valor a ser


procurado em relação ao
<attribute> especificado.
Você pode especificar vários
valores para um único
/Filtertype. Os valores
Parâmetro Descrição

disponíveis para cada filtro


são:

PackageId –
Especifique um GUID
válido. Por exemplo:
{4d36e972-e325-11ce-
bfc1-08002be10318}
PackageName –
Especifique qualquer
valor de cadeia de
caracteres
PackageEnabled –
Especifique Sim ou
Não
Packagedateadded –
Especifique a data no
seguinte formato:
YYYY/MM/DD
PackageInfFilename –
Especifique qualquer
valor de cadeia de
caracteres
PackageClass –
Especifique um GUID
de classe ou nome de
classe válido. Por
exemplo: DiskDrive,
Net ou {4d36e972-
e325-11ce-bfc1-
08002be10318}
PackageProvider –
Especifique qualquer
valor de cadeia de
caracteres
PackageArchitecture –
Especifique x86, x64
ou ia64
PckageLocale –
Especifique um
identificador de
idioma válido. Por
exemplo: en-US ou es-
ES
PackageSigned –
Especifique Sim ou
Não
Parâmetro Descrição

PackagedatePublished
– Especifique a data no
seguinte formato:
YYYY/MM/DD
Packageversion –
Especifique a versão
no seguinte formato:
a.b.x.y. Por exemplo:
6.1.0.0
Driverdescription –
Especifique qualquer
valor de cadeia de
caracteres
DriverManufacturer –
Especifique qualquer
valor de cadeia de
caracteres
DriverHardwareId –
Especifique qualquer
valor de cadeia de
caracteres
DrivercompatibleId –
Especifique qualquer
valor de cadeia de
caracteres
DriverExcludeId –
Especifique qualquer
valor de cadeia de
caracteres
DriverGroupId –
Especifique um GUID
válido. Por exemplo:
{4d36e972-e325-11ce-
bfc1-08002be10318}
DriverGroupName –
Especifique qualquer
valor de cadeia de
caracteres

Para obter mais informações


sobre esses valores, confira
Atributos de driver e pacote.

Exemplos
Para adicionar pacotes de drivers a uma imagem de inicialização, digite uma das
seguintes opções:

wdsutil /add-ImageDriverPackagemedia:WinPE Boot Imagemediatype:Boot


/Architecture:x86 /Filtertype:DriverGroupName /Operator:Equal /Value:x86Bus
/Filtertype:PackageProvider /Operator:Contains /Value:Provider1
/Filtertype:Packageversion /Operator:GreaterOrEqual /Value:6.1.0.0

wdsutil /verbose /add-ImageDriverPackagemedia: WinPE Boot Image


/Server:MyWDSServemediatype:Boot /Architecture:x64 /Filtertype:PackageClass
/Operator:Equal /Value:Net /Filtertype:DriverManufacturer /Operator:NotEqual
/Value:Name1 /Value:Name2 /Filtertype:Packagedateadded /Operator:LessOrEqual
/Value:2008/01/01

wdsutil /verbose /add-ImageDriverPackagemedia:WinPE Boot Image


/Server:MyWDSServemediatype:Boot /Architecture:x64 /Filtertype:PackageClass
/Operator:Equal /Value:Net /Value:System /Value:DiskDrive /Value:HDC
/Value:SCSIAdapter

Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil add-imagedriverpackage

comando wdsutil add-alldriverpackages

cmdlets dos Serviços de Implantação do Windows


wdsutil add-imagegroup
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Adiciona um grupo de imagens a um servidor dos Serviços de Implantação do


Windows.

Sintaxe

wdsutil [Options] /add-ImageGroup imageGroup:<Imagegroupname> [/Server:


<Server name>]

Parâmetros

Parâmetro Descrição

imageGroup: <Imagegroupname> ] Especifica o nome da imagem a ser adicionada.

[/Server: <Servername> ] Especifica o nome do servidor. Pode ser o nome NetBIOS ou o


FQDN (nome de domínio totalmente qualificado). Se um nome
do servidor não for especificado, o servidor local será usado.

Exemplos
Para adicionar um grupo de imagens, digite:

wdsutil /add-ImageGroup imageGroup:ImageGroup2

wdsutil /verbose /add-Imagegroup imageGroup:My Image Group


/Server:MyWDSServer
Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil get-allimagegroups

comando wdsutil get-imagegroup

comando wdsutil remove-imagegroup

comando wdsutil set-imagegroup

cmdlets dos Serviços de Implantação do Windows


wdsutil approve-autoadddevices
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Aprova os computadores com aprovação administrativa pendente. Quando a política de


adição automática está habilitada, é necessária a aprovação administrativa para que
computadores desconhecidos (os que não foram pré-testados) possam instalar uma
imagem. Você pode habilitar essa política usando a guia Resposta PXE da página de
propriedades do servidor.

Sintaxe

wdsutil [Options] /Approve-AutoaddDevices [/Server:<Server name>]


/RequestId:{<Request ID>| ALL} [/MachineName:<Device name>] [/OU:<DN of OU>]
[/User:<Domain\User | User@Domain>] [/JoinRights:{JoinOnly | Full}]
[/JoinDomain:{Yes | No}] [/ReferralServer:<Server name>] [/BootProgram:
<Relative path>] [/WdsClientUnattend:<Relative path>] [/BootImagepath:
<Relative path>]

Parâmetros

Parâmetro Descrição

/Server: <Servername> Especifica o nome do servidor. Pode ser o nome NetBIOS


ou FQDN. Se nenhum nome do servidor for especificado,
o servidor local será usado.

/RequestId: {Request ID|ALL} Especifica a ID de solicitação atribuída ao computador


pendente. Especifique ALL para aprovar todos os
computadores pendentes.

/Machinename: <Devicename> Especifica o nome do dispositivo a ser adicionado. Você


não pode usar essa opção ao aprovar todos os
computadores.

[/OU: <DN of OU> ] O nome diferenciado da unidade organizacional em que


o objeto da conta de computador deve ser criado. Por
exemplo: OU=MyOU,CN=Test, DC=Domain,DC=com. O
local padrão é o contêiner do computador padrão.
Parâmetro Descrição

[/User: <Domain\User|User@Domain> ] Define permissões no objeto de conta do computador


para dar ao usuário especificado os direitos necessários
para ingressar o computador no domínio.

[/JoinRights: {JoinOnly|Full} ] Especifica o tipo de direitos a serem atribuídos ao


usuário.
JoinOnly – Exige que o administrador redefina a
conta do computador antes que o usuário possa
ingressar o computador no domínio.
Full – Dá acesso completo ao usuário, o que inclui
o direito de ingressar o computador no domínio.

[/JoinDomain: {Yes|No} ] Especifica se o computador deve ser ingressado no


domínio como esta conta de computador durante a
instalação do sistema operacional. O valor padrão é Sim.

[/ReferralServer: <Servername> ] Especifica o nome do servidor a ser contatado para


baixar o programa de inicialização de rede e a imagem
de inicialização usando o tftp.

[/BootProgram: <Relativepath> ] Especifica o caminho relativo da pasta remoteInstall para


o programa de inicialização de rede que este
computador deve receber. Por exemplo:
boot\x86\pxeboot.com.

[/WdsClientUnattend: <Relativepath> ] Especifica o caminho relativo da pasta remoteInstall para


o arquivo autônomo que automatiza o cliente dos
Serviços de Implantação do Windows.

[/BootImagepath: <Relativepath> ] Especifica o caminho relativo da pasta remoteInstall para


a imagem de inicialização e este computador deve
receber.

Exemplos
Para aprovar o computador com uma RequestId de 12, digite:

wdsutil /Approve-AutoaddDevices /RequestId:12

Para aprovar o computador com uma RequestID de 20 e implantar a imagem com as


configurações especificadas, digite:
wdsutil /Approve-AutoaddDevices /RequestId:20 /MachineName:computer1
/OU:OU=Test,CN=company,DC=Domain,DC=Com /User:Domain\User1
/JoinRights:Full /ReferralServer:MyWDSServer
/BootProgram:boot\x86\pxeboot.n12
/WdsClientUnattend:WDSClientUnattend\Unattend.xml
/BootImagepath:boot\x86\images\boot.wim

Para aprovar todos os computadores pendentes, digite:

wdsutil /verbose /Approve-AutoaddDevices /RequestId:ALL

Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil delete-autoadddevices

comando wdsutil get-autoadddevices

comando wdsutil reject-autoadddevices

cmdlets dos Serviços de Implantação do Windows


convert-riprepimage
Artigo • 12/04/2023

Converte uma imagem RIPrep (Preparação para Instalação Remota) existente no


formato de Imagem do Windows (.wim).

Sintaxe

wdsutil [Options] /Convert-RIPrepImage /FilePath:<Filepath and name>


/DestinationImage /FilePath:<Filepath and name> [/Name:<Name>]
[/Description:<Description>] [/InPlace] [/Overwrite:{Yes | No | Append}]

Parâmetros

Parâmetro Descrição

/FilePath: <Filepath Especifica o caminho completo do arquivo e o nome do arquivo .sif que
and name> corresponde à imagem RIPrep. Esse arquivo normalmente é chamado de
Riprep.sif e é encontrado na subpasta \Templates da pasta que contém a
imagem RIPrep.

/DestinationImage Especifica as configurações da imagem de destino. Usa as seguintes opções:


/FilePath:<Filepath and name> – Define o caminho completo do
novo arquivo. Por exemplo: C:\Temp\convert.wim
[ /Name:<Name> ] – Define o nome de exibição da imagem. Se nenhum
nome de exibição for especificado, o nome de exibição da imagem de
origem será usado.
[ /Description:<Description> ] – Especifica a descrição da imagem.
[/InPlace] – Especifica que a conversão deve ocorrer na imagem
RIPrep original e não em uma cópia da imagem original, que é o
comportamento padrão.
[ /Overwrite:{Yes | No | Append} ] – Define se essa imagem deve
substituir ou acrescentar arquivos existentes.

Exemplos
Para converter a imagem RIPrep.sif especificada em RIPREP.wim, digite:
wdsutil /Convert-RiPrepImage /FilePath:R:\RemoteInstall\Setup\English
\Images\Win2k3.SP1\i386\Templates\riprep.sif /DestinationImage
/FilePath:C:\Temp\RIPREP.wim

Para converter a imagem RIPrep.sif especificada em RIPREP.wim com o nome e a


descrição especificados e substituí-la pelo novo arquivo, se um arquivo já existir, digite:

wdsutil /Verbose /Progress /Convert-RiPrepImage /FilePath:\\Server


\RemInst\Setup\English\Images\WinXP.SP2\i386\Templates\riprep.sif
/DestinationImage /FilePath:\\Server\Share\RIPREP.wim /Name:WindowsXP image
/Description:Converted RIPREP image of WindowsXP /Overwrite:Append

Links relacionados
Chave da sintaxe de linha de comando

cmdlets dos Serviços de Implantação do Windows


comandos wdsutil copy
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Copia uma imagem ou um grupo de drivers.

Parâmetros
Parâmetro Descrição

comando wdsutil copy-image Copia as imagens que estão no mesmo grupo de imagens.

comando wdsutil copy-drivergroup Copia um grupo de drivers existente no servidor.

Links relacionados
Chave da sintaxe de linha de comando

cmdlets dos Serviços de Implantação do Windows


copy-drivergroup
Artigo • 12/04/2023

Duplica um grupo de drivers existente no servidor, incluindo os filtros, os pacotes de


drivers e o status habilitado/desabilitado.

Sintaxe

wdsutil /Copy-DriverGroup [/Server:<Server name>] /DriverGroup:<Source


Groupname> /GroupName:<New Groupname>

Parâmetros

Parâmetro Descrição

/Server: <Servername> Especifica o nome do servidor. Pode ser o nome NetBIOS ou FQDN. Se
um nome do servidor não é especificado, o servidor local é usado.

/DriverGroup: <Source Especifica o nome do grupo de drivers de origem.


Groupname>

/GroupName: <New Especifica o nome do novo grupo de drivers.


Groupname>

Exemplos
Para copiar um grupo de drivers, digite:

wdsutil /Copy-DriverGroup /Server:MyWdsServer /DriverGroup:PrinterDrivers


/GroupName:X86PrinterDrivers

wdsutil /Copy-DriverGroup /DriverGroup:PrinterDrivers


/GroupName:ColorPrinterDrivers
Links relacionados
Chave da sintaxe de linha de comando

cmdlets dos Serviços de Implantação do Windows


wdsutil copy-image
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Copia as imagens que estão no mesmo grupo de imagens. Para copiar imagens entre
grupos de imagens, use o comando wdsutil Export-Image e, em seguida, o comando
wdsutil add-Image.

Sintaxe

wdsutil [Options] /copy-Image image:<Image name> [/Server:<Server name>]


imagetype:Install imageGroup:<Image group name>] [/Filename:<File name>]
/DestinationImage /Name:<Name> /Filename:<File name> [/Description:
<Description>]

Parâmetros

Parâmetro Descrição

image: <Imagename> Especifica o nome da imagem a ser copiada.

[/Server: <Servername> ] Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN
(nome de domínio totalmente qualificado). Se nenhum nome do
servidor for especificado, o servidor local será usado.

imagetype:Install Especifica o tipo da imagem a ser copiada. Essa opção deve ser definida
como install.

\imageGroup: <Image Especifica o grupo de imagens que contém a imagem a ser copiada. Se
groupname> ] nenhum grupo de imagens for especificado e apenas um grupo existir
no servidor, esse grupo de imagens será usado por padrão. Se houver
mais de um grupo de imagens no servidor, você deverá especificar o
grupo de imagens.

[/Filename: <Filename> ] Especifica o nome do arquivo da imagem a ser copiado. Se a imagem


não puder ser identificada exclusivamente pelo nome, você precisará
especificar o nome de arquivo.
Parâmetro Descrição

/DestinationImage Especifica as configurações da imagem de destino. Os valores válidos


são:
/Name: <Name> - define o nome de exibição da imagem a ser
copiado.
/Filename: <Filename> - define o nome do arquivo de imagem de
destino que conterá a cópia da imagem.
[/Description: <Description> ] - define a descrição da cópia da
imagem.

Exemplos
Para criar uma cópia da imagem especificada e nomeá-la WindowsVista.wim, digite:

wdsutil /copy-Image image:Windows Vista with Office imagetype:Install


/DestinationImage /Name:copy of Windows Vista with Office /
Filename:WindowsVista.wim

Para criar uma cópia da imagem especificada, aplique as configurações especificadas e


nomear a cópia WindowsVista.wim, digite:

wdsutil /verbose /Progress /copy-Image image:Windows Vista with Office


/Server:MyWDSServe imagetype:Install imageGroup:ImageGroup1
/Filename:install.wim /DestinationImage /Name:copy of Windows Vista with
Office /Filename:WindowsVista.wim /Description:This is a copy of the
original Windows image with Office installed

Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil add-image

comando wdsutil export-image

comando wdsutil get-image

comando wdsutil remove-image


Comando wdsutil replace-image

comando wdsutil set-image

cmdlets dos Serviços de Implantação do Windows


wdsutil delete-autoadddevices
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exclui computadores pendentes, rejeitados ou aprovados do banco de dados de adição


automática. Esse banco de dados armazena informações sobre esses computadores no
servidor.

Sintaxe

wdsutil /delete-AutoaddDevices [/Server:<Servername>] /Devicetype:


{PendingDevices | RejectedDevices |ApprovedDevices}

Parâmetros

Parâmetro Descrição

[/Server: <Servername> ] Especifica o nome do servidor.


Pode ser o nome NetBIOS ou o
FQDN (nome de domínio
totalmente qualificado). Se
nenhum nome do servidor for
especificado, o servidor local
será usado.
Parâmetro Descrição

/Devicetype: {PendingDevices|RejectedDevices|ApprovedDevices} Especifica o tipo de


computador a ser excluído do
banco de dados. Esse tipo
pode ser PendingDevices, que
retorna todos os
computadores no banco de
dados que têm o status
pendente, RejectedDevices,
que retorna todos os
computadores no banco de
dados que têm o status
rejeitado ou ApprovedDevices,
que retorna todos os
computadores que têm o
status aprovado.

Exemplos
Para excluir todos os computadores rejeitados, digite:

wdsutil /delete-AutoaddDevices /Devicetype:RejectedDevices

Para excluir todos os computadores aprovados, digite:

wdsutil /verbose /delete-AutoaddDevices /Server:MyWDSServer


/Devicetype:ApprovedDevices

Links relacionados
Chave da sintaxe de linha de comando

Comando wdsutil approve-autoadddevices

Comando wdsutil get-autoadddevices

Comando wdsutil reject-autoadddevices

cmdlets dos Serviços de Implantação do Windows


comandos wdsutil disable
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Desabilita todos os Serviços de Implantação do Windows.

Parâmetros
Parâmetro Descrição

comando wdsutil Desabilita todos os Serviços de Implantação do Windows em um


disable-server servidor especificado (Servidor de Implantação).

comando wdsutil Desabilita todos os Serviços de Implantação do Windows em um


disable-transportserver Servidor de Transporte especificado.

Links relacionados
Chave da sintaxe de linha de comando

cmdlets dos Serviços de Implantação do Windows


wdsutil disable-server
Artigo • 11/04/2023

Desabilita todos os serviços para um servidor dos Serviços de Implantação do Windows.

Sintaxe

wdsutil [Options] /Disable-Server [/Server:<Server name>]

Parâmetros

Parâmetro Descrição

[/Server: <Servername> ] Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN
(nome de domínio totalmente qualificado). Se nenhum nome do
servidor for especificado, o servidor local será usado.

Exemplos
Para desabilitar o servidor, digite:

wdsutil /Disable-Server

wdsutil /Verbose /Disable-Server /Server:MyWDSServer

Links relacionados
Chave da sintaxe de linha de comando

cmdlets Windows Deployment Services


wdsutil disable-transportserver
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Desabilita todos os serviços de um Servidor de Transporte.

Sintaxe

wdsutil [Options] /Disable-TransportServer [/Server:<Servername>]

Parâmetros

Parâmetro Descrição

[/Server: <Servername> ] Especifica o nome do Servidor de Transporte a ser desabilitado. Pode ser
o nome NetBIOS ou o FQDN (nome de domínio totalmente qualificado).
Se nenhum nome de Servidor de Transporte for especificado, o servidor
local será usado.

Exemplos
Para desabilitar o servidor, digite:

wdsutil /Disable-TransportServer

wdsutil /verbose /Disable-TransportServer /Server:MyWDSServer

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil enable-transportserver

comando wdsutil get-transportserver

comando wdsutil set-transportserver

comando wdsutil start-transportserver

comando wdsutil stop-transportserver

cmdlets dos Serviços de Implantação do Windows


wdsutil disconnect-client
Artigo • 12/04/2023

Desconecta um cliente de uma transmissão multicast ou um namespace. A menos que


você especifique /Force, o cliente fará fallback para outro método de transferência (se
houver suporte do cliente).

Sintaxe

wdsutil /Disconnect-Client /ClientId:<Client ID> [/Server:<Server name>]


[/Force]

Parâmetros

Parâmetro Descrição

/ClientId: <ClientID> Especifica a ID do cliente a ser desconectado. Para exibir a ID de um


cliente, execute o comando wdsutil /get-multicasttransmission
/show:clients .

[/Server: <Servername> ] Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN
(nome de domínio totalmente qualificado). Se nenhum nome do
servidor for especificado, o servidor local será usado.

[/Force] Interrompe completamente a instalação e não usa um método de


fallback. Como o Wdsmcast.exe não é compatível com os mecanismos
de fallback, o comportamento padrão é o seguinte:
Se você estiver usando o cliente dos Serviços de Implantação do
Windows: o cliente continuará a instalação usando o unicasting.
Se você não estiver usando o cliente dos Serviços de
Implantação do Windows: a instalação falhará.

Importante: é altamente recomendável usar esse parâmetro com cautela


porque, se a instalação falhar, o computador pode ficar em um estado
inutilizável.

Exemplos
Para desconectar um cliente, digite:
wdsutil /Disconnect-Client /ClientId:1

Para desconectar um cliente e forçar a falha na instalação, digite:

wdsutil /Disconnect-Client /Server:MyWDSServer /ClientId:1 /Force

Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil get-multicasttransmission

cmdlets dos Serviços de Implantação do Windows


comandos wdsutil enable
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Habilita todos os Serviços de Implantação do Windows.

Parâmetros
Parâmetro Descrição

comando wdsutil Habilita todos os serviços em um servidor especificado dos Serviços de


enable-server Implantação do Windows (Servidor de Implantação).

comando wdsutil Habilita todos os serviços em um Servidor de Transporte especificado.


enable-transportserver

Links relacionados
Chave da sintaxe de linha de comando

cmdlets dos Serviços de Implantação do Windows


wdsutil enable-server
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Habilita todos os serviços para os Serviços de Implantação do Windows.

Sintaxe

wdsutil [options] /Enable-Server [/Server:<Servername>]

Parâmetros

Parâmetro Descrição

[/Server: <Servername> ] Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN
(nome de domínio totalmente qualificado). Se nenhum nome do
servidor for especificado, o servidor local será usado.

Exemplos
Para habilitar os serviços no servidor, digite:

wdsutil /Enable-Server

wdsutil /verbose /Enable-Server /Server:MyWDSServer

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil disable-server

comando wdsutil get-Server

comando wdsutil initialize-server

comando wdsutil set-server

comando wdsutil start-server

comando wdsutil stop-server

comando wdsutil uninitialize-server

cmdlets Windows Deployment Services


wdsutil enable-transportserver
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Habilita todos os serviços do Servidor de Transporte.

Sintaxe

wdsutil [options] /Enable-TransportServer [/Server:<Servername>]

Parâmetros

Parâmetro Descrição

[/Server: <Servername> ] Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN
(nome de domínio totalmente qualificado). Se um nome do servidor não
é especificado, o servidor local é usado.

Exemplos
Para habilitar os serviços no servidor, digite:

wdsutil /Enable-TransportServer

wdsutil /verbose /Enable-TransportServer /Server:MyWDSServer

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil disable-transportserver

comando wdsutil get-transportserver

comando wdsutil set-transportserver

comando wdsutil start-transportserver

comando wdsutil stop-transportserver

cmdlets dos Serviços de Implantação do Windows


wdsutil export image
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exporta uma imagem existente do repositório de imagens para outro arquivo de


Imagem do Windows (.wim).

Syntax
Para imagens de inicialização:

wdsutil [options] /Export-Image image:<Image name> [/Server:<Servername>]


imagetype:Boot /Architecture:{x86 | ia64 | x64} [/Filename:<Filename>]
/DestinationImage
/Filepath:<Filepath and name>
[/Name:<Name>]
[/Description:<Description>]
[/Overwrite:{Yes | No}]

Para imagens de instalação:

wdsutil [options] /Export-Image image:<Image name> [/Server:<Servername>]


imagetype:Install imageGroup:<Image group name>]
[/Filename:<Filename>]
/DestinationImage
/Filepath:<Filepath and name>
[/Name:<Name>]
[/Description:<Description>]
[/Overwrite:{Yes | No | append}]

Parâmetros

Parâmetro Descrição

image: <Imagename> Especifica o nome da imagem a ser exportada.


Parâmetro Descrição

[/Server: <Servername> ] Especifica o nome do servidor. Pode ser o nome NetBIOS ou o


FQDN (nome de domínio totalmente qualificado). Se nenhum
nome do servidor for especificado, o servidor local será usado.

imagetype: {Boot|Install} Especifica o tipo da imagem a ser exportada.

\imageGroup: <Image group Especifica o grupo de imagens que contém a imagem a ser
name> ] exportada. Se nenhum nome do grupo de imagens for
especificado e apenas um grupo existir no servidor, esse grupo
será usado por padrão. Se houver mais de um grupo de imagens
no servidor, o grupo de imagens deve ser especificado.

/Architecture: {x86|ia64|x64} Especifica a arquitetura da imagem a ser exportada. Como é


possível ter o mesmo nome de imagem para as imagens de
inicialização em arquiteturas diferentes, especificar o valor de
arquitetura garante que a imagem correta seja retornada.

[/Filename: <Filename> ] Se a imagem não puder ser identificada exclusivamente pelo


nome, o nome do arquivo deverá ser especificado.

/DestinationImage Especifica as configurações da imagem de destino. Você pode


especificar essas configurações usando as seguintes opções:
/Filepath:<Filepath and name> – Especifica o caminho de
arquivo completa para a nova imagem.
[/Name:<Name>] – Define o nome de exibição da imagem. Se
nenhum nome for especificado, o nome de exibição da
imagem de origem será usado.
[/Description: <Description>] – Define a descrição da
imagem.

[/Overwrite: {Yes|No|append} ] Determina se o arquivo especificado na opção /DestinationImage


será sobrescrito se um arquivo de imagem com o nome que já
existe no /FilePath. A opção Yes faz com que o arquivo existente
seja substituído; a opção No (padrão) causará um erro se um
arquivo com o mesmo nome já existir e a opção append faz com
que a imagem gerada seja acrescentada como uma nova imagem
no arquivo .wim existente.

Exemplos
Para exportar uma imagem de inicialização, digite:

wdsutil /Export-Image image:WinPE boot image imagetype:Boot


/Architecture:x86 /DestinationImage /Filepath:C:\temp\boot.wim
wdsutil /verbose /Progress /Export-Image image:WinPE boot image
/Server:MyWDSServer imagetype:Boot /Architecture:x64 /Filename:boot.wim
/DestinationImage /Filepath:\\Server\Share\ExportImage.wim /Name:Exported
WinPE image /Description:WinPE Image from WDS server /Overwrite:Yes

Para exportar uma imagem de instalação, digite:

wdsutil /Export-Image image:Windows Vista with Office imagetype:Install


/DestinationImage /Filepath:C:\Temp\Install.wim

wdsutil /verbose /Progress /Export-Image image:Windows Vista with Office


/Server:MyWDSServer imagetype:Instal imageGroup:ImageGroup1
/Filename:install.wim /DestinationImage /Filepath:\\server\share\export.wim
/Name:Exported Windows image /Description:Windows Vista image from WDS
server /Overwrite:append

Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil add-image

comando wdsutil copy-image

comando wdsutil get-image

comando wdsutil remove-image

Comando wdsutil replace-image

comando wdsutil set-image

cmdlets dos Serviços de Implantação do Windows


wdsutil get
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Recupera as propriedades ou os atributos sobre o objeto especificado.

Subcomandos
Subcomando Descrição

comando wdsutil get- Exibe as informações sobre todos os computadores pré-testados.


alldevices

comando wdsutil get- Exibe as informações sobre todos os grupos de imagens.


allImagegroups

comando wdsutil get- Exibe as informações sobre todas as imagens.


allimages

comando wdsutil get- Exibe os atributos de todas as transmissões multicast.


allmulticasttransmissions

comando wdsutil get- Exibe os atributos de todos os namespaces.


allnamespaces

comando wdsutil get- Exibe as informações sobre todos os servidores dos Serviços de
allservers Implantação do Windows.

comando wdsutil get- Exibe os computadores que estão aguardando aprovação


autoadddevices administrativa em um servidor especificado.

comando wdsutil get- Exibe os atributos de um computador pendente.


device

comando wdsutil get- Exibe os atributos de uma imagem existente.


image

comando wdsutil get- Exibe as informações sobre as imagens em um arquivo .wim


imagefile especificado.

comando wdsutil get- Exibe as informações sobre um grupo de imagens especificado.


imagegroup

comando wdsutil get- Exibe os atributos de uma transmissão multicast especificada.


multicasttransmission
Subcomando Descrição

comando wdsutil get- Exibe os atributos de um namespace especificado.


namespace

comando wdsutil get- Exibe as informações sobre um servidor dos Serviços de Implantação
server do Windows especificado.

comando wdsutil get- Exibe as informações sobre um Servidor de Transporte especificado.


transportserver

comando wdsutil get- Exibe as informações sobre os pacotes de drivers em um servidor.


driverpackage

comando wdsutil get- Exibe as informações sobre todos os grupos de drivers no servidor.
alldrivergroups

comando wdsutil get- Exibe as informações sobre os grupos de drivers em um servidor.


drivergroup

comando wdsutil get- Exibe as informações sobre todos os pacotes de drivers em um


alldriverpackages servidor que correspondem aos critérios de pesquisa especificados.

comando wdsutil get- Exibe as informações sobre um pacote de drivers, incluindo os drivers
driverpackagefile e arquivos que ele contém.
wdsutil get-alldevices
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe as propriedades dos Serviços de Implantação do Windows de todos os


computadores preparados previamente. Um computador preparado previamente é um
computador físico que foi vinculado a uma conta de computador no Active Directory
Domain Services.

Sintaxe

wdsutil [options] /get-alldevices [/forest:{Yes | No}] [/referralserver:


<servername>]

Parâmetros

Parâmetro Descrição

[/forest:{Yes | Especifica se os Serviços de Implantação do Windows devem retornar


No}] computadores em toda a floresta ou no domínio local. A configuração
padrão é No, o que significa que somente os computadores no domínio
local são retornados.

[/referralserver: Retorna somente os computadores preparados previamente para o servidor


<servername>] especificado.

Exemplos
Para exibir todos os computadores, digite:

wdsutil /get-alldevices
wdsutil /verbose /get-alldevices /forest:Yes /referralserver:MyWDSServer

Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil set-device

comando wdsutil add-device

comando wdsutil get-device


wdsutil get-alldrivergroups
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe informações sobre todos os grupos de drivers em um servidor.

Sintaxe

wdsutil /get-alldrivergroups [/server:<servername>] [/show:{packagemetadata


| filters | all}]

Parâmetros

Parâmetro Descrição

[/server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN. Se um


<servername>] nome do servidor não for especificado, o servidor local será usado.

/show: Exibe os metadados de todos os pacotes de drivers no grupo especificado.


{packagemetadata PackageMetaData exibe informações sobre todos os filtros do grupo de
| filters | drivers. Filters exibe os metadados de todos os pacotes de drivers e filtros
all}] para o grupo.

Exemplos
Para exibir informações sobre um arquivo de driver, digite:

wdsutil /get-alldrivergroups /server:MyWdsServer /show:All

wdsutil /get-alldrivergroups [/show:packagemetadata]


Links relacionados
Chave da sintaxe de linha de comando

Comando wdsutil get-drivergroup


wdsutil get-alldriverpackages
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe as informações sobre todos os pacotes de drivers em um servidor que


correspondem aos critérios de pesquisa especificados.

Sintaxe

wdsutil /get-alldriverpackages [/server:<servername>] [/show:{drivers |


files | all}] [/filtertype:<filtertype> /operator:{equal | notequal |
greaterorequal | lessorequal | contains} /value:<value> [/value:<value>
...]]

Parâmetros

Parâmetro Descrição

[/server: O nome do servidor. Pode ser o nome NetBIOS ou FQDN. Se um nome do


<servername>] servidor não for especificado, o servidor local será usado.

[/show:{drivers Indica as informações do pacote a serem exibidas. Se /show não for


| files | all}] especificado, o padrão será retornar apenas os metadados do pacote de
drivers. Drivers exibe a lista de drivers no pacote, files exibe a lista de arquivos
no pacote e all exibe os drivers e arquivos.
Parâmetro Descrição

/filtertype: Especifica o atributo do pacote de drivers a ser procurado. Você pode


<filtertype> especificar vários atributos em um único comando. Você também deve
especificar /operator e /value com essa opção.

O <filtertype> pode ser um dos seguintes:

PackageId
PackageName
PackageEnabled
Packagedateadded
PackageInfFilename
PackageClass
PackageProvider
PackageArchitecture
PackageLocale
PackageSigned
PackagedatePublished
Packageversion
Driverdescription
DriverManufacturer
DriverHardwareId
DrivercompatibleId
DriverGroupId
DriverGroupName

/operator: Especifica a relação entre o atributo e os valores. Você só pode especificar


{equal | contains com os atributos de cadeia de caracteres. Você só pode especificar
notequal | greaterorequal e lessorequal com os atributos de data e versão.
greaterorequal
| lessorequal |
contains}
Parâmetro Descrição

/value:<value> Especifica o valor para procurar o <attribute> especificado. Você pode


especificar vários valores para um único /filtertype. A lista a seguir descreve os
atributos que você pode especificar para cada filtro. Para obter mais
informações sobre esses atributos, confira Atributos de driver e pacote. Os
atributos podem incluir:

PackageId. Especifica um GUID válido. Por exemplo: {4d36e972-e325-


11ce-bfc1-08002be10318}.
PackageName. Especifica qualquer valor de cadeia de caracteres.
PackageEnabled. Especifica Sim ou Não.
Packagedateadded. Especifica a data no seguinte formato:
DD/MM/AAAA
PackageInfFilename. Especifica qualquer valor de cadeia de caracteres.
PackageClass. Especifica um GUID de classe ou um nome de classe
válido. Por exemplo: DiskDrive, Net ou {4d36e972-e325-11ce-bfc1-
08002be10318}.
PackageProvider. Especifica qualquer valor de cadeia de caracteres.
PackageArchitecture. Especifica x86, x64 ou ia64.
PackagLocale. Especifica um identificador de idioma válido. Por
exemplo: en-US ou es-ES.
PackageSigned. Especifica Sim ou Não.
PackagedatePublished. Especifica a data no seguinte formato:
DD/MM/AAAA.
Packageversion. Especifica a versão no seguinte formato: a.b.x.y. Por
exemplo: 6.1.0.0.
Driverdescription. Especifica qualquer valor de cadeia de caracteres.
DriverManufacturer. Especifica qualquer valor de cadeia de caracteres.
DriverHardwareId. Especifica qualquer valor de cadeia de caracteres.
DrivercompatibleId. Especifica qualquer valor de cadeia de caracteres.
DriverExcludeId. Especifica qualquer valor de cadeia de caracteres.
DriverGroupId. Especifica um GUID válido. Por exemplo: {4d36e972-
e325-11ce-bfc1-08002be10318}.
DriverGroupName. Especifica qualquer valor de cadeia de caracteres.

Exemplos
Para exibir as informações, digite:

wdsutil /get-alldriverpackages /server:MyWdsServer /show:all


/filtertype:drivergroupname /operator:contains /value:printer
/filtertype:packagearchitecture /operator:equal /value:x64 /value:x86
wdsutil /get-alldriverpackages /show:drivers /filtertype:packagedateadded
/operator:greaterorequal /value:2008/01/01

Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil get-driverpackage

comando wdsutil get-driverpackagefile


wdsutil get-allimagegroups
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Recupera as informações sobre todos os grupos de imagens em um servidor e todas as


imagens nesses grupos de imagens.

Sintaxe

wdsutil [options] /get-allimagegroups [/server:<servername>] [/detailed]

Parâmetros

Parâmetro Descrição

[/server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<servername>] domínio totalmente qualificado). Se nenhum nome do servidor for especificado,
o servidor local será usado.

[/detailed] Retorna os metadados de imagem de cada imagem. Se esse parâmetro não for
usado, o comportamento padrão será retornar apenas o nome da imagem, a
descrição e o nome do arquivo de cada imagem.

Exemplos
Para exibir as informações sobre os grupos de imagens, digite:

wdsutil /get-allimagegroups

wdsutil /verbose /get-allimagegroups /server:MyWDSServer /detailed


Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil add-imagegroup

comando wdsutil remove-imagegroup

comando wdsutil set-imagegroup


wdsutil get-allimages
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Recupera as informações sobre todas as imagens em um servidor.

Sintaxe

wdsutil /get-allimages [/server:<servername>] /show:{boot | install |


legacyris | all} [/detailed]

Parâmetros

Parâmetro Descrição

[/server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<servername>] domínio totalmente qualificado). Se nenhum nome do servidor for especificado,
o servidor local será usado.

/show:{boot | Quando boot retorna apenas imagens de inicialização, install retorna as imagens
install | de instalação, bem como as informações sobre os grupos de imagens que as
legacyris | contêm, LegacyRis retorna apenas imagens de RIS (Serviços Remotos de
all} Instalação) e All retorna as informações de imagem de inicialização, as
informações de imagem de instalação (incluindo as informações sobre os grupos
de imagens) e as informações de imagem de RIS.

[/detailed] Indica que todos os metadados de imagem de cada imagem devem ser
retornados. Se essa opção não for usada, o comportamento padrão será retornar
apenas o nome da imagem, a descrição e o nome do arquivo.

Exemplos
Para exibir as informações sobre as imagens, digite:

wdsutil /get-allimages /show:install


wdsutil /verbose /get-allimages /server:MyWDSServer /show:all /detailed

Links relacionados
Chave da sintaxe de linha de comando

comando wdsutil add-image

comando wdsutil copy-image

comando wdsutil export-image

comando wdsutil remove-image

comando wdsutil replace-image

comando wdsutil set-image


wdsutil get-allmulticasttransmissions
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe as informações sobre todas as transmissões multicast em um servidor.

Syntax
Para o Windows Server 2008:

wdsutil /Get-AllMulticastTransmissions [/Server:<Server name>]


[/Show:Clients] [/ExcludedeletePending]

Para o Windows Server 2008 R2:

wdsutil /Get-AllMulticastTransmissions [/Server:<Server name>] [/Show:{Boot


| Install | All}] [/details:Clients] [/ExcludedeletePending]

Parâmetros

Parâmetro Explicação

[/Server:<Server Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN


name>] (nome de domínio totalmente qualificado). Se nenhum nome do
servidor for especificado, o servidor local será usado.

[/Show] Windows Server 2008

/Show:Clients – Exibe as informações sobre os computadores cliente


conectados às transmissões multicast.

Windows Server 2008 R2

Show: {Boot | Instalar | All} – O tipo de imagem a ser retornada. Boot


retorna apenas as transmissões de imagem de inicialização. Install
retorna apenas as transmissões de imagem de instalação. All retornam
os dois tipos de imagem.
Parâmetro Explicação

/details:clients Compatível apenas com o Windows Server 2008 R2. Se presente, os


clientes conectados à transmissão serão exibidos.

[/ExcludedeletePending] Exclui todas as transmissões desativadas da lista.

Exemplos
Para exibir as informações sobre todas as transmissões, digite:

Windows Server 2008: wdsutil /Get-AllMulticastTransmissions


Windows Server 2008 R2: wdsutil /Get-AllMulticastTransmissions /Show:All Para
exibir as informações sobre todas as transmissões, exceto as transmissões
desativadas, digite:
Windows Server 2008: wdsutil /Get-AllMulticastTransmissions
/Server:MyWDSServer /Show:Clients /ExcludedeletePending

Windows Server 2008 R2: wdsutil /Get-AllMulticastTransmissions


/Server:MyWDSServer /Show:All /details:Clients /ExcludedeletePending

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil get-multicasttransmission
comando wdsutil new-multicasttransmission
comando wdsutil remove-multicasttransmission
comando wdsutil start-multicasttransmission
wdsutil get-allnamespaces
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe informações sobre todos os namespaces em um servidor.

Syntax
Windows Server 2008:

wdsutil /Get-AllNamespaces [/Server:<Server name>] [/ContentProvider:<name>]


[/Show:Clients] [/ExcludedeletePending]

Windows Server 2008 R2:

wdsutil /Get-AllNamespaces [/Server:<Server name>] [/ContentProvider:<name>]


[/details:Clients] [/ExcludedeletePending]

Parâmetros

Parâmetro Windows Server 2008 Windows


Server
2008 R2

[/Server:<nome do Especifica o nome do servidor. Pode ser o nome NetBIOS


servidor>] ou o FQDN (nome de domínio totalmente qualificado). Se
nenhum nome do servidor for especificado, o servidor
local será usado.

[/ContentProvider: Exibe os namespaces somente para o provedor de


<name>] conteúdo especificado.

[/Show:Clients] Só há suporte ao Windows Server 2008. Exibe informações


sobre os computadores cliente conectados ao namespace.
Parâmetro Windows Server 2008 Windows
Server
2008 R2

[/details:Clients] Compatível apenas com o Windows Server 2008 R2. Exibe


informações sobre os computadores cliente conectados
ao namespace.

[/ExcludedeletePending] Exclui todas as transmissões desativadas da lista.

Exemplos
Para exibir todos os namespaces, digite:

wdsutil /Get-AllNamespaces

Para exibir todos os namespaces, exceto aqueles que estão desativados, digite:

Windows Server 2008

wdsutil /Get-AllNamespaces /Server:MyWDSServer


/ContentProvider:MyContentProv /Show:Clients /ExcludedeletePending

Windows Server 2008 R2

wdsutil /Get-AllNamespaces /Server:MyWDSServer


/ContentProvider:MyContentProv /details:Clients /ExcludedeletePending

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil new-namespace
comando wdsutil remove-namespace
comando wdsutil start-namespace
get-AllServers
Artigo • 17/04/2023

Exibe as informações sobre todos os servidores dos Serviços de Implantação do


Windows.

7 Observação

A conclusão desse comando pode demorar bastante se houver muitos servidores


dos Serviços de Implantação do Windows em seu ambiente ou se a conexão da
rede que vincula os servidores estiver lenta.

Sintaxe

wdsutil [Options] /Get-AllServers /Show:{Config | Images | All} [/Detailed]


[/Forest:{Yes | No}]

Parâmetros

Parâmetro Descrição

/Show: Imagens
{Config

[/Detailed] Quando usado em conjunto com /Show:Images ou /Show:All, retorna todos os


metadados de imagem de cada imagem. Se a opção /Detailed não for especificada,
o comportamento padrão será retornar o nome da imagem, a descrição e o nome
do arquivo.

[/Forest: No}]
{Yes

Exemplos
Para exibir informações sobre todos os servidores, digite:

wdsutil /Get-AllServers /Show:Config


Para exibir informações detalhadas sobre todos os servidores, digite:

wdsutil /Verbose /Get-AllServers /Show:All /Detailed /Forest:Yes

Links relacionados
Chave da sintaxe de linha de comando
wdsutil get-autoadddevices
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe todos os computadores que estão no banco de dados de adição automática em


um servidor dos Serviços de Implantação do Windows.

Sintaxe

wdsutil [Options] /Get-AutoaddDevices [/Server:<Server name>] /Devicetype:


{PendingDevices | RejectedDevices | ApprovedDevices}

Parâmetros

Parâmetro Descrição

[/Server:<Server Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN


name>] (nome de domínio totalmente qualificado). Se nenhum nome do
servidor for especificado, o servidor local será usado.

/Devicetype: Especifica o tipo de computador a ser retornado.


{PendingDevices | - PendingDevices retorna todos os computadores no banco de dados
RejectedDevices | que têm um status pendente.
ApprovedDevices} - RejectedDevices retorna todos os computadores no banco de dados
que têm um status rejeitado.
- ApprovedDevices retorna todos os computadores no banco de
dados que têm um status aprovado.

Exemplos
Para ver todos os computadores aprovados, digite:

wdsutil /Get-AutoaddDevices /Devicetype:ApprovedDevices

Para ver todos os computadores rejeitados, digite:


wdsutil /verbose /Get-AutoaddDevices /Devicetype:RejectedDevices
/Server:MyWDSServer

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil delete-autoadddevices
comando wdsutil approve-autoadddevices
comando wdsutil reject-autoadddevices
wdsutil get-device
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Recupera informações dos Serviços de Implantação do Windows sobre um computador


preparado previamente (ou seja, um computador físico que foi alinhado a uma conta de
computador no Active Directory Domain Services.

Sintaxe

wdsutil /Get-Device {/Device:<Device name> | /ID:<MAC or UUID>} [/Domain:


<Domain>] [/forest:{Yes | No}]

Parâmetros

Parâmetro Descrição

/Device: Especifica o nome do computador (SAMAccountName).


<Nome do
dispositivo>

/ID:<MAC Especifica o endereço MAC ou a UUID (GUID) do computador, conforme mostrado


ou UUID> nos exemplos a seguir. Observe que um GUID válido deve estar no formato de
cadeia de caracteres binária ou cadeia de caracteres GUID
- Cadeia de caracteres binária: /ID:ACEFA3E81F20694E953EB2DAA1E8B1B6
- Endereço MAC: 00B056882FDC (sem traços) ou 00-B0-56-88-2F-DC (com traços)
- Cadeia de caracteres do GUID: /ID:E8A3EFAC-201F-4E69-953-B2DAA1E8B1B6

[/Domain: Especifica o domínio a ser pesquisado para o computador preparado previamente.


<Domínio>] O valor padrão para esse parâmetro é o domínio local.

[/forest:{Sim Especifica se os Serviços de Implantação do Windows devem pesquisar toda a


| Não}] floresta ou o domínio local. O valor padrão é Não, o que significa que somente o
domínio local será pesquisado.

Exemplos
Para obter informações usando o nome do computador, digite:
wdsutil /Get-Device /Device:computer1

Para obter informações usando o endereço MAC, digite:

wdsutil /verbose /Get-Device /ID:00-B0-56-88-2F-DC /Domain:MyDomain

Para obter informações usando a cadeia de caracteres GUID, digite:

wdsutil /verbose /Get-Device /ID:E8A3EFAC-201F-4E69-953-B2DAA1E8B1B6


/forest:Yes

Links relacionados
Chave da sintaxe de linha de comando
Comando wdsutil set-device
Comando wdsutil add-device
Comando wdsutil get-alldevices
wdsutil get-drivergroup
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe informações sobre todos os grupos de drivers em um servidor.

Sintaxe

wdsutil /Get-DriverGroup /DriverGroup:<Group Name> [/Server:<Server name>]

Parâmetros

Parâmetro Descrição

/DriverGroup: Especifica o nome do grupo de drivers.


<nome do
grupo>

[/Server:<nome Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN. Se um


do servidor>] nome do servidor não for especificado, o servidor local será usado.

[/Show: Exibe os metadados de todos os pacotes de drivers no grupo especificado.


{PackageMetaData PackageMetaData exibe informações sobre todos os filtros do grupo de
| Filters | All}] drivers. Filters exibe os metadados de todos os pacotes de drivers e filtros
para o grupo.

Exemplos
Para exibir as informações sobre um arquivo de driver, digite:

wdsutil /Get-DriverGroup /DriverGroup:printerdrivers /Show:PackageMetaData


wdsutil /Get-DriverGroup /DriverGroup:printerdrivers /Server:MyWdsServer
/Show:Filters

Links relacionados
Chave da sintaxe de linha de comando
Comando wdsutil get-alldrivergroups
get-DriverPackage
Artigo • 12/04/2023

Exibe as informações sobre um pacote de drivers no servidor.

Sintaxe

wdsutil /Get-DriverPackage [/Server:<Server name>] {/DriverPackage:<Package


Name> | /PackageId:<ID>} [/Show:{Drivers | Files | All}]

Parâmetros

Parâmetro Descrição

[/Server:<Server Especifica o nome do servidor. Pode ser o nome NetBIOS ou FQDN. Se


name>] nenhum nome do servidor for especificado, o servidor local será usado.

[/DriverPackage: Especifica o nome do pacote de drivers a ser mostrado.


<Name>]

[/PackageId: Especifica a ID dos Serviços de Implantação do Windows do pacote de drivers


<ID>] a ser mostrado. Você deverá especificar a ID, se não for possível especificar o
pacote de drivers exclusivamente pelo nome.

[/Show: {Drivers Arquivos

Exemplos
Para exibir as informações sobre um pacote de drivers, digite uma das seguintes opções:

wdsutil /Get-DriverPackage /PackageId:{4D36E972-E325-11CE-BFC1-08002BE10318}

wdsutil /Get-DriverPackage /DriverPackage:MyDriverPackage /Show:All


Links relacionados
Chave da sintaxe de linha de comando
wdsutil get-image
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Recupera informações sobre uma imagem.

Syntax
Para imagens de inicialização:

wdsutil [Options] /Get-Image image:<Image name> [/Server:<Server name>


imagetype:Boot /Architecture:{x86 | ia64 | x64} [/Filename:<File name>]

Para imagens de instalação:

wdsutil [Options] /Get-image image:<Image name> [/Server:<Server name>


imagetype:Install imagegroup:<Image group name>] [/Filename:<File name>]

Parâmetros

Parâmetro Descrição

\image: Especifica o nome da imagem.


<Nome da
imagem>

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<Nome do domínio totalmente qualificado). Se nenhum nome do servidor for especificado, o
servidor>] servidor local será usado.

imagetype: Especifica o tipo de imagem.


{Boot |
Install}

/Architecture: Especifica a arquitetura da imagem. Como é possível ter o mesmo nome de


{x86 | ia64 | imagem para as imagens de inicialização em arquiteturas diferentes, especificar o
x64} valor de arquitetura garante que a imagem correta seja retornada.
Parâmetro Descrição

[/Filename: Se a imagem não puder ser identificada exclusivamente pelo nome, você deverá
<Nome de usar essa opção para especificar o nome de arquivo.
arquivo>]

\imagegroup: Especifica o grupo de imagens que contém a imagem. Se nenhum grupo de


<Nome do imagens for especificado e apenas um grupo existir no servidor, esse grupo será
grupo de usado. Se houver mais de um grupo de imagens no servidor, você deverá usar
imagens>] esse parâmetro para especificar o grupo de imagens.

Exemplos
Para recuperar informações sobre uma imagem de inicialização, digite uma das
seguintes opções:

wdsutil /Get-Image image:WinPE boot imagetype:Boot /Architecture:x86


wdsutil /verbose /Get-Image image:WinPE boot image /Server:MyWDSServer
imagetype:Boot /Architecture:x86 /Filename:boot.wim

Para recuperar informações sobre uma imagem de instalação, digite uma das seguintes
opções:

wdsutil /Get-Image:Windows Vista with Office imagetype:Install


wdsutil /verbose /Get-Image:Windows Vista with Office /Server:MyWDSServer
imagetype:Install imagegroup:ImageGroup1 /Filename:install.wim

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil add-image
comando wdsutil copy-image
comando wdsutil export-image
comando wdsutil remove-image
comando wdsutil replace-image
comando wdsutil set-image
get-ImageFile
Artigo • 12/04/2023

Recupera as informações sobre as imagens contidas em um arquivo de Imagem do


Windows (.wim).

Sintaxe

wdsutil [Options] /Get-ImageFile /ImageFile:<wim file path> [/Detailed]

Parâmetros

Parâmetro Descrição

/ImageFile: Especifica o caminho completo e o nome do arquivo .wim.


<WIM file
path>

[/Detailed] Retorna todos os metadados de imagem de cada imagem. Se essa opção não for
usada, o comportamento padrão será retornar apenas o nome da imagem, a
descrição e o nome do arquivo.

Exemplos
Para exibir as informações sobre uma imagem, digite:

wdsutil /Get-ImageFile /ImageFile:C:\temp\install.wim

Para exibir as informações detalhadas, digite:

wdsutil /Verbose /Get-ImageFile /ImageFile:\\Server\Share\My Folder


\install.wim /Detailed

Links relacionados
Chave da sintaxe de linha de comando
wdsutil get-imagegroup
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Recupera as informações sobre um grupo de imagens e as imagens nele.

Sintaxe

wdsutil [Options] /Get-ImageGroup ImageGroup:<Image group name> [/Server:


<Server name>] [/detailed]

Parâmetros

Parâmetro Descrição

/ImageGroup: Especifica o nome do grupo de imagens.


<Image
group name>

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<Server domínio totalmente qualificado). Se nenhum nome do servidor for especificado,
name>] o servidor local será usado.

[/detailed] Retorna os metadados de imagem de cada imagem. Se esse parâmetro não for
usado, o comportamento padrão será retornar apenas o nome da imagem, a
descrição e o nome do arquivo.

Exemplos
Para exibir as informações sobre um grupo de imagens, digite:

wdsutil /Get-ImageGroup ImageGroup:ImageGroup1

Para exibir as informações, incluindo os metadados, digite:


wdsutil /verbose /Get-ImageGroup ImageGroup:ImageGroup1 /Server:MyWDSServer
/detailed

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil add-imagegroup
comando wdsutil get-allimagegroups
comando wdsutil remove-imagegroup
comando wdsutil set-imagegroup
wdsutil get-multicasttransmission
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe as informações sobre a transmissão multicast de uma imagem especificada.

Syntax
Windows Server 2008

wdsutil [Options] /Get-MulticastTransmissiomedia:<Image name> [/Server:


<Server name>mediatype:InstallmediaGroup:<Image group name>]
[/Filename:<File name>] [/Show:Clients]

Windows Server 2008 R2

para transmissões de imagem de inicialização:

wdsutil [Options] /Get-MulticastTransmissiomedia:<Image name>


[/Server:<Server name>]
[/details:Clients]
mediatype:Boot
/Architecture:{x86 | ia64 | x64}
[/Filename:<File name>]

para transmissões de imagem de instalação:

wdsutil [Options] /Get-MulticastTransmissiomedia:<Image name>


[/Server:<Server name>]
[/details:Clients]
mediatype:Install
mediaGroup:<Image Group>]
[/Filename:<File name>]

Parâmetros
Parâmetro Descrição

media:<Image Exibe a transmissão multicast associada a essa imagem.


name>

[/Server:<Server Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome
name>] de domínio totalmente qualificado). Se nenhum nome do servidor for
especificado, o servidor local será usado.

/imagetype:Install Especifica o tipo de imagem. Observe que essa opção deve ser definida como
Install.

/imagegroup: Especifica o grupo de imagens que contém a imagem. Se nenhum nome do


<Image group grupo de imagens for especificado e apenas um grupo existir no servidor,
name>] esse grupo será usado. Se houver mais de um grupo de imagens no servidor,
você deverá usar essa opção para especificar um grupo de imagens.

/Architecture:{x86 Especifica a arquitetura da imagem de inicialização associada à transmissão.


| ia64 | x64} Como é possível ter o mesmo nome de imagem para as imagens de
inicialização em arquiteturas diferentes, você deve especificar a arquitetura
para garantir que a imagem correta seja usada.

[/Filename:<File Especifica o arquivo que contém a imagem. Se a imagem não puder ser
name>] identificada exclusivamente pelo nome, você deverá usar essa opção para
especificar o nome de arquivo.

[/Show:Clients] Exibe as informações sobre os computadores cliente conectados à


ou transmissão multicast.

[/details:Clients]

Exemplos
Windows Server 2008

Para exibir as informações sobre a transmissão de uma imagem chamada Vista com o
Office, digite uma das seguintes opções:

wdsutil /Get-MulticastTransmission:Vista with Office imagetype:Install


wdsutil /Get-MulticastTransmission /Server:MyWDSServer image:Vista with
Office imagetype:Install imageGroup:ImageGroup1 /Filename:install.wim
/Show:Clients

Windows Server 2008 R2


Para exibir as informações sobre a transmissão de uma imagem chamada Vista com o
Office, digite uma das seguintes opções:

wdsutil /Get-MulticastTransmission:Vista with Office


/Imagetype:Install

wdsutil /Get-MulticastTransmission /Server:MyWDSServer image:Vista with


Office imagetype:Install ImageGroup:ImageGroup1 /Filename:install.wim
/details:Clients

wdsutil /Get-MulticastTransmission /Server:MyWDSServer:X64 Boot


Imagetype:Boot /Architecture:x64 /Filename:boot.wim /details:Clients

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil get-allmulticasttransmissions
comando wdsutil new-multicasttransmission
comando wdsutil remove-multicasttransmission
comando wdsutil start-multicasttransmission
wdsutil get-namespace
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe informações sobre um namespace personalizado.

Syntax
Windows Server 2008 R2

wdsutil /Get-Namespace /Namespace:<Namespace name> [/Server:<Server name>]


[/Show:Clients]

Windows Server 2008 R2

wdsutil /Get-Namespace /Namespace:<Namespace name> [/Server:<Server name>]


[/details:Clients]

Parâmetros

Parâmetro Descrição

/Namespace: Especifica o nome do namespace. Observe que não é o nome amigável e deve
<nome do ser exclusivo.
Namespace> – Servidor de Implantação: a sintaxe para o nome do namespace é
/Namspace:WDS:<ImageGroup>/<ImageName>/<Index>. Por exemplo:
WDS:ImageGroup1/install.wim/1
– Servidor de Transporte: esse valor deve corresponder ao nome fornecido ao
namespace quando ele foi criado no servidor.

[/Server:<Nome Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
do servidor>] domínio totalmente qualificado). Se nenhum nome do servidor for
especificado, o servidor local será usado.
Parâmetro Descrição

[/Show:Clients] Exibe informações sobre os computadores cliente conectados ao namespace


ou especificado.
[/details:Clients]

Exemplos
Para exibir informações sobre um namespace, digite:

wdsutil /Get-Namespace /Namespace:Custom Auto 1

Para exibir informações sobre um namespace e os clientes conectados, digite um dos


seguintes:

Windows Server 2008: wdsutil /Get-Namespace /Server:MyWDSServer


/Namespace:Custom Auto 1 /Show:Clients

Windows Server 2008 R2: wdsutil /Get-Namespace /Server:MyWDSServer


/Namespace:Custom Auto 1 /details:Clients

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil get-allnamespaces
comando wdsutil new-namespace
comando wdsutil remove-namespace
comando wdsutil start-namespace
wdsutil get-server
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Recupera informações do servidor dos Serviços de Implantação do Windows


especificado.

Sintaxe

wdsutil [Options] /Get-Server [/Server:<Server name>] /Show:{Config | Images


| All} [/detailed]

Parâmetros

Parâmetro Descrição

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<nome do domínio totalmente qualificado). Se nenhum nome do servidor for especificado, o
servidor>] servidor local será usado.

/Show: Especifica o tipo de informação a ser retornada.


{Config | - Config retorna informações de configuração.
Images | - Images retorna informações sobre grupos de imagens, imagens de inicialização e
All} imagens de instalação.
- All retorna informações de configuração e informações de imagem.

[/detailed] Você pode usar essa opção com /Show:Images ou /Show:All para indicar que todos
os metadados de imagem de cada imagem devem ser retornados. Se essa opção
/detailed não for usada, o comportamento padrão será retornar o nome da
imagem, a descrição e o nome do arquivo.

Exemplos
Para exibir informações sobre o servidor, digite:

wdsutil /Get-Server /Show:Config


Para exibir informações detalhadas sobre o servidor, digite:

wdsutil /verbose /Get-Server /Server:MyWDSServer /Show:All /detailed

Links relacionados
Chave da sintaxe de linha de comando
Comando wdsutil disable-server
Comando wdsutil enable-server
Comando wdsutil initialize-server
Comando wdsutil set-server
Comando wdsutil start-server
Comando wdsutil stop-server
Comando wdsutil uninitialize-server
wdsutil get-transportserver
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exibe informações sobre um Servidor de Transporte especificado.

Sintaxe

wdsutil [Options] /Get-TransportServer [/Server:<Server name>] /Show:


{Config}

Parâmetros

Parâmetro Descrição

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<Nome do domínio totalmente qualificado). Se nenhum nome do servidor for especificado, o
servidor>] servidor local será usado.

/Show: Retorna informações de configuração sobre o Servidor de Transporte especificado.


{Config}

Exemplos
Para exibir informações sobre o servidor, digite:

wdsutil /Get-TransportServer /Show:Config

Para exibir informações de configuração, digite:

wdsutil /Get-TransportServer /Server:MyWDSServer /Show:Config


Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil disable-transportserver
comando wdsutil enable-transportserver
comando wdsutil set-transportserver
comando wdsutil start-transportserver
comando wdsutil stop-transportserver
wdsutil initialize-server
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Configura um servidor dos Serviços de Implantação do Windows para uso inicial após a
instalação da função de servidor. Depois de executar esse comando, use o comando
wdsutil add-Image para adicionar imagens ao servidor.

Sintaxe

wdsutil /Initialize-Server [/Server:<Server name>] /remInst:<Full path>


[/Authorize]

Parâmetros

Parâmetro Descrição

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<Nome do domínio totalmente qualificado). Se nenhum nome do servidor for especificado, o
servidor>] servidor local será usado.

/remInst: Especifica o caminho completo e o nome da pasta remoteInstall. Se a pasta


<Caminho especificada ainda não existir, essa opção a criará quando o comando for
completo> executado. Sempre insira um caminho local, mesmo no caso de um computador
remoto. Por exemplo: D:\remoteInstall.

[/Authorize] Autoriza o servidor no DHCP (Dynamic Host Control Protocol). Essa opção será
necessária apenas se a detecção de invasor DHCP estiver habilitada, ou seja, o
servidor PXE dos Serviços de Implantação do Windows precisa ser autorizado no
DHCP antes que os computadores cliente possam ser atendidos. Observe que a
detecção de invasor DHCP está desabilitada por padrão.

Exemplos
Para inicializar o servidor e definir a pasta compartilhada remoteInstall como a unidade
F:, digite.
wdsutil /Initialize-Server /remInst:F:\remoteInstall

Para inicializar o servidor e definir a pasta compartilhada remoteInstall como a unidade


C:, digite.

wdsutil /verbose /Progress /Initialize-Server /Server:MyWDSServer


/remInst:C:\remoteInstall

Links relacionados
Chave da sintaxe de linha de comando
Comando wdsutil disable-server
Comando wdsutil enable-server
Comando wdsutil get-server
Comando wdsutil set-server
Comando wdsutil start-server
Comando wdsutil stop-server
Comando wdsutil uninitialize-server
wdsutil new
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria imagens de captura e descoberta, transmissões multicast e namespaces.

Subcomandos
Subcomando Descrição

comando wdsutil new- cria uma nova imagem de captura a partir de uma imagem de
captureimage inicialização existente.

comando wdsutil new- cria uma nova imagem de descoberta a partir de uma imagem
discoverimage de inicialização existente.

comando wdsutil new- cria uma nova transmissão multicast.


multicasttransmission

comando wdsutil new- cria um novo namespace.


namespace
new-CaptureImage
Artigo • 12/04/2023

Cria uma nova imagem de captura a partir de uma imagem de inicialização existente. As
imagens de captura são imagens de inicialização que iniciam o utilitário de captura dos
Serviços de Implantação do Windows, em vez de iniciar a Configuração. Quando você
inicializa um computador de referência (que foi preparado com o Sysprep) em uma
imagem de captura, o assistente cria uma imagem de instalação do computador de
referência e a salva como um arquivo de Imagem do Windows (.wim). Você também
pode adicionar a imagem à mídia (como um CD, DVD ou unidade USB) e, em seguida,
inicializar um computador a partir dessa mídia. Depois de criar a imagem de instalação,
você pode adicionar a imagem ao servidor para implantação de inicialização PXE. Para
obter mais informações, confira Como criar imagens (https://go.microsoft.com/fwlink/?
LinkId=115311).

Sintaxe

wdsutil [Options] /New-CaptureImage [/Server:<Server name>]


/Image:<Image name>
/Architecture:{x86 | ia64 | x64}
[/Filename:<File name>]
/DestinationImage
/FilePath:<File path and name>
[/Name:<Name>]
[/Description:<Description>]
[/Overwrite:{Yes | No | Append}]
[/UnattendFilePath:<File path>]

Parâmetros

Parâmetro Descrição

[/Server:<Server Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome
name>] de domínio totalmente qualificado). Se nenhum nome do servidor for
especificado, o servidor local será usado.

/Image:<Image Especifica o nome da imagem de inicialização de origem.


name>

/Architecture: {x86 ia64


Parâmetro Descrição

[/Filename: Se a imagem não puder ser identificada exclusivamente pelo nome, você
<Filename>] deverá usar essa opção para especificar o nome de arquivo.

/DestinationImage Especifica as configurações da imagem de destino. Você especificará as


configurações usando as seguintes opções:
- /FilePath: <Caminho e nome do arquivo> Define o caminho completo do
arquivo para a nova imagem de captura.
- [/Name: <Name>]- Define o nome de exibição da imagem. Se nenhum
nome de exibição for especificado, o nome de exibição da imagem de
origem será usado.
- [/Description: <Description>] - Define a descrição da imagem.
- [/Overwrite: {Yes

Exemplos
Para criar uma imagem de captura e chamá-la de WinPECapture.wim, digite:

wdsutil /New-CaptureImage /Image:WinPE boot image /Architecture:x86


/DestinationImage /FilePath:C:\Temp\WinPECapture.wim

Para criar uma imagem de captura e aplicar as configurações especificadas, digite:

wdsutil /Verbose /Progress /New-CaptureImage /Server:MyWDSServer


/Image:WinPE boot image /Architecture:x64 /Filename:boot.wim
/DestinationImage /FilePath:\\Server\Share\WinPECapture.wim /Name:New WinPE
image /Description:WinPE image with capture utility /Overwrite:No
/UnattendFilePath:\\Server\Share\WDSCapture.inf

Links relacionados
Chave da sintaxe de linha de comando
new-DiscoverImage
Artigo • 12/04/2023

Cria uma nova imagem de descoberta a partir de uma imagem de inicialização existente.
As imagens de descoberta são imagens de inicialização que forçam o programa
Setup.exe a iniciar no modo Serviços de Implantação do Windows e, em seguida,
descobrir um servidor dos Serviços de Implantação do Windows. Normalmente, essas
imagens são usadas para implantar imagens em computadores que não podem
inicializar no PXE. Para obter mais informações, confira Como criar imagens
(https://go.microsoft.com/fwlink/?LinkId=115311).

Sintaxe

wdsutil [Options] /New-DiscoverImage [/Server:<Server name>]


/Image:<Image name>
/Architecture:{x86 | ia64 | x64}
[/Filename:<File name>]
/DestinationImage
/FilePath:<File path and name>
[/Name:<Name>]
[/Description:<Description>]
[/WDSServer:<Server name>]
[/Overwrite:{Yes | No | Append}]

Parâmetros

Parâmetro Descrição

[/Server:<Server Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome
name>] de domínio totalmente qualificado). Se nenhum nome do servidor for
especificado, o servidor local será usado.

/Image:<Image Especifica o nome da imagem de inicialização de origem.


name>

/Architecture:{x86 ia64

[/Filename:<File Se a imagem não puder ser identificada exclusivamente pelo nome, você
name>] deverá usar essa opção para especificar o nome de arquivo.
Parâmetro Descrição

/DestinationImage Especifica as configurações da imagem de destino. Você pode especificar as


configurações usando as seguintes opções:
- /FilePath: <Caminho e nome do arquivo> - Define o caminho completo do
arquivo para a nova imagem.
- [/Name:<Name>]- Define o nome de exibição da imagem. Se nenhum
nome de exibição for especificado, o nome de exibição da imagem de
origem será usado.
- [/Description: <Description>] - Define a descrição da imagem.
- [/WDSServer: <Server name>] - Especifica o nome do servidor com que
todos os clientes que inicializam da imagem especificada devem entrar em
contato para baixar a imagem de instalação. Por padrão, todos os clientes
que inicializarem essa imagem descobrirão um servidor válido dos Serviços
de Implantação do Windows. Usar essa opção ignora a funcionalidade de
descoberta e força o cliente inicializado a entrar em contato com o servidor
especificado.
- [/Overwrite:{Yes

Exemplos
Para criar uma imagem de descoberta a partir da imagem de inicialização e chamá-la de
WinPEDiscover.wim, digite:

wdsutil /New-DiscoverImage /Image:WinPE boot image /Architecture:x86


/DestinationImage /FilePath:C:\Temp\WinPEDiscover.wim

Para criar uma imagem de descoberta a partir da imagem de inicialização e chamá-la de


WinPEDiscover.wim com as configurações especificadas, digite:

wdsutil /Verbose /Progress /New-DiscoverImage /Server:MyWDSServer


/Image:WinPE boot image /Architecture:x64 /Filename:boot.wim
/DestinationImage /FilePath:\\Server\Share\WinPEDiscover.wim
/Name:New WinPE image /Description:WinPE image for WDS Client discovery
/Overwrite:No

Links relacionados
Chave da sintaxe de linha de comando
wdsutil new-multicasttransmission
Artigo • 10/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria uma transmissão multicast para uma imagem. Esse comando é equivalente à
criação de uma transmissão usando o suplemento mmc dos Serviços de Implantação do
Windows (clique com o botão direito do mouse no nó Transmissões Multicast e clique
em Criar Transmissão Multicast). Use esse comando quando você tiver o serviço de
função Servidor de Implantação e o serviço de função Servidor de Transporte instalados
(que é a instalação padrão). Se você tiver apenas o serviço de função Servidor de
Transporte instalado, use o comando wdsutilnew-Namespace.

Syntax
Para transmissões de imagens de instalação:

wdsutil [Options] /New-MulticastTransmissiomedia:<Image name>


[/Server:<Server name>]
/FriendlyName:<Friendly name>
[/Description:<Description>]
/Transmissiontype: {AutoCast | ScheduledCast}
[/time:<YYYY/MM/DD:hh:mm>]
[/Clients:<Num of Clients>]
imagetype:Install
ImageGroup:<Image Group>]
[/Filename:<File name>]

Para transmissões de imagem de inicialização (com suporte apenas para o Windows


Server 2008 R2):

wdsutil [Options] /New-MulticastTransmissiomedia:<Image name>


[/Server:<Server name>]
/FriendlyName:<Friendly name>
[/Description:<Description>]
/Transmissiontype: {AutoCast | ScheduledCast}
[/time:<YYYY/MM/DD:hh:mm>]
[/Clients:<Num of Clients>]
imagetype:Boot
/Architecture:{x86 | ia64 | x64}
[/Filename:<File name>]

Parâmetros

Parâmetro Descrição

/image:<nome da Especifica o nome da imagem a ser transmitida usando multicasting.


imagem>

[/Server:<nome Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome
do servidor>] de domínio totalmente qualificado). Se nenhum nome do servidor for
especificado, o servidor local será usado.

/FriendlyName: Especifica o nome amigável da transmissão.


<nome amigável>

[/Description: Especifica a descrição da transmissão.


<descrição>]

/imagetype: Especifica o tipo da imagem a ser transmitida usando multicasting.


{Boot|Install} Observação Boot é compatível apenas com o Windows Server 2008 R2.

/ImageGroup: Especifica o grupo de imagens que contém a imagem. Se nenhum nome do


<nome do grupo grupo de imagens for especificado e apenas um grupo existir no servidor,
de imagens>] esse grupo será usado. Se houver mais de um grupo de imagens no
servidor, você deverá usar essa opção para especificar o nome do grupo de
imagens.

[/Filename:<nome especifica o nome do arquivo. Se a imagem não puder ser identificada


de arquivo>] exclusivamente pelo nome, você deverá usar essa opção para especificar o
nome de arquivo.
Parâmetro Descrição

/Transmissiontype: Especifica se a transmissão será iniciada automaticamente (AutoCast) ou


{AutoCast | com base nos critérios de início especificados (ScheduledCast).
ScheduledCast}
Auto-Cast. Esse tipo de transmissão indica que assim que um cliente
aplicável solicita uma imagem de instalação, uma transmissão
multicast da imagem selecionada começa. À medida que outros
clientes solicitam a mesma imagem, eles são adicionados à
transmissão que já foi iniciada.
Scheduled-Cast. Esse tipo de transmissão define os critérios de início
para a transmissão com base no número de clientes que estão
solicitando uma imagem e/ou um dia e hora específicos. Você pode
especificar as seguintes opções:

[/time: <hora>] – define a hora em que a transmissão deve


começar usando o seguinte formato: AAAA/MM/DD:hh:mm.
[/Clients: <número de clientes>] – define o número mínimo de
clientes a aguardar antes do início da transmissão.

/Architecture:{x86 Especifica a arquitetura da imagem de inicialização a ser transmitida usando


| ia64 | x64} multicasting. Como é possível ter o mesmo nome para as imagens de
inicialização em arquiteturas diferentes, você deve especificar a arquitetura
para garantir que a imagem correta seja usada.

[/Filename:<nome especifica o nome do arquivo. Se a imagem não puder ser identificada


de arquivo>] exclusivamente pelo nome, você precisará especificar o nome de arquivo.

Exemplos
Para criar uma transmissão do tipo Auto-Cast de uma imagem de inicialização no
Windows Server 2008 R2, digite:

wdsutil /New-MulticastTransmission /FriendlyName:WDS Boot Transmission


/Image:X64 Boot imagetype:Boot /Architecture:x64 /Transmissiontype:AutoCast

Para criar uma transmissão do tipo Auto-Cast de uma imagem de instalação, digite:

wdsutil /New-MulticastTransmission /FriendlyName:WDS AutoCast Transmission


/Image:Vista with Officeimage imagetype:Install /Transmissiontype:AutoCast
Para criar uma transmissão do tipo Scheduled-Cast de uma imagem de instalação,
digite:

wdsutil /New-MulticastTransmission /FriendlyName:WDS SchedCast Transmission


/Server:MyWDSServer Image:Vista with Office imagetype:Install
/Transmissiontype:ScheduledCast /time:2006/11/20:17:00 /Clients:100

Links relacionados
Chave da sintaxe de linha de comando
Comando wdsutil get-allmulticasttransmissions
Comando wdsutil get-multicasttransmission
Comando wdsutil remove-multicasttransmission
Comando wdsutil start-multicasttransmission
wdsutil new-namespace
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Cria e configura um novo namespace. Você deve usar essa opção quando tiver apenas o
serviço de função servidor de transporte instalado. Se você tiver o serviço de função
servidor de implantação e o serviço de função servidor de transporte instalado (que é o
padrão), use o comando wdsutilnew-MulticastTransmission. Observe que você deve
registrar o provedor de conteúdo, antes de usar essa opção.

Sintaxe

wdsutil [Options] /New-Namespace [/Server:<Server name>]


/FriendlyName:<Friendly name>
[/Description:<Description>]
/Namespace:<Namespace name>
/ContentProvider:<Name>
[/ConfigString:<Configuration string>]
/Namespacetype: {AutoCast | ScheduledCast}
[/time:<YYYY/MM/DD:hh:mm>]
[/Clients:<Number of clients>]

Parâmetros

Parâmetro Descrição

[/Server:<Server Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome
name>] de domínio totalmente qualificado). Se nenhum nome do servidor for
especificado, o servidor local será usado.

/FriendlyName: Especifica o nome amigável do namespace.


<Friendly name>

[/Description: Especifica a descrição do namespace.


<Description>]
Parâmetro Descrição

/Namespace: Especifica o nome do namespace. Observe que não é o nome amigável e


<Namespace deve ser exclusivo.
name> - Serviço de função do Servidor de Implantação: a sintaxe dessa opção é
/Namespace:WDS:<Image group>/<Image name>/<Index>. Por exemplo:
WDS:ImageGroup1/install.wim/1
- Serviço de função do Servidor de Transporte: esse valor deve corresponder
ao nome fornecido quando o namespace foi criado no servidor.

/ContentProvider: Especifica o nome do provedor de conteúdo que fornecerá conteúdo para o


<Name>] namespace.

[/ConfigString: Especifica a cadeia de caracteres de configuração do provedor de conteúdo.


<Configuration
string>]

/Namespacetype: Especifica as configurações da transmissão. Você especificará as


{AutoCast | configurações usando as seguintes opções:
ScheduledCast} - [/time: <time>] – Define a hora em que a transmissão deve começar usando
o seguinte formato: YYYYY/MM/DD:hh:mm. Essa opção se aplica somente a
transmissões de Scheduled-Cast.
- [/Clients: <Number of clients>] – Define o número mínimo de clientes a ser
aguardado, antes do início da transmissão. Essa opção se aplica somente a
transmissões de Scheduled-Cast.

Exemplos
Para criar um namespace de Conversão Automática, digite:

wdsutil /New-Namespace /FriendlyName:Custom AutoCast Namespace


/Namespace:Custom Auto 1 /ContentProvider:MyContentProvider
/Namespacetype:AutoCast

Para criar um namespace Scheduled-Cast, digite:

wdsutil /New-Namespace /Server:MyWDSServer /FriendlyName:Custom Scheduled


Namespace /Namespace:Custom Auto 1 /ContentProvider:MyContentProvider
/Namespacetype:ScheduledCast /time:2006/11/20:17:00 /Clients:20

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil get-allnamespaces
comando wdsutil remove-namespace
comando wdsutil start-namespace
wdsutil /progress
Artigo • 12/04/2023

Exibe o progresso enquanto um comando está em execução. Você pode usar /progress
com quaisquer outros comandos wdsutil. Se você quiser ativar o log detalhado para
esse comando, especifique /verbose e /progress diretamente depois de wdsutil.

Sintaxe

wdsutil /progress <commands>

Exemplos
Para inicializar o servidor e exibir o progresso, digite:

wdsutil /verbose /progress /Initialize-Server /Server:MyWDSServer


/RemInst:C:\RemoteInstall

Links relacionados
Chave da sintaxe de linha de comando
wdsutil reject-autoadddevices
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Rejeita os computadores com aprovação administrativa pendente. Quando a política de


adição automática está habilitada, é necessária a aprovação administrativa para que
computadores desconhecidos (os que não foram pré-testados) possam instalar uma
imagem. Você pode habilitar essa política usando a guia Resposta PXE da página de
propriedades do servidor.

Sintaxe

wdsutil [Options] /Reject-AutoaddDevices [/Server:<Server name>] /RequestId:


<Request ID or ALL>

Parâmetros

Parâmetro Descrição

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<Server domínio totalmente qualificado). Se nenhum nome do servidor for especificado, o
name>] servidor local será usado.

/RequestId: Especifica a ID de solicitação atribuída ao computador pendente. Para rejeitar


<Request todos os computadores pendentes, especifique ALL.
ID | ALL>

Exemplos
Para rejeitar um único computador, digite:

wdsutil /Reject-AutoaddDevices /RequestId:12

Para rejeitar todos os computadores, digite:


wdsutil /verbose /Reject-AutoaddDevices /Server:MyWDSServer /RequestId:ALL

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil approve-autoadddevices
comando wdsutil delete-autoadddevices
comando wdsutil get-autoadddevices
wdsutil remove
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Subcomandos
Subcomando Descrição

comando wdsutil remove-image Remove uma imagem de inicialização ou instalação do


servidor.

comando wdsutil remove-imagegroup Remove um grupo de imagens do servidor.

Comando wdsutil remove- Desabilita a transmissão multicast de uma imagem.


multicasttransmission

comando wdsutil remove-namespace Remove um namespace do servidor.

comando wdsutil remove- Remove um pacote de drivers de um grupo de drivers


drivergrouppackage em um servidor.

wdsutil remove-drivergrouppackages Remove os pacotes de drivers de um grupo de drivers


em um servidor.

comando wdsutil remove- Remove um pacote de drivers de um servidor.


driverpackage

comando wdsutil remove- Remove pacotes de drivers de um servidor.


driverpackages

comando wdsutil remove-drivergroup Remove um grupo de drivers de um servidor.

comando wdsutil remove-drivergroup Remove uma regra de filtro de um grupo de drivers em


um servidor.
remove-DriverGroup
Artigo • 12/04/2023

Remove um grupo de drivers de um servidor.

Sintaxe

wdsutil /Remove-DriverGroup /DriverGroup:<Group Name> [/Server:<Server


name>]

Parâmetros

Parâmetro Descrição

/DriverGroup: Especifica o nome do grupo de drivers a ser removido.


<Group
Name>

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou FQDN. Se um


<Server nome do servidor não for especificado, o servidor local será usado.
name>]

Exemplos
Para remover um grupo de drivers, digite uma das seguintes opções:

wdsutil /Remove-DriverGroup /DriverGroup:PrinterDrivers

wdsutil /Remove-DriverGroup /DriverGroup:PrinterDrivers /Server:MyWdsServer

Links relacionados
Chave da sintaxe de linha de comando
remove-DriverGroupFilter
Artigo • 12/04/2023

Remove uma regra de filtro de um grupo de drivers em um servidor.

Sintaxe

wdsutil /Remove-DriverGroupFilter /DriverGroup:<Group Name> [/Server:<Server


name>] /FilterType:<Filter Type>

Parâmetros

Parâmetro Descrição

/DriverGroup: Especifica o nome do grupo de drivers.


<Group
Name>

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou FQDN. Se um


<Server nome do servidor não for especificado, o servidor local será usado.
name>]

[/FilterType: Especifica o tipo do filtro a ser removido do grupo. <FilterType> pode ser uma
<FilterType>] das seguintes opções:
BiosVendor
BiosVersion
ChassisType
Manufacturer
Uuid
OsVersion
OsEdition
OsLanguage

Exemplos
Para remover um filtro, digite uma das seguintes opções:

wdsutil /Remove-DriverGroupFilter /DriverGroup:PrinterDrivers


/FilterType:Manufacturer
wdsutil /Remove-DriverGroupFilter /DriverGroup:PrinterDrivers
/FilterType:Manufacturer /FilterType:OSLanguage

Links relacionados
Chave da sintaxe de linha de comando
remove-DriverGroupPackage
Artigo • 17/04/2023

Remove um pacote de drivers de um grupo de drivers em um servidor.

Sintaxe

wdsutil /Remove-DriverGroupPackage /DriverGroup:<Group Name> [/Server:


<Server Name>] {/DriverPackage:<Name> | /PackageId:<ID>}

Parâmetros

Parâmetro Descrição

[/Server:<nome Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN. Se um


do servidor>] nome do servidor não for especificado, o servidor local será usado.

[/DriverPackage: Especifica o nome do pacote de drivers a ser removido.


<Name>]

[/PackageId: Especifica a ID dos Serviços de Implantação do Windows do pacote de drivers


<ID>] a ser removido. Você deverá especificar essa opção se o pacote de driver não
puder ser identificado exclusivamente pelo nome.

Exemplos

wdsutil /Remove-DriverGroupPackage /DriverGroup:PrinterDrivers /PackageId:


{4D36E972-E325-11CE-BFC1-08002BE10318}

wdsutil /Remove-DriverGroupPackage /DriverGroup:PrinterDrivers


/DriverPackage:XYZ

Links relacionados
Chave da sintaxe de linha de comando
wdsutil remove-drivergrouppackages
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Remove os pacotes de drivers de um grupo de drivers em um servidor.

Sintaxe

wdsutil /remove-DriverGroupPackages /DriverGroup:<Group Name> [/Server:


<Server Name>] /Filtertype:<Filter type> /Operator:{Equal | NotEqual |
GreaterOrEqual | LessOrEqual | Contains} /Value:<Value> [/Value:<Value> ...]

Parâmetros

Parâmetro Descrição

/DriverGroup: Especifica o nome do grupo de drivers.


<Group
Name>

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou FQDN. Se um


<Server nome do servidor não for especificado, o servidor local será usado.
name>]
Parâmetro Descrição

/Filtertype: Especifica o atributo do pacote de drivers a ser procurado. Você pode


<Filter type> especificar vários atributos em um único comando. Você também deve
especificar /Operator e /Value com essa opção.

O <tipo de filtro> pode ser um destes:

PackageId

PackageName

PackageEnabled

Packagedateadded

PackageInfFilename

PackageClass

PackageProvider

PackageArchitecture

PackageLocale

PackageSigned

PackagedatePublished

Packageversion

Driverdescription

DriverManufacturer

DriverHardwareId

DrivercompatibleId

DriverExcludeId

DriverGroupId

DriverGroupName

/Operator: Especifica a relação entre o atributo e os valores. Você só pode especificar


{Equal | Contains com os atributos de cadeia de caracteres. Você só pode especificar
NotEqual | GreaterOrEqual e LessOrEqual com os atributos de data e versão.
GreaterOrEqual
| LessOrEqual |
Contains}
Parâmetro Descrição

/Value:<Value> Especifica o valor para procurar o <atributo> especificado. Você pode


especificar vários valores para um único /Filtertype. A lista a seguir descreve os
atributos que você pode especificar para cada filtro. Para obter mais
informações sobre esses atributos, confira Atributos de driver e pacote
(https://go.microsoft.com/fwlink/?LinkId=166895 ).

- PackageId – Especifique um GUID válido. Por exemplo: {4d36e972-e325-11ce-


bfc1-08002be10318}.
- PackageName – Especifique qualquer valor de cadeia de caracteres.
- PackageEnabled – Especifique Sim ou Não.
- Packagedateadded – Especifique a data no seguinte formato: YYYY/MM/DD
- PackageInfFilename Especifique qualquer valor de cadeia de caracteres.
- PackageClass – Especifique um GUID de classe ou nome de classe válido. Por
exemplo: DiskDrive, Net ou {4d36e972-e325-11ce-bfc1-08002be10318}.
- PackageProvider Especifique qualquer valor de cadeia de caracteres.
- PackageArchitecture – Especifique x86, x64 ou ia64.
- PckageLocale – Especifique um identificador de idioma válido. Por exemplo:
en-US ou es-ES.
- PackageSigned – Especifique Sim ou Não.
- PackagedatePublished – Especifique a data no seguinte formato:
YYYY/MM/DD
- Packageversion – Especifique a versão no seguinte formato: a.b.x.y. Por
exemplo: 6.1.0.0
- Driverdescription Especifique qualquer valor de cadeia de caracteres.
- DriverManufacturer Especifique qualquer valor de cadeia de caracteres.
- DriverHardwareId – Especifique qualquer valor de cadeia de caracteres.
- DrivercompatibleId – Especifique qualquer valor de cadeia de caracteres.
- DriverExcludeId – Especifique qualquer valor de cadeia de caracteres.
- DriverGroupId – Especifique um GUID válido. Por exemplo: {4d36e972-e325-
11ce-bfc1-08002be10318}.
- DriverGroupName Especifique qualquer valor de cadeia de caracteres.

Exemplos
Para remover os pacotes de drivers de um grupo de drivers, digite uma das seguintes
opções:

wdsutil /verbose /remove-DriverGroupPackages /DriverGroup:printerdrivers


/Filtertype:DriverManufacturer /Operator:NotEqual /Value:Name1 /Value:Name2
wdsutil /verbose /remove-DriverGroupPackages /DriverGroup:DisplayDrivers
/Filtertype:PackageArchitecture /Operator:Equal /Value:x86
/Filtertype:Packagedateadded /Operator:LessOrEqual /Value:2008/01/01

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil remove-drivergrouppackage
wdsutil remove-driverpackage
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Remove um pacote de drivers de um servidor.

Sintaxe

wdsutil /remove-DriverPackage [/Server:<Server name>] {/DriverPackage:


<Package Name> | /PackageId:<ID>}

Parâmetros

Parâmetro Descrição

[/Server:<Server Especifica o nome do servidor. Pode ser o nome NetBIOS ou FQDN. Se um


name>] nome do servidor não for especificado, o servidor local será usado.

[/DriverPackage: Especifica o nome do pacote de drivers a ser removido.


<Name>]

[/PackageId: Especifica a ID dos Serviços de Implantação do Windows do pacote de drivers


<ID>] a ser removido. Você deverá especificar a ID, se não for possível especificar o
pacote de drivers exclusivamente pelo nome.

Exemplos
Para exibir as informações sobre as imagens, digite uma das seguintes opções:

wdsutil /remove-DriverPackage /PackageId:{4D36E972-E325-11CE-Bfc1-


08002BE10318}
wdsutil /remove-DriverPackage /Server:MyWdsServer
/DriverPackage:MyDriverPackage

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil remove-driverpackages
wdsutil remove-driverpackages
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Remove os pacotes de drivers do servidor.

Sintaxe

wdsutil /remove-DriverPackages [/Server:<Server name>] /Filtertype:<Filter


type> /Operator:{Equal | NotEqual | GreaterOrEqual | LessOrEqual | Contains}
/Value:<Value> [/Value:<Value> ...]

Parâmetros

Parâmetro Descrição

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou FQDN. Se um


<Server nome do servidor não for especificado, o servidor local será usado.
name>]
Parâmetro Descrição

/Filtertype: Especifica o atributo do pacote de drivers a ser procurado. Você pode


<Filter type> especificar vários atributos em um único comando. Você também deve
especificar /Operator e /Value com essa opção. O <tipo de filtro> pode ser um
destes:

PackageId
PackageName
PackageEnabled
Packagedateadded
PackageInfFilename
PackageClass
PackageProvider
PackageArchitecture
PackageLocale
PackageSigned
PackagedatePublished
Packageversion
Driverdescription
DriverManufacturer
DriverHardwareId
DrivercompatibleId
DriverExcludeId
DriverGroupId
DriverGroupName

/Operator: Especifica a relação entre o atributo e os valores. Você só pode especificar


{Equal | Contains com os atributos de cadeia de caracteres. Você só pode especificar
NotEqual | GreaterOrEqual e LessOrEqual com os atributos de data e versão.
GreaterOrEqual
| LessOrEqual |
Contains}
Parâmetro Descrição

/Value:<Value> Especifica o valor para procurar o <atributo> especificado. Você pode


especificar vários valores para um único /Filtertype. A lista a seguir descreve os
atributos que você pode especificar para cada filtro. Para obter mais
informações sobre esses atributos, confira Atributos de driver e pacote
(https://go.microsoft.com/fwlink/?LinkId=166895 ).

PackageId – Especifique um GUID válido. Por exemplo: {4d36e972-e325-


11ce-bfc1-08002be10318}.
PackageName – Especifique qualquer valor de cadeia de caracteres.
PackageEnabled – Especifique Sim ou Não.
Packagedateadded – Especifique a data no seguinte formato:
YYYY/MM/DD.
PackageInfFilename – Especifique qualquer valor de cadeia de caracteres.
PackageClass – Especifique um GUID de classe ou nome de classe válido.
Por exemplo: DiskDrive, Net ou {4d36e972-e325-11ce-bfc1-
08002be10318}.
PackageProvider – Especifique qualquer valor de cadeia de caracteres.
PackageArchitecture – Especifique x86, x64 ou ia64.
PckageLocale – Especifique um identificador de idioma válido. Por
exemplo: en-US ou es-ES.
PackageSigned – Especifique Sim ou Não.
PackagedatePublished – Especifique a data no seguinte formato:
YYYY/MM/DD.
Packageversion – Especifique a versão no seguinte formato: a.b.x.y. Por
exemplo: 6.1.0.0.
Driverdescription – Especifique qualquer valor de cadeia de caracteres.
DriverManufacturer – Especifique qualquer valor de cadeia de caracteres.
DriverHardwareId – Especifique qualquer valor de cadeia de caracteres.
DrivercompatibleId – Especifique qualquer valor de cadeia de caracteres.
DriverExcludeId – Especifique qualquer valor de cadeia de caracteres.
DriverGroupId – Especifique um GUID válido. Por exemplo: {4d36e972-
e325-11ce-bfc1-08002be10318}.
DriverGroupName – Especifique qualquer valor de cadeia de caracteres.

Exemplos
Para remover pacotes, digite uma das seguintes opções:

wdsutil /verbose /remove-DriverPackages /Server:MyWdsServer


/Filtertype:PackageProvider /Operator:Equal /Value:Name1 /Value:Name2
wdsutil /remove-DriverPackages /Filtertype:PackageArchitecture
/Operator:Equal
/Value:x86 /Value:x64 /Filtertype:PackageEnabled /Operator:Equal /Value:No

wdsutil /verbose /remove-DriverPackages /Server:MyWdsServer


/Filtertype:Packagedateadded /Operator:LessOrEqual /Value:2008/01/01

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil remove-driverpackage
wdsutil remove-image
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Exclui uma imagem de um servidor.

Syntax
para imagens de inicialização:

wdsutil [Options] /remove-Image:<Image name> [/Server:<Server name>


type:Boot /Architecture:{x86 | ia64 | x64} [/Filename:<Filename>]

para imagens de instalação:

wdsutil [Options] /remove-image:<Image name> [/Server:<Server name>


type:Install ImageGroup:<Image group name>] [/Filename:<Filename>]

Parâmetros

Parâmetro Descrição

/remove- Especifica o nome da imagem.


image:
<Nome da
imagem>

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<nome do domínio totalmente qualificado). Se nenhum nome do servidor for especificado,
servidor>] o servidor local será usado.

mediatype: Especifica o tipo de imagem.


{Boot | Install}

/Architecture: Especifica a arquitetura da imagem. Como é possível ter o mesmo nome de


{x86 | ia64 | imagem para as imagens de inicialização em arquiteturas diferentes, especificar o
x64} valor da arquitetura garante que a imagem correta retorne.
Parâmetro Descrição

\ImageGroup: Especifica o grupo de imagens que contém a imagem. Se nenhum nome do


<nome do grupo de imagens for especificado e apenas um grupo existir no servidor, esse
grupo de grupo será usado. Se houver mais de um grupo de imagens, você deverá usar
imagens>] essa opção para especificar o grupo de imagens.

[/Filename: se a imagem não puder ser identificada exclusivamente pelo nome, você deverá
<nome de usar essa opção para especificar o nome de arquivo.
arquivo>]

Exemplos
Para remover uma imagem de inicialização, digite:

wdsutil /remove-Imagmedia:WinPE Boot Imagemediatype:Boot /Architecture:x86

wdsutil /verbose /remove-Image:WinPE Boot Image /Server:MyWDSServer


type:Boot /Architecture:x64 /Filename:boot.wim

Para remover uma imagem de instalação, digite:

wdsutil /remove-Image:Windows Vista with Officemediatype:Install

wdsutil /verbose /remove-Image:Windows Vista with Office


/Server:MyWDSServemediatype:Instal ImageGroup:ImageGroup1
/Filename:install.wim

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil add-image
comando wdsutil copy-image
comando wdsutil export-image
comando wdsutil get-image
Comando wdsutil replace-image
comando wdsutil set-image
wdsutil remove-imagegroup
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Remove um grupo de imagens de um servidor.

Sintaxe

wdsutil [Options] /remove-ImageGroup Group:<Image group name> [/Server:


<Server name>]

Parâmetros

Parâmetro Descrição

imagegroup: Especifica o nome do grupo de imagens a ser removido


<Image
group name>

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<Server domínio totalmente qualificado). Se um nome do servidor não for especificado, o
name>] servidor local será usado.

Exemplos
Para remover o grupo de imagens, digite uma das seguintes opções:

wdsutil /remove-ImageGroumediaGroup:ImageGroup1
wdsutil /verbose /remove-ImageGroumediaGroup:My Image Group
/Server:MyWDSServer

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil add-imagegroup
comando wdsutil get-allimagegroups
comando wdsutil get-imagegroup
comando wdsutil set-imagegroup
wdsutil remove-multicasttransmission
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Desabilita a transmissão multicast para uma imagem. A menos que você especifique
/force, os clientes existentes concluirão a transferência de imagem, mas os novos
clientes não poderão ingressar.

Syntax
Windows Server 2008

wdsutil /remove-MulticastTransmission:<Image name> [/Server:<Server name>


mediatype:Install Group:<Image Group>] [/Filename:<File name>] [/force]

Windows Server 2008 R2 para imagens de inicialização:

wdsutil [Options] /remove-MulticastTransmissiomedia:<Image name>


\x20 [/Server:<Server name>]
\x20 mediatype:Boot
\x20 /Architecture:{x86 | ia64 | x64}
\x20 [/Filename:<File name>]

para imagens de instalação:

wdsutil [Options] /remove-MulticastTransmissiomedia:<Image name>


[/Server:<Server name>]
mediatype:Install
mediaGroup:<Image Group
[/Filename:<File name>]

Parâmetros
Parâmetro Descrição

media: Especifica o nome da imagem.


<Nome da
imagem>

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<Nome do domínio totalmente qualificado). Se nenhum nome do servidor for especificado,
servidor>] o servidor local será usado.

mediatype: Especifica o tipo de imagem. Observe que essa opção deve ser definida para
{Install|Boot} Instalar para o Windows Server 2008.

/Architecture: Especifica a arquitetura da imagem de inicialização associada à transmissão a ser


{x86 | ia64 | iniciada. Como é possível ter o mesmo nome de imagem para as imagens de
x64} inicialização em arquiteturas diferentes, você deve especificar a arquitetura para
garantir que a transmissão correta seja usada.

\mediaGroup: Especifica o grupo de imagens que contém a imagem. Se nenhum nome do


<Nome do grupo de imagens for especificado e apenas um grupo existir no servidor, esse
grupo de grupo será usado. Se houver mais de um grupo de imagens no servidor, você
imagens>] deverá usar essa opção para especificar o nome do grupo de imagens.

[/Filename: especifica o nome do arquivo. Se a imagem não puder ser identificada


<Nome de exclusivamente pelo nome, você deverá usar essa opção para especificar o nome
arquivo>] de arquivo.

[/force] remove a transmissão e encerra todos os clientes. A menos que você especifique
um valor para a opção /force, os clientes existentes poderão concluir a
transferência de imagem, mas os novos clientes não poderão ingressar.

Exemplos
Para interromper um namespace (os clientes atuais concluirão a transmissão, mas os
novos clientes não poderão ingressar), digite:

wdsutil /remove-MulticastTransmission:Vista with Office


/Imagetype:Install

wdsutil /remove-MulticastTransmission:x64 Boot Image


/Imagetype:Boot /Architecture:x64

Para forçar o encerramento de todos os clientes, digite:


wdsutil /remove-MulticastTransmission /Server:MyWDSServer
/Image:Vista with Officemediatype:InstalmediaGroup:ImageGroup1
/Filename:install.wim /force

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil get-allmulticasttransmissions
comando wdsutil get-multicasttransmission
comando wdsutil new-multicasttransmission
comando wdsutil start-multicasttransmission
wdsutil remove-namespace
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Remove um namespace personalizado.

Sintaxe

wdsutil /remove-Namespace /Namespace:<Namespace name> [/Server:<Server


name>] [/force]

Parâmetros

Parâmetro Descrição

/Namespace: Especifica o nome do namespace. Esse não é o nome amigável e deve ser
<Namespace exclusivo.
name> - Serviço de função do Servidor de Implantação: a sintaxe para o nome do
namespace é /Namespace:WDS:<ImageGroup>/<ImageName>/<Index>. Por
exemplo: WDS:ImageGroup1/install.wim/1
- Serviço de função do Servidor de Transporte: esse valor deve corresponder ao
nome fornecido ao namespace quando ele foi criado no servidor.

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<nome do domínio totalmente qualificado). Se nenhum nome do servidor for especificado, o
servidor>] servidor local será usado.

[/force] remove o namespace imediatamente e encerra todos os clientes. Observe que, a


menos que você especifique /force, os clientes existentes podem concluir a
transferência, mas novos clientes não podem ingressar.

Exemplos
Para interromper um namespace (os clientes atuais podem concluir a transferência, mas
novos clientes não podem ingressar), digite:
wdsutil /remove-Namespace /Namespace:Custom Auto 1

Para forçar o encerramento de todos os clientes, digite:

wdsutil /remove-Namespace /Server:MyWDSServer /Namespace:Custom Auto 1


/force

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil get-allnamespaces
comando wdsutil new-namespace
comando wdsutil start-namespace
wdsutil replace-image
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Substitui uma imagem existente por uma nova versão dessa imagem.

Syntax
para imagens de inicialização:

wdsutil [Options] /replace-Imagmedia:<Image name> [/Server:<Server name>]


mediatype:Boot
/Architecture:{x86 | ia64 | x64}
[/Filename:<File name>]
/replacementImage
mediaFile:<wim file path>
[/Name:<Image name>]
[/Description:<Image description>]

para imagens de instalação:

wdsutil [Options] /replace-Imagmedia:<Image name> [/Server:<Server name>]


mediatype:Install
mediaGroup:<Image group name>]
[/Filename:<File name>]
/replacementImage
mediaFile:<wim file path>
[/SourceImage:<Source image name>]
[/Name:<Image name>]
[/Description:<Image description>]

Parâmetros

Parâmetro Descrição

media:<Image Especifica o nome da imagem a ser adicionada.


name>
Parâmetro Descrição

[/Server:<nome do Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN


servidor>] (nome de domínio totalmente qualificado). Se nenhum nome do servidor
for especificado, o servidor local será usado.

mediatype:{Boot | Especifica o tipo da imagem a ser substituída.


Install}

/Architecture:{x86 | Especifica a arquitetura da imagem a ser substituída. Como é possível ter o


ia64 | x64} mesmo nome de imagem para as imagens de inicialização diferentes em
arquiteturas diferentes, especificar a arquitetura garante que a imagem
correta seja substituída.

[/Filename:<nome se a imagem não puder ser identificada exclusivamente pelo nome, você
de arquivo>] deverá usar essa opção para especificar o nome de arquivo.

/replacementImage Especifica as configurações para a imagem de substituição. Defina as


configurações usando as seguintes opções:
- mediaFile: <caminho do arquivo> - especifica o nome e o local (caminho
completo) do novo arquivo .wim.
- [/SourceImage: <nome da imagem>] - especifica a imagem a ser usada se
o arquivo .wim contiver várias imagens. Essa opção se aplica apenas às
imagens de instalação.
- [/Name:<Nome da imagem>] - define o nome de exibição da imagem.
- [/Description:<Descrição da imagem>] - define a descrição da imagem.

Exemplos
Para substituir uma imagem de inicialização, digite uma das seguintes opções:

wdsutil /replace-Imagmedia:WinPE Boot Imagemediatype:Boot /Architecture:x86


/replacementImagmediaFile:C:\MyFolder\Boot.wim
wdsutil /verbose /Progress /replace-Imagmedia:WinPE Boot Image
/Server:MyWDSServemediatype:Boot /Architecture:x64 /Filename:boot.wim
/replacementImagmediaFile:\\MyServer\Share\Boot.wim /Name:My WinPE Image
/Description:WinPE Image with drivers

Para substituir uma imagem de inicialização, digite uma das seguintes opções:

wdsutil /replace-Imagmedia:Windows Vista Homemediatype:Install


/replacementImagmediaFile:C:\MyFolder\Install.wim
wdsutil /verbose /Progress /replace-Imagmedia:Windows Vista Pro
/Server:MyWDSServemediatype:InstalmediaGroup:ImageGroup1
/Filename:Install.wim /replacementImagmediaFile:\\MyServer\Share
\Install.wim /SourceImage:Windows Vista Ultimate /Name:Windows Vista Desktop
/Description:Windows Vista Ultimate with standard business applications.

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil add-image
comando wdsutil copy-image
comando wdsutil export-image
comando wdsutil get-image
Comando wdsutil replace-image
comando wdsutil set-image
Usando o comando set
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Define propriedades e atributos para servidores dos Serviços de Implantação do


Windows, computadores preparados previamente, imagens, grupos de imagens e
Servidores de Transporte.

Subcomandos
Subcomando Descrição

Subcomando: altera os atributos de um computador preparado previamente. Um


set-Device computador preparado previamente é um computador que foi vinculado a
um objeto de conta do computador no AD DS (Active Directory Domain
Servers). Os clientes pré-testados são também chamados de computadores
conhecidos.

Subcomando: Muda os atributos de uma imagem existente.


set-Image

Subcomando: muda os atributos de um grupo de imagens existente.


set-ImageGroup

Subcomando: Define as configurações para um servidor dos Serviços de Implantação do


set-Server Windows.

Subcomando: Define as configurações de um Servidor de Transporte.


set-
TransportServer

Subcomando: renomeia e/ou habilita/desabilita um pacote de drivers em um servidor.


set-
DriverPackage

Subcomando: Define as propriedades de um grupo de drivers existente em um servidor.


set-DriverGroup

Subcomando: Adiciona ou remove um filtro de grupo de drivers existente de um grupo de


set- drivers.
DriverGroupFilter
wdsutil set device
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera os atributos de um computador preparado previamente. Um computador


preparado previamente é um computador que foi vinculado a um objeto de conta do
computador no AD DS (Active Directory Domain Servers). Os clientes pré-testados são
também chamados de computadores conhecidos. Você pode configurar propriedades
na conta do computador para controlar a instalação do cliente. Por exemplo, é possível
configurar um programa de inicialização de rede e o arquivo autônomo que o cliente
deve receber, além do servidor do qual o cliente deve baixar o programa de inicialização
da rede.

Sintaxe

wdsutil [Options] /Set-Device /Device:<Device name> [/ID:<UUID | MAC


address>] [/ReferralServer:<Server name>] [/BootProgram:<Relative path>]
[/WdsClientUnattend:<Relative path>] [/User:<Domain\User | User@Domain>]
[/JoinRights:{JoinOnly | Full}] [/JoinDomain:{Yes | No}] [/BootImagepath:
<Relative path>] [/Domain:<Domain>] [/resetAccount]

Parâmetros

Parâmetro Descrição

/Device:<nome do Especifica o nome do computador (SAM-Account-Name).


computador>

[/ID:<UUID | Especifica o GUID/UUID ou o endereço MAC do computador. Esse valor


endereço MAC>] deve estar em um dos três seguintes formatos:
- Cadeia de caracteres binária:
/ID:ACEFA3E81F20694E953EB2DAA1E8B1B6
- Cadeia de caracteres GUID/UUID: /ID:E8A3EFAC-201F-4E69-953E-
B2DAA1E8B1B6
- Endereço MAC: 00B056882FDC (sem traços) ou 00-B0-56-88-2F-DC
(com traços)
Parâmetro Descrição

[/ReferralServer: Especifica o nome do servidor a ser contatado para baixar o programa de


<Nome do inicialização de rede e a imagem de inicialização usando o tftp (Trivial File
servidor>] Transfer Protocol).

[/BootProgram: Especifica o caminho relativo da pasta remoteInstall para o programa de


<Caminho relativo>] inicialização de rede que o computador especificado receberá. Por
exemplo: boot\x86\pxeboot.com

[/WdsClientUnattend: Especifica o caminho relativo da pasta remoteInstall para o arquivo


<Caminho relativo>] unattend que automatiza as telas de instalação do cliente dos Serviços de
Implantação do Windows.

[/User:<Domain\User Define permissões no objeto de conta do computador para dar ao


| usuário especificado os direitos necessários para ingressar o computador
Usuário@Domínio>] no domínio.

[/JoinRights: Especifica o tipo de direitos a serem atribuídos ao usuário.


{JoinOnly | Full}] - JoinOnly – Exige que o administrador redefina a conta do computador
antes que o usuário possa ingressar o computador no domínio.
- Full dá acesso completo ao usuário, incluindo o direito de ingressar o
computador no domínio.

[/JoinDomain:{Yes | Especifica se o computador deve ou não ser ingressado no domínio como


No}] essa conta de computador durante uma instalação dos Serviços de
Implantação do Windows. A configuração padrão é Sim.

[/BootImagepath: Especifica o caminho relativo da pasta remoteInstall para a imagem de


<Caminho relativo>] inicialização e este computador usará.

[/Domain: Especifica o domínio a ser pesquisado para o computador preparado


<Domínio>] previamente. O valor padrão é o domínio local.

[/resetAccount] redefine as permissões no computador especificado para que toda


pessoa com as permissões apropriadas possa ingressar no domínio
usando essa conta.

Exemplos
Para definir o programa de inicialização de rede e o servidor de referência para um
computador, digite:

wdsutil /Set-Device /Device:computer1 /ReferralServer:MyWDSServer


/BootProgram:boot\x86\pxeboot.n12
Para definir várias configurações para um computador, digite:

wdsutil /verbose /Set-Device /Device:computer2 /ID:00-B0-56-88-2F-DC


/WdsClientUnattend:WDSClientUnattend\unattend.xml
/User:Domain\user /JoinRights:JoinOnly /JoinDomain:No
/BootImagepath:boot\x86\images\boot.wim /Domain:NorthAmerica /resetAccount

Links relacionados
Chave da sintaxe de linha de comando
Comando wdsutil add-device
Comando wdsutil get-alldevices
comando wdsutil get-device
Subcomando: set-DriverGroup
Artigo • 17/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Define as propriedades de um grupo de drivers existente em um servidor.

Sintaxe

wdsutil /Set-DriverGroup /DriverGroup:<Group Name> [/Server:<Server Name>]


[/Name:<New Group Name>] [/Enabled:{Yes | No}] [/Applicability:{Matched |
All}]

Parâmetros

Parâmetro Descrição

/DriverGroup: Especifica o nome do grupo de drivers.


<Nome do
Grupo>

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN. Se um


<nome do nome do servidor não for especificado, o servidor local será usado.
servidor>]

[/Name: Especifica o novo nome para o grupo de drivers.


<Nome do
Novo
Grupo>]

[/Enabled:{Yes Habilita ou desabilita o grupo de drivers.


| No}

[/Applicability: Especifica quais pacotes devem ser instalados, se os critérios de filtro forem
{Matched | atendidos. Matched significa instalar apenas os pacotes de drivers que
All}] correspondem ao hardware de um cliente. All significa instalar todos os pacotes
para clientes, independentemente do hardware.

Exemplos
Para definir as propriedades de um grupo de drivers, digite uma das seguintes opções:

wdsutil /Set-DriverGroup /DriverGroup:printerdrivers /Enabled:Yes

wdsutil /Set-DriverGroup /DriverGroup:printerdrivers


/Name:colorprinterdrivers /Applicability:All

Links relacionados
Chave de Sintaxe de Linha de ComandoSubcomando: set-DriverGroupFilter
Subcommand: set-DriverGroupFilter
Artigo • 12/04/2023

Adiciona ou remove um filtro de grupo de drivers existente de um grupo de drivers.

Sintaxe

wdsutil /Set-DriverGroupFilter /DriverGroup:<Group Name> [/Server:<Server


name>] /FilterType:<Filter Type> [/Policy:{Include | Exclude}] [/AddValue:
<Value> [/AddValue:<Value> ...]] [/RemoveValue:<Value> [/RemoveValue:<Value>
...]]

Parâmetros

Parâmetro Descrição

/DriverGroup: Especifica o nome do grupo de drivers.


<Group
Name>

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou FQDN. Se um


<Server nome do servidor não for especificado, o servidor local será usado.
name>]

/FilterType: Especifica o tipo de filtro de grupo de drivers a ser adicionado ou removido.


<FilterType> Você pode especificar vários filtros em um único comando. Para cada
/FilterType, você pode adicionar ou remover vários valores usando
/RemoveValue e /AddValue. <FilterType> pode ser uma das seguintes opções:
BiosVendor
BiosVersion
ChassisType
Manufacturer
Uuid
OsVersion
OsEdition
OsLanguage

[/Policy: Exclude}]
{Include
Parâmetro Descrição

[/AddValue: Especifica o novo valor do cliente a ser adicionado ao filtro. Você pode
<Value>] especificar vários valores para um único tipo de filtro. Confira a lista a seguir
para obter os valores de atributo válidos para ChassisType. Para obter
informações sobre como obter os valores de todos os outros tipos de filtro,
confira Filtros de Grupo de Drivers (https://go.microsoft.com/fwlink/?
LinkID=155158 ).
Outros
UnknownChassis
Desktop
LowProfileDesktop
PizzaBox
MiniTower
Tower
Portable
Laptop
Notebook
Handheld
DockingStation
AllInOne
SubNotebook
SpaceSaving
LunchBox
MainSystemChassis
ExpansionChassis
SubChassis
BusExpansionChassis
PeripheralChassis
StorageChassis
RackMountChassis
SealedCaseComputer
MultiSystemChassis
CompactPci
AdvancedTca

[/RemoveValue: Especifica o valor do cliente existente a ser removido do filtro, conforme


<Value>] especificado com /AddValue.

Exemplos
Para remover um filtro, digite uma das seguintes opções:

wdsutil /Set-DriverGroupFilter /DriverGroup:PrinterDrivers


/FilterType:Manufacturer /Policy:Include /AddValue:Name1 /RemoveValue:Name2
wdsutil /Set-DriverGroupFilter /DriverGroup:PrinterDrivers
/FilterType:Manufacturer /Policy:Include /RemoveValue:Name1
/FilterType:ChassisType /Policy:Exclude /AddValue:Tower /AddValue:MiniTower

Links relacionados
Chave da sintaxe de linha de comando
Subcomando: set-DriverPackage
Artigo • 11/04/2023

Renomeia e/ou habilita ou desabilita um pacote de driver em um servidor.

Sintaxe

wdsutil /Set-DriverPackage [/Server:<Server name>] {/DriverPackage:<Name> |


/PackageId:<ID>} [/Name:<New Name>] [/Enabled:{Yes | No}

Parâmetros

Parâmetro Descrição

[/Server:<Nome Especifica o nome do servidor. Pode ser o nome NetBIOS ou FQDN. Se um


do servidor>] nome do servidor não for especificado, o servidor local será usado.

[/DriverPackage: Especifica o nome atual do pacote de driver a ser modificado.


<Nome>]

[/PackageId: Especifica a ID dos Serviços de Implantação do Windows do pacote de driver.


<ID>] Você deverá especificar essa opção se o pacote de driver não puder ser
identificado exclusivamente pelo nome. Para localizar a ID de um pacote,
clique no grupo de driver em que o pacote está (ou no nó Todos os Pacotes ),
clique com o botão direito no pacote e clique em Propriedades. A ID do
Pacote está listada na guia Geral. Por exemplo: {DD098D20-1850-4FC8-8E35-
EA24A1BEFF5E}.

[/Name:<Novo Especifica o novo nome para o pacote de driver.


nome>]

[/Enabled:{Yes No}

Exemplos
Para alterar as configurações sobre um pacote, digite um dos seguintes:

wdsutil /Set-DriverPackage /PackageId:{4D36E972-E325-11CE-BFC1-08002BE10318}


/Name:MyDriverPackage
wdsutil /Set-DriverPackage /DriverPackage:MyDriverPackage /Name:NewName
/Enabled:Yes

Links relacionados
Chave da sintaxe de linha de comando
wdsutil set-image
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera os atributos de uma imagem.

Syntax
para imagens de inicialização:

wdsutil /Set-Imagmedia:<Image name> [/Server:<Server name>mediatype:Boot


/Architecture:{x86 | ia64 | x64} [/Filename:<File name>] [/Name:<Name>]
[/Description:<Description>] [/Enabled:{Yes | No}]

para imagens de instalação:

wdsutil /Set-Imagmedia:<Image name> [/Server:<Server name>]


mediatype:InstallmediaGroup:<Image group name>]
[/Filename:<File name>]
[/Name:<Name>]
[/Description:<Description>]
[/UserFilter:<SDDL>]
[/Enabled:{Yes | No}]
[/UnattendFile:<Unattend file path>]
[/OverwriteUnattend:{Yes | No}]

Parâmetros

Parâmetro Descrição

media:<Image Especifica o nome da imagem.


name>

[/Server:<Server Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN


name>] (nome de domínio totalmente qualificado). Se nenhum nome do servidor
for especificado, o servidor local será usado.
Parâmetro Descrição

mediatype:{Boot | Especifica o tipo de imagem.


Install}

/Architecture:{x86 | Especifica a arquitetura da imagem. Como é possível ter o mesmo nome


ia64 | x64} de imagem para diferentes imagens de inicialização em diferentes
arquiteturas, especificar a arquitetura garante que a imagem correta seja
modificada.

[/Filename:<File se a imagem não puder ser identificada exclusivamente pelo nome, você
name>] deverá usar essa opção para especificar o nome de arquivo.

[/Name] Especifica o nome da imagem.

[/Description: Especifica a descrição da imagem.


<Description>]

[/Enabled:{Yes | No}] Habilita ou desabilita a imagem.

\mediaGroup: Especifica o grupo de imagens que contém a imagem. Se nenhum nome


<Image group do grupo de imagens for especificado e apenas um grupo existir no
name>] servidor, esse grupo será usado. Se houver mais de um grupo de imagens
no servidor, você deverá usar essa opção para especificar o grupo de
imagens.

[/UserFilter:<SDDL>] Define o filtro do usuário na imagem. A cadeia de caracteres de filtro deve


estar no formato SDDL (Linguagem de Definição de Descritor de
Segurança). Observe que, ao contrário da opção /Security para grupos de
imagens, essa opção restringe apenas quem pode ver a definição de
imagem e não os recursos reais do arquivo de imagem. Para restringir o
acesso aos recursos de arquivo e, portanto, acessar todas as imagens em
um grupo de imagens, você precisará definir a segurança para o próprio
grupo de imagens.

[/UnattendFile: Define o caminho completo para o arquivo autônomo a ser associado à


<Unattend file imagem. Por exemplo: D:\Files\Unattend\Img1Unattend.xml
path>]

[/OverwriteUnattend: Você pode especificar /Overwrite para substituir o arquivo autônomo, se


{Yes | No}] já houver um arquivo autônomo associado à imagem. Observe que a
configuração padrão é Não.

Exemplos
Para definir valores para uma imagem de inicialização, digite uma das seguintes opções:
wdsutil /Set-Imagmedia:WinPE boot imagemediatype:Boot /Architecture:x86
/Description:New description
wdsutil /verbose /Set-Imagmedia:WinPE boot image
/Server:MyWDSServemediatype:Boot /Architecture:x86 /Filename:boot.wim
/Name:New Name /Description:New Description /Enabled:Yes

Para definir valores para uma imagem de instalação, digite uma das seguintes opções:

wdsutil /Set-Imagmedia:Windows Vista with Officemediatype:Install


/Description:New description
wdsutil /verbose /Set-Imagmedia:Windows Vista with Office
/Server:MyWDSServemediatype:InstalmediaGroup:ImageGroup1
/Filename:install.wim /Name:New name /Description:New description
/UserFilter:O:BAG:DUD:AI(A;ID;FA;;;SY)(A;ID;FA;;;BA)(A;ID;0x1200a9;;;AU)
/Enabled:Yes /UnattendFile:\\server\share\unattend.xml
/OverwriteUnattend:Yes

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil add-image
comando wdsutil copy-image
comando wdsutil export-image
comando wdsutil get-image
comando wdsutil remove-image
comando wdsutil replace-image
wdsutil set-imagegroup
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Altera os atributos de um grupo de imagens.

Sintaxe

wdsutil [Options] /set-imagegroup:<Image group name> [/Server:<Server name>]


[/Name:<New image group name>] [/Security:<SDDL>]

Parâmetros

Parâmetro Descrição

/set-imagegroup: Especifica o nome do grupo de imagens.


<Image group
name>

[/Server:<Server Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome
name>] de domínio totalmente qualificado). Se não for especificado, o servidor local
será usado.

[/Name:<New Especifica o novo nome do grupo de imagens.


image group
name>]

[/Security: Especifica o novo Descritor de Segurança do grupo de imagens no formato


<SDDL>] SDDL.

Exemplos
Para definir o nome de um grupo de imagens, digite:

wdsutil /Set-ImageGroup:ImageGroup1 /Name:New Image Group Name


Para especificar várias configurações para um grupo de imagens, digite:

wdsutil /verbose /Set-ImageGroupGroup:ImageGroup1 /Server:MyWDSServer


/Name:New Image Group Name
/Security:O:BAG:S-1-5-21-2176941838-3499754553-4071289181-513
D:AI(A;ID;FA;;;SY)(A;OICIIOID;GA;;;SY)(A;ID;FA;;;BA)(A;OICIIOID;GA;;;BA)
(A;ID;0x1200a9;;;AU)(A;OICIIOID;GXGR;;;AU)

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil add-imagegroup
comando wdsutil get-allimagegroups
comando wdsutil get-imagegroup
comando wdsutil remove-imagegroup
wdsutil set-server
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Define as configurações para um servidor dos Serviços de Implantação do Windows.

Sintaxe

wdsutil [Options] /Set-Server [/Server:<Server name>]


[/Authorize:{Yes | No}]
[/RogueDetection:{Yes | No}]
[/AnswerClients:{All | Known | None}]
[/Responsedelay:<time in seconds>]
[/AllowN12forNewClients:{Yes | No}]
[/ArchitectureDiscovery:{Yes | No}]
[/resetBootProgram:{Yes | No}]
[/DefaultX86X64Imagetype:{x86 | x64 | Both}]
[/UseDhcpPorts:{Yes | No}]
[/DhcpOption60:{Yes | No}]
[/RpcPort:<Port number>]
[/PxepromptPolicy
[/Known:{OptIn | Noprompt | OptOut}]
[/New:{OptIn | Noprompt | OptOut}]
[/BootProgram:<Relative path>]
/Architecture:{x86 | ia64 | x64}
[/N12BootProgram:<Relative path>]
/Architecture:{x86 | ia64 | x64}
[/BootImage:<Relative path>]
/Architecture:{x86 | ia64 | x64}
[/PreferredDC:<DC Name>]
[/PreferredGC:<GC Name>]
[/PrestageUsingMAC:{Yes | No}]
[/NewMachineNamingPolicy:<Policy>]
[/NewMachineOU]
[/type:{Serverdomain | Userdomain | UserOU | Custom}]
[/OU:<Domain name of OU>]
[/DomainSearchOrder:{GCOnly | DCFirst}]
[/NewMachineDomainJoin:{Yes | No}]
[/OSCMenuName:<Name>]
[/WdsClientLogging]
[/Enabled:{Yes | No}]
[/LoggingLevel:{None | Errors | Warnings | Info}]
[/WdsUnattend]
[/Policy:{Enabled | Disabled}]
[/CommandlinePrecedence:{Yes | No}]
[/File:<path>]
/Architecture:{x86 | ia64 | x64}
[/AutoaddPolicy]
[/Policy:{AdminApproval | Disabled}]
[/PollInterval:{time in seconds}]
[/MaxRetry:{Retries}]
[/Message:<Message>]
[/RetentionPeriod]
[/Approved:<time in days>]
[/Others:<time in days>]
[/AutoaddSettings]
/Architecture:{x86 | ia64 | x64}
[/BootProgram:<Relative path>]
[/ReferralServer:<Server name>
[/WdsClientUnattend:<Relative path>]
[/BootImage:<Relative path>]
[/User:<Owner>]
[/JoinRights:{JoinOnly | Full}]
[/JoinDomain:{Yes | No}]
[/BindPolicy]
[/Policy:{Include | Exclude}]
[/add]
/address:<IP or MAC address>
/addresstype:{IP | MAC}
[/remove]
/address:<IP or MAC address>
/addresstype:{IP | MAC}
[/RefreshPeriod:<time in seconds>]
[/BannedGuidPolicy]
[/add]
/Guid:<GUID>
[/remove]
/Guid:<GUID>
[/BcdRefreshPolicy]
[/Enabled:{Yes | No}]
[/RefreshPeriod:<time in minutes>]
[/Transport]
[/ObtainIpv4From:{Dhcp | Range}]
[/start:<start IP address>]
[/End:<End IP address>]
[/ObtainIpv6From:Range]
[/start:<start IP address>]
[/End:<End IP address>]
[/startPort:<start Port>
[/EndPort:<start Port>
[/Profile:{10Mbps | 100Mbps | 1Gbps | Custom}]
[/MulticastSessionPolicy]
[/Policy:{None | AutoDisconnect | Multistream}]
[/Threshold:<Speed in KBps>]
[/StreamCount:{2 | 3}]
[/Fallback:{Yes | No}]
[/forceNative]
Parâmetros

Parâmetro Descrição

[/Server:<Server name>] Especifica o nome do servidor. Pode ser o nome NetBIOS ou o


FQDN (nome de domínio totalmente qualificado). Se um nome do
servidor não for especificado, o servidor local será usado.

[/Authorize:{Yes | No}] Especifica se esse servidor deve ser autorizado no DHCP (Dynamic
Host Control Protocol).

[/RogueDetection:{Yes | No}] Habilita ou desabilita a detecção de invasor DHCP.

[/AnswerClients:{All | Known Especifica quais clientes esse servidor atenderá. Se você definir
| None}] esse valor como Conhecido, um computador deverá estar em pré-
teste no AD DS (Active Directory Domain Services) antes que ele
seja respondido pelo servidor dos Serviços de Implantação do
Windows.

[/Responsedelay:<time in A quantidade de tempo que o servidor aguardará antes de


seconds>] responder a um cliente de inicialização. Essa configuração não se
aplica a computadores em pré-teste.

[/AllowN12forNewClients: para o Windows Server 2008, especifica que clientes


{Yes | No}] desconhecidos não precisarão pressionar a tecla F12 para iniciar
uma inicialização de rede. Os clientes conhecidos receberão o
programa de inicialização especificado para o computador ou, se
não for especificado, o programa de inicialização especificado
para a arquitetura.
para o Windows Server 2008 R2, essa opção foi substituída pelo
seguinte comando: wdsutil /Set-Server /PxepromptPolicy
/New:Noprompt

[/ArchitectureDiscovery:{Yes | Habilita ou desabilita a descoberta de arquitetura. Isso facilita a


No}] descoberta de clientes baseados em x64 que não transmitem
corretamente sua arquitetura.

[/resetBootProgram:{Yes | Determina se o caminho de inicialização será apagado para um


No}] cliente que acabou de ser inicializado sem precisar pressionar a
tecla F12.

[/DefaultX86X64Imagetype: Controla quais imagens de inicialização serão mostradas para


{x86 | x64 | Both}] clientes baseados em x64.

[/UseDhcpPorts:{Yes | No}] Especifica se o servidor PXE deve ou não tentar associar à porta
DHCP, porta TCP 67. Se os Serviços de Implantação do Windows e
DHCP estiverem em execução no mesmo computador, você
deverá definir essa opção como Não para habilitar o servidor
DHCP a utilizar a porta e definir o parâmetro /DhcpOption60
como Sim. A configuração padrão para esse valor é Sim.
Parâmetro Descrição

[/DhcpOption60:{Yes | No}] Especifica se a opção DHCP 60 deve ser configurada para suporte
a PXE. Se os Serviços de Implantação do Windows e DHCP
estiverem em execução no mesmo servidor, defina essa opção
como Sim e defina a opção /UseDhcpPorts como Não. A
configuração padrão para esse valor é Não.

[/RpcPort:<Port number>] Especifica o número da porta TCP a ser usado para atender às
solicitações do cliente.

[/PxepromptPolicy] Configura o quão conhecidos (pré-teste) e novos clientes iniciam


uma inicialização PXE. Essa opção se aplica apenas ao Windows
Server 2008 R2. Defina as configurações usando as seguintes
opções:
- [/Known:{OptIn|OptOut|Noprompt}] - Define a política para
clientes em pré-teste.
- [/New:{OptIn|OptOut|Noprompt}] - Define a política para novos
clientes.

OptIn significa que o cliente precisa pressionar uma tecla para


Inicialização PXE, caso contrário, ele retornará para o próximo
dispositivo de inicialização.

Noprompt significa que o cliente sempre será fará Inicialização


PXE.

OptOut significa que o cliente fará Inicialização PXE, a menos que


a tecla Esc seja pressionada.

[/BootProgram:<Relative Especifica o caminho relativo para o programa de inicialização na


path>] /Architecture:{x86 | pasta remoteInstall (por exemplo, boot\x86\pxeboot.n12) e
ia64 | x64} especifica a arquitetura do programa de inicialização.

[/N12BootProgram:<Relative Especifica o caminho relativo para o programa de inicialização que


path>] /Architecture:{x86 | não requer que a tecla F12 seja pressionada (por exemplo,
ia64 | x64} boot\F12\pxeboot.x86) e especifica a arquitetura do programa de
inicialização.

[/BootImage:<Relative Especifica o caminho relativo para a imagem de inicialização que


path>] /Architecture:{x86 | os clientes de inicialização devem receber e especifica a
ia64 | x64} arquitetura da imagem de inicialização. Isso pode ser especificado
para cada arquitetura.

[/PreferredDC:<DC Name>] Especifica o nome do controlador de domínio que os Serviços de


Implantação do Windows devem usar. Pode ser o nome NetBIOS
ou FQDN.

[/PreferredGC:<GC Name>] Especifica o nome do servidor de catálogo global que os Serviços


de Implantação do Windows devem usar. Pode ser o nome
NetBIOS ou FQDN.
Parâmetro Descrição

[/PrestageUsingMAC:{Yes | Especifica se os Serviços de Implantação do Windows, ao criar


No}] contas de computador no AD DS, devem usar o endereço MAC
em vez do GUID/UUID para identificar o computador.

[/NewMachineNamingPolicy: Especifica o formato a ser usado ao gerar nomes de computador


<Policy>] para clientes. Para obter informações sobre o formato a ser usado
para a <política>, clique com o botão direito do mouse no
servidor no snap-in MMC, clique em Propriedades e veja a guia
Serviços de diretório. Por exemplo, /NewMachineNamingPolicy:
%61Username%#.

[/NewMachineOU] Usado para especificar o local no AD DS em que as contas de


computador cliente serão criadas. Especifique o local usando as
opções a seguir.
- [/type: Serverdomain | Userdomain | UserOU | Custom ]
Especifica o tipo de local. Serverdomain cria contas no mesmo
domínio que o servidor dos Serviços de Implantação do Windows.
Userdomain cria contas no mesmo domínio que o usuário que
executa a instalação. UserOU cria contas na unidade
organizacional do usuário que executa a instalação. Personalizado
permite que você especifique um local personalizado (você
também deve especificar um valor para /UO com essa opção).
- [/OU:<Domain name of OU>] - se você especificar Custom para
a opção /type, essa opção especificará a unidade organizacional
em que as contas de computador devem ser criadas.

[/DomainSearchOrder: Especifica a política para pesquisa de contas de computador no


{GCOnly | DCFirst}] AD DS (catálogo global ou controlador de domínio).

[/NewMachineDomainJoin: Especifica se um computador que ainda não esteja em pré-teste


{Yes | No}] no AD DS deve ser ingressado no domínio durante a instalação. A
configuração padrão é Sim.

[/WdsClientLogging] Especifica o nível de log para o servidor.


- [/Enabled:{Yes | No}] – Habilita ou desabilita o registro em log de
ações de cliente dos Serviços de Implantação do Windows.
- [/LoggingLevel: {None | Errors | Warnings | Info} – Define o nível
de registro em log. Nenhum é equivalente a desabilitar o registro
em log. Erros é o nível mais baixo de registro em log e indica que
somente erros serão registrados. Avisos inclui avisos e erros.
Informações é o nível mais alto de registro em log e inclui erros,
avisos e eventos informativos.
Parâmetro Descrição

[/WdsUnattend] Essas configurações controlam o comportamento de instalação


autônoma do cliente dos Serviços de Implantação do Windows.
Defina as configurações usando as seguintes opções:
- [/Policy:{Enabled | Disabled}] – Especifica se a instalação
autônoma é usada ou não.
- [/CommandlinePrecedence: {Yes | No}] – Especifica se um
arquivo de Autounattend.xml (se estiver presente no cliente) ou
um arquivo de instalação autônoma que foi passado diretamente
para o cliente dos Serviços de Implantação do Windows com a
opção /Unattend será usado em vez de um arquivo autônomo de
imagem durante a instalação de um cliente. A configuração
padrão é No.
- [/File:<Relative path> /Architecture:{x86 | ia64 | x64}] - Especifica
o nome do arquivo, o caminho e a arquitetura do arquivo
autônomo.
Parâmetro Descrição

[/AutoaddPolicy] Essas configurações controlam a política de adição automática.


Defina as configurações usando as seguintes opções:
- [/Policy: {AdminApproval | Disabled}] - AdminApprove faz com
que todos os computadores desconhecidos sejam adicionados a
uma fila pendente, em que o administrador pode examinar a lista
de computadores e aprovar ou rejeitar cada solicitação, conforme
apropriado. Desabilitado indica que nenhuma ação adicional é
tomada quando um computador desconhecido tenta inicializar no
servidor.
- [/PollInterval:{time in seconds}] - Especifica o intervalo (em
segundos) no qual o programa de inicialização de rede deve
sondar o servidor dos Serviços de Implantação do Windows.
- [/MaxRetry: <Number>] - Especifica o número de vezes que o
programa de inicialização de rede deve sondar o servidor dos
Serviços de Implantação do Windows. Esse valor, juntamente com
/PollInterval, determina quanto tempo o programa de
inicialização de rede aguardará para que um administrador aprove
ou rejeite o computador antes de atingir o tempo limite. Por
exemplo, um valor MaxRetry de 10 e um valor PollInterval de 60
indicariam que o cliente deve sondar o servidor 10 vezes,
aguardando 60 segundos entre as tentativas. Portanto, o cliente
atingiria o tempo limite após 10 minutos (10 x 60 segundos = 10
minutos).
- [/Message: <Message>] - Especifica a mensagem exibida ao
cliente na página de diálogo do programa de inicialização de
rede.
- [/RetentionPeriod] - Especifica o número de dias em que um
computador pode estar em um estado pendente antes de ser
limpo automaticamente.
- [/Approved: <time in days>] - Especifica o período de retenção
para computadores aprovados. Você deve usar esse parâmetro
com a opção /RetentionPeriod.
- [/Others: <time in days>] - Especifica o período de retenção
para computadores não aprovados (rejeitados ou pendentes).
Você deve usar esse parâmetro com a opção /RetentionPeriod.
Parâmetro Descrição

[/AutoaddSettings] Especifica as configurações padrão a serem aplicadas a cada


computador. Defina as configurações usando as seguintes opções:
- /Architecture: {x86 | ia64 | x64} - Especifica a arquitetura.
- [/BootProgram: <Relative path>] - Especifica o programa de
inicialização enviado ao computador aprovado. Se nenhum
programa de inicialização for especificado, o padrão para a
arquitetura do computador (conforme especificado no servidor)
será usado.
- [/WdsClientUnattend: <Relative path>] - Define o caminho
relativo para o arquivo autônomo que o cliente aprovado deve
receber.
- [/ReferralServer: <Server name>] - Especifica o servidor dos
Serviços de Implantação do Windows que o cliente usará para
baixar imagens.
- [/BootImage: <Relative path>] - Especifica a imagem de
inicialização que o cliente aprovado receberá.
- [/User: <Domain\User | User@Domain>] - Define permissões no
objeto de conta do computador para dar ao usuário especificado
os direitos necessários para ingressar o computador no domínio.
- [JoinRights: {JoinOnly | Full}] - Especifica o tipo de direitos a
serem atribuídos ao usuário. JoinOnly exige que o administrador
redefina a conta do computador antes que o usuário possa
ingressar o computador no domínio. Full dá acesso completo ao
usuário, incluindo o direito de ingressar o computador no
domínio.
- [/JoinDomain: {Yes | No}] - Especifica se o computador deve ou
não ser ingressado no domínio como essa conta de computador
durante uma instalação dos Serviços de Implantação do Windows.
A configuração padrão é Sim.

[/BindPolicy] Configura os adaptadores de rede para o provedor PXE escutar.


Defina a política usando as seguintes opções:
- [/Policy: {Include | Exclude}] - Define a política de associação de
interface para incluir ou excluir os endereços na lista de interfaces.
- [/add] - adiciona uma interface à lista. Você também deve
especificar /addresstype e /address.
- [/remove] - remove uma interface da lista. Você também deve
especificar /addresstype e /address.
- /address:<endereço IP ou MAC> - Especifica o endereço IP ou
MAC da interface a ser adicionada ou removida.
- /addresstype: {IP | MAC} – Indica o tipo de endereço especificado
na opção /address.

[/RefreshPeriod: <seconds>] Especifica com que frequência (em segundos) o servidor atualizará
suas configurações.
Parâmetro Descrição

[/BannedGuidPolicy] Gerencia a lista de GUIDs proibidos usando as seguintes opções:


- [/add] /Guid:<GUID> - adiciona o GUID especificado à lista de
GUIDs proibidos. Qualquer cliente com esse GUID será
identificado por seu endereço MAC.
- [/remove] /Guid:<GUID> - remove o GUID especificado da lista
de GUIDs proibidos.

[/BcdRefreshPolicy] Define as configurações para atualizar arquivos Bcd usando as


seguintes opções:
- [/Enabled:{Yes | No}] - especifica a política de atualização Bcd.
Quando /Enabled é definido como Sim, os arquivos Bcd são
atualizados no intervalo de tempo especificado.
- [/RefreshPeriod:<time in minutes>] - Especifica o intervalo de
tempo no qual os arquivos Bcd são atualizados.

[/Transport] Configura as seguintes opções:

[/ObtainIpv4From: {Dhcp | Range}] - Especifica a origem dos


endereços IPv4.
[/start: <starting Ipv4 address>] - Especifica o início do
intervalo de endereços IP. Essa opção é necessária e
válida somente se /ObtainIpv4From estiver definido
como Intervalo
[/End: <Ending Ipv4 address>] - Especifica o final do
intervalo de endereços IP. Essa opção é necessária e
válida somente se /ObtainIpv4From estiver definido
como Intervalo.
[/ObtainIpv6From:Range] [/start:<start IP address>] [/End:
<End IP address>] Especifica a origem dos endereços IPv6.
Essa opção só se aplica ao Windows Server 2008 R2 e o
único valor com suporte é Intervalo.
[/startPort: <starting port>] - Especifica o início do intervalo
de portas.
[/EndPort: <Ending port>] - Especifica o fim do intervalo de
portas.
[/Profile: {10Mbps | 100Mbps | 1Gbps | Custom}] - Especifica
o perfil de rede a ser usado. Essa opção só tem suporte para
servidores que executam o Windows Server 2008.
[/MulticastSessionPolicy] Define as configurações de
transferência para transmissões multicast. Esse comando só
está disponível para o Windows Server 2008 R2.
[/Policy:{None | AutoDisconnect | Multistream}] -
Determina como lidar com clientes lentos. Nenhum
significa manter todos os clientes em uma sessão na
mesma velocidade. AutoDisconnect significa que todos
os clientes que ficarem abaixo do /Threshold
especificado serão desconectados. Multistream significa
Parâmetro Descrição

que os clientes serão separados em várias sessões,


conforme especificado por /StreamCount.
[/Threshold:<Speed in KBps>] - para
/Policy:AutoDisconnect, essa opção define a taxa de
transferência mínima em KBps. Os clientes que ficarem
abaixo dessa taxa serão desconectados das transmissões
multicast.
[/StreamCount:{2 | 3}] [/Fallback:{Yes | No}] - para
/Policy:Multistream, essa opção determina o número de
sessões. 2 significa duas sessões (rápidas e lentas) 3
significa três sessões (lenta, média, rápida).
[/Fallback:{Yes | No}] - Determina se os clientes
desconectados continuarão a transferência usando outro
método (se houver suporte do cliente). Se você estiver
usando o cliente WDS, o computador fará fallback para
unicasting. Wdsmcast.exe não dá suporte a um
mecanismo de fallback. Essa opção também se aplica a
clientes que não dão suporte a Multistream. Nesse caso,
o computador retornará para outro método em vez de
passar para uma sessão de transferência mais lenta.

Exemplos
Para definir o servidor para responder somente clientes conhecidos, com um atraso de
resposta de 4 minutos, digite:

wdsutil /Set-Server /AnswerClients:Known /Responsedelay:4

Para definir o programa de inicialização e a arquitetura para o servidor, digite:

wdsutil /Set-Server /BootProgram:boot\x86\pxeboot.n12 /Architecture:x86

Para habilitar o log no servidor, digite:

wdsutil /Set-Server /WdsClientLogging /Enabled:Yes /LoggingLevel:Warnings


Para habilitar o autônomo no servidor, bem como a arquitetura e o arquivo autônomo
do cliente, digite:

wdsutil /Set-Server /WdsUnattend /Policy:Enabled /File:WDSClientUnattend


\unattend.xml /Architecture:x86

Para definir o servidor PXE (Pre-Boot Execution Environment) para tentar associar às
portas TCP 67 e 60, digite:

wdsutil /Set-server /UseDhcpPorts:No /DhcpOption60:Yes

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil disable-server
comando wdsutil enable-server
comando wdsutil get-server
comando wdsutil initialize-server
comando wdsutil start-server
comando wdsutil stop-server
comando wdsutil uninitialize-server
wdsutil set-transportserver
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Define as configurações de um Servidor de Transporte.

Sintaxe

wdsutil [Options] /Set-TransportServer [/Server:<Server name>]


[/ObtainIpv4From:{Dhcp | Range}]
[/start:<starting IP address>]
[/End:<Ending IP address>]
[/ObtainIpv6From:Range]\n\
[/start:<start IP address>]\n\
[/End:<End IP address>]
[/startPort:<starting port>
[/EndPort:<starting port>
[/Profile:{10Mbps | 100Mbps | 1Gbps | Custom}]
[/MulticastSessionPolicy]
[/Policy:{None | AutoDisconnect | Multistream}]
[/Threshold:<Speed in KBps>]
[/StreamCount:{2 | 3}]
[/Fallback:{Yes | No}]

Parâmetros

Parâmetro Descrição

[/Server:<Server name>] Especifica o nome do Servidor de Transporte. Pode ser o nome


NetBIOS ou o FQDN (nome de domínio totalmente qualificado). Se
nenhum nome de Servidor de Transporte for especificado, o servidor
local será usado.
Parâmetro Descrição

[/ObtainIpv4From:{Dhcp | Define a origem dos endereços IPv4 da seguinte maneira:


Range}] - [/start: <IP address>] Define o início do intervalo de endereços IP.
Isso é necessário e válido apenas se essa opção estiver definida como
Intervalo.
- [/End: <IP address>] Define o fim do intervalo de endereços IP. Isso
é necessário e válido apenas se essa opção estiver definida como
Intervalo.
- [/startPort: <port>] Define o início do intervalo de portas.
- [/EndPort: <port>] Define o fim do intervalo de portas.

[/ObtainIpv6From:Range] Especifica a origem dos endereços IPv6. Essa opção só se aplica ao


Windows Server 2008 R2 e o único valor com suporte é Intervalo.

- [/start: <IP address>] Define o início do intervalo de endereços IP.


Isso é necessário e válido apenas se essa opção estiver definida como
Intervalo.
- [/End: <IP address>] Define o fim do intervalo de endereços IP. Isso
é necessário e válido apenas se essa opção estiver definida como
Intervalo.
- [/startPort: <port>] Define o início do intervalo de portas.
- [/EndPort: <port>] Define o fim do intervalo de portas.

[/Profile: {10Mbps | Especifica o perfil de rede a ser usado. Essa opção só está disponível
100Mbps | 1Gbps | para servidores que executam o Windows Server 2008 ou o Windows
Custom}] Server 2003.
Parâmetro Descrição

[/MulticastSessionPolicy] Define as configurações de transferência para transmissões multicast.


Esse comando só está disponível para o Windows Server 2008 R2.
- [/Policy:{None | AutoDisconnect | Multistream}] Determina como
lidar com clientes lentos. Nenhum significa manter todos os clientes
em uma sessão na mesma velocidade. AutoDisconnect significa que
todos os clientes que ficarem abaixo do /Threshold especificado
serão desconectados. Multistream significa que os clientes serão
separados em várias sessões, conforme especificado por
/StreamCount.
- [/Threshold:<Speed in KBps>] Define a taxa mínima de transferência
em KBps para /Policy:AutoDisconnect. Os clientes que ficarem abaixo
dessa taxa serão desconectados das transmissões multicast.
- [/StreamCount:{2 | 3}] [/Fallback:{Yes | No}] Determina o número de
sessões para /Policy:Multistream. 2 significa duas sessões (rápidas e
lentas) e 3 significa três sessões (lenta, média, rápida).
- [/Fallback:{Yes | No}] Determina se os clientes desconectados
continuarão a transferência usando outro método (se houver suporte
do cliente). Se você estiver usando o cliente WDS, o computador fará
fallback para unicasting. Wdsmcast.exe não dá suporte a um
mecanismo de fallback. Essa opção também se aplica a clientes que
não dão suporte a Multistream. Nesse caso, o computador retornará
para outro método em vez de passar para uma sessão de
transferência mais lenta.

Exemplos
Para definir o intervalo de endereços IPv4 do servidor, digite:

wdsutil /Set-TransportServer /ObtainIpv4From:Range /start:239.0.0.1


/End:239.0.0.100

Para definir o intervalo de endereços IPv4, o intervalo de portas e o perfil do servidor,


digite:

wdsutil /Set-TransportServer /Server:MyWDSServer /ObtainIpv4From:Range


/start:239.0.0.1 /End:239.0.0.100 /startPort:12000 /EndPort:50000
/Profile:10mbps

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil disable-transportserver
comando wdsutil enable-transportserver
comando wdsutil get-transportserver
comando wdsutil start-transportserver
comando wdsutil stop-transportserver
wdsutil start-multicasttransmission
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Inicia uma transmissão do Scheduled-Cast de uma imagem.

Syntax
Windows Server 2008

wdsutil /start-MulticastTransmissiomedia:<Image name> [/Server:<Server


namemediatype:InstallmediaGroup:<Image group name>] [/Filename:<File name>]

Windows Server 2008 R2 para imagens de inicialização:

wdsutil [Options] /start-MulticastTransmissiomedia:<Image name>


[/Server:<Server name>]
mediatype:Boot
/Architecture:{x86 | ia64 | x64}
[/Filename:<File name>]

para imagens de instalação:

wdsutil [Options] /start-MulticastTransmissiomedia:<Image name>


[/Server:<Server name>]
mediatype:Install
mediaGroup:<Image Group>]
[/Filename:<File name>]

Parâmetros

Parâmetro Descrição
Parâmetro Descrição

media: Especifica o nome da imagem.


<Image
name>

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<Server domínio totalmente qualificado). Se nenhum nome do servidor for especificado,
name>] o servidor local será usado.

mediatype: Especifica o tipo de imagem. Observe que essa opção deve ser definida como
{Install|Boot} Install para o Windows Server 2008.

/Architecture: A arquitetura da imagem de inicialização associada à transmissão a ser iniciada.


{x86 | ia64 | Como é possível ter o mesmo nome de imagem para as imagens de inicialização
x64} em arquiteturas diferentes, você deve especificar a arquitetura para garantir que
a transmissão correta seja usada.

\mediaGroup: Especifica o grupo de imagens da imagem. Se nenhum nome do grupo de


<Image imagens for especificado e apenas um grupo existir no servidor, esse grupo será
group usado. Se houver mais de um grupo de imagens no servidor, você deverá usar
name>] essa opção para especificar o nome do grupo de imagens.

[/Filename: Especifica o nome do arquivo que contém a imagem. Se a imagem não puder ser
<File name>] identificada exclusivamente pelo nome, você deverá usar essa opção para
especificar o nome de arquivo.

Exemplos
Para iniciar uma transmissão multicast, digite uma das seguintes opções:

wdsutil /start-MulticastTransmissiomedia:Vista with Office


/Imagetype:Install
wdsutil /start-MulticastTransmission /Server:MyWDSServemedia:Vista with
Officemediatype:InstalmediaGroup:ImageGroup1 /Filename:install.wim

Para iniciar uma transmissão multicast da imagem de inicialização para o Windows


Server 2008 R2, digite:

wdsutil /start-MulticastTransmission /Server:MyWDSServemedia:X64 Boot


Imagemediatype:Boot /Architecture:x64
/Filename:boot.wim\n\
Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil get-allmulticasttransmissions
comando wdsutil get-multicasttransmission
comando wdsutil new-multicasttransmission
comando wdsutil remove-multicasttransmission
wdsutil start-namespace
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Inicia um namespace Scheduled-Cast.

Sintaxe

wdsutil /start-Namespace /Namespace:<Namespace name[/Server:<Server name>]

Parâmetros

Parâmetro Descrição

/Namespace: Especifica o nome do namespace. Observe que não é o nome amigável e deve ser
<Namespace exclusivo.
name> - Servidor de Implantação: a sintaxe do nome do namespace é /Namspace:WDS:
<Grupo de imagens>/<Nome da imagem>/<Índice>. Por exemplo:
WDS:ImageGroup1/install.wim/1
- Servidor de Transporte: esse valor deve corresponder ao nome dado ao
namespace quando ele foi criado no servidor.

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<Server domínio totalmente qualificado). Se nenhum nome do servidor for especificado, o
name>] servidor local será usado.

Exemplos
Para iniciar um namespace, digite uma das seguintes opções:

wdsutil /start-Namespace /Namespace:Custom Auto 1


wdsutil /start-Namespace /Server:MyWDSServer /Namespace:Custom Auto 1

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil get-allnamespaces
comando wdsutil new-namespace
comando wdsutil remove-namespace
wdsutil start-server
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Inicia todos os serviços para um servidor dos Serviços de Implantação do Windows.

Sintaxe

wdsutil [Options] /start-Server [/Server:<Server name>]

Parâmetros

Parâmetro Descrição

[/Server: Especifica o nome do servidor a ser iniciado. Pode ser o nome NetBIOS ou o FQDN
<Server (nome de domínio totalmente qualificado). Se um nome do servidor não for
name>] especificado, o servidor local será usado.

Exemplos
Para iniciar o servidor, digite uma das seguintes opções:

wdsutil /start-Server
wdsutil /verbose /start-Server /Server:MyWDSServer

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil disable-server
comando wdsutil enable-server
comando wdsutil get-server
comando wdsutil initialize-server
comando wdsutil set-server
comando wdsutil stop-server
comando wdsutil start-server
comando wdsutil uninitialize-server
wdsutil start-transportserver
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Inicia todos os serviços de um Servidor de Transporte.

Sintaxe

wdsutil [Options] /start-TransportServer [/Server:<Server name>]

Parâmetros

Parâmetro Descrição

[/Server: Especifica o nome do Servidor de Transporte. Pode ser o nome NetBIOS ou o FQDN
<Server (nome de domínio totalmente qualificado). Se um nome do servidor não for
name>] especificado, o servidor local será usado.

Exemplos
Para iniciar o servidor, digite uma das seguintes opções:

wdsutil /start-TransportServer
wdsutil /verbose /start-TransportServer /Server:MyWDSServer

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil disable-transportserver
comando wdsutil enable-transportserver
comando wdsutil get-transportserver
comando wdsutil set-transportserver
comando wdsutil stop-transportserver
wdsutil stop-server
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Para todos os serviços em um servidor dos Serviços de Implantação do Windows.

Sintaxe

wdsutil [Options] /Stop-Server [/Server:<Server name>]

Parâmetros

Parâmetro Descrição

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<Server domínio totalmente qualificado). Se um nome do servidor não for especificado, o
name>] servidor local será usado.

Exemplos
Para interromper os serviços, digite um dos seguintes:

wdsutil /Stop-Server
wdsutil /verbose /Stop-Server /Server:MyWDSServer

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil disable-server
comando wdsutil enable-server
comando wdsutil get-server
comando wdsutil initialize-server
comando wdsutil set-server
comando wdsutil start-server
comando wdsutil uninitialize-server
wdsutil stop-transportserver
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Interrompe todos os serviços em um Servidor de Transporte.

Sintaxe

wdsutil [Options] /Stop-TransportServer [/Server:<Server name>]

Parâmetros

Parâmetro Descrição

[/Server: Especifica o nome do Servidor de Transporte. Pode ser o nome NetBIOS ou o FQDN
<Nome do (nome de domínio totalmente qualificado). Se nenhum Servidor de Transporte for
servidor>] especificado, o servidor local será usado.

Exemplos
Para interromper os serviços, digite um dos seguintes:

wdsutil /Stop-TransportServer
wdsutil /verbose /Stop-TransportServer /Server:MyWDSServer

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil disable-transportserver
comando wdsutil enable-transportserver
comando wdsutil get-transportserver
comando wdsutil set-transportserver
comando wdsutil start-transportserver
wdsutil uninitialize-server
Artigo • 12/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Reverte as alterações feitas no servidor durante a configuração inicial do servidor. Isso


inclui as alterações feitas pela opção /initialize-server ou pelo snap-in mmc dos
Serviços de Implantação do Windows. Observe que esse comando redefine o servidor
como um estado não configurado. Esse comando não modifica o conteúdo da pasta
compartilhada remoteInstall. Em vez disso, ele redefine o estado do servidor para que
você possa reinicializar o servidor.

Sintaxe

wdsutil [Options] /Uninitialize-Server [/Server:<Server name>]

Parâmetros

Parâmetro Descrição

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<Server domínio totalmente qualificado). Se nenhum nome do servidor for especificado, o
name>] servidor local será usado.

Exemplos
Para reinicializar o servidor, digite uma das seguintes opções:

wdsutil /Uninitialize-Server
wdsutil /verbose /Uninitialize-Server /Server:MyWDSServer

Links relacionados
Chave da sintaxe de linha de comando
comando wdsutil disable-server
comando wdsutil enable-server
comando wdsutil get-server
comando wdsutil initialize-server
comando wdsutil set-server
comando wdsutil start-server
comando wdsutil stop-server
Update-ServerFiles
Artigo • 12/04/2023

Atualiza os arquivos na pasta compartilhada REMINST usando os arquivos mais recentes


armazenados na pasta %Windir%\System32\RemInst do servidor. Para garantir a
validade da instalação dos Serviços de Implantação do Windows, você deve executar
esse comando uma vez após cada atualização de servidor, instalação de service pack ou
atualização para arquivos dos Serviços de Implantação do Windows.

Sintaxe

wdsutil [Options] /Update-ServerFiles [/Server:<Server name>]

Parâmetros

Parâmetro Descrição

[/Server: Especifica o nome do servidor. Pode ser o nome NetBIOS ou o FQDN (nome de
<Server domínio totalmente qualificado). Se nenhum nome do servidor for especificado, o
name>] servidor local será usado.

Exemplos
Para atualizar os arquivos, digite uma das seguintes opções:

wdsutil /Update-ServerFiles
wdsutil /Verbose /Progress /Update-ServerFiles /Server:MyWDSServer

Links relacionados
Chave da sintaxe de linha de comando
Usando o comando verbose
Artigo • 12/04/2023

Exibe a saída detalhada de um comando especificado. Você pode usar /verbose com
quaisquer outros comandos wdsutil. Observe que você deve especificar /verbose e
/progress diretamente depois do wdsutil.

Sintaxe

wdsutil /verbose <commands>

Exemplos
Para excluir os computadores aprovados do banco de dados de Adição Automática e
mostrar a saída detalhada, digite:

wdsutil /Verbose /progress /Delete-AutoAddDevices /Server:MyWDSServer


/DeviceType:ApprovedDevices
wecutil
Artigo • 12/04/2023

Permite que você crie e gerencie assinaturas de eventos que são encaminhados de
computadores remotos. O computador remoto deve dar suporte ao protocolo WS-
Management.

) Importante

Se você receber a mensagem "O servidor RPC não está disponível?” ao tentar
executar o wecutil, você precisa iniciar o serviço de coletor de eventos do Windows
(wecsvc). Para iniciar o wecsvc, digite net start wecsvc em um prompt de
comando com privilégios elevados.

Sintaxe
command

wecutil [{es | enum-subscription}] [{gs | get-subscription} <Subid> [/f:


<Format>] [/uni:<Unicode>]] [{gr | get-subscriptionruntimestatus} <Subid>
[<Eventsource> …]] [{ss | set-subscription} [<Subid> [/e:[<Subenabled>]]
[/esa:<Address>] [/ese:[<Srcenabled>]] [/aes] [/res] [/un:<Username>] [/up:
<Password>] [/d:<Desc>] [/uri:<Uri>] [/cm:<Configmode>] [/ex:<Expires>] [/q:
<Query>] [/dia:<Dialect>] [/tn:<Transportname>] [/tp:<Transportport>] [/dm:
<Deliverymode>] [/dmi:<Deliverymax>] [/dmlt:<Deliverytime>] [/hi:
<Heartbeat>] [/cf:<Content>] [/l:<Locale>] [/ree:[<Readexist>]] [/lf:
<Logfile>] [/pn:<Publishername>] [/essp:<Enableport>] [/hn:<Hostname>] [/ct:
<Type>]] [/c:<Configfile> [/cun:<Username> /cup:<Password>]]] [{cs | create-
subscription} <Configfile> [/cun:<Username> /cup:<Password>]] [{ds | delete-
subscription} <Subid>] [{rs | retry-subscription} <Subid> [<Eventsource>…]]
[{qc | quick-config} [/q:[<quiet>]]]

Parâmetros

Parâmetro Descrição

{es | enum-subscription} Exibe os nomes de todas as assinaturas de evento


remoto que existem.
Parâmetro Descrição

{gs | get-subscription} <Subid> [/f: Exibe informações de configuração da assinatura


<Format>] [/uni:<Unicode>] remota. <Subid> é uma cadeia de caracteres que
identifica exclusivamente uma assinatura. É o mesmo
que a cadeia de caracteres especificada na marca
<SubscriptionId> do arquivo de configuração XML,
que foi usada para criar a assinatura.

{gr | get-subscriptionruntimestatus} Exibe o status de runtime de uma assinatura. <Subid>


<Subid> [<Eventsource> …] é uma cadeia de caracteres que identifica
exclusivamente uma assinatura. É o mesmo que a
cadeia de caracteres especificada na marca
<SubscriptionId> do arquivo de configuração XML,
que foi usada para criar a assinatura. <Eventsource> é
uma cadeia de caracteres que identifica um
computador que serve como uma fonte de eventos.
Deve ser um nome de domínio totalmente
qualificado, um nome NetBIOS ou endereço IP.

{ss | set-subscription} <Subid> [/e: Altera a configuração da assinatura. Você pode


[<Subenabled>]] [/esa:<Address>] [/ese: especificar a ID da assinatura e as opções apropriadas
[<Srcenabled>]] [/aes] [/res] [/un: para alterar os parâmetros da assinatura, ou você
<Username>] [/up:<Password>] [/d: pode especificar um arquivo de configuração XML
<Desc>] [/uri:<Uri>] [/cm:<Configmode>] para alterar os parâmetros de assinatura.
[/ex:<Expires>] [/q:<Query>] [/dia:
<Dialect>] [/tn:<Transportname>] [/tp:
<Transportport>] [/dm:<Deliverymode>]
[/dmi:<Deliverymax>] [/dmlt:
<Deliverytime>] [/hi:<Heartbeat>] [/cf:
<Content>] [/l:<Locale>] [/ree:
[<Readexist>]] [/lf:<Logfile>] [/pn:
<Publishername>] [/essp:<Enableport>]
[/hn:<Hostname>] [/ct:<Type>]
OR
{ss | set-subscription /c:<Configfile>
[/cun:<Comusername> /cup:
<Compassword>]

{cs | create-subscription} Cria uma assinatura remota. <Configfile> especifica


<Configfile> [/cun:<Username> /cup: o caminho para o arquivo XML que contém a
<Password>] configuração da assinatura. O caminho pode ser
absoluto ou relativo ao diretório atual.
Parâmetro Descrição

{ds | delete-subscription} <Subid> Exclui uma assinatura e cancela a inscrição em todas


as fontes de eventos que fornecem eventos para o
log de eventos da assinatura. Todos os eventos já
recebidos e registrados não são excluídos. <Subid> é
uma cadeia de caracteres que identifica
exclusivamente uma assinatura. É o mesmo que a
cadeia de caracteres especificada na marca
<SubscriptionId> do arquivo de configuração XML
que foi usada para criar a assinatura.

{rs | retry-subscription} <Subid> Tenta estabelecer uma conexão e enviar uma


[<Eventsource>…] solicitação de assinatura remota para uma assinatura
inativa. Tenta reativar todas as fontes de evento ou
fontes de evento especificadas. Não se repete
tentativas para fontes desabilitadas. <Subid> é uma
cadeia de caracteres que identifica exclusivamente
uma assinatura. É o mesmo que a cadeia de
caracteres especificada na marca <SubscriptionId>
do arquivo de configuração XML que foi usada para
criar a assinatura. <Eventsource> é uma cadeia de
caracteres que identifica um computador que serve
como uma fonte de eventos. Deve ser um nome de
domínio totalmente qualificado, um nome NetBIOS
ou endereço IP.

{qc | quick-config} [/q:[<Quiet>]] Configura o serviço Coletor de Eventos do Windows


para garantir que uma assinatura possa ser criada e
sustentada por meio de reinicializações. Isso inclui as
seguintes etapas:

1. Habilite o canal ForwardedEvents se ele estiver


desabilitado.
2. Defina o serviço Coletor de Eventos do
Windows para atrasar o início.
3. Inicie o serviço Coletor de Eventos do Windows
se ele não estiver em execução.

Opções

Opção Descrição

/f: <Format> Especifica o formato das informações exibidas. <Format> pode ser XML
ou Terse. Se for XML, a saída será exibida no formato XML. Se for Terse, a
saída será exibida em pares nome-valor. O padrão é Terse.
Opção Descrição

/c: <Configfile> Especifica o caminho para o arquivo XML que contém uma configuração
de assinatura. O caminho pode ser absoluto ou relativo ao diretório atual.
Essa opção só pode ser usada com as opções /cun e /cup e é
mutuamente exclusiva com todas as outras opções.

/e:[ <Subenabled> ] Habilita ou desabilita uma assinatura. <Subenabled> deve ser true
ou false. O valor padrão desta opção é true.

/esa: <Address> Especifica o endereço de uma fonte de evento. <Address> é uma cadeia
de caracteres que contém um nome de domínio totalmente qualificado,
um nome NetBIOS ou um endereço IP, que identifica um computador
que serve como uma fonte de eventos. Essa opção deve ser usada com as
opções /ese, /aes, /res ou /un e /up.

/ese:[ <Srcenabled> ] Habilita ou desabilita uma fonte de evento. <Srcenabled> deve ser true
ou false. Essa opção somente é permitida se a opção /esa estiver
especificada. O valor padrão desta opção é true.

/aes Adiciona a origem do evento especificada pela opção /esa se ela ainda
não fizer parte da assinatura. Se o endereço especificado pela opção /esa
já fizer parte da assinatura, um erro será relatado. Essa opção somente é
permitida se a opção /esa estiver especificada.

/res Remove a origem do evento especificada pela opção /esa se ela já fizer
parte da assinatura. Se o endereço especificado pela opção /esa não fizer
parte da assinatura, um erro será relatado. Essa opção somente é
permitida se a opção /esa estiver especificada.

/un: <Username> Especifica a credencial de usuário a ser usada com a origem do evento
especificada pela opção /esa. Essa opção somente é permitida se a opção
/esa estiver especificada.

/up: <Password> Especifica a senha que corresponde à credencial do usuário. Essa opção
somente é permitida se a opção /un estiver especificada.

/d: <Desc> Fornece uma descrição para a assinatura.

/uri: <Uri> Especifica o tipo de eventos que são consumidos pela assinatura. <Uri>
contém uma cadeia de caracteres de URI combinada com o endereço do
computador de origem do evento para identificar exclusivamente a
origem dos eventos. A cadeia de caracteres de URI é usada para todos os
endereços de origem do evento na assinatura.
Opção Descrição

/cm: <Configmode> Define o modo de configuração. <Configmode> pode ser uma das
seguintes cadeias de caracteres: Normal, Personalizado, MinLatency ou
MinBandwidth. Os modos Normal, MinLatency e MinBandwidth
definem o modo de entrega, o máximo de itens de entrega, o intervalo
de pulsação e o tempo máximo de latência de entrega. As opções /dm,
/dmi, /hi ou /dmlt só poderão ser especificadas se o modo de
configuração estiver definido como Personalizado.

/ex: <Expires> Define o momento em que a assinatura expira. <Expires> deve ser
definido no formato de data/hora padrão XML ou ISO8601: yyyy-MM-
ddThh:mm:ss[.sss][Z] , em que T é o separador de hora e Z indica hora
UTC.

/q: <Query> Especifica a cadeia de caracteres de consulta para a assinatura. O formato


de <Query> pode ser diferente para valores de URI diferentes e se aplica a
todas as fontes na assinatura.

/dia: <Dialect> Define o dialeto que a cadeia de caracteres de consulta usa.

/tn: <Transportname> Especifica o nome do transporte usado para se conectar a uma origem de
evento remoto.

/tp: <Transportport> Define o número da porta que é usado pelo transporte ao se conectar a
uma origem de evento remoto.

/dm: <Deliverymode> Especifica o modo de entrega. <Deliverymode> pode ser pull ou push.
Essa opção só será válida se a opção /cm estiver definida como
Personalizada.

/dmi: <Deliverymax> Define o número máximo de itens para entrega em lote. Essa opção só
será válida se /cm estiver definido como Personalizado.

/dmlt: <Deliverytime> Define a latência máxima na entrega de um lote de eventos.


<Deliverytime> é o número de milissegundos. Essa opção só será válida
se /cm estiver definido como Personalizado.

/hi: <Heartbeat> Altera o intervalo de pulsação. <Heartbeat> é o número de


milissegundos. Essa opção só será válida se /cm estiver definido como
Personalizado.

/cf: <Content> Especifica o formato dos eventos retornados. <Content> pode ser Events
ou RenderedText. Quando o valor é RenderedText, os eventos são
retornados com as cadeias de caracteres localizadas (como a descrição
do evento) anexadas ao evento. O valor padrão é RenderedText.
Opção Descrição

/l: <Locale> Especifica a localidade para entrega das cadeias de caracteres localizadas
no formato RenderedText. <Locale> é um identificador de idioma e
país/região, por exemplo, EN-us. Essa opção só será válida se a opção /cf
estiver definida como RenderedText.

/ree:[ <Readexist> ] Identifica os eventos que são entregues para a assinatura. <Readexist>
pode ser true ou false. Quando o <Readexist> é true, todos os eventos
existentes são lidos das fontes de evento de assinatura. Quando o
<Readexist> é false, somente eventos futuros (chegando) são entregues.
O valor padrão é true para uma opção /ree sem um valor. Se nenhuma
opção /ree for especificada, o valor padrão será false.

/lf: <Logfile> Especifica o log de eventos local usado para armazenar eventos
recebidos das origens do evento.

/pn: <Publishername> Especifica o nome do editor. Ele deve ser um editor que possui ou
importa o log especificado pela opção /lf.

/essp: <Enableport> Especifica que o número da porta deve ser acrescentado ao nome da
entidade de serviço do serviço remoto. <Enableport> deve ser true
ou false. O número da porta é acrescentado quando <Enableport> for
true. Quando o número da porta é acrescentado, algumas configurações
podem ser necessárias para impedir que o acesso a fontes de eventos
seja negado.

/hn: <Hostname> Especifica o nome DNS do computador local. Esse nome é usado pela
origem do evento remoto para efetuar push de eventos e deve ser usado
apenas para uma assinatura push.

/ct: <Type> Define o tipo de credencial para o acesso de origem remoto. <Type> deve
ser um dos seguintes valores: default, negotiate, digest, basic ou
localmachine. O valor padrão é default.

/cun: <Comusername> Define a credencial de usuário compartilhado a ser usada para fontes de
eventos que não têm suas próprias credenciais de usuário. Se essa opção
for especificada com a opção /c, as configurações UserName e
UserPassword para fontes de eventos individuais do arquivo de
configuração serão ignoradas. Se você quiser usar uma credencial
diferente para uma origem de evento específica, substitua esse valor
especificando as opções /un e /up para uma origem de evento específica
na linha de comando de outro comando ss.

/cup: <Compassword> Define a senha do usuário para a credencial de usuário compartilhado.


Quando <Compassword> é definido como * (asterisco), a senha é lida no
console. Essa opção somente é válida quando a opção /cun for
especificada.
Opção Descrição

/q:[ <Quiet> ] Especifica se o procedimento de configuração solicita confirmação.


<Quiet> deve ser true ou false. Se <Quiet> for true, o procedimento de
configuração não solicitará confirmação. O valor padrão desta opção é
false.

Exemplos
Para mostrar o conteúdo de um arquivo de configuração, digite:

XML

<Subscription
xmlns=https://schemas.microsoft.com/2006/03/windows/events/subscription>
<Uri>https://schemas.microsoft.com/wbem/wsman/1/windows/EventLog</Uri>
<!-- Use Normal (default), Custom, MinLatency, MinBandwidth -->
<ConfigurationMode>Normal</ConfigurationMode>
<Description>Forward Sample Subscription</Description>
<SubscriptionId>SampleSubscription</SubscriptionId>
<Query><![CDATA[
<QueryList>
<Query Path=Application>
<Select>*</Select>
</Query>
</QueryList>]]
</Query>
<EventSources>
<EventSource Enabled=true>
<Address>mySource.myDomain.com</Address>
<UserName>myUserName</UserName>
<Password>*</Password>
</EventSource>
</EventSources>
<CredentialsType>Default</CredentialsType>
<Locale Language=EN-US></Locale>
</Subscription>

Para exibir as informações de configuração de saída de uma assinatura chamada sub1,


digite:

command

wecutil gs sub1

Saída de exemplo:

Saída
EventSource[0]:
Address: localhost
Enabled: true
Description: Subscription 1
Uri: wsman:microsoft/logrecord/sel
DeliveryMode: pull
DeliveryMaxSize: 16000
DeliveryMaxItems: 15
DeliveryMaxLatencyTime: 1000
HeartbeatInterval: 10000
Locale:
ContentFormat: renderedtext
LogFile: HardwareEvents

Para exibir o status de runtime de uma assinatura chamada sub1, digite:

command

wecutil gr sub1

Para atualizar a configuração de assinatura chamada sub1 de um novo arquivo XML


chamado WsSelRg2.xml, digite:

command

wecutil ss sub1 /c:%Windir%system32WsSelRg2.xml

Para atualizar a configuração de assinatura chamada sub2 com vários parâmetros, digite:

command

wecutil ss sub2 /esa:myComputer /ese /un:uname /up:* /cm:Normal

Para excluir uma assinatura chamada sub1, digite:

wecutil ds sub1

Links relacionados
Chave da sintaxe de linha de comando
wevtutil
Artigo • 21/09/2022

Permite que você recupere informações sobre logs de eventos e editores. Também é
possível usar esse comando para instalar e desinstalar manifestos de eventos, para
executar consultas e para exportar, arquivar e limpar os logs.

Sintaxe

wevtutil [{el | enum-logs}] [{gl | get-log} <Logname> [/f:<Format>]]


[{sl | set-log} <Logname> [/e:<Enabled>] [/i:<Isolation>] [/lfn:<Logpath>]
[/rt:<Retention>] [/ab:<Auto>] [/ms:<MaxSize>] [/l:<Level>] [/k:<Keywords>]
[/ca:<Channel>] [/c:<Config>]]
[{ep | enum-publishers}]
[{gp | get-publisher} <Publishername> [/ge:<Metadata>] [/gm:<Message>] [/f:
<Format>]] [{im | install-manifest} <Manifest>]
[{um | uninstall-manifest} <Manifest>] [{qe | query-events} <Path> [/lf:
<Logfile>] [/sq:<Structquery>] [/q:<Query>] [/bm:<Bookmark>] [/sbm:<Savebm>]
[/rd:<Direction>] [/f:<Format>] [/l:<Locale>] [/c:<Count>] [/e:<Element>]]
[{gli | get-loginfo} <Logname> [/lf:<Logfile>]]
[{epl | export-log} <Path> <Exportfile> [/lf:<Logfile>] [/sq:<Structquery>]
[/q:<Query>] [/ow:<Overwrite>]]
[{al | archive-log} <Logpath> [/l:<Locale>]]
[{cl | clear-log} <Logname> [/bu:<Backup>]] [/r:<Remote>] [/u:<Username>]
[/p:<Password>] [/a:<Auth>] [/uni:<Unicode>]

Parâmetros

Parâmetro Descrição

{el | enum-logs} Exibe os nomes de todos os logs.

{gl | get-log} < Logname > Exibe informações de configuração para o log especificado, que
[/f: < Formato > ] inclui se o log está habilitado ou não, o limite de tamanho máximo
atual do log e o caminho para o arquivo em que o log está
armazenado.
Parâmetro Descrição

{sl | set-log} < Logname > Modifica a configuração do log especificado.


[/e: < Enabled > ] [/i: <
Isolation ] > [/lfn: < Logpath
] > [/rt: < Retention ] > [/ab:
< Auto ] > [/ms: < MaxSize
> ] [/l: < Level ] > [/k: <
Keywords ] > [/ca: <
Channel ] > [/c: < Config > ]

{ep | enum-publishers} Exibe os editores de eventos no computador local.

{gp | get-publisher} < Exibe as informações de configuração do publicador de eventos


Publishername > [/ge: < especificado.
Metadados > ] [/gm: <
Message ] > [/f: < Format >
]]

{im | install-manifest} < Instala editores de eventos e logs de um manifesto. Para obter
Manifesto> mais informações sobre manifestos de eventos e usar esse
parâmetro, consulte o SDK do Log de Eventos do Windows no site
do MSDN (Microsoft Developers Network) (
https://msdn.microsoft.com ).

{um | uninstall-manifest} < Desinstala todos os editores e logs de um manifesto. Para obter
Manifesto> mais informações sobre manifestos de eventos e usar esse
parâmetro, consulte o SDK do Log de Eventos do Windows no site
do MSDN (Microsoft Developers Network) (
https://msdn.microsoft.com ).

{qe | query-events} < Lê eventos de um log de eventos, de um arquivo de log ou usando


Caminho > [/lf: < Logfile > ] uma consulta estruturada. Por padrão, você fornece um nome de
[/sq: < Structquery > ] [/q: < log para < o Caminho > . No entanto, se você usar a opção /lf,
Consulta ] > [/bm: < Path deverá ser um caminho para um arquivo de > log. Se você
Indicador ] > [/sbm: < usar o parâmetro /sq, Path deverá ser um caminho para um
Savebm > ] [/rd: Direction ] arquivo que contém uma consulta > estruturada.
<> [/f: < Format ] > [/l: <
Locale ] > [/c: < Count ] >
[/e: < Element > ]

{gli | get-loginfo} < Exibe informações de status sobre um log de eventos ou arquivo
Logname > [/lf: < Logfile > ] de log. Se a opção /lf for usada, Logname > será um caminho para
um arquivo de log. Você pode executar wevtutil el para obter uma
lista de nomes de log.
Parâmetro Descrição

{epl | export-log} < Path >< Exporta eventos de um log de eventos, de um arquivo de log ou
Exportfile > [/lf: < Logfile > ] usando uma consulta estruturada para o arquivo especificado. Por
[/sq: < Structquery > ] [/q: < padrão, você fornece um nome de log para < o Caminho > . No
Query ] > [/ow: < Overwrite entanto, se você usar a opção /lf, Path deverá ser um caminho
>] para um arquivo de > log. Se você usar a opção /sq, Path deverá
ser um caminho para um arquivo que contém uma consulta >
estruturada. <Exportfile > é um caminho para o arquivo em que os
eventos exportados serão armazenados.

{al | archive-log} < Logpath Arquiva o arquivo de log especificado em um formato


> [/l: < Localidade > ] independente. Um subdiretório com o nome da localidade é
criado e todas as informações específicas da localidade são salvas
nesse subdiretório. Depois que o diretório e o arquivo de log são
criados executando wevtutil al, os eventos no arquivo podem ser
lidos se o publicador está instalado ou não.

{cl | clear-log} < Logname > Limpa os eventos do log de eventos especificado. A opção /bu
[/bu: < Backup > ] pode ser usada para fazer o back-up dos eventos limpos.

Opções
Opção Descrição

/f: < Especifica que a saída deve ser XML ou formato de texto. Se < Format > for XML,
Formato> a saída será exibida no formato XML. Se < Format > for Text, a saída será exibida
sem marcas XML. O padrão é texto.

/e: < Habilita ou desabilita um log. <Habilitado pode > ser true ou false.
Habilitado>

/i: < Define o modo de isolamento de log. <O > isolamento pode ser sistema,
Isolamento> aplicativo ou personalizado. O modo de isolamento de um log determina se um
log compartilha uma sessão com outros logs na mesma classe de isolamento. Se
você especificar o isolamento do sistema, o log de destino compartilhará pelo
menos permissões de gravação com o log do sistema. Se você especificar o
isolamento do aplicativo, o log de destino compartilhará pelo menos permissões
de gravação com o log do aplicativo. Se você especificar o isolamento
personalizado, também deverá fornecer um descritor de segurança usando a
opção /ca.

/lfn: < Define o nome do arquivo de log. <Logpath > é um caminho completo para o
Logpath> arquivo em que o serviço log de eventos armazena eventos para esse log.
Opção Descrição

/rt: < Define o modo de retenção de log. <A > retenção pode ser verdadeira ou falsa. O
Retenção> modo de retenção de log determina o comportamento do serviço log de eventos
quando um log atinge seu tamanho máximo. Se um log de eventos atingir seu
tamanho máximo e o modo de retenção de log for true, os eventos existentes
serão retidos e os eventos de entrada serão descartados. Se o modo de retenção
de log for false, os eventos de entrada substituirão os eventos mais antigos no
log.

/ab: < Auto> Especifica a política de backup automático de log. <Auto > pode ser true ou false.
Se esse valor for true, o log será feito backup automaticamente quando atingir o
tamanho máximo. Se esse valor for true, a retenção (especificada com a opção /rt)
também deverá ser definida como true.

/ms: < Define o tamanho máximo do log em bytes. O tamanho mínimo do log é 1048576
MaxSize> bytes (1024KB) e os arquivos de log são sempre múltiplos de 64KB, portanto, o
valor que você inserir será arredondado de acordo.

/l: < Level> Define o filtro de nível do log. <Nível > pode ser qualquer valor de nível válido.
Essa opção só é aplicável a logs com uma sessão dedicada. Você pode remover
um filtro de nível definindo < Nível > como 0.

/k: < Especifica o filtro de palavras-chave do log. <>Palavras-chave podem ser qualquer
Palavras- máscara de palavra-chave de 64 bits válida. Essa opção só é aplicável a logs com
chave> uma sessão dedicada.

/ca: < Define a permissão de acesso para um log de eventos. <Channel > é um descritor
Canal> de segurança que usa a SDDL (Linguagem de Definição do Descritor de
Segurança). Para obter mais informações sobre o formato SDDL, consulte o site do
MSDN (Microsoft Developers Network) ( https://msdn.microsoft.com ).

/c: < Especifica o caminho para um arquivo de configuração. Essa opção fará com que
Config> as propriedades de log sejam lidas do arquivo de configuração definido em <
Config > . Se você usar essa opção, não deverá especificar um < parâmetro >
Logname. O nome do log será lido do arquivo de configuração.

/ge: < Obtém informações de metadados para eventos que podem ser gerados por este
Metadados> publicador. <Os > metadados podem ser verdadeiros ou falsos.

/gm: < Exibe a mensagem real em vez da ID da mensagem numérica. <A > mensagem
Mensagem> pode ser verdadeira ou falsa.

/lf: < Especifica que os eventos devem ser lidos de um log ou de um arquivo de log. <O
Logfile> logfile > pode ser true ou false. Se true, o parâmetro para o comando será o
caminho para um arquivo de log.

/sq: < Especifica que os eventos devem ser obtidos com uma consulta estruturada.
Structquery> <Structquery > pode ser true ou false. Se true, < Path é o caminho para um
arquivo que contém uma consulta > estruturada.
Opção Descrição

/q: < Define a consulta XPath para filtrar os eventos que são lidos ou exportados. Se
Consulta> essa opção não for especificada, todos os eventos serão retornados ou
exportados. Essa opção não está disponível quando /sq é true.

/bm: < Especifica o caminho para um arquivo que contém um indicador de uma consulta
Indicador> anterior.

/sbm: < Especifica o caminho para um arquivo usado para salvar um indicador dessa
Savebm> consulta. A extensão de nome de arquivo deve ser .xml.

/rd: < Especifica a direção na qual os eventos são lidos. <A > direção pode ser
Direção> verdadeira ou falsa. Se true, os eventos mais recentes serão retornados primeiro.

/l: < Define uma cadeia de caracteres de localidade usada para imprimir o texto do
Localidade> evento em uma localidade específica. Disponível somente ao imprimir eventos no
formato de texto usando a opção /f.

/c: < Count> Define o número máximo de eventos a ler.

/e: < Inclui um elemento raiz ao exibir eventos em XML. <Elemento > é a cadeia de
Elemento> caracteres que você deseja dentro do elemento raiz. Por exemplo, /e:root
resultaria em XML que contém a raiz do par de elementos > raiz.

/ow: < Especifica que o arquivo de exportação deve ser substituído. <Substituir pode >
Substituir> ser true ou false. Se true e o arquivo de exportação especificado em Exportfile já
<> existir, ele será substituído sem confirmação.

/bu: < Especifica o caminho para um arquivo em que os eventos limpos serão
Backup> armazenados. Inclua a extensão .evtx no nome do arquivo de backup.

/r: < Executa o comando em um computador remoto. <Remote > é o nome do


Remoto> computador remoto. Os parâmetros im e um não são suportados por operação
remota.

/u: Nome de Especifica um usuário diferente para fazer logoff em um computador remoto.
< usuário> <Nome > de usuário é um nome de usuário no formato domínio\usuário ou
usuário. Essa opção só é aplicável quando a opção /r é especificada.

/p: < Especifica a senha do usuário. Se a opção /u for usada e essa opção não for
Senha> especificada ou Senha for *, o usuário será solicitado a inserir uma > senha. Essa
opção só é aplicável quando a opção /u é especificada.

/a: < Auth> Define o tipo de autenticação para se conectar a um computador remoto. <Auth
> pode ser Default, Negotiate, Kerberos ou NTLM. O padrão é Negotiate.

/uni: < Exibe a saída em Unicode. <Unicode > pode ser true ou false. Se < Unicode > for
Unicode> true, a saída será em Unicode.
Comentários
Usando um arquivo de configuração com o parâmetro sl

O arquivo de configuração é um arquivo XML com o mesmo formato que a saída


de wevtutil gl < Logname > /f:xml. Para mostrar o formato de um arquivo de
configuração que habilita a retenção, habilita obackup automático e define o
tamanho máximo do log no log do aplicativo:

<?xml version=1.0 encoding=UTF-8?>


<channel name=Application isolation=Application
xmlns=https://schemas.microsoft.com/win/2004/08/events>
<logging>
<retention>true</retention>
<autoBackup>true</autoBackup>
<maxSize>9000000</maxSize>
</logging>
<publishing>
</publishing>
</channel>

Exemplos
Liste os nomes de todos os logs:

wevtutil el

Exibir informações de configuração sobre o log do sistema no computador local no


formato XML:

wevtutil gl System /f:xml

Use um arquivo de configuração para definir atributos de log de eventos (consulte


Comentários para ver um exemplo de um arquivo de configuração):

wevtutil sl /c:config.xml
Exibir informações sobre o editor de eventos Microsoft-Windows-Eventlog, incluindo
metadados sobre os eventos que o publicador pode autá-lo:

wevtutil gp Microsoft-Windows-Eventlog /ge:true

Instale editores e logs do arquivo myManifest.xml manifesto:

wevtutil im myManifest.xml

Desinstale editores e logs do arquivo myManifest.xml manifesto:

wevtutil um myManifest.xml

Exibir os três eventos mais recentes do log do aplicativo no formato textual:

wevtutil qe Application /c:3 /rd:true /f:text

Exibir o status do log do aplicativo:

wevtutil gli Application

Exportar eventos do log do sistema para C:\backup\system0506.evtx:

wevtutil epl System C:\backup\system0506.evtx

Limpe todos os eventos do log do aplicativo depois de salvá-los em


C:\admin\backups\a10306.evtx:

wevtutil cl Application /bu:C:\admin\backups\a10306.evtx


Referências adicionais
Chave da sintaxe de linha de comando
onde
Artigo • 17/04/2023

Exibe o local dos arquivos que correspondem ao padrão de pesquisa fornecido.

Sintaxe

where [/r <Dir>] [/q] [/f] [/t] [$<ENV>:|<Path>:]<Pattern>[ ...]

Parâmetros

Parâmetro Descrição

/r <Dir> Indica uma pesquisa recursiva, começando com o diretório especificado.

/q Retorna um código de saída (0 para êxito, 1 para falha) sem exibir a lista de arquivos
correspondentes.

/f Exibe os resultados do comando where entre aspas.

/t Exibe o tamanho do arquivo e a data e hora da última modificação de cada arquivo


correspondente.

[$<ENV>:| Especifica o padrão de pesquisa para obter arquivos correspondentes. Pelo menos
<Path>:] um padrão é necessário e o padrão pode incluir caracteres curinga (* e ?). Por
<Pattern>[ padrão, where pesquisa o diretório atual, e os caminhos especificados na variável de
...] ambiente PATH. Você pode especificar um caminho diferente para pesquisar usando
o formato $ENV:Pattern (em que ENV é uma variável de ambiente existente que
contém um ou mais caminhos) ou usando o formato Path:Pattern (em que Path é o
caminho de diretório que você quer pesquisar). Esses formatos opcionais não
devem ser usados com a opção de linha de comando /r.

/? Exibe a ajuda no prompt de comando.

Comentários
Se você não especificar uma extensão de nome de arquivo, as extensões listadas
na variável de ambiente PATHEXT serão acrescentadas automaticamente ao
padrão.
Where pode executar pesquisas recursivas, exibir informações de arquivo, como
data ou tamanho, e aceitar variáveis de ambiente no lugar de caminhos em
computadores locais.

Exemplos
Para localizar todos os arquivos chamados Test na unidade C do computador atual e
seus subdiretórios, digite:

where /r c:\ test

Para listar todos os arquivos no diretório Público, digite:

where $public:*.*

Para localizar todos os arquivos chamados Notepad na unidade C do computador


remoto, Computer 1, e seus subdiretórios, digite:

where /r \\computer1\c notepad.*

Links relacionados
Chave da sintaxe de linha de comando
whoami
Artigo • 12/04/2023

Exibe as informações de usuário, grupo e privilégios para o usuário que está conectado
atualmente ao sistema local. Se usado sem parâmetros, o whoami exibe o nome de
usuário e domínio atual.

Sintaxe

whoami [/upn | /fqdn | /logonid]


whoami {[/user] [/groups] [/priv]} [/fo <Format>] [/nh]
whoami /all [/fo <Format>] [/nh]

Parâmetros

Parâmetro Descrição

/upn Exibe o nome de usuário no formato UPN.

/fqdn Exibe o nome de usuário no formato FQDN.

/logonid Exibe a ID de logon do usuário atual.

/user Exibe o domínio e o nome de usuário atuais e o SID (identificador de segurança).

/groups Exibe os grupos de usuários aos quais o usuário atual pertence.

/priv Exibe os privilégios de segurança do usuário atual.

/fo Especifica o formato de saída. Os valores válidos incluem:


<Format> table Exibe a saída em uma tabela. Esse é o valor padrão.
list Exibe a saída em uma lista.
csv Exibe a saída no formato CSV.

/all Exibe todas as informações no token de acesso atual, incluindo o nome de usuário
atual, SID (identificadores de segurança), privilégios e grupos aos quais o usuário
atual pertence.

/nh Especifica que o cabeçalho da coluna não deve ser exibido na saída. Isso é válido
somente para formatos de tabela e CSV.

/? Exibe a ajuda no prompt de comando.


Exemplos
Para exibir o domínio e o nome de usuário da pessoa que está conectada atualmente a
este computador, digite:

whoami

Saída semelhante à seguinte exibida:

DOMAIN1\administrator

Para exibir todas as informações no token de acesso atual, digite:

whoami /all

Links relacionados
Chave da sintaxe de linha de comando
winnt
Artigo • 08/05/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O comando winnt foi preterido e não haverá suporte para ele nas versões futuras do
Windows.

Essa ferramenta está incluída no Windows Server 2003. Para obter mais informações,
confira Winnt
winnt32
Artigo • 11/04/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

Executa uma instalação ou um upgrade de um produto no Windows Server 2003. Você


pode executar o winnt32 no prompt de comando em um computador que executa o
Windows 95, o Windows 98, o Windows Millennium Edition, o Windows NT, o Windows
2000, o Windows XP ou um produto no Windows Server 2003. Se você executar
winnt32 em um computador que executa o Windows NT versão 4.0, precisará primeiro
aplicar o Service Pack 5 ou posterior.

Sintaxe

winnt32 [/checkupgradeonly] [/cmd: <CommandLine>] [/cmdcons] [/copydir:


{i386|ia64}\<FolderName>] [/copysource: <FolderName>] [/debug[<Level>]:[
<FileName>]] [/dudisable] [/duprepare: <pathName>] [/dushare: <pathName>]
[/emsport:{com1|com2|usebiossettings|off}] [/emsbaudrate: <BaudRate>] [/m:
<FolderName>] [/makelocalsource] [/noreboot] [/s: <Sourcepath>] [/syspart:
<DriveLetter>] [/tempdrive: <DriveLetter>] [/udf: <ID>[,<UDB_File>]]
[/unattend[<Num>]:[ <AnswerFile>]]

Parâmetros

Parâmetro Descrição

/checkupgradeonly Verifica a compatibilidade de upgrade do computador com produtos no


Windows Server 2003.
Se você usar essa opção com /unattend, nenhuma entrada de usuário será
necessária. Caso contrário, os resultados são exibidos na tela e você pode
salvá-los com o nome do arquivo especificado. O nome do arquivo padrão
é upgrade.txt na pasta systemroot.

/cmd Instrui a instalação a executar um comando específico antes da fase final da


instalação. Isso ocorre depois que o computador é reiniciado e depois que a
instalação coleta as informações de configuração necessárias, mas antes da
instalação ser concluída.

<CommandLine> Especifica a linha de comando a ser executada antes da fase final da


instalação.
Parâmetro Descrição

/cmdcons Em um computador baseado em x86, instala o Console de recuperação


como uma opção de inicialização. O Console de recuperação é uma
interface de linha de comando na qual você pode executar tarefas como
iniciar e parar serviços e acessar a unidade local (incluindo unidades
formatadas com NTFS). Você só pode usar a opção /cmdcons após a
conclusão da instalação.

/copydir Cria uma pasta adicional dentro da pasta na qual os arquivos do sistema
operacional estão instalados. Por exemplo, para computadores baseados
em x86 e x64, você pode criar uma pasta chamada Private_drivers dentro da
pasta de origem i386 da sua instalação e colocar arquivos de driver na
pasta. Digite /copydir:i386\Private_drivers para que a instalação copie essa
pasta para o computador recém-instalado, tornando
systemroot\Private_drivers a nova localização da pasta.

- i386 especifica i386


- ia64 especifica ia64

Você pode usar /copydir para criar quantas pastas adicionais desejar.

<FolderName> Especifica a pasta que você criou para manter as modificações em seu site.

/copysource Cria uma pasta adicional temporária dentro da pasta na qual os arquivos do
sistema operacional estão instalados. Você pode usar /copysource para
criar quantas pastas adicionais desejar.

Ao contrário das pastas que /copydir cria, as pastas /copysource são


excluídas após a conclusão da Instalação.

/debug Cria um log de depuração no nível especificado, por exemplo,


/debug4:Debug.log. O arquivo de log padrão é C:\
systemroot\winnt32.log e

<level> Valores de nível e descrições


- 0: erros graves
- 1: erros
- 2: nível padrão. Warnings
- 3: informação
- 4: informações detalhadas para depuração

Cada nível inclui os níveis abaixo dele.

/dudisable Impede a execução da Atualização Dinâmica. Sem a Atualização Dinâmica, a


instalação é executada somente com os arquivos de instalação originais.
Essa opção desabilitará a Atualização Dinâmica mesmo se você usar um
arquivo de resposta e especificar opções de Atualização Dinâmica nesse
arquivo.
Parâmetro Descrição

/duprepare Realiza os preparativos em um compartilhamento de instalação para que ele


possa ser usado com arquivos de Atualização Dinâmica baixados do site do
Windows Update. Esse compartilhamento pode ser usado a fim de instalar o
Windows XP para vários clientes.

<pathName> Especifica o nome do caminho completo.

/dushare Especifica um compartilhamento no qual você baixou anteriormente


arquivos de Atualização Dinâmica (arquivos atualizados para uso com a
Instalação) do site do Windows Update e no qual você executou
anteriormente /duprepare:< pathName>. Quando executado em um
cliente, especifica que a instalação do cliente usará os arquivos atualizados
no compartilhamento especificado em <pathName>.

/emsport Habilita ou desabilita os Serviços de Gerenciamento de Emergência durante


a instalação e após a instalação do sistema operacional do servidor. Com os
Serviços de Gerenciamento de Emergência, você pode gerenciar
remotamente um servidor em situações de emergência que normalmente
exigiriam teclado local, mouse e monitor, por exemplo, quando a rede está
indisponível ou o servidor não está funcionando corretamente. Os Serviços
de Gerenciamento de Emergência têm requisitos de hardware específicos e
estão disponíveis apenas para produtos no Windows Server 2003.
- com1 é aplicável somente a computadores baseados em x86 (não
computadores baseados em arquitetura Itanium).
- com2 é aplicável somente a computadores baseados em x86 (não
computadores baseados em arquitetura Itanium).
- Default. Usa a configuração especificada na tabela SPCR
(Redirecionamento de Console de Porta Serial) do BIOS ou, em sistemas
baseados em arquitetura Itanium, pelo caminho do dispositivo de console
EFI. Se você especificar usebiossettings e não houver nenhuma tabela SPCR
ou caminho de dispositivo de console EFI apropriado, os Seviços de
Gerenciamento de Emergências não serão habilitados.
- off desabilita os Serviços de Gerenciamento de Emergência.
Posteriormente, você pode habilitá-los modificando as configurações de
inicialização.

/emsbaudrate Para computadores baseados em x86, especifica a taxa de transmissão para


os Serviços de Gerenciamento de Emergência. (A opção não é aplicável a
computadores baseados em arquitetura Itanium.) Precisa ser usado com
/emsport:com1 ou /emsport:com2 (caso contrário, /emsbaudrate é
ignorado).

<BaudRate> Especifica a taxa de transmissão de 9600, 19200, 57600 ou 115200. 9600 é o


padrão.

/m Especifica que a instalação copia arquivos de substituição de um local


alternativo. Instrui a configuração a procurar no local alternativo primeiro e,
se houver arquivos, a usá-los em vez dos arquivos do local padrão.
Parâmetro Descrição

/makelocalsource Instrui a instalação para copiar todos os arquivos de origem de instalação


para o disco rígido local. Use /makelocalsource ao instalar de um CD para
fornecer arquivos de instalação quando o CD não estiver disponível
posteriormente na instalação.

/noreboot Instrui a instalação a não reiniciar o computador depois que a fase de cópia
de arquivo da instalação é concluída para que você possa executar outro
comando.

/s Especifica o local de origem dos arquivos para sua instalação. Para copiar
arquivos simultaneamente de vários servidores, digite a opção /s:
<Sourcepath> várias vezes (até um máximo de oito). Se você digitar a
opção várias vezes, o primeiro servidor especificado precisará estar
disponível ou a instalação falhará.

<Sourcepath> Especifica o nome do caminho completo da origem.

/syspart Em um computador baseado em x86, especifica que você pode copiar


arquivos de inicialização de instalação para um disco rígido, marcar o disco
como ativo e, em seguida, instalar o disco em outro computador. Quando
você inicia esse computador, ele começa automaticamente com a próxima
fase de instalação.
Você sempre precisa usar o parâmetro /tempdrive com o parâmetro
/syspart.

Você pode iniciar o winnt32 com a opção /syspart em um computador


baseado em x86 executando o Windows NT 4.0, o Windows 2000, o
Windows XP ou um produto no Windows Server 2003. Se o computador
estiver executando o Windows NT versão 4.0, ele exigirá o Service Pack 5 ou
posterior. O computador não pode estar executando o Windows 95, o
Windows 98 nem o Windows Millennium Edition.

<DriveLetter> Especifica a letra da unidade.

/tempdrive Direciona a instalação para colocar arquivos temporários na partição


especificada.
Em uma nova instalação, o sistema operacional do servidor também será
instalado na partição especificada.

Em um upgrade, a opção /tempdrive afeta apenas o posicionamento de


arquivos temporários; o sistema operacional será atualizado na partição na
qual você executa o winnt32.
Parâmetro Descrição

/udf Indica um identificador (<ID>) que a instalação usa para especificar como
um arquivo de Banco de Dados de Exclusividade (UDB) modifica um arquivo
de resposta (consulte a opção /unattend). O UDB substitui valores no
arquivo de resposta e o identificador determina quais valores no arquivo
UDB são usados. Por exemplo, /udf:RAS_user,Our_company.udb substitui as
configurações especificadas para o identificador RAS_user no arquivo
Our_company.udb. Se nenhum <UDB_file> for especificado, a instalação
solicitará que o usuário insira um disco que contenha o arquivo
$Unique$.udb.

<ID> Indica um identificador usado para especificar como um arquivo UDB


(Banco de Dados de Exclusividade) modifica um arquivo de resposta.

<UDB_file> Especifica um arquivo UDB (Banco de Dados de Exclusividade).

/unattend Em um computador baseado em x86, faz upgrade da sua versão anterior do


Windows NT 4.0 Server (com Service Pack 5 ou posterior) ou do Windows
2000 no modo de instalação autônoma. Todas as configurações do usuário
são obtidas da instalação anterior, ou seja, nenhuma intervenção do usuário
é necessária durante a instalação.

<num> Especifica o número de segundos entre o tempo em que a instalação


termina de copiar os arquivos e quando ela reinicia o computador. Você
pode usar <Num> em qualquer computador que execute o Windows 98, o
Windows Millennium Edition, o Windows NT, o Windows 2000, o Windows
XP ou um produto no Windows Server 2003 . Se o computador estiver
executando o Windows NT versão 4.0, ele exigirá o Service Pack 5 ou
posterior.

<AnswerFile> Fornece instalação com suas especificações personalizadas

/? Exibe a ajuda no prompt de comando.

Comentários
Se você estiver implantando o Windows XP em computadores cliente, poderá usar a
versão do winnt32.exe que vem com o Windows XP. Outra maneira de implantar o
Windows XP é usar winnt32.msi, que funciona por meio do Windows Installer, parte do
conjunto de tecnologias IntelliMirror. Para obter mais informações sobre implantações
de cliente, consulte o Kit de Implantação do Windows Server 2003, que está descrito em
Usando Kits de Recursos e Implantação do Windows.

Em um computador baseado em Itanium, winnt32 pode ser executado no EFI


(Extensible Firmware Interface) ou no Windows Server 2003 Enterprise, no Windows
Server 2003 R2 Enterprise, no Datacenter do Windows Server 2003 R2 ou no Datacenter
do Windows Server 2003. Além disso, em um computador baseado em arquitetura
Itanium, /cmdcons e /syspart não estão disponíveis e as opções relacionadas a
upgrades não estão disponíveis. Para obter mais informações sobre compatibilidade de
hardware, consulte Compatibilidade de hardware. Para obter informações mais
detalhadas sobre como usar a Atualização Dinâmica e instalar vários clientes, consulte o
Kit de Implantação do Windows Server 2003, descrito em Usando os Kits de Recursos e
Implantação do Windows. Para obter informações sobre como modificar as
configurações de inicialização, consulte Kits de Recursos e Implantação do Windows
para Windows Server 2003. Para obter mais informações, consulte Usando os Kits de
Recursos e Implantação do Windows. O uso da opção de linha de comando /unattend
para automatizar a instalação afirma que você leu e aceitou o Contrato de Licença da
Microsoft para Windows Server 2003. Antes de usar essa opção de linha de comando
para instalar o Windows Server 2003 em nome de uma organização diferente da sua,
você precisará confirmar se o usuário final (seja uma pessoa física, seja uma pessoa
jurídica) recebeu, leu e aceitou os termos do Contrato de Licença da Microsoft para esse
produto. Os OEMs podem não especificar essa chave em computadores que estão
sendo vendidos aos usuários finais.

Links relacionados
Chave da sintaxe de linha de comando
winrs
Artigo • 10/05/2023

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 e Windows Server 2012

O Gerenciamento Remoto do Windows usando o comando winrs permite que você


gerencie e execute programas remotamente.

Sintaxe

winrs [/<parameter>[:<value>]] <command>

Parâmetros
Parâmetro Descrição

/remote: Especifica o ponto de extremidade de destino usando um nome NetBIOS ou a


<ponto de conexão padrão:
extremidade> - <url>: [<transporte>://]<destino>[:<porta>]

se não for especificado, /r:localhost será usado.

/unencrypted Especifica que as mensagens para o shell remoto não são criptografadas. Esse
parâmetro é útil para a solução de problemas, quando o tráfego de rede já está
criptografado usando ipsec ou quando a segurança física é imposta.

Por padrão, as mensagens são criptografadas usando as chaves Kerberos ou


NTLM.

Essa opção da linha de comando é ignorada quando o transporte HTTPS é


selecionado.

/username: Especifica o nome de usuário na linha de comando.


<nome de Se não for especificado, a ferramenta usará a autenticação Negotiate ou
usuário> solicitará o nome.

Se /username for especificado, /password também deverá ser especificado.


Parâmetro Descrição

/password: Especifica a senha na linha de comando.


<password> Se /password não for especificado, mas /username for, a ferramenta solicitará a
senha.

Se /password for especificado, /username também deverá ser especificado.

/timeout: Essa opção foi preterida.


<seconds>

/directory: Especifica o diretório inicial do shell remoto.


<caminho> Se não for especificado, o shell remoto será iniciado no diretório inicial do
usuário definido pela variável de ambiente %USERPROFILE%.

/environment: Especifica uma única variável de ambiente a ser definida quando o shell é
<string>= iniciado, o que permite alterar o ambiente padrão para o shell.
<value> Várias ocorrências dessa opção devem ser usadas para especificar diversas
variáveis de ambiente.

/noecho Especifica que o eco deve ser desabilitado. noecho pode ser necessário para
garantir que as respostas do usuário a prompts remotos não sejam exibidas
localmente.
Por padrão, o eco está ativado.

/noprofile Especifica que o perfil do usuário não deve ser carregado.


Por padrão, o servidor tenta carregar o perfil do usuário.

Se o usuário remoto não for um administrador local no sistema de destino, essa


opção será necessária (o padrão resultará em erro).

/allowdelegate Especifica que as credenciais do usuário podem ser usadas para acessar um
compartilhamento remoto, por exemplo, uma máquina diferente do terminal de
destino.

/compression Habilite compactação. Instalações mais antigas em computadores remotos


podem não dar suporte à compactação.
A configuração padrão está desativada, pois as instalações mais antigas em
computadores remotos podem não dar suporte à compactação.

/usessl Use uma conexão SSL ao usar um ponto de extremidade remoto. Especificar SSL
em vez do https: de transporte usará a porta padrão WinRM.

/? Exibe a ajuda no prompt de comando.

Comentários
Todas as opções da linha de comando aceitam uma forma curta ou longa. Por
exemplo, tanto /r quanto /remote são válidos.
Para encerrar o comando /remote, o usuário pode digitar Ctrl-C ou Ctrl-break,
que é enviado para o shell remoto. O segundo Ctrl-C força o encerramento de
winrs.exe.
Para gerenciar a configuração ativa dos shells remotos ou de winrs, use a
ferramenta WinRM. O alias de URI para gerenciar os shells ativos é shell/cmd. O
alias de URI para a configuração de winrs é winrm/config/winrs.

Exemplos

winrs /r:https://contoso.com command

winrs /r:contoso.com /usessl command

winrs /r:myserver command

winrs /r:http://127.0.0.1 command

winrs /r:http://169.51.2.101:80 /unencrypted command

winrs /r:https://[::FFFF:129.144.52.38] command

winrs /r:http://[1080:0:0:0:8:800:200C:417A]:80 command

winrs /r:https://contoso.com /t:600 /u:administrator /p:$%fgh7 ipconfig


winrs /r:myserver /env:path=^%path^%;c:\tools /env:TEMP=d:\temp config.cmd

winrs /r:myserver netdom join myserver /domain:testdomain /userd:johns


/passwordd:$%fgh789

winrs /r:myserver /ad /u:administrator /p:$%fgh7 dir \\anotherserver\share

Links relacionados
Chave da sintaxe de linha de comando
winsat mem
Artigo • 10/05/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O comando winsat mem testa a largura de banda da memória do sistema usando um


processo semelhante às grandes cópias de buffer de memória para memória no
processamento de multimídia.

Sintaxe
CLI

winsat mem <parameters>

Parâmetros

Parâmetro Descrição

-up Forca o teste de memória com apenas um thread. O padrão é executar um thread
por CPU física ou núcleo.

-rn Especifica que os threads da avaliação devem ser executados com prioridade
normal. O padrão é executar na prioridade 15.

-nc Especifique que a avaliação deve alocar memória e sinalizá-la como não
armazenada em cache. Este sinalizador significa que os caches do processador são
ignorados para operações de cópia. O padrão é executar no espaço armazenado em
cache.

-do <n> Especifica a distância, em bytes, entre o fim do buffer de origem e o início do buffer
de destino. O padrão é 64 bytes. O deslocamento de destino máximo permitido é
de 16 MB. Especificar um deslocamento de destino inválido resultará em um erro.
Observação: zero é um valor válido para <n> , mas números negativos não são.

-mint <n> Especifica o tempo mínimo de execução em segundos para a avaliação. O padrão é
2.0. O valor mínimo é 1.0. O valor máximo é 30.0.
Observação: especificar um valor -mint maior que o valor -maxt , quando os dois
parâmetros são usados em combinação, resultará em um erro.
Parâmetro Descrição

-maxt <n> Especifica o tempo máximo de execução em segundos para a avaliação. O padrão é
5.0. O valor mínimo é 1.0. O valor máximo é 30.0. Se usado em combinação com o
parâmetro -mint , a avaliação começará a fazer verificações estatísticas periódicas
dos resultados após o período especificado em -mint . Se as verificações estatísticas
forem aprovadas, a avaliação será concluída antes que o período especificado em -
maxt tenha decorrido. Se a avaliação for executada pelo período especificado em -
maxt , sem atender às verificações estatísticas, a avaliação será concluída nesse
momento e retornará os resultados coletados.

- Especifica o tamanho do buffer que o teste de cópia de memória deve usar. Duas
buffersize vezes esse valor será alocado por CPU, o que determina a quantidade de dados
<n> copiados de um buffer para outro. O valor padrão é 16 MB. Esse valor é
arredondado para o limite de 4 KB mais próximo. O valor máximo é 32 MB. O valor
mínimo é 4 KB. Especificar um tamanho de buffer inválido resultará em um erro.

-v Envie a saída detalhada para STDOUT, incluindo as informações de status e


progresso. Qualquer erro também será gravado na janela de comando.

-xml <file Salva a saída da avaliação como o arquivo XML especificado. Se o arquivo
name> especificado existir, ele será substituído.

- Salva as informações sobre volumes físicos e discos lógicos como parte da seção
idiskinfo <SystemConfig> na saída XML.

-iguid Cria um GUID (identificador global exclusivo) no arquivo de saída XML.

-note Adicione o texto da anotação à seção <note text> no arquivo de saída XML.
<note
text>

-icn Inclui o nome do computador local no arquivo de saída XML.

-eef Enumera as informações adicionais do sistema no arquivo de saída XML.

Exemplos
Para executar a avaliação por no mínimo 4 segundos e não mais que 12 segundos,
usando um tamanho de buffer de 32 MB e salvando os resultados em formato
XML no arquivo memtest.xml :

CLI

winsat mem -mint 4.0 -maxt 12.0 -buffersize 32MB -xml memtest.xml
Comentários
O requisito mínimo para usar o comando winsat mem é ser membro do grupo
Administradores local (ou equivalente). Winsat mem deve ser executado em uma
janela de prompt de comandos com privilégios elevados.
Para abrir uma janela de prompt de comandos com privilégios elevados,
selecioneIniciar, selecione Acessórios, clique com o botão direito do mouse em
Prompt de comandos e selecione Executar como administrador.
winsat mfmedia
Artigo • 12/04/2023

Mede o desempenho da decodificação de vídeo (reprodução) usando a estrutura do


Media Foundation.

Sintaxe

winsat mfmedia <parameters>

Parâmetros

Parâmetros Descrição

-input <file Obrigatório: especifique o arquivo que contém o clipe de vídeo a ser reproduzido
name> ou codificado. O arquivo pode estar em qualquer formato que possa ser
renderizado pelo Media Foundation.

- Especifica quee o grafo de filtro deve ser salvo em um arquivo compatível com o
dumpgraph GraphEdit antes do início da avaliação.

-ns Especifica que o grafo de filtro deve ser executado na velocidade normal de
reprodução do arquivo de entrada. Por padrão, o grafo de filtro é executado o mais
rápido possível, ignorando os tempos de apresentação.

-play Executa a avaliação no modo de decodificação e reproduz qualquer conteúdo de


áudio fornecido no arquivo especificado em -input usando o dispositivo
DirectSound padrão. Por padrão, a reprodução de áudio está desabilitada.

-nopmp Não use o processo do MFPMP (Media Foundation Protected Media Pipeline)
durante a avaliação.

-pmp Sempre use o processo MFPMP durante a avaliação.


Observação: se -pmp ou -nopmp não for especificado, o MFPMP será usado
somente quando necessário.

-v Envie a saída detalhada para STDOUT, incluindo as informações de status e


progresso. Os erros também serão gravados na janela de comando.

-xml <file Salva a saída da avaliação como o arquivo XML especificado. Se o arquivo
name> especificado existir, ele será substituído.
Parâmetros Descrição

-idiskinfo Salva as informações sobre volumes físicos e discos lógicos como parte da seção
<SystemConfig> na saída XML.

-iguid Cria um GUID (identificador global exclusivo) no arquivo de saída XML.

-note note Adicione o texto da anotação à seção <anotação> no arquivo de saída XML.
text

-icn Inclui o nome do computador local no arquivo de saída XML.

-eef Enumera as informações adicionais do sistema no arquivo de saída XML.

Exemplos
Para executar a avaliação com o arquivo de entrada usado durante uma avaliação
do formal winsat, sem empregar o MFPMP (Media Foundation Protected Media
Pipeline), em um computador em que c:\windows é o local da pasta do Windows.

winsat mfmedia -input c:\windows\performance\winsat\winsat.wmv -nopmp

Comentários
A associação no grupo local Administradores, ou equivalente, é o mínimo
necessário para usar o winsat. O comando deve ser executado em uma janela de
prompt de comandos com privilégios elevados.
Para abrir uma janela de prompt de comandos com privilégios elevados, clique em
Iniciar, clique em Acessórios, clique com o botão direito do mouse em Prompt de
Comando e clique em Executar como administrador.

Links relacionados
wmic
Artigo • 12/04/2023

Exibe as informações de WMI dentro de um shell de comando interativo.

) Importante

O utilitário WMIC (linha de comando WMI) foi preterido a partir de Windows 10,
versão 21H1, e a partir da versão de canal semestral 21H1 do Windows Server. Esse
utilitário foi substituído pelo Windows PowerShell para WMI (confira Capítulo 7 –
Como trabalhar com o WMI). Essa substituição se aplica somente ao utilitário
WMIC (linha de comando WMI). O próprio WMI (Instrumentação de
Gerenciamento do Windows) não é afetado. Confira também os recursos do
Windows 10 que não estamos mais desenvolvendo.

Syntax
Prompt de comando do Windows

wmic </parameter>

Subcomandos
Os seguintes subcomandos estão disponíveis:

Subcomando Descrição

classe Escapa do modo de alias padrão do WMIC para acessar classes no esquema WMI
diretamente.

caminho Escapa do modo de alias padrão do WMIC para acessar instâncias no esquema
WMI diretamente.

contexto Exibe os valores atuais de todos os comutadores globais.

[quit | exit] Sai do shell de comando WMIC.

Exemplos
Para exibir os valores atuais de todos os comutadores globais, digite:
Prompt de comando do Windows

wmic context

Uma saída semelhante a esta será exibida:

Prompt de comando do Windows

NAMESPACE : root\cimv2
ROLE : root\cli
NODE(S) : BOBENTERPRISE
IMPLEVEL : IMPERSONATE
[AUTHORITY : N/A]
AUTHLEVEL : PKTPRIVACY
LOCALE : ms_409
PRIVILEGES : ENABLE
TRACE : OFF
RECORD : N/A
INTERACTIVE : OFF
FAILFAST : OFF
OUTPUT : STDOUT
APPEND : STDOUT
USER : N/A
AGGREGATE : ON

Para alterar a ID do idioma usada pela linha de comando para inglês (ID de localidade
409), digite:

Prompt de comando do Windows

wmic /locale:ms_409

Links relacionados
Chave da sintaxe de linha de comando
gravador
Artigo • 12/04/2023

Verifica se um gravador ou componente está incluído ou exclui um gravador ou


componente do procedimento de backup ou restauração. Se usado sem parâmetros, o
writer exibe a ajuda no prompt de comando.

Sintaxe

writer verify [writer> | <component>]


writer exclude [<writer> | <component>]

Parâmetros

Parâmetro Descrição

verificar Verifica se o gravador ou componente especificado está incluído no procedimento


de backup ou restauração. O procedimento de backup ou restauração falhará, se o
gravador ou componente não estiver incluído.

excluir Exclui o gravador ou componente especificado do procedimento de backup ou


restauração.

Exemplos
Para verificar um gravador especificando o GUID (neste exemplo, 4dc3bdd4-ab48-4d07-
adb0-3bee2926fd7f), digite:

writer verify {4dc3bdd4-ab48-4d07-adb0-3bee2926fd7f}

Para excluir um gravador com o nome Gravador do Sistema, digite:

writer exclude System Writer


Links relacionados
Chave da sintaxe de linha de comando
wscript
Artigo • 30/05/2023

Aplica-se a: Windows Server (todas as versões com suporte)

O Host do Windows Script fornece um ambiente no qual os usuários podem executar


scripts em vários idiomas que usam vários modelos de objeto para executar tarefas.

Sintaxe

wscript [<scriptname>] [/b] [/d] [/e:<engine>] [{/h:cscript|/h:wscript}]


[/i] [/job:<identifier>] [{/logo|/nologo}] [/s] [/t:<number>] [/x] [/?]
[<ScriptArguments>]

Parâmetros
Parâmetro Descrição

scriptname Especifica o caminho e o nome do arquivo de script.

/b Especifica o modo de lote, que não exibe alertas, erros de script ou prompts
de entrada. O parâmetro /b é o oposto de /i.

/d Inicia o depurador.

/e Especifica o mecanismo usado para executar o script. Esse parâmetro permite


executar scripts que usam uma extensão de nome de arquivo personalizado.
Sem o parâmetro /e, você só pode executar scripts que usam extensões de
nome de arquivo registrado. Por exemplo, se você tentar executar este
comando:
cscript test.admin
Você receberá esta mensagem de erro: Erro de entrada: não há mecanismo de
script para a extensão de arquivo .admin .
Uma vantagem de usar extensões de nome de arquivo não padrão é que isso
protege contra a seleção dupla acidental de um script e a execução de algo
indesejado.
Usar essa extensão não cria uma associação permanente entre a extensão de
nome de arquivo .admin e o VBScript. Sempre que você executar um script
que usa uma extensão de nome de arquivo .admin , será necessário usar o
parâmetro /e.

/h:cscript Registra cscript.exe como o host de script padrão para executar scripts.
Parâmetro Descrição

/h:wscript Registra wscript.exe como o host de script padrão para executar scripts. Esse é
o comportamento padrão quando a opção /h é omitida.

/i Especifica o modo interativo, que exibe alertas, erros de script e prompts de


entrada.
O parâmetro /i é o padrão e o oposto de /b.

/job:\ Executa o trabalho identificado pelo identificador em um arquivo de script


<identifier> .wsf.

/logo Especifica que a faixa do Host de Script do Windows seja exibida no console
antes da execução do script.
O parâmetro /logo é o padrão e o oposto de /nologo.

/nologo Especifica que a faixa do Host de Script do Windows não seja exibida antes da
execução do script. O parâmetro /nologo é o oposto de /logo.

/s Salva as opções do prompt de comando atuais para o usuário atual.

/t:\<number> Especifica o tempo máximo que o script pode executar (em segundos). Você
pode especificar até 32.767 segundos.
O padrão é sem limite de tempo.

/x Inicia o script no depurador.

ScriptArguments Especifica os argumentos passados ao script. Cada argumento de script deve


ser precedido por uma barra (/).

/? Exibe a ajuda no prompt de comando.

Comentários
A execução desta tarefa não exige que você possua credenciais administrativas.
Considere executar essa tarefa como um usuário sem credenciais administrativas,
como uma melhor prática de segurança.
Para abrir um prompt de comando, na tela Inicial, digite cmd e selecione prompt
de comando.
Cada parâmetro é opcional. No entanto, você não pode especificar argumentos de
script sem especificar um script. Se você não especificar um script ou argumentos
de script, wscript.exe exibirá a caixa de diálogo Configurações do Host de Script
do Windows. Use a caixa de diálogo para definir propriedades de script global
para todos os scripts que wscript.exe executa no computador local.
O parâmetro /t impede a execução excessiva de scripts definindo um
temporizador. Quando o tempo excede o valor especificado, wscript interrompe o
mecanismo do script e encerra o processo.
Os arquivos de script do Windows geralmente têm uma das seguintes extensões
de nome de arquivo: .wsf, .vbs, .js.
Se você selecionar duas vezes um arquivo de script com uma extensão sem
associação, a caixa de diálogo Abrir com será exibida. Selecione wscript ou cscript
e, em seguida, selecione Sempre usar este programa para abrir esse tipo de
arquivo. Isso registra wscript.exe ou cscript.exe como o host de script padrão para
os arquivos desse tipo de arquivo.
É possível definir propriedades para scripts individuais. Para obter mais
informações sobre o Host de Script do Windows, confira Visão geral do Host de
Script do Windows.
O Host de Script do Windows pode usar arquivos de script .wsf. Cada arquivo .wsf
pode usar vários mecanismos de script e executar vários trabalhos.

Links relacionados
Chave da sintaxe de linha de comando
xcopy
Artigo • 12/04/2023

Copia arquivos e diretórios, incluindo subdiretórios.

Para obter exemplos de como usar esse comando, consulte Exemplos.

Sintaxe

Xcopy <Source> [<Destination>] [/w] [/p] [/c] [/v] [/q] [/f] [/l] [/g] [/d
[:MM-DD-YYYY]] [/u] [/i] [/s [/e]] [/t] [/k] [/r] [/h] [{/a | /m}] [/n] [/o]
[/x] [/exclude:FileName1[+[FileName2]][+[FileName3]]] [{/y | /-y}] [/z] [/b]
[/j] [/compress]

Parâmetros

Parâmetro Descrição

<Origem> Obrigatórios. Especifica o local e os nomes dos arquivos que você


quer copiar. Esse parâmetro deve incluir uma unidade ou um
caminho.

[<Destination>] Especifica o destino dos arquivos que você deseja copiar. Esse
parâmetro pode incluir uma letra da unidade e dois-pontos, um
nome de diretório, um nome de arquivo ou uma combinação
deles.

/w Exibe a seguinte mensagem e aguarda sua resposta antes de


começar a copiar arquivos:
Pressione qualquer tecla para começar a copiar os arquivos

/p Solicita que você confirme se deseja criar cada arquivo de


destino.

/c Ignora erros.

/v Verifica cada arquivo conforme é gravado no destino para


assegurar que os arquivos de destino sejam exatamente iguais
aos arquivos de origem.

/q Suprime a exibição de mensagens xcopy .

/f Exibe nomes do arquivo de origem e de destino durante a cópia.


Parâmetro Descrição

/l Gera uma lista de arquivos que devem ser copiados, mas não os
copia ativamente.

/g Cria arquivos de destino descriptografados quando o destino não


dá suporte à criptografia.

/d [:MM-DD-YYYY] Copia apenas os arquivos de origem alterados a partir da data


especificada. Se você não incluir um valor MM-DD-YYYY, xcopy
copiará todos os arquivos de origem mais recentes do que os
arquivos de destino existentes. Essa opção de linha de comando
permite atualizar arquivos que foram alterados.

/u Copia arquivos da origem que existem somente no destino.

/i Se a origem for um diretório ou contiver curingas e o destino não


existir, xcopy pressupõe que o destino está especificando um
nome de diretório e cria um novo diretório. Em seguida, xcopy
copia todos os arquivos especificados para o novo diretório. Por
padrão, xcopy solicita que você especifique se o destino é um
arquivo ou um diretório.

/s Copia diretórios e subdiretórios, a menos que estejam vazios. Se


você omitir /s, xcopy funcionará em um único diretório.

/e Copia todos os subdiretórios, mesmo que estejam vazios. Use /e


com as opções de linha de comando /s e /t.

/t Copia apenas a estrutura do subdiretório (ou seja, a árvore), mas


não os arquivos. Para copiar diretórios vazios, você deve incluir a
opção de linha de comando /e.

/k Copia arquivos e retém o atributo somente leitura nos arquivos


de destino se estiver presente nos arquivos de origem. Por padrão,
xcopy remove o atributo somente leitura.

/r Copia arquivos somente leitura.

/h Copia arquivos com atributos de arquivos ocultos e do sistema.


Por padrão, xcopy não copia arquivos ocultos ou do sistema

/a Copia somente arquivos de origem que têm seus atributos de


arquivo morto definidos. /a não modifica o atributo de arquivo
morto do arquivo de origem. Para obter informações sobre como
definir o atributo de arquivo morto usando attrib, consulte os
Links relacionados.
Parâmetro Descrição

/m Copia arquivos de origem que têm seus atributos de arquivo


morto definidos. Ao contrário de /a, /m desativa os atributos de
arquivo morto nos arquivos especificados na origem. Para obter
informações sobre como definir o atributo de arquivo morto
usando attrib, consulte os Links relacionados.

/n Cria cópias usando os nomes curtos de arquivos ou diretórios do


NTFS. /n é necessário quando você copia arquivos ou diretórios
de um volume NTFS para um volume FAT ou quando a convenção
de nomenclatura do sistema de arquivos FAT (ou seja, 8,3
caracteres) é necessária no sistema de arquivos de destino. O
sistema de arquivos de destino* pode ser FAT ou NTFS.

/o Copia a propriedade do arquivo e as informações da DACL (lista


de controle de acesso discricionário).

/x Copia as configurações de auditoria de arquivo e as informações


da SACL (lista de controle de acesso do sistema) (implica /o).

/exclude:NomeDoArquivo1[+ Especifica uma lista de arquivos. É necessário especificar pelo


[NomeDoArquivo2]][+ menos um arquivo. Cada arquivo incluirá cadeias de caracteres de
[NomeDoArquivo3]( )] pesquisa, cada uma em uma linha separada. Quando qualquer um
dos caracteres da cadeia coincidir com qualquer parte do
caminho absoluto do arquivo a ser copiado, esse arquivo será
excluído da cópia. Por exemplo, especificar a cadeia de caracteres
obj excluirá todos os arquivos sob o diretório obj ou todos os
arquivos com a extensão .obj.

/y Suprime a solicitação para confirmar que você deseja substituir


um arquivo de destino existente.

/-y Solicita que você confirme que deseja substituir um arquivo de


destino existente.

/z Copia em uma rede no modo reinicializável.

/b Copia o link simbólico em vez dos arquivos. Este parâmetro foi


introduzido no Windows Vista®.

/j Copia arquivos sem armazenamento em buffer. Recomendado


para arquivos muito grandes. Este parâmetro foi adicionado no
Windows Server 2008 R2.

/compress Solicita a compactação de rede durante a transferência de


arquivos, quando aplicável.

/? Exibe a ajuda no prompt de comando.


Comentários
Usando /z

Se você perder sua conexão durante a fase de cópia (por exemplo, se o servidor
desconectar e cortar a conexão), ela será retomada após você reestabelecer a
conexão. /z também exibe o percentual da operação de cópia concluída para cada
arquivo.

Usando /y na variável de ambiente COPYCMD.

Você pode usar /y na variável de ambiente COPYCMD. Você pode substituir esse
comando usando /-y na linha de comando. Por padrão, você será solicitado a
substituir.

Copiar arquivos criptografados

Copiar arquivos criptografados para um volume que não dá suporte ao EFS resulta
em um erro. Descriptografe os arquivos primeiro ou copie os arquivos para um
volume que dê suporte ao EFS.

Anexar arquivos

Para anexar arquivos, especifique um único arquivo para o destino, mas vários
arquivos para a origem (ou seja, usando curingas ou formato
arquivo1+arquivo2+arquivo3).

Valor padrão para o destino

Se você omitir o destino, o comando xcopy copiará os arquivos para o diretório


atual.

Especificar se o destino é um arquivo ou diretório

Se o destino não contiver um diretório existente e não terminar com uma barra
invertida (\), a seguinte mensagem será exibida:

Does <Destination> specify a file name or directory name on the


target(F = file, D = directory)?

Pressione F se quiser que o arquivo ou os arquivos sejam copiados para um arquivo.


Pressione D se quiser que o arquivo ou os arquivos sejam copiados para um diretório.
Você pode suprimir essa mensagem usando a opção de linha de comando /i, o que faz
com que xcopy assuma que o destino seja um diretório se a origem for mais de um
arquivo ou um diretório.

Usar o comando xcopy para definir o atributo de arquivo morto para arquivos de
destino

O comando xcopy cria arquivos com o conjunto de atributos de arquivo morto,


independentemente de esse atributo ter sido definido ou não no arquivo de
origem. Para obter mais informações sobre atributos de arquivo e attrib, consulte
os Links relacionados.

Comparar ** xcopy ** e diskcopy

Se você tiver um disco que contenha arquivos em subdiretórios e quiser copiá-lo


para um disco que tenha um formato diferente, use o comando xcopy em vez de
diskcopy. Como o comando diskcopy copia os discos faixa por faixa, os discos de
origem e de destino devem ter o mesmo formato. O comando xcopy não tem esse
requisito. Use xcopy a menos que você precise de uma cópia completa da imagem
de disco.

Sair de códigos para xcopy

Para processar códigos de saída retornados por xcopy , use o parâmetro ErrorLevel
na linha de comando if em um programa em lotes. Para obter um exemplo de um
programa em lotes que processa códigos de saída usando if, consulte os Links
relacionados. A tabela a seguir lista cada código de saída e uma descrição.

Código Descrição
de
saída

0 Os arquivos foram copiados sem erro.

1 Nenhum arquivo encontrado para copiar.

2 O usuário pressionou CTRL+C para encerrar xcopy .

4 Ocorreu um erro de inicialização. Não há memória ou espaço em disco suficiente


ou você inseriu um nome de unidade inválido ou uma sintaxe inválida na linha de
comando.

5 Erro de gravação de disco.


Exemplos
1. Para copiar todos os arquivos e subdiretórios (incluindo quaisquer subdiretórios
vazios) da unidade A para a unidade B, digite:

xcopy a: b: /s /e

2. Para incluir qualquer sistema ou arquivos ocultos no exemplo anterior, adicione a


opção de linha de comando /h da seguinte maneira:

xcopy a: b: /s /e /h

3. Para atualizar arquivos no diretório \Reports com os arquivos no diretório \Rawdata


que foram alterados desde 29 de dezembro de 1993, digite:

xcopy \rawdata \reports /d:12-29-1993

4. Para atualizar todos os arquivos que existem em \Reports no exemplo anterior,


independentemente da data, digite:

xcopy \rawdata \reports /u

5. Para obter uma lista dos arquivos a serem copiados pelo comando anterior (ou seja,
sem realmente copiar os arquivos), digite:

xcopy \rawdata \reports /d:12-29-1993 /l > xcopy.out

O arquivo xcopy.out lista todos os arquivos que devem ser copiados.

6. Para copiar o diretório \Customer e todos os subdiretórios para o diretório


\\Public\Address na unidade de rede H:, mantenha o atributo somente leitura e ser
solicitado quando um novo arquivo for criado em H:, digite:
xcopy \customer h:\public\address /s /e /k /p

7. Para emitir o comando anterior, certifique-se de que xcopy crie o diretório \Address
se ele não existir e suprima a mensagem exibida ao criar um novo diretório, adicione a
opção de linha de comando /i da seguinte maneira:

xcopy \customer h:\public\address /s /e /k /p /i

8. Você pode criar um programa em lotes para executar operações xcopy e usar o
comando de lote if para processar o código de saída se ocorrer um erro. Por exemplo, o
seguinte programa em lotes usa parâmetros substituíveis para os parâmetros de origem
e destino xcopy :

@echo off
rem COPYIT.BAT transfers all files in all subdirectories of
rem the source drive or directory (%1) to the destination
rem drive or directory (%2)
xcopy %1 %2 /s /e
if errorlevel 4 goto lowmemory
if errorlevel 2 goto abort
if errorlevel 0 goto exit
:lowmemory
echo Insufficient memory to copy files or
echo invalid drive or command-line syntax.
goto exit
:abort
echo You pressed CTRL+C to end the copy operation.
goto exit
:exit

Para usar o programa em lotes anterior para copiar todos os arquivos no diretório
C:\Prgmcode e seus subdiretórios para a unidade B, digite:

copyit c:\prgmcode b:

O interpretador de comando substitui C:\Prgmcode por %1 e B: para %2 e usa xcopy


com as opções de linha de comando /e e /s. Se xcopy encontrar um erro, o programa
em lotes lerá o código de saída e irá para o rótulo indicado na instrução IF ERRORLEVEL
apropriada e exibirá a mensagem apropriada e sairá do programa em lotes.

9. Este exemplo copia todos os diretórios não vazios, além de arquivos com a extensão
de arquivo associada após o símbolo de asterisco.

xcopy .\toc*.yml ..\..\Copy-To\ /S /Y

rem Output example.


rem .\d1\toc.yml
rem .\d1\d12\toc.yml
rem .\d2\toc.yml
rem 3 File(s) copied

No exemplo anterior, esse valor de parâmetro de origem específico .\toc*.yml copia os


mesmos 3 arquivos, mesmo que seus dois caracteres de caminho .\ tenham sido
removidos. No entanto, nenhum arquivo seria copiado se o curinga do asterisco fosse
removido do parâmetro de origem, tornando-o apenas .\toc.yml.

Links relacionados
Copy
Mover
Dir
Attrib
Diskcopy
If
Chave da sintaxe de linha de comando

Você também pode gostar