Está en la página 1de 2033

Díganos qué opina sobre la experiencia de descarga del PDF.

Comandos de Windows
Artículo • 25/04/2023

Todas las versiones compatibles de Windows y Windows Server tienen un conjunto de


comandos de consola Win32 integrados. En este conjunto de documentación se
describen los comandos de Windows que puede usar para automatizar tareas mediante
scripts o herramientas de scripting.

Shells de línea de comandos


Windows tiene dos shells de línea de comandos: el shell de comandos y PowerShell.
Cada shell es un programa de software que proporciona comunicación directa entre el
usuario y el sistema operativo o la aplicación, proporcionando un entorno para
automatizar las operaciones de TI.

El Shell de comandos fue el primer shell integrado en Windows para automatizar tareas
rutinarias, como la administración de cuentas de usuario o las copias de seguridad
nocturnas, con archivos por lotes (.bat). Con Windows Script Host, puede ejecutar scripts
más sofisticados en el Shell de comandos. Para obtener más información, consulte
cscript o wscript. Puede realizar operaciones de forma más eficaz mediante scripts que
mediante la interfaz de usuario. Los scripts aceptan todos los comandos disponibles en
la línea de comandos.

PowerShell se diseñó para ampliar las funcionalidades del Shell de comandos para
ejecutar comandos de PowerShell denominados cmdlets. Los cmdlets son similares a los
comandos de Windows, pero proporcionan un lenguaje de scripting más extensible.
Puede ejecutar tanto los comandos de Windows como los cmdlets de PowerShell en
PowerShell, pero el Shell de comandos solo puede ejecutar comandos de Windows y no
cmdlets de PowerShell.

Para la automatización de Windows más sólida y actualizada, se recomienda usar


PowerShell en lugar de comandos de Windows o Windows Script Host para
automatización de Windows.

Puede encontrar una referencia de códigos de salida y error para los comandos de
Windows en los artículos Códigos de error del sistema de depuración que pueden
resultar útiles para comprender los errores generados. Los comandos de Windows
también incluyen operadores de redireccionamiento de comandos. Para obtener más
información sobre su uso, consulte Uso de operadores de redireccionamiento de
comandos.
7 Nota

También puede descargar e instalar PowerShell Core, la versión de código abierto


de PowerShell.

Finalización automática del archivo del Shell de


comandos y el nombre del directorio
Puede configurar el Shell de comandos para completar automáticamente los nombres
de archivo y directorio en un equipo o sesión de usuario cuando se presiona un carácter
de control especificado. De forma predeterminada, este carácter de control está
configurado para que sea la tecla de tabulador para los nombres de archivo y
directorio, aunque pueden ser diferentes. Para cambiar este carácter de control, ejecute
regedit.exe y vaya a cualquiera de las siguientes claves y entradas del Registro, en
función de si desea cambiar el valor solo para el usuario actual o para todos los usuarios
del equipo.

U Precaución

La edición incorrecta del Registro puede dañar gravemente el sistema. Antes de


realizar los siguientes cambios en el Registro, debe hacer una copia de seguridad
de los datos de valor guardados en el equipo.

registry

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

Establezca estos valores en los del carácter de control que desea usar. Consulte códigos
de clave virtual para obtener una lista completa. Para deshabilitar un carácter de
terminación determinado en el Registro, use el valor para espacio (0×20) porque no es
un carácter de control válido. El tipo de valor de esta entrada de Registro es
REG_DWORD y se puede especificar también mediante un valor hexadecimal o decimal.

También puede habilitar o deshabilitar la finalización del nombre de archivo y directorio


por instancia de un Shell de comandos mediante la ejecución de cmd.exe con el
parámetro y el conmutador /F:ON o /F:OFF . Si la finalización del nombre está habilitada
con el conmutador y el parámetro /F:ON , los dos caracteres de control usados son
Ctrl-D para la finalización del nombre de directorio y Ctrl-F para la finalización del
nombre de archivo. La configuración especificada por el usuario tiene prioridad sobre la
configuración del equipo y las opciones de línea de comandos tienen prioridad sobre la
configuración del registro.

Referencia A-Z de la línea de comandos


Para buscar información sobre un comando específico, en el siguiente menú A-Z,
seleccione la letra con la que empieza el comando y, a continuación, seleccione el
nombre del 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 y delete
bitsadmin cache y deleteurl
bitsadmin cache y getexpirationtime
bitsadmin cache y getlimit
bitsadmin cache y help
bitsadmin cache e info
bitsadmin cache y list
bitsadmin cache y setexpirationtime
bitsadmin cache y setlimit
bitsadmin cache y clear
bitsadmin cancel
bitsadmin complete
bitsadmin create
Ejemplos de bitsadmin
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 y getconfigurationflags
bitsadmin peercaching y help
bitsadmin peercaching y setconfigurationflags
bitsadmin peers
bitsadmin peers y clear
bitsadmin peers y discover
bitsadmin peers y help
bitsadmin peers y 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 y enableanalyticchannel
bitsadmin util y getieproxy
bitsadmin util y help
bitsadmin util y repairservice
bitsadmin util y setieproxy
bitsadmin util y 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
crear partición extendida
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 y logman export
logman query
logman start y 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
Comando nslookup exit
Comando nslookup finger
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
set device (subcomando)
set drivergroup (subcomando)
set drivergroupfilter (subcomando)
set driverpackage (subcomando)
set image (subcomando)
set imagegroup (subcomando)
set image (subcomando)
set transportserver (subcomando)
set multicasttransmission (subcomando)
start namespace (subcomando)
start server (subcomando)
start transportserver (subcomando)
stop server (subcomando)
stop transportserver (subcomando)
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
Clave de sintaxis de la línea de
comandos
Artículo • 08/09/2023

La siguiente tabla describe la notación que se usa para indicar la sintaxis de línea de
comandos.

Notación Descripción

Texto sin corchetes ni llaves Elementos que se deben escribir como se muestra.

<Text inside angle brackets> Marcador de posición para el que debe proporcionar un valor.

[Text inside square Elementos opcionales.


brackets]

{Text inside braces} Conjunto de elementos obligatorios. Debe elegir una.

Barra vertical ( | ) Separador para elementos mutuamente exclusivos. Debe elegir


una.

Puntos suspensivos ( … ) Elementos que se pueden repetir y usar varias veces.


Comandos por rol del servidor
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Un rol del servidor describe la función principal del servidor. Los administradores
pueden optar por dedicar un servidor completo a un rol o instalar varios roles de
servidor y subroles en un solo equipo. Cada rol puede incluir herramientas de línea de
comandos adicionales, instaladas como parte del rol. En los temas siguientes se
proporciona una lista de comandos asociados a cada rol del servidor.

Referencia de comandos de impresión

Servicios de referencia de comandos de sistema de archivos de red

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto

Referencia de comandos de copia de seguridad de Windows Server


Referencia de la herramienta de línea de
comandos de impresión
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Información y vínculos a cada una de las herramientas de línea de comandos de


impresión asociadas:

Get-Help Descripción

lpq Muestra el estado de una cola de impresión en un equipo que ejecuta


Line printer Daemon (LPD).

lpr Envía un archivo a un equipo o dispositivo de uso compartido de


impresoras que ejecute el servicio Line printer Daemon (LPD) como
preparación para la impresión.

Net print Muestra información sobre una cola de impresión especificada, muestra
información sobre un trabajo de impresión especificado o controla un
trabajo de impresión especificado.

print Envía un archivo de texto a una impresora.

prncnfg Configura o muestra información de la configuración de una impresora.

prndrvr Agrega, elimina y enumera los controladores de impresora.

prnjobs Pausa, reanuda, cancela y enumera los trabajos de impresión.

prnmngr Agrega, elimina y enumera impresoras o conexiones de impresora,


además de establecer y mostrar la impresora predeterminada.

prnport Crea, elimina y enumera los puertos de impresora TCP/IP estándar,


además de mostrar y cambiar la configuración del puerto.

prnqctl Imprime una página de prueba, pausa o reanuda una impresora y borra
una cola de impresora.

pubprn Publica una impresora en el servicio de directorio de Active Directory.

rundll32 Permite automatizar la instalación y configuración de impresoras


printui.dll,printUIEntry mediante scripts o el símbolo del sistema.
Servicios para herramientas de línea de
comandos de Network File System
Artículo • 08/04/2023

Servicios para Network File System (NFS) es una solución para compartir archivos que
permite transferir archivos entre equipos con sistemas operativos Windows y UNIX
mediante el protocolo NFS.

Información y vínculos a cada una de las herramientas de línea de comandos de NFS


asociadas:

Get-Help Descripción

mapadmin Administración de la asignación de nombres de usuario para servicios de Microsoft


para Network File System.

mount Montaje de recursos compartidos de red del Network File System (NFS).

nfsadmin Administración del servidor para NFS y el cliente para NFS.

nfsshare Control de recursos compartidos de Network File System (NFS).

nfsstat Visualización o restablecimiento de los recuentos de llamadas realizadas al servidor


para NFS.

rpcinfo Enumeración de programas en equipos remotos.

showmount Visualización de directorios montados.

Vínculos relacionados
Clave de sintaxis de línea de comandos
Referencia de herramientas de línea de
comandos de Servicios de Escritorio
remoto (Terminal Services)
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Obtenga información sobre las herramientas de línea de comandos de Servicios de


Escritorio remoto (Terminal Services) disponibles, con descripciones y vínculos para
obtener información más detallada.

7 Nota

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de Escritorio remoto en Windows Server.

Get-Help Descripción

change Cambia la configuración del servidor host de sesión de Escritorio remoto para el
inicio de sesión, las asignaciones de puertos COM y el modo de instalación.

change Habilita o deshabilita los inicios de sesión de las sesiones de cliente en un servidor
logon host de sesión de Escritorio remoto o muestra el estado de inicio de sesión actual.

change Muestra o cambia las asignaciones de puertos COM para que sean compatibles con
port las aplicaciones MS-DOS.

change Cambia el modo de instalación del servidor host de sesión de Escritorio remoto.
user

chglogon Habilita o deshabilita los inicios de sesión de las sesiones de cliente en un servidor
host de sesión de Escritorio remoto o muestra el estado de inicio de sesión actual.

chgport Muestra o cambia las asignaciones de puertos COM para que sean compatibles con
las aplicaciones MS-DOS.

chgusr Cambia el modo de instalación del servidor host de sesión de Escritorio remoto.

flattemp Habilita o deshabilita carpetas temporales planas.

logoff Cierra la sesión de un usuario de una sesión en un servidor host de sesión de


Escritorio remoto y elimina la sesión del servidor.
Get-Help Descripción

msg Envía un mensaje a un usuario en un servidor host de sesión de escritorio remoto.

mstsc Crea conexiones a servidores host de sesión de Escritorio remoto u otros equipos
remotos.

qappsrv Muestra una lista de todos los servidores host de sesión de Escritorio remoto de la
red.

qprocess Muestra información sobre los procesos que se ejecutan en un servidor host de
sesión de Escritorio remoto.

consulta Muestra información sobre procesos, sesiones y servidores host de sesión de


Escritorio remoto.

query Muestra información sobre los procesos que se ejecutan en un servidor host de
process sesión de Escritorio remoto.

query Muestra información sobre las sesiones en un servidor host de sesión de Escritorio
session remoto.

query Muestra una lista de todos los servidores host de sesión de Escritorio remoto de la
termserver red.

query user Muestra información sobre las sesiones de usuario en un servidor host de sesión de
Escritorio remoto.

quser Muestra información sobre las sesiones de usuario en un servidor host de sesión de
Escritorio remoto.

qwinsta Muestra información sobre las sesiones en un servidor host de sesión de Escritorio
remoto.

rdpsign Permite firmar digitalmente un archivo de Protocolo de escritorio remoto (.rdp).

reset Permite restablecer (eliminar) una sesión en un servidor host de sesión de Escritorio
session remoto.

rwinsta Permite restablecer (eliminar) una sesión en un servidor host de sesión de Escritorio
remoto.

shadow Permite controlar de forma remota una sesión activa de otro usuario en un servidor
host de sesión de Escritorio remoto.

tscon Se conecta a otra sesión en un servidor host de sesión de Escritorio remoto.

tsdiscon Desconecta una sesión de un servidor host de sesión de Escritorio remoto.

tskill Finaliza un proceso que se ejecuta en una sesión en un servidor host de sesión de
Escritorio remoto.
Get-Help Descripción

tsprof Copia la información de configuración de usuario de Servicios de Escritorio remoto


de un usuario a otro.

Vínculos relacionados
Clave de sintaxis de línea de comandos
Referencia de comandos de copia de
seguridad de Windows Server
Artículo • 08/04/2023

Los siguientes subcomandos para wbadmin proporcionan funciones de copia de


seguridad y recuperación desde un símbolo del sistema.

Para configurar una programación de copia de seguridad, debe ser miembro del grupo
Administradores. Para realizar el resto de tareas con este comando, debe ser miembro
del grupo Operadores de copias de seguridad o del grupo Administradores, o se le
deben haber delegado los permisos adecuados.

Debe ejecutar wbadmin desde un símbolo del sistema con privilegios elevados. (Para
abrir un símbolo del sistema con privilegios elevados, haga clic en Inicio, haga clic con
el botón derecho del ratón en Símbolo del sistema y haga clic en Ejecutar como
administrador).

Subcomando Descripción

Wbadmin enable Configura y habilita una programación de copia de seguridad diaria.


backup

Wbadmin disable Deshabilita las copias de seguridad diarias.


backup

Wbadmin start Ejecuta una copia de seguridad única. Si se usa sin parámetros, usa la
backup configuración de la programación de copia de seguridad diaria.

Wbadmin stop job Detiene la operación de copia de seguridad o recuperación en curso.

Wbadmin get Enumera los detalles de las copias de seguridad recuperables desde el
versions equipo local o, si se especifica otra ubicación, desde otro equipo.

Wbadmin get items Enumera los elementos incluidos en una copia de seguridad específica.

Wbadmin start Ejecuta una recuperación de los volúmenes, aplicaciones, archivos o


recovery carpetas especificados.

Wbadmin get status Muestra el estado de la operación de copia de seguridad o recuperación


que se está ejecutando actualmente.

Wbadmin get disks Enumera los discos que están actualmente en línea.

Wbadmin start Ejecuta una recuperación de estado del sistema.


systemstaterecovery
Subcomando Descripción

Wbadmin start Ejecuta una copia de seguridad de estado del sistema.


systemstatebackup

Wbadmin delete Elimina una o varias copias de seguridad de estado del sistema.
systemstatebackup

Wbadmin start Ejecuta una recuperación del sistema completo (al menos de todos los
sysrecovery volúmenes que contienen el estado del sistema operativo). Este
subcomando solo está disponible si usa el entorno de recuperación de
Windows.

Wbadmin restore Recupera un catálogo de copias de seguridad de una ubicación de


catalog almacenamiento especificada en caso de que el catálogo de copia de
seguridad del equipo local esté dañado.

Wbadmin delete Elimina el catálogo de copias de seguridad en el equipo local. Use este
catalog comando solo si el catálogo de copias de seguridad de este equipo está
dañado y no tiene copias de seguridad almacenadas en otra ubicación que
puede usar para restaurar el catálogo.
active
Artículo • 12/04/2023

En discos básicos, marca como activa la partición que tiene el foco. Sólo las particiones
se pueden marcar como "activas". Se debe seleccionar una partición para que esta
operación se realice correctamente. Use el comando select partition para seleccionar
una partición y desplazar el foco a ella.

U Precaución

DiskPart tan solo informa al sistema básico de entrada/salida (BIOS) o a la interfaz


de firmware extensible (EFI) que la partición o el volumen es una partición o
volumen del sistema válidos, y es capaz de contener los archivos de inicio del
sistema operativo. DiskPart no comprueba el contenido de la partición. Si por error
marca como "activa" una partición que no contiene los archivos de inicio del
sistema operativo, el equipo podría no iniciarse.

Sintaxis

active

Ejemplos
Para marcar la partición con el foco como partición activa, escriba:

active

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando select partition


add (diskshadow)
Artículo • 13/10/2023

Agrega volúmenes al conjunto de volúmenes que se van a copiar en la sombra o agrega


alias al entorno de alias. Si se usa sin subcomandos, add enumera los volúmenes y alias
actuales.

7 Nota

Los alias no se agregan al entorno de alias hasta que se crea la instantánea. Los
alias que necesita se deben agregar inmediatamente mediante el uso de add alias.

Sintaxis

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

Parámetros

Parámetro Descripción

volumen Agrega un volumen al conjunto de instantáneas, que es el conjunto de volúmenes


que se van a copiar instantáneamente. Consulte add volume para ver la sintaxis y los
parámetros.

alias Agrega el nombre y el valor indicados al entorno de alias. Consulte add alias para la
sintaxis y los parámetros.

/? Muestra ayuda en la línea de comandos.

Ejemplos
Para mostrar los volúmenes agregados y los alias que están actualmente en el entorno,
escriba:
add

La siguiente salida muestra que la unidad C se ha agregado al conjunto de instantáneas:

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


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

Vínculos relacionados
Clave de sintaxis de línea de comandos
add alias
Artículo • 14/04/2023

Agrega alias al entorno de alias. Si se usa sin parámetros, add alias muestra la ayuda en
el símbolo del sistema. Los alias se guardan en el archivo de metadatos y se cargan con
el comando load metadata.

Sintaxis

add alias <aliasname> <aliasvalue>

Parámetros

Parámetro Descripción

<aliasname> Especifica el nombre del alias.

<aliasvalue> Especifica el valor de los alias.

`? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para enumerar todas las sombras, incluidos sus alias, escriba:

list shadows all

En el fragmento siguiente se muestra una instantánea a la que se ha asignado el alias


predeterminado, VSS_SHADOW_x:

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


%VSS_SHADOW_1%

Para asignar un nuevo alias con el nombre System1 a esta instantánea, escriba:
add alias System1 %VSS_SHADOW_1%

Como alternativa, puede asignar el alias mediante el id. de instantánea:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando load metadata


add volume
Artículo • 14/04/2023

Agrega volúmenes al conjunto de instantáneas, que es el conjunto de volúmenes en con


que se van a crear instantáneas. Cuando se crea una instantánea, una variable de
entorno vincula el alias al identificador de instantánea, por lo que el alias se puede usar
para el scripting.

Los volúmenes se agregan de uno en uno. Cada vez que se agrega un volumen, se
comprueba para asegurarse de que VSS admite la creación de instantáneas para ese
volumen. Esta comprobación se puede invalidar mediante el uso posterior del comando
set context.

Este comando es necesario para crear instantáneas. Si se usa sin parámetros, add
volume muestra ayuda en el símbolo del sistema.

Sintaxis

add volume <volume> [provider <providerid>]

Parámetros

Parámetro Descripción

<volume> Especifica un volumen que se va a agregar al conjunto de instantáneas. Se


requiere al menos un volumen para la creación de instantáneas.

[provider \ Especifica el identificador de proveedor para que un proveedor registrado lo use


<providerid>] para crear la instantánea. Si no se especifica un proveedor, se utiliza el proveedor
predeterminado.

Ejemplos
Para ver la lista actual de proveedores registrados, escriba lo siguiente en el mensaje
diskshadow> :

list providers
La salida siguiente muestra un único proveedor, que se usará de forma predeterminada:

* 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 agregar la unidad C: al conjunto de instantáneas y asignar un alias denominado


System1, escriba:

add volume c: alias System1

Vínculos relacionados
Clave de sintaxis de línea de comandos

COMANDO set context


append
Artículo • 12/04/2023

Permite que los programas abran archivos de datos en directorios especificados como si
estuvieran en el directorio actual. Si se usa sin parámetros, append muestra la lista de
directorios anexada.

7 Nota

Este comando no se admite en Windows 10.

Sintaxis

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


append ;

Parámetros

Parámetro Descripción

[\ Especifica una unidad y un directorio que se van a anexar.


<drive>:]
<path>

/x:on Aplica directorios anexados a búsquedas de archivos y a aplicaciones de inicio.

/x:off Aplica directorios anexados solo a las solicitudes para abrir archivos. La opción
/x:off es la configuración predeterminada.

/path:on Aplica directorios anexados a solicitudes de archivo que ya especifican una ruta de
acceso. /path:on es la configuración predeterminada.

/path:off Desactiva el efecto de /path:on.

/e Almacena una copia de la lista de directorios anexados en una variable de entorno


denominada APPEND. /e solo se puede usar la primera vez que use append
después de iniciar el sistema.

; Borra la lista de directorios anexados.

/? Muestra la ayuda en el símbolo del sistema.


Ejemplos
Para borrar la lista de directorios anexados, escriba lo siguiente:

append ;

Para almacenar una copia del directorio anexado a una variable de entorno denominada
append, escriba lo siguiente:

append /e

Vínculos relacionados
Clave de sintaxis de línea de comandos
arp
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra y modifica las entradas en la memoria caché del Protocolo de resolución de


direcciones (ARP). La memoria caché de ARP contiene una o varias tablas que se usan
para almacenar direcciones IP y sus direcciones físicas de Ethernet o Token Ring
resueltas. Hay una tabla independiente para cada adaptador de red Ethernet o Token
Ring instalado en el equipo. Usado sin parámetros, arp muestra información de ayuda.

Sintaxis

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


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

Parámetros

Parámetro Descripción

[/a Muestra las tablas de caché de arp actuales para todas las interfaces. El
[<inetaddr>] parámetro /n distingue mayúsculas de minúsculas. Para mostrar la entrada de
[/n caché arp para una dirección IP específica, use arp /a con el parámetro inetaddr,
<ifaceaddr>] donde inetaddr es una dirección IP. Si no se especifica inetaddr, se usa la
primera interfaz aplicable. Para mostrar la tabla de caché arp para una interfaz
específica, use el parámetro /n ifaceaddr junto con el parámetro /a donde
inetaddr es la dirección IP asignada a la interfaz.

[/g Idéntico a /a.


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

[/d Elimina una entrada con una dirección IP específica, donde inetaddr es la
<inetaddr> dirección IP. Para eliminar una entrada de una tabla para una interfaz específica,
[<ifaceaddr>] use el parámetro ifaceaddr donde ifaceaddr es la dirección IP asignada a la
interfaz. Para eliminar todas las entradas, use el carácter comodín asterisco (*) en
lugar de inetaddr.
Parámetro Descripción

[/s Agrega una entrada estática a la memoria caché arp que resuelve la dirección IP
<inetaddr> inetaddr a la dirección física etheraddr. Para agregar una entrada de caché arp
<etheraddr> estática a la tabla para una interfaz específica, use el parámetro ifaceaddr donde
[<ifaceaddr>] ifaceaddr es una dirección IP asignada a la interfaz.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Las direcciones IP de inetaddr e ifaceaddr se expresan en notación decimal de
puntos.

La dirección física para etheraddr consta de seis bytes expresados en notación


hexadecimal y separados por guiones (por ejemplo, 00-AA-00-4F-2A-9C).

Las entradas agregadas con el parámetro /s son estáticas y no agotan el tiempo de


espera de la memoria caché de arp. Las entradas se quitan si el protocolo TCP/IP
se detiene e inicia. Para crear entradas de caché arp estáticas permanentes,
coloque los comandos arp adecuados en un archivo por lotes y use Tareas
programadas para ejecutar el archivo por lotes en el inicio.

Ejemplos
Para mostrar las tablas de caché arp para todas las interfaces, escriba:

arp /a

Para mostrar la tabla de caché arp para la interfaz a la que se asigna la dirección IP
10.0.0.99, escriba:

arp /a /n 10.0.0.99

Para agregar una entrada de caché arp estática que resuelva la dirección IP 10.0.0.80 a la
dirección física 00-AA-00-4F-2A-9C, escriba:
arp /s 10.0.0.80 00-AA-00-4F-2A-9C

Vínculos relacionados
Clave de sintaxis de línea de comandos
asignar
Artículo • 09/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Asigna una letra de unidad o un punto de montaje al volumen que tiene el foco. Este
comando también se puede utilizar para cambiar la letra de unidad asociada a una
unidad extraíble. Si no se especifican una letra de unidad o un punto de montaje, se
asigna la siguiente letra de unidad disponible. Si la letra de unidad o el punto de
montaje ya están en uso, se genera un error.

Se debe seleccionar un volumen para que esta operación se realice correctamente. Use
el comando select volume para seleccionar un volumen y desplazar el foco a él.

) Importante

No se pueden asignar letras de unidad a volúmenes de sistema, a volúmenes de


arranque ni a volúmenes que contengan el archivo de paginación. Además, no se
puede asignar una letra de unidad a una partición del fabricante de equipos
originales (OEM) o a cualquier partición de la tabla de particiones GUID (GPT) que
no sea una partición de datos básica.

Sintaxis

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

Parámetros

Parámetro Descripción

letter=<d> La letra de unidad que desea asignar al volumen.

mount= La ruta de acceso del punto de montaje que desea asignar al volumen. Para
<path> obtener instrucciones sobre cómo usar este comando, consulte el artículo Montaje
de una unidad en una carpeta.
Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para asignar la letra E al volumen en el foco, escriba:

assign letter=e

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando select volume


assoc
Artículo • 12/04/2023

Muestra o modifica las asociaciones de extensión de nombre de archivo. Si se usa sin


parámetros, assoc muestra una lista de todas las asociaciones actuales de extensión de
nombre de archivo.

7 Nota

Este comando solo se admite dentro de cmd.exe y no está disponible desde


PowerShell. Aunque puede usar cmd /c assoc como solución alternativa.

Sintaxis

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

Parámetros

Parámetro Descripción

<.ext> Escribe la extensión del nombre de archivo.

<filetype> Especifica el tipo de archivo que se va a asociar a la extensión de nombre de archivo


especificada.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Para realizar cambios en las asociaciones, necesita privilegios de administración.

Para quitar la asociación de tipo de archivo de una extensión de nombre de


archivo, agregue un espacio en blanco después del signo igual presionando la
BARRA ESPACIADORA.

Para asociar archivos sin extensión a un tipo de archivo, use solo un punto (vea los
ejemplos).
Para ver los tipos de archivo actuales que tienen definidas cadenas de comandos
abiertas, use el comando ftype.

Para redirigir la salida de assoc a un archivo de texto, use el operador de


redireccionamiento > .

Ejemplos
Para ver la asociación actual de tipo de archivo para la extensión de nombre de archivo
.txt, escriba:

assoc .txt

Para quitar la asociación de tipo de archivo para la extensión de nombre de archivo .bak,
escriba:

assoc .bak=

7 Nota

Asegúrese de agregar un espacio después del signo igual.

Para ver la salida de assoc paginado, escriba:

assoc | more

Para enviar la salida de assoc al archivo assoc.txt, escriba:

assoc>assoc.txt

Asociar .log a archivos de texto:


assoc .log=txtfile

Asociar archivos sin extensión a archivos de texto:

assoc .=txtfile

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ftype
en
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Programa comandos y programas para que se ejecuten en un equipo en una fecha y


hora especificada. Solo puede usar at cuando el servicio de programación está en
ejecución. Si se usa sin parámetros, at enumera comandos programados. Debe ser
miembro del grupo Administradores local para ejecutar este comando.

Sintaxis

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


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

Parámetros

Parámetro Descripción

\ Especifica un equipo remoto. Si omite este parámetro, at programa los


<computername\> comandos y programas en el equipo local.

<id> Especifica el número de identificación asignado a un comando programado.

/delete Cancela un comando programado. Si omite ID, se cancelan todos los


comandos programados del equipo.

/yes Responde sí a todas las consultas del sistema al eliminar eventos programados.

<time> Especifica la hora en que desea ejecutar el comando. La hora se expresa en


horas:minutos en notación de 24 horas (es decir, 00:00 (medianoche) a 23:59).

interactiva Permite que command interactúe con el escritorio del usuario que ha iniciado
sesión en el momento en que se ejecuta Command.

every: Ejecuta command el día o los días especificados de la semana o del mes (por
ejemplo, todos los jueves o el tercer día de cada mes).
Parámetro Descripción

<date> Especifica la fecha en que desea ejecutar el comando. Puede especificar uno o
varios días de la semana (es decir, escriba M,T,W,Th,F,S,Su) o uno o varios días
del mes (es decir, escriba de 1 a 31). En el caso de varias entradas de fecha,
sepárelas con comas. Si omite date, at usa el día actual del mes.

next: Ejecuta command el siguiente día que procede (por ejemplo, el próximo
jueves).

<command> Especifica el comando de Windows, programa (es decir, archivo .exe o .com) o
programa por lotes (es decir, archivo .bat o .cmd) que desea ejecutar. Cuando
el comando requiera una ruta de acceso como argumento, use la ruta de
acceso absoluta (es decir, toda la ruta de acceso que comienza con la letra de
unidad). Si el comando está en un equipo remoto, especifique la notación UNC
(Convención de nomenclatura universal) para el servidor y el nombre del
recurso compartido, en lugar de una letra de unidad remota.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Este comando no carga automáticamente cmd.exe antes de ejecutar comandos. Si
no está ejecutando un archivo ejecutable (.exe), debe cargar explícitamente
cmd.exe al principio del comando de la siguiente manera:

cmd /c dir > c:\test.out

Si usa este comando sin opciones de línea de comandos, las tareas programadas
aparecen en una tabla con formato similar al siguiente:

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

Si se incluye un número de identificación (ID) con este comando, solo aparece


información de una sola entrada en un formato similar al siguiente:
Task ID: 1
Status: OK
Schedule: Each F
Time of Day: 4:30 PM
Command: net send group leads status due

Después de programar un comando, especialmente un comando que tenga


opciones de línea de comandos, compruebe que la sintaxis del comando es
correcta escribiendo at sin ninguna opción de línea de comandos. Si la información
de la columna Línea de comandos es incorrecta, elimine el comando y vuelva a
escribirlo. Si aun así es incorrecto, vuelva a escribir el comando con menos
opciones de línea de comandos.

Los comandos programados con at se ejecutan como procesos de fondo. La salida


no se muestra en la pantalla del equipo. Para redirigir la salida a un archivo, use el
símbolo de redireccionamiento > . Si redirige la salida a un archivo, debe usar el
símbolo de escape ^ antes del símbolo de redireccionamiento, tanto si usa at en
la línea de comandos como en un archivo por lotes. Por ejemplo, para redirigir la
salida a output.txt, escriba lo siguiente:

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

El directorio actual del comando en ejecución es la carpeta systemroot.

Si cambia la hora del sistema después de programar la ejecución de un comando,


sincronice el programador at con la hora del sistema revisada escribiendo at sin
opciones de línea de comandos.

Los comandos programados se almacenan en el Registro. Como resultado, no


perderá las tareas programadas si reinicia el servicio de programación.

No use una unidad redirigida para los trabajos programados que acceden a la red.
Es posible que el servicio de programación no pueda acceder a la unidad redirigida
o que la unidad redirigida no aparezca si un usuario distinto ha iniciado sesión en
el momento en que se ejecuta la tarea programada. En su lugar, use rutas UNC
para trabajos programados. Por ejemplo:

at 1:00pm my_backup \\server\share


No use la siguiente sintaxis, donde x: es una conexión realizada por el usuario:

at 1:00pm my_backup x:

Si programa un comando at que usa una letra de unidad para conectarse a un


directorio compartido, incluya un comando at para desconectar la unidad cuando
haya terminado de usar la unidad. Si la unidad no está desconectada, la letra de
unidad asignada no estará disponible en el símbolo del sistema.

De forma predeterminada, las tareas programadas que utilizan este comando se


detendrán después de 72 horas. Puede modificar el Registro para cambiar este
valor predeterminado.

Para modificar el Registro

U Precaución

La edición incorrecta del Registro puede dañar gravemente el sistema. Antes


de realizar cambios en el Registro, debe hacer una copia de seguridad de los
datos de valor guardados en el equipo.

1. Inicie el Editor del Registro (regedit.exe).

2. Busque y haga clic en la siguiente clave del Registro:


HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Schedule

3. En el menú Editar, haga clic en Agregar valor y, a continuación, agregue los


siguientes valores del Registro:

Value Name. atTaskMaxHours

Tipo de datos. reg_DWOrd

Radix. Decimal

Value Data: 0. Un valor de 0 en el campo Value Data indica que no hay


ningún límite y que no se detiene. Los valores comprendidos entre 1 y 99
indican el número de horas.

Puede usar la carpeta Tareas programadas para ver o modificar la configuración de


una tarea que se creó mediante este comando. Al programar una tarea con este
comando, la tarea aparece en la carpeta Tareas programadas, con un nombre
similar al siguiente: at3478. Sin embargo, si modifica una tarea a través de la
carpeta Tareas programadas, se actualiza a una tarea programada normal. La tarea
ya no es visible para el comando at y ya no se aplica la configuración de la cuenta
at. Debe escribir explícitamente una cuenta de usuario y una contraseña para la
tarea.

Ejemplos
Para mostrar una lista de comandos programados en el servidor de marketing, escriba
lo siguiente:

at \\marketing

Para obtener más información sobre un comando con el número de identificación 3 en


el servidor Corp, escriba lo siguiente:

at \\corp 3

Para programar un comando net share para que se ejecute en el servidor Corp a las 8:00
de la mañana y redirigir la lista al servidor de mantenimiento, en el directorio
compartido de Informes y el archivo Corp.txt, escriba lo siguiente:

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


\\maintenance\reports\corp.txt

Para hacer una copia de seguridad de la unidad de disco duro del servidor de marketing
en una unidad de cinta a medianoche cada cinco días, cree un programa por lotes
denominado Archive.cmd, que contenga los comandos de copia de seguridad y, a
continuación, programe el programa por lotes para que se ejecute. Después, escriba lo
siguiente:

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


Para cancelar todos los comandos programados en el servidor actual, borre la
información de programación de at como se indica a continuación:

at /delete

Para ejecutar un comando que no es un archivo ejecutable (.exe), coloque cmd /c


delante del comando para cargar cmd.exe de la siguiente manera:

cmd /c dir > c:\test.out

Vínculos relacionados
Clave de sintaxis de línea de comandos

schtasks. Otra herramienta de programación de línea de comandos.


atmadm
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Supervisa las conexiones y direcciones registradas por el Administrador de llamadas atM


en una red de modo de transferencia asincrónica (atM). Puede usar atmadm para
mostrar las estadísticas de las llamadas entrantes y salientes en adaptadores atM. Si lo
usa sin parámetros, atmadm muestra estadísticas para supervisar el estado de las
conexiones atM activas.

Sintaxis

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

Parámetros

Parámetro Descripción

/C Muestra información de llamadas de todas las conexiones actuales al adaptador de


red atM instalado en este equipo.

/a Muestra la dirección del punto de acceso de servicio de red (NSAP) registrada por
cada adaptador instalado en este equipo.

/s Muestra estadísticas para supervisar el estado de las conexiones atM activas.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
El comando atmadm /c genera una salida similar a la siguiente:

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

La tabla siguiente contiene descripciones de cada elemento de la salida de


ejemplo de atmadm /c.

Tipo de datos Visualización por pantalla Descripción

Información de Entrada o salida Dirección de la


conexión llamada. In
significa que es al
adaptador de red
atM desde otro
dispositivo. Out
significa que es
del adaptador de
red atM a otro
dispositivo.

PMP Llamada de un punto a varios puntos.

P-P Llamada de punto a punto.

SVC La conexión está en un circuito virtual


conmutado.

PVC La conexión está en un circuito virtual


permanente.
Tipo de datos Visualización por pantalla Descripción

Información de VPI/VCI Ruta de acceso


VPI/VCI virtual y canal
virtual de la
llamada entrante
o saliente.

Dirección 47000580FFE1000000F21A2E180000C110081500 Dirección NSAP


remota/Parámetros del dispositivo
multimedia atM que hace (In)
o recibe (Out) la
llamada.

Tx El parámetro Tx incluye los tres elementos


siguientes:
Tipo de velocidad de bits predeterminado o
especificado (UBR, CBR, VBR o ABR).
Velocidad de línea predeterminada o
especificada.
Tamaño de unidad de datos de servicio (SDU)
especificado.

Rx El parámetro Rx incluye los tres elementos


siguientes:
Tipo de velocidad de bits predeterminado o
especificado (UBR, CBR, VBR o ABR).
Velocidad de línea predeterminada o
especificada.
Tamaño de SDU especificado.

El comando atmadm /a genera una salida similar a la siguiente:

Windows atM call Manager Statistics


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

El comando atmadm /s genera una salida similar a la siguiente:

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

La tabla siguiente contiene descripciones de cada elemento de la salida de


ejemplo de atmadm /s.

Estadística del Descripción


Administrador de
llamadas

Llamadas activas Llamadas activas actualmente en el adaptador atM instalado en


actuales este equipo.

Total de llamadas Llamadas recibidas correctamente de otros dispositivos en esta


entrantes efectuadas red atM.
correctamente

Total de llamadas Llamadas realizadas correctamente a otros dispositivos atM en


salientes efectuadas esta red desde este equipo.
correctamente

Llamadas entrantes no Llamadas entrantes que no se pudieron conectar a este equipo.


efectuadas
correctamente

Llamadas salientes no Llamadas salientes que no se pudieron conectar a otro dispositivo


efectuadas en la red.
correctamente

Llamadas cerradas por Llamadas cerradas por un dispositivo remoto en la red.


dispositivo remoto

Llamadas cerradas Llamadas cerradas por este equipo.


localmente

Paquetes de Número de paquetes de interfaz de administración local (ILMI)


señalización e ILMI integrados que se han enviado al conmutador al que este equipo
enviados intenta conectarse.

Paquetes de Número de paquetes ILMI recibidos del conmutador atM.


señalización e ILMI
recibidos

Ejemplos
Para mostrar información de llamadas de todas las conexiones actuales al adaptador de
red atM instalado en este equipo, escriba:

atmadm /c

Para mostrar la dirección del punto de acceso de servicio de red (NSAP) registrada por
cada adaptador instalado en este equipo, escriba:

atmadm /a

Para mostrar estadísticas para supervisar el estado de las conexiones atM activas,
escriba:

atmadm /s

Vínculos relacionados
Clave de sintaxis de línea de comandos
attach vdisk
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Adjunta (también llamado montaje o muestra) un disco duro virtual (VHD) para que
aparezca en el equipo host como una unidad de disco duro local. Si el VHD ya tiene una
partición de disco y un volumen de sistema de archivos cuando lo adjunta, al volumen
dentro del VHD se le asigna una letra de unidad.

) Importante

Debe elegir y desasociar un VHD para que esta operación se realice correctamente.
Use el comando select vdisk para seleccionar un VHD y que este reciba el enfoque.

Sintaxis

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

Parámetros

Parámetro Descripción

readonly Asocia el disco duro virtual como de solo lectura. Cualquier operación de escritura
devuelve un error.
Parámetro Descripción

sd=<SDDL Establece el filtro de usuario en el disco duro virtual. La cadena del filtro debe estar
string> en formato de lenguaje de definición de descriptores de seguridad (SDDL). De
forma predeterminada, el filtro de usuario permite el acceso como en un disco
físico. Las cadenas SDDL pueden ser complejas, pero en su forma más sencilla, un
descriptor de seguridad que protege el acceso se conoce como una lista de control
de acceso discrecional (DACL). Usa el formato: D:<dacl_flags><string_ace1>
<string_ace2> ... <string_acen>

Las marcas de DACL comunes son:

A. Permitir acceso
D. Denegación del acceso

Los derechos comunes son:

GA. Acceso a todo


GR. acceso de lectura
GW. Acceso de escritura

Las cuentas de usuario comunes son:

BA. Administradores integrados


AU. Usuarios autenticados
CO. Creador propietario
WD. Todos

Ejemplos:

D:P:(A;;GR;;;AU. Proporciona acceso de lectura a todos los usuarios


autenticados.
D:P:(A;;GA;;;WD. Proporciona a todos los usuarios acceso total.

usefilesd Especifica que el descriptor de seguridad del archivo .vhd debe usarse en el disco
duro virtual. Si no se especifica el parámetro Usefilesd, el VHD no tendrá un
descriptor de seguridad explícito a menos que se especifique con el parámetro Sd.

noerr Se usa solo para scripting. Cuando se detecta un error, DiskPart sigue procesando
los comandos como si no hubiera ningún error. Sin este parámetro, un error hace
que DiskPart salga con un código de error.

Ejemplos
Para adjuntar el disco duro virtual seleccionado como de solo lectura, escriba lo
siguiente:
attach vdisk readonly

Vínculos relacionados
Clave de sintaxis de línea de comandos

select vdisk

compact vdisk

detail vdisk

detach vdisk

expand vdisk

merge vdisk

list
attrib
Artículo • 06/10/2023

Muestra, establece o quita atributos asignados a archivos o directorios. Si se usa sin


parámetros, attrib muestra los atributos de todos los archivos del directorio actual.

Sintaxis

attrib [{+|-}r] [{+|-}a] [{+|-}s] [{+|-}h] [{+|-}o] [{+|-}i] [{+|-}x]


[{+|-}p] [{+|-}u] [{+|-}b] [<drive>:][<path>][<filename>] [/s [/d] [/l]]

Parámetros

Parámetro Descripción

{+\|-}r Establece (+) o borra (-) el atributo de archivo Solo lectura.

{+\|-}a Establece (+) o borra (-) el atributo archivo Archivo. Este conjunto de
atributos marca los archivos que han cambiado desde la última vez que se
ha realizado una copia de seguridad. El comando xcopy usa atributos de
archivo.

{+\|-}s Establece (+) o borra (-) el atributo de archivo Sistema. Si un archivo usa
este conjunto de atributos, debe borrar el atributo para poder cambiar
cualquier otro atributo del archivo.

{+\|-}h Establece (+) o borra (-) el atributo de archivo Oculto. Si un archivo usa este
conjunto de atributos, debe borrar el atributo para poder cambiar cualquier
otro atributo del archivo.

{+\|-}o Establece (+) o borra (-) el atributo de archivo sin conexión.

{+\|-}i Establece (+) o borra (-) el atributo de archivo Sin contenido indexado.

{+\|-}x Establece (+) o borra (-) el atributo de archivo de limpieza.

{+\|-}p Establece (+) o borra (-) el atributo de archivo anclado.

{+\|-}u Establece (+) o borra (-) el atributo de archivo desanclado.

{+\|-}b Establece (+) o borra (-) el atributo de archivo de blob SMR.

[<drive>:] Especifica la ubicación y el nombre del directorio, archivo o grupo de


[<path>] archivos para los que desea mostrar o cambiar los atributos.
Parámetro Descripción

[<filename>] Puede usar los caracteres comodín ? y * en el parámetro filename para


mostrar o cambiar los atributos de un grupo de archivos.

/s Aplica attrib y cualquier opción de línea de comandos a los archivos


coincidentes en el directorio actual y en todos sus subdirectorios.

/d Aplica attrib y cualquier opción de línea de comandos a directorios.

/l Aplica attrib y cualquier opción de línea de comandos al vínculo simbólico,


en lugar del destino del vínculo simbólico.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para mostrar los atributos de un archivo denominado News86 que se encuentra en el
directorio actual, escriba:

attrib news86

Para asignar el atributo de solo lectura al archivo denominado report.txt, escriba:

attrib +r report.txt

Para quitar el atributo de solo lectura de los archivos del directorio público y sus
subdirectorios en un disco de la unidad b:, escriba:

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

Para establecer el atributo Archivo para todos los archivos de la unidad a: y, a


continuación, desactivar el atributo Archivo para los archivos con la extensión .bak,
escriba:

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


Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando xcopy
attributes
Artículo • 12/04/2023

Muestra, establece o borra los atributos de un disco o volumen.

Sintaxis

attributes disk
attributes volume

Parámetros

Parámetro Descripción

attributes disk Muestra, establece o borra los atributos de un disco.

attributes volume Muestra, establece o borra los atributos de un volumen.

Vínculos relacionados
Clave de sintaxis de línea de comandos
attributes disk
Artículo • 12/04/2023

Muestra, establece o borra los atributos de un disco. Cuando este comando se usa para
mostrar los atributos actuales de un disco, el atributo de disco de inicio denota el disco
usado para iniciar el equipo. Para un reflejo dinámico, muestra el disco que contiene el
complejo de arranque del volumen de arranque.

) Importante

Debe seleccionarse un disco para que el comando attributes disk tenga éxito. Use
el comando select disk para seleccionar un disco y desplazar el foco a él.

Sintaxis

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

Parámetros

Parámetro Descripción

set Establece el atributo especificado del disco con foco.

clear Borra el atributo especificado del disco con foco.

readonly Especifica que el disco es de solo lectura.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para ver los atributos del disco seleccionado, escriba lo siguiente:

attributes disk
Para establecer el disco seleccionado como de solo lectura, escriba lo siguiente:

attributes disk set readonly

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando select disk


attributes volume
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra, establece o borra los atributos de un volumen.

Sintaxis

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


| shadowcopy}] [noerr]

Parámetros

Parámetro Descripción

set Establece el atributo especificado del volumen con foco.

clear Desactiva el atributo especificado del volumen con foco.

readonly Especifica que el volumen es de sólo lectura.

hidden Especifica que el volumen está oculto.

nodefaultdriveletter Especifica que el volumen no recibe una letra de unidad de forma


predeterminada.

shadowcopy Especifica que el volumen es un volumen de instantánea.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando
los comandos como si no hubiera ningún error. Sin este parámetro, un
error hace que DiskPart salga con un código de error.

Comentarios
En los discos básicos de registro de arranque maestro (MBR), los parámetros
hidden, readonly y nodefaultdriveletter se aplican a todos los volúmenes del
disco.
En los discos básicos de la tabla de particiones GUID (GPT), y en los discos
dinámicos MBR y GPT, los parámetros hidden, readonly y nodefaultdriveletter
solo se aplican al volumen seleccionado.

Se debe seleccionar un volumen para que el comando attributes volume funcione


correctamente. Use el comando select volume para seleccionar un volumen y
desplazar el foco a él.

Ejemplos
Para mostrar los atributos actuales en el volumen seleccionado, escriba:

attributes volume

Para establecer el volumen seleccionado como oculto y de solo lectura, escriba:

attributes volume set hidden readonly

Para quitar los atributos ocultos y de solo lectura en el volumen seleccionado, escriba:

attributes volume clear hidden readonly

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando select volume


auditpol
Artículo • 12/04/2023

Muestra información sobre directivas de auditoría y realiza funciones para manipularlas,


como:

Establecer y consultar una directiva de auditoría de sistema.

Establecer y consultar una directiva de auditoría por usuario.

Establecer y consultar las opciones de auditoría.

Establecer y consultar el descriptor de seguridad usado para delegar el acceso a


una directiva de auditoría.

Creación de informes o copia de seguridad de una directiva de auditoría en un


archivo de texto de valores separados por comas (CSV).

Carga de una directiva de auditoría desde un archivo de texto CSV.

Configuración de SACL de recursos globales.

Sintaxis

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

Parámetros

Subcomando Descripción

/get Muestra la directiva de auditoría actual. Para obtener más información sobre
sintaxis y otras opciones, consulte auditpol get.

/set Establece la directiva de auditoría. Para obtener más información sobre sintaxis y
otras opciones, consulte auditpol set.

/list Muestra elementos de directiva seleccionables. Para obtener más información


sobre sintaxis y otras opciones, consulte auditpol list.

/backup Guarda la directiva de auditoría en un archivo. Para obtener más información


sobre sintaxis y otras opciones, consulte auditpol backup.
Subcomando Descripción

/restore Restaura la directiva de auditoría a partir de un archivo creado anteriormente


mediante auditpol /backup. Para obtener más información sobre sintaxis y otras
opciones, consulte auditpol restore.

/clear Borra la directiva de auditoría. Para obtener más información sobre sintaxis y
otras opciones, consulte auditpol clear.

/remove Quita toda la configuración de directiva de auditoría por usuario y deshabilita


todas las configuraciones de directiva de auditoría de sistema. Para obtener más
información sobre sintaxis y otras opciones, consulte auditpol remove.

/resourceSACL Configura listas de control de acceso de sistema de recursos globales (SACL).


Nota: Solo se aplica a Windows 7 y Windows Server 2008 R2. Para más
información, consulte auditpol resourceSACL.

/? Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
auditpol backup
Artículo • 30/05/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

El comando auditpol backup realiza copias de seguridad de la configuración de la


directiva de auditoría del sistema, la configuración de directiva de auditoría por usuario
para todos los usuarios y todas las opciones de auditoría en un archivo de texto de
valores separados por comas (CSV).

Para ejecutar operaciones de copia de seguridad en las directivas por usuario y de


sistema, se debe tener permiso de Escritura o Control total para el objeto establecido
en el descriptor de seguridad. También se pueden ejecutar operaciones de copia de
seguridad con el derecho de usuario (SeSecurityPrivilege) de Administrar auditoría y
registro de seguridad. Sin embargo, este derecho permite el acceso que no es
necesario para realizar las operaciones generales de copia de seguridad.

Sintaxis

auditpol /backup /file:<filename>

Parámetros

Parámetro Descripción

/file Especifica el nombre de archivo para la copia de seguridad.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Puede realizar una copia de seguridad de la siguiente configuración en un archivo de
texto con formato CSV:

Configuración de directivas de auditoría por usuario para todos los usuarios


Configuración de la directiva de auditoría del sistema
Todas las opciones de auditoría
Para realizar una copia de seguridad de esta configuración en un archivo denominado
auditpolicy.csv, escriba el siguiente comando:

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

7 Nota

Si no se especifica ninguna unidad, se usa el directorio actual.

Vínculos relacionados
Clave de sintaxis de línea de comandos

auditpol restore

comandos auditpol
auditpol clear
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Elimina la directiva de auditoría por usuario para todos los usuarios, restablece
(deshabilita) la directiva de auditoría del sistema para todas las subcategorías y
establece todas las opciones de auditoría en deshabilitadas.

Para ejecutar operaciones de borrado en las directivas por usuario y de sistema, se debe
tener permiso de Escritura o Control total para el objeto establecido en el descriptor de
seguridad. También se pueden ejecutar operaciones de borrado con el derecho de
usuario (SeSecurityPrivilege) de Administrar auditoría y registro de seguridad. Sin
embargo, este derecho permite el acceso adicional que no se necesita para realizar las
operaciones generales de borrado.

Sintaxis

auditpol /clear [/y]

Parámetros

Parámetro Descripción

/y Suprime la petición para confirmar si se borra toda la configuración de directiva de


auditoría.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para eliminar la directiva de auditoría por usuario para todos los usuarios, restablecer
(deshabilitar) la directiva de auditoría del sistema para todas las subcategorías y
establecer la configuración de la directiva de auditoría en deshabilitada en la petición de
confirmación, escriba:
auditpol /clear

Para eliminar la directiva de auditoría por usuario para todos los usuarios, restablecer la
configuración de la directiva de auditoría del sistema para todas las subcategorías y
establecer la configuración de la directiva de auditoría en deshabilitada en la petición de
confirmación sin una petición de confirmación, escriba:

auditpol /clear /y

7 Nota

El ejemplo anterior resulta útil cuando se usa un script para ejecutar esta operación.

Vínculos relacionados
Clave de sintaxis de línea de comandos

comandos auditpol
auditpol get
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server, 2019,
Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Recupera la directiva del sistema, la directiva por usuario, las opciones de auditoría y el
objeto descriptor de seguridad de auditoría.

Para realizar operaciones get en las directivas por usuario y del sistema, debe tener
permiso de lectura para ese objeto establecido en el descriptor de seguridad. También
puede realizar operaciones get si tiene el derecho de usuario Administrar auditoría y
registro de seguridad (SeSecurityPrivilege). Sin embargo, este derecho permite el
acceso adicional que no se necesita para realizar las operaciones generales get.

Sintaxis

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

Parámetros

Parámetro Descripción

/user Muestra la entidad de seguridad para la que se consulta la directiva de auditoría


por usuario. Se debe especificar el parámetro /category o /subcategory. El usuario
puede especificarse como un identificador de seguridad (SID) o un nombre. Si no
se especifica ninguna cuenta de usuario, se consulta la directiva de auditoría del
sistema.

/categoría Una o varias categorías de auditoría especificadas por el identificador único global
(GUID) o el nombre. Se puede usar un asterisco (*) para indicar que se deben
consultar todas las categorías de auditoría.

/subcategory Una o varias subcategorías de auditoría especificadas por GUID o nombre.


Parámetro Descripción

/sd Recupera el descriptor de seguridad usado para delegar el acceso a la directiva de


auditoría.

/option Recupera la directiva existente para las opciones CrashOnAuditFail,


FullprivilegeAuditing, AuditBaseObjects o AuditBasedirectories.

/r Muestra la salida en formato de informe, valor separado por comas (CSV).

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Todas las categorías y subcategorías se pueden especificar mediante el GUID o el
nombre entre comillas ("). Los usuarios pueden especificarse por SID o nombre.

Ejemplos
Para recuperar la directiva de auditoría por usuario de la cuenta de invitado y mostrar la
salida de las categorías Sistema, Seguimiento detallado y Acceso a objetos, escriba:

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


/category:System,detailed Tracking,Object Access

7 Nota

Este comando es útil en dos escenarios. 1) Al supervisar una cuenta de usuario


específica para actividades sospechosas, puede usar el comando /get para
recuperar los resultados en categorías específicas mediante una directiva de
inclusión para habilitar la auditoría adicional. 2) Si la configuración de auditoría de
una cuenta registra numerosos eventos, pero superfluos, puede usar el comando
/get para filtrar los eventos extraños de esa cuenta con una directiva de exclusión.
Para obtener una lista de todas las categorías, use el comando auditpol /list
/category .

Para recuperar la directiva de auditoría por usuario de una categoría y una subcategoría
determinada, que informa de la configuración inclusiva y exclusiva de esa subcategoría
en la categoría de sistema de la cuenta de invitado, escriba:
auditpol /get /user:guest /category:System /subcategory:{0ccee921a-69ae-
11d9-bed3-505054503030}

Para mostrar la salida en formato de informe e incluir el nombre del equipo, el destino
de la directiva, la subcategoría, el GUID de subcategoría, la configuración de inclusión y
la configuración de exclusión, escriba:

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

Para recuperar la directiva de la categoría y subcategorías del sistema, que informa de la


configuración de la directiva de categoría y subcategoría para la directiva de auditoría
del sistema, escriba:

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


505054503030}

Para recuperar la directiva de las subcategorías y categorías de seguimiento detalladas


en formato de informe e incluir el nombre del equipo, el destino de la directiva, la
subcategoría, el GUID de subcategoría, la configuración de inclusión y la configuración
de exclusión, escriba:

auditpol /get /category:detailed Tracking /r

Para recuperar la directiva de dos categorías con las categorías especificadas como
GUID, que notifica toda la configuración de directiva de auditoría de todas las
subcategorías en dos categorías, escriba:

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


797a-11d9-bed3-505054503030} subcategory:{0ccee921a-69ae-11d9-bed3-
505054503030}

Para recuperar el estado, ya sea habilitado o deshabilitado, de la opción


AuditBaseObjects, escriba:
auditpol /get /option:AuditBaseObjects

En este caso, las opciones disponibles son AuditBaseObjects, AuditBaseOperations y


FullprivilegeAuditing. Para recuperar el estado habilitado, deshabilitado o 2 de la opción
CrashOnAuditFail, escriba:

auditpol /get /option:CrashOnAuditFail /r

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comandos auditpol
auditpol list
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Enumera las categorías y subcategorías de directiva de auditoría, o enumera los usuarios


para los que se define una directiva de auditoría por usuario.

Para realizar operaciones de lista en la directiva por usuario, debe tener permiso de
lectura para ese objeto establecido en el descriptor de seguridad. También se pueden
ejecutar operaciones de lista con el derecho de usuario (SeSecurityPrivilege) de
Administrar auditoría y registro de seguridad. Sin embargo, este derecho permite el
acceso adicional que no se necesita para realizar las operaciones generales de lista.

Sintaxis

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

Parámetros

Parámetro Descripción

/user Recupera todos los usuarios para los que se ha definido la directiva de auditoría
por usuario. Si se usa con el parámetro /v, también se muestra el identificador de
seguridad (SID) del usuario.

/categoría Muestra los nombres de las categorías que entiende el sistema. Si se usa con el
parámetro /v, también se muestra el identificador único global de categoría
(GUID).

/subcategory Muestra los nombres de subcategorías y su GUID asociado.

/v Muestra el GUID con la categoría o subcategoría, o cuando se usa con /user,


muestra el SID de cada usuario.

/r Muestra la salida como un informe en formato de valor separado por comas


(CSV).
Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para enumerar todos los usuarios que tienen una directiva de auditoría definida, escriba:

auditpol /list /user

Para enumerar todos los usuarios que tienen una directiva de auditoría definida y su SID
asociado, escriba:

auditpol /list /user /v

Para enumerar todas las categorías y subcategorías en formato de informe, escriba:

auditpol /list /subcategory:* /r

Para enumerar las subcategorías de las categorías de seguimiento y acceso de DS


detalladas, escriba:

auditpol /list /subcategory:detailed Tracking,DS Access

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comandos auditpol
auditpol remove
Artículo • 30/05/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

El comando auditpol remove quita la directiva de auditoría por usuario de una cuenta
especificada o de todas las cuentas.

Para ejecutar operaciones de eliminación en la directiva per-user se debe tener permiso


de Escritura o Control total para el objeto establecido en el descriptor de seguridad.
También puede realizar operaciones de eliminación si tiene el derecho de usuario
Administrar registro de seguridad y auditoría ( SeSecurityPrivilege ). Sin embargo, este
derecho permite el acceso que no es necesario para realizar las operaciones generales
de eliminación.

Sintaxis

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


[/allusers]

Parámetros

Parámetro Descripción

/user Especifica el id. de seguridad (SID) o el nombre de usuario para el usuario para el
que se va a eliminar la directiva de auditoría por usuario.

/allusers Quita la directiva de auditoría por usuario para todos los usuarios.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para quitar la directiva de auditoría por usuario para el usuario mikedan por nombre,
escriba lo siguiente:
auditpol /remove /user:mikedan

Para quitar la directiva de auditoría por usuario para el usuario mikedan por SID, escriba
lo siguiente:

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

Para quitar la directiva de auditoría por usuario para todos los usuarios, escriba lo
siguiente:

auditpol /remove /allusers

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comandos auditpol
auditpol resourceSACL
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 7 y


Windows 2008 R2

Configura las listas de control de acceso de sistema (SACL) de recursos globales.

Para realizar operaciones resourceSACL, debe tener permisos de escritura o control total
para ese objeto establecido en el descriptor de seguridad. También puede realizar
operaciones resourceSACL si tiene el derecho de usuario Administrar auditoría y
registro de seguridad (SeSecurityPrivilege).

Sintaxis

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 Descripción

/set Agrega una nueva entrada o actualiza una entrada existente en el SACL de recursos
para el tipo de recurso especificado.

/remove Quita todas las entradas del usuario especificado en la lista de auditoría de acceso a
objetos global.

/clear Quita todas las entradas de la lista global de auditoría de acceso a objetos.

/view Enumera las entradas de auditoría de acceso a objetos globales en una SACL de
recursos. Los tipos de usuario y recurso son opcionales.

/? Muestra la ayuda en el símbolo del sistema.

Argumentos
Argumento Descripción

/type Recurso para el que se está configurando la auditoría de acceso a objetos. Los
valores de argumento admitidos y con distinción entre mayúsculas y minúsculas
son File (para directorios y archivos) y Key (para claves del registro).

/success Especifica la auditoría del éxito.

/failure Especifica la auditoría de los errores.

/user Especifica un usuario en uno de los siguientes formularios:


DomainName\Account (por ejemplo, DOM\Administrators)
StandaloneServer\Group Account (vea la función LookupAccountName)
{S-1-x-x-x-x-x} (x se expresa en decimales y todo el SID debe ir entre llaves).
Por ejemplo: {S-1-5-21-5624481-130208933-164394174-1001}
Nota: Si se usa el formulario SID, no se realiza ninguna comprobación para
comprobar la existencia de esta cuenta.

/access Especifica una máscara de permisos que se puede especificar mediante:


Derechos de acceso genéricos, entre los que se incluyen:

GA: TODO GENÉRICO


GR: LECTURA GENÉRICA
GW: ESCRITURA GENÉRICA
GX: EJECUCIÓN GENÉRICA

Derechos de acceso para archivos, entre los que se incluyen:

FA: TODO GENÉRICO DE ARCHIVO


FR: LECTURA GENÉRICA DE ARCHIVO
FW: ESCRITURA GENÉRICA DE ARCHIVO
FX: EJECUCIÓN GENÉRICA DE ARCHIVO

Derechos de acceso para las claves del Registro, entre las que se incluyen:

KA: TODO GENÉRICO DE CLAVE


KR: LECTURA DE CLAVE
KW: ESCRITURA DE CLAVE
KX: EJECUCIÓN DE CLAVE

Por ejemplo: /access:FRFW habilita eventos de auditoría para operaciones de


lectura y escritura.

Un valor hexadecimal que representa la máscara de acceso (por ejemplo,


0x1200a9)

Esto resulta útil cuando se usan máscaras de bits específicas de recursos que no
forman parte del estándar del lenguaje de definición de descriptores de seguridad
(SDDL). Si se omite, se usa Acceso total.
Ejemplos
Para establecer un SACL de recursos global para auditar los intentos de acceso correctos
por parte de un usuario en una clave del registro:

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

Para establecer un SACL de recursos global para auditar los intentos correctos y
erróneos de un usuario para realizar funciones genéricas de lectura y escritura en
archivos o carpetas:

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


/failure /access:FRFW

Para quitar todas las entradas SACL de recursos globales para archivos o carpetas:

auditpol /resourceSACL /type:File /clear

Para quitar todas las entradas SACL de recursos globales para un usuario concreto de
archivos o carpetas:

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


1302087933-1644394174-1001}

Para enumerar las entradas de auditoría de acceso a objetos globales establecidas en


archivos o carpetas:

auditpol /resourceSACL /type:File /view

Para enumerar las entradas de auditoría de acceso a objetos globales de un usuario


determinado que se establecen en archivos o carpetas:
auditpol /resourceSACL /type:File /view /user:MYDOMAIN\myuser

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comandos auditpol
auditpol restore
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Restaura la configuración de la directiva de auditoría del sistema, la configuración de la


directiva de auditoría por usuario para todos los usuarios, y todas las opciones de
auditoría de un archivo que es sintácticamente coherente con el formato de archivo de
valores separados por comas (CSV) usado por la opción /backup.

Para ejecutar operaciones de restauración en las directivas por usuario y de sistema, se


debe tener permiso de Escritura o Control total del objeto establecido en el descriptor
de seguridad. También puede realizar operaciones de restauración si tiene el derecho de
usuario Administrar registro de seguridad y auditoría (SeSecurityPrivilege), lo que
resulta útil al restaurar el descriptor de seguridad en caso de error o ataque
malintencionado.

Sintaxis

auditpol /restore /file:<filename>

Parámetros

Parámetro Descripción

/file Especifica el archivo desde el que se debe restaurar la directiva de auditoría. El


archivo debe haberse creado mediante la opción /backup o debe ser coherente
sintácticamente con el formato de archivo CSV usado por la opción /backup.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para restaurar la configuración de la directiva de auditoría del sistema, la configuración
de directiva de auditoría por usuario para todos los usuarios y todas las opciones de
auditoría de un archivo denominado auditpolicy.csv, que se creó mediante el comando
/backup, escriba:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos

auditpol backup

comandos auditpol
auditpol set
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Establece la directiva de auditoría por usuario, la directiva de auditoría del sistema o las
opciones de auditoría.

Para ejecutar operaciones establecidas en las directivas por usuario y de sistema, se debe
tener permiso de Escritura o Control total para el objeto establecido en el descriptor de
seguridad. También se pueden ejecutar operaciones establecidas con el derecho de
usuario (SeSecurityPrivilege) de Administrar auditoría y registro de seguridad. Sin
embargo, este derecho permite el acceso adicional que no se necesita para realizar las
operaciones generales establecidas.

Sintaxis

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 Descripción

/user La entidad de seguridad para la que se establece la directiva de auditoría por


usuario especificada por la categoría o subcategoría. Se debe especificar la opción
de categoría o subcategoría, como identificador de seguridad (SID) o nombre.

/include Especificado con /user; indica que la directiva por usuario del usuario hará que se
genere una auditoría aunque la directiva de auditoría del sistema no la
especifique. Esta configuración es la predeterminada y se aplica automáticamente
si no se especifican explícitamente los parámetros /include ni /exclude.
Parámetro Descripción

/exclude Especificado con /user; indica que la directiva por usuario del usuario hará que se
suprima una auditoría independientemente de la directiva de auditoría del
sistema. Esta configuración se omite para los usuarios que son miembros del
grupo Administradores local.

/categoría Una o varias categorías de auditoría especificadas por el identificador único global
(GUID) o el nombre. Si no se especifica ningún usuario, se establece la directiva
del sistema.

/subcategory Una o varias subcategorías de auditoría especificadas por GUID o nombre. Si no


se especifica ningún usuario, se establece la directiva del sistema.

/success Especifica la auditoría correcta. Esta configuración es la predeterminada y se


aplica automáticamente si no se especifican explícitamente los parámetros
/success ni /failure. Esta configuración debe usarse con un parámetro que indique
si se va a habilitar o deshabilitar la configuración.

/failure Especifica la auditoría de errores. Esta configuración debe usarse con un


parámetro que indique si se va a habilitar o deshabilitar la configuración.

/option Establece la directiva de auditoría para las opciones CrashOnAuditFail,


FullprivilegeAuditing, AuditBaseObjects o AuditBasedirectories.

/sd Establece el descriptor de seguridad usado para delegar el acceso a la directiva de


auditoría. El descriptor de seguridad debe especificarse mediante el lenguaje de
definición de descriptor de seguridad (SDDL). El descriptor de seguridad debe
tener una lista de control de acceso discrecional (DACL).

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para establecer la directiva de auditoría por usuario para todas las subcategorías en la
categoría Seguimiento detallado del usuario mikedan y que se auditen todos los
intentos correctos del usuario, escriba lo siguiente:

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


/success:enable

Para establecer la directiva de auditoría por usuario para las categorías especificadas por
nombre y GUID, y las subcategorías especificadas por GUID y suprimir la auditoría de los
intentos correctos o erróneos, escriba lo siguiente:
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 establecer la directiva de auditoría por usuario para el usuario especificado para
todas las categorías para la supresión de la auditoría de todos los intentos excepto los
correctos, escriba lo siguiente:

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

Para establecer la directiva de auditoría del sistema para todas las subcategorías de la
categoría Seguimiento detallado para incluir la auditoría solo de intentos correctos,
escriba lo siguiente:

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

7 Nota

La configuración de error no se modifica.

Para establecer la directiva de auditoría de sistema para las categorías Acceso a objetos
y Sistema (que está implícita porque se enumeran las subcategorías) y las subcategorías
especificadas por los GUID para la supresión de intentos erróneos y la auditoría de
intentos correctos, escriba lo siguiente:

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


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

Para establecer las opciones de auditoría en el estado habilitado para la opción


CrashOnAuditFail, escriba lo siguiente:

auditpol /set /option:CrashOnAuditFail /value:enable


Vínculos relacionados
Clave de sintaxis de línea de comandos

comandos auditpol
autochk
Artículo • 14/04/2023

Se ejecuta cuando se inicia el equipo y antes de que Windows Server empiece a


comprobar la integridad lógica de un sistema de archivos.

Autochk.exe es una versión de chkdsk que solo se ejecuta en discos NTFS y solo antes
de que se inicie Windows Server. Autochk no se puede ejecutar directamente desde la
línea de comandos. En su lugar, autochk se ejecuta en las situaciones siguientes:

Si intenta ejecutar chkdsk en el volumen de arranque.

Si chkdsk no puede obtener un uso exclusivo del volumen.

Si el volumen se marca como sucio.

Comentarios

2 Advertencia

La herramienta de línea de comandos autochk no se puede ejecutar directamente


desde la línea de comandos. En su lugar, use la herramienta de línea de comandos
chkntfs para configurar la forma en que desea que autochk se ejecute en el inicio.

Puede usar chkntfs con el parámetro /x para evitar que autochk se ejecute en
un volumen específico o en varios volúmenes.

Use la herramienta de línea de comandos chkntfs.exe con el parámetro /t


para cambiar el retraso de autochk de 0 segundos a 3 días (259 200
segundos). Sin embargo, un retraso largo implica que el equipo no se iniciará
hasta que transcurra el tiempo o hasta que se presione una tecla para
cancelar autochk.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando chkdsk

Comando chkntfs
autoconv
Artículo • 04/05/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Convierte la tabla de asignación de archivos (Fat) y los volúmenes Fat32 en el sistema de


archivos NTFS, y deja intactos los archivos y directorios existentes durante el inicio
después de que se ejecute autochk. Los volúmenes convertidos al sistema de archivos
NTFS no se pueden convertir a Fat o Fat32.

) Importante

No se puede ejecutar autoconv desde la línea de comandos. Esto solo se puede


ejecutar durante el inicio, si se establece mediante convert.exe.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando autochk

Comando convert
autofmt
Artículo • 12/04/2023

Inicia la utilidad del formato de sistema de archivos automático, que da formato a una
unidad o partición cuando se llama desde la Consola de recuperación de Windows.

) Importante

No se puede ejecutar autofmt directamente desde la línea de comandos.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Entorno de recuperación de Windows (WinRE)

Cómo usar el entorno de recuperación de Windows (WinRE) para solucionar


problemas habituales de inicio
automount
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Clave de sintaxis de línea de comandos

) Importante

En configuraciones de red de área de almacenamiento (SAN), al deshabilitar


automount se impide que Windows monte o asigne letras de unidad
automáticamente a cualquier nuevo volumen básico que se agregue al sistema.

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

Parámetros

Parámetro Descripción

enable Habilita Windows para montar automáticamente los nuevos volúmenes básicos y
dinámicos agregados al sistema y para asignarles letras de unidad.

disable Impide que Windows monte automáticamente los nuevos volúmenes básicos y
dinámicos que se agreguen al sistema.
Nota: deshabilitar el montaje automático puede hacer que los clústeres de
conmutación por error fallen en la parte de almacenamiento del asistente de validar
una configuración.

scrub Quita los directorios del punto de montaje de volumen y la configuración del
Registro de aquellos volúmenes que ya no se encuentran en el sistema. Así se
impide que los volúmenes que se encontraban previamente en el sistema se
monten automáticamente y reciban los puntos de montaje de volumen anteriores
cuando se vuelven a agregar al sistema.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.
Ejemplos
Para ver si la característica de montaje automático está habilitada, escriba los siguientes
comandos desde el comando DiskPart:

automount

Para habilitar la característica de montaje automático, escriba:

automount enable

Para deshabilitar la característica de montaje automático, escriba:

automount disable

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comandos DiskPart
bcdboot
Artículo • 12/04/2023

Permite configurar rápidamente una partición del sistema o repara el entorno de


arranque ubicado en la partición del sistema. La partición de sistema se configura
copiando un conjunto simple de archivos de datos de la configuración de arranque
(BCD) en una partición vacía existente.

Sintaxis

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

Parámetros

Parámetro Descripción

source Especifica la ubicación del directorio de Windows que se va a usar como origen para
copiar archivos de entorno de arranque.

/l Especifica la configuración regional. La configuración regional predeterminada es


inglés de EE. UU.

/s Especifica la letra de volumen de la partición del sistema. El valor predeterminado es


la partición del sistema identificada por el firmware.

Ejemplos
Para obtener información sobre dónde encontrar BCDboot y ejemplos de cómo usar
este comando, consulte el tema BCDboot Command-Line Options.

Vínculos relacionados
Clave de sintaxis de línea de comandos
bcdedit
Artículo • 14/04/2023

Los archivos de datos de la configuración de arranque (BCD) proporcionan un almacén


que se usa para describir aplicaciones de arranque y configuraciones de aplicaciones de
arranque. Los objetos y elementos del almacén reemplazan Boot.ini.

BCDEdit es una herramienta de la línea de comandos que sirve para administrar


almacenes BCD. Se puede usar para diversos fines, entre ellos crear nuevos almacenes,
modificar los existentes, agregar opciones de menú de arranque, etc. Esencialmente,
BCDEdit tiene el mismo objetivo que Bootcfg.exe en versiones anteriores de Windows,
con dos mejoras destacables:

Expone una mayor variedad de parámetros de arranque que Bootcfg.exe.

Ha mejorado la compatibilidad con los scripts.

7 Nota

Se requieren privilegios administrativos para usar BCDEditor con el fin de modificar


BCD.

BCDEdit es la principal herramienta para editar la configuración de arranque de


Windows Vista y versiones posteriores de Windows. Se incluye con la distribución de
Windows Vista en la carpeta %WINDIR%\System32.

BCDEdit se limita a los tipos de datos estándar y se ha diseñado principalmente para


realizar cambios comunes en BCD. Para realizar operaciones más complejas o trabajar
con tipos de datos no estándar, use la interfaz de programación de aplicaciones (API) de
Instrumental de administración de Windows (WMI) de BCD para crear herramientas
personalizadas más versátiles y flexibles.

Sintaxis

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

Parámetros
Opciones generales de la línea de comandos de BCDEdit

Opción Descripción

/? Muestra una lista de comandos de BCDEdit. Si ejecuta este comando sin argumentos,
se muestra un resumen de los comandos disponibles. Para mostrar ayuda detallada
acerca de un comando concreto, ejecute bcdedit /? <command> , donde <command> es el
nombre del comando del que busca más información. Por ejemplo, bcdedit /?
createstore muestra ayuda detallada acerca del comando Createstore.

Parámetros que funcionan en un Store

Opción Descripción

/createstore Crea un nuevo almacén de datos de la configuración de arranque (BCD) vacío. El


almacén creado no es un almacén del sistema.

/export Exporta el contenido del almacén del sistema a un archivo. Este archivo se puede
usar más adelante para restaurar el estado del almacén del sistema. Este comando
sólo es válido para el almacén del sistema.

/import Restaura el estado del almacén del sistema mediante un archivo de datos de copia
de seguridad generado anteriormente con la opción /export. Este comando
elimina las entradas existentes en el almacén del sistema antes de realizar la
importación. Este comando sólo es válido para el almacén del sistema.

/store Esta opción se puede usar con la mayoría de los comandos de BCDEdit para
especificar el almacén que se va a usar. Si no se especifica esta opción, BCDEdit
opera en el almacén del sistema. Si ejecuta el comando bcdedit /store por sí solo,
equivale a ejecutar el comando bcdedit /enum active.

Parámetros que funcionan en las entradas de un Store

Parámetro Descripción

/copy Hace una copia de una entrada de arranque especificada en el mismo almacén del
sistema.

/create Crea una nueva entrada en el almacén de datos de la configuración de arranque


(BCD). Si se especifica un identificador conocido, no se pueden especificar los
parámetros /application, /inherit ni /device. Si no se especifica un identificador o
éste no es conocido, se deben especificar las opciones /application, /inherit o
/device.

/delete Elimina un elemento de una entrada especificada.


Parámetros que funcionan en las opciones de entrada

Parámetro Descripción

/deletevalue Elimina un elemento especificado de una entrada de arranque.

/set Establece el valor de una opción de entrada.

Parámetros que controlan la salida

Parámetro Descripción

/enum Enumera las entradas de un almacén. La opción /enum es el valor predeterminado


para BCEdit, por lo que ejecutar el comando bcdedit sin parámetros equivale a
ejecutar el comando bcdedit /enum active.

/v Modo detallado. Normalmente, los identificadores de entrada conocidos se


representan en formato abreviado. Si especifica /v como opción de la línea de
comandos, se muestra la forma completa de todos los identificadores. Si ejecuta el
comando bcdedit /v por sí solo, equivale a ejecutar el comando bcdedit /enum
active /v.

Parámetros que controlan el administrar de arranque

Parámetro Descripción

/bootsequence Especifica un orden de presentación único que se usará en el siguiente


arranque. Este comando se asemeja a la opción /displayorder, excepto en
que se usa sólo la siguiente vez que se inicia el equipo. Después, el equipo
vuelve al orden de presentación original.

/default Especifica la entrada predeterminada que el administrador de arranque


selecciona cuando se agota el tiempo de espera.

/displayorder Especifica el orden de presentación que el administrador de arranque usa al


mostrar parámetros de arranque a un usuario.

/timeout Especifica el tiempo de espera, en segundos, antes de que el administrador


de arranque seleccione la entrada predeterminada.

/toolsdisplayorder Especifica el orden de presentación que el administrador de arranque usará


al mostrar el menú Herramientas.

Parámetros que controlan los servicios de administración de


control de emergencia
Parámetro Descripción

/bootems Habilita o deshabilita Servicios de administración de emergencia (EMS) para la


entrada especificada.

/ems Habilita o deshabilita EMS para la entrada de arranque de sistema operativo


especificada.

/emssettings Establece la configuración global de EMS para el equipo. /emssettings no habilita


ni deshabilita EMS para ninguna entrada de arranque concreta.

Parámetros que controlan la depuración

Parámetro Descripción

/bootdebug Habilita o deshabilita el depurador de arranque para una entrada de arranque


especificada. Aunque este comando funciona con cualquier entrada de arranque,
sólo es efectivo para aplicaciones de arranque.

/dbgsettings Especifica o muestra la configuración global del depurador para el sistema. Este
comando no habilita ni deshabilita el depurador de kernel; use la opción /debug
para ese fin. Para establecer una configuración global de depurador individual, use
el comando bcdedit/set <dbgsettings> <type> <value> .

/debug Habilita o deshabilita el depurador de kernel para una entrada de arranque


especificada.

Vínculos relacionados
Para obtener ejemplos de cómo usar BCDEdit, consulte el artículo Referencia de
opciones de BCDEdit.

Para ver la notación usada para indicar la sintaxis de la línea de comandos, vea Clave de
sintaxis de la línea de comandos.
bdehdcfg
Artículo • 14/04/2023

Prepara una unidad de disco duro con las particiones necesarias para el Cifrado de
unidad BitLocker. La mayoría de las instalaciones de Windows 7 no necesitarán utilizar
esta herramienta porque el programa de instalación de BitLocker incluye la posibilidad
de preparar y volver a crear particiones de unidades según sea necesario.

2 Advertencia

Existe un conflicto conocido con la configuración de directiva de grupo Denegar el


acceso de escritura a unidades fijas no protegidas por BitLocker ubicada en
Configuración del equipo\Plantillas administrativas\Componentes de
Windows\Cifrado de unidad BitLocker\Unidades de datos fijas.

Si se ejecuta bdehdcfg en un equipo cuando está habilitada esta configuración de


directiva, se pueden encontrar estos problemas:

Si ha intentado reducir la unidad y crear la unidad de sistema, el tamaño de la


unidad se reducirá correctamente y se creará una partición sin formato. Sin
embargo, no se dará formato a esa partición. Se muestra el mensaje de error
siguiente: "No se puede formatear la unidad activa nueva. Es posible que
deba preparar la unidad manualmente para BitLocker".

Si ha intentado usar espacio sin asignar para crear la unidad de sistema, se


creará una partición sin formato. Sin embargo, no se dará formato a esa
partición. Se muestra el mensaje de error siguiente: "No se puede formatear la
unidad activa nueva. Es posible que deba preparar la unidad manualmente
para BitLocker".

Si ha intentado combinar una unidad existente con la unidad de sistema, la


herramienta no podrá copiar el archivo de arranque necesario en la unidad de
destino para crear la unidad de sistema. Se muestra el mensaje de error
siguiente: "El programa de instalación de BitLocker no pudo copiar los
archivos de arranque. Es posible que deba preparar la unidad manualmente
para BitLocker".

Si se aplica esta configuración de directiva, no se pueden volver a crear


particiones porque la unidad está protegida. Si está actualizando los equipos
de su organización desde una versión anterior de Windows y esos equipos se
configuraron con una sola partición, debe crear la partición de sistema de
BitLocker necesaria antes de aplicar la configuración de directiva a los
equipos.

Sintaxis

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


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

Parámetros

Parámetro Descripción

bdehdcfg: Muestra la letra de la unidad, el tamaño total, el espacio máximo disponible y las
driveinfo características de particiones en la unidad especificada. Solo se enumeran las
particiones válidas. El espacio sin asignar no se enumera si ya existen cuatro
particiones principales o extendidas.

bdehdcfg: Define la parte de una unidad que se va a usar como unidad del sistema y activa
target esa parte.

bdehdcfg: Asigna una letra de unidad nueva a la parte de una unidad utilizada como
newdriveletter unidad del sistema.

bdehdcfg: size Especifica el tamaño de la partición del sistema cuando se crea una unidad del
sistema.

bdehdcfg: Impide la visualización de todas las acciones y errores en la interfaz de la línea de


quiet comandos y le indica a bdehdcfg que use la respuesta Sí a cualquier aviso Sí/No
que se produzca durante la preparación posterior de la unidad.

bdehdcfg: Indica al equipo que se reinicie una vez finalizada la preparación de la unidad.
restart

/? Muestra la Ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
bdehdcfg: driveinfo
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra la letra de la unidad, el tamaño total, el espacio máximo disponible y las


características de particiones. Solo se enumeran las particiones válidas. El espacio sin
asignar no se enumera si ya existen cuatro particiones principales o extendidas.

7 Nota

Este comando es solo informativo y no realiza ningún cambio en la unidad.

Sintaxis

bdehdcfg -driveinfo <drive_letter>

Parámetros

Parámetro Descripción

<drive_letter> Especifica la letra de una unidad seguida del signo de dos puntos.

Ejemplo
Para mostrar la información de la unidad C:

bdehdcfg driveinfo C:

Vínculos relacionados
Clave de sintaxis de línea de comandos
bdehdcfg
bdehdcfg: newdriveletter
Artículo • 14/04/2023

Asigna una nueva letra de unidad a la parte de una unidad utilizada como unidad del
sistema. Como procedimiento recomendado, se recomienda no asignar una letra de
unidad a la unidad del sistema.

Sintaxis

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


merge} -newdriveletter <drive_letter>

Parámetros

Parámetro Descripción

<drive_letter> Define la letra de unidad que se asignará a la unidad de destino especificada.

Ejemplos
Para asignar a la unidad predeterminada la letra de unidad P :

bdehdcfg -target default -newdriveletter P:

Vínculos relacionados
Clave de sintaxis de línea de comandos

bdehdcfg
bdehdcfg: quiet
Artículo • 05/10/2023

Informa a la herramienta de línea de comandos bdehdcfg que no se mostrarán todas las


acciones y errores en la interfaz de la línea de comandos. Las solicitudes Sí/No (S/N) que
se muestren durante la preparación de la unidad asumirán la respuesta "Sí". Para ver los
errores que se produzcan durante la preparación de la unidad, revise el registro de
eventos del sistema en el proveedor de eventos Microsoft-Windows-BitLocker-
DrivePreparationTool.

Sintaxis

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


merge} -quiet

Parámetros
Este comando no toma ningún parámetro adicional.

Ejemplos
Para usar el comando quiet:

bdehdcfg -target default -quiet

Vínculos relacionados
Clave de sintaxis de línea de comandos

bdehdcfg
bdehdcfg: restart
Artículo • 04/05/2023

Informa a la herramienta de línea de comandos bdehdcfg de que el equipo debe


reiniciarse una vez finalizada la preparación de la unidad. Si otros usuarios han iniciado
sesión en el equipo y no se especifica la opción quiet, aparece un mensaje para
confirmar que el equipo se debe reiniciar.

Sintaxis

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


merge} -restart

Parámetros
Este comando no toma ningún parámetro adicional.

Ejemplos
Para usar el comando restart:

bdehdcfg -target default -restart

Vínculos relacionados
Clave de sintaxis de línea de comandos

bdehdcfg
bdehdcfg: size
Artículo • 12/04/2023

Especifica el tamaño de la partición del sistema cuando se crea una nueva unidad del
sistema. Si no especifica un tamaño, la herramienta utilizará el valor predeterminado de
300 MB. El tamaño mínimo de la unidad del sistema es 100 MB. Si va a almacenar las
herramientas de recuperación del sistema u otras herramientas del sistema en la
partición del sistema, deberá aumentar el tamaño consiguientemente.

7 Nota

El comando size no se puede combinar con el comando target <drive_letter>


merge .

Sintaxis

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


<size_in_mb>

Parámetros

Parámetro Descripción

<size_in_mb> Indica el número de megabytes (MB) que se va a utilizar para la nueva partición.

Ejemplos
Para asignar 500 MB a la unidad de sistema predeterminada:

bdehdcfg -target default -size 500

Vínculos relacionados
Clave de sintaxis de línea de comandos
bdehdcfg
bdehdcfg: target
Artículo • 14/04/2023

Prepara una partición para su uso como unidad del sistema mediante BitLocker y la
recuperación de Windows. De forma predeterminada, esta partición se crea sin una letra
de unidad.

Sintaxis

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


merge}

Parámetros

Parámetro Descripción

default Indica que la herramienta de línea de comandos seguirá el mismo proceso que
el asistente para la instalación de BitLocker.

unallocated Crea la partición del sistema a partir del espacio sin asignar disponible en el
disco.

<drive_letter> Reduce la unidad especificada en la cantidad necesaria para crear una partición
shrink activa del sistema. Para utilizar este comando, la unidad especificada debe tener
al menos el 5 por ciento de espacio disponible.

<drive_letter> Utiliza la unidad de disco especificada como partición activa del sistema. La
merge unidad del sistema operativo no puede ser un destino para la combinación.

Ejemplos
Para designar una unidad existente (P) como unidad del sistema:

bdehdcfg -target P: merge

Vínculos relacionados
Clave de sintaxis de línea de comandos

bdehdcfg
begin backup
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2,
Windows Server 2012

Inicia una sesión de copia de seguridad completa. Este comando invalida la


configuración predeterminada de copia de seguridad.

Sintaxis

begin backup

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando begin restore


begin restore
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2,
Windows Server 2012

Empieza una sesión de restauración y emite un evento PreRestore a los escritores


implicados.

Sintaxis

begin restore

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando begin backup

Preparación para la restauración


bitsadmin
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2, Windows Server 2012, Windows 10

Bitsadmin es una herramienta de línea de comandos que se usa para crear, descargar o
cargar trabajos, y para supervisar su progreso. La herramienta bitsadmin usa
conmutadores para identificar el trabajo a realizar. Puede llamar a bitsadmin /? o
bitsadmin /help para obtener una lista de conmutadores.

La mayoría de los conmutadores requieren un parámetro <job> , que se establece en el


nombre para mostrar del trabajo, o GUID. El nombre para mostrar de un trabajo no
tiene por qué ser único. Los conmutadores /create y /list devuelven el GUID de un
trabajo.

De forma predeterminada, puede acceder a información sobre sus propios trabajos.


Para acceder a la información de los trabajos de otro usuario, debe tener privilegios de
administrador. Si el trabajo se creó en un estado con privilegios elevados, debe ejecutar
bitsadmin desde una ventana con privilegios elevados; de lo contrario, tendrá acceso de
solo lectura al trabajo.

Muchos de los modificadores corresponden a los métodos de las interfaces BITS. Para
obtener detalles adicionales que pueden ser relevantes para usar un modificador,
consulte el método correspondiente.

Use los siguientes modificadores para crear un trabajo, establecer y recuperar las
propiedades de un trabajo y supervisar el estado de un trabajo. Para ver ejemplos que
muestran cómo usar algunos de estos modificadores para realizar tareas, consulte
ejemplos de bitsadmin.

Conmutadores disponibles
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
Artículo • 14/04/2023

Agrega un archivo al trabajo especificado.

Sintaxis

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

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

remoteURL Dirección URL del archivo en el servidor.

localname El nombre del archivo del equipo local. Localname debe contener una ruta de
acceso absoluta al archivo.

Ejemplos
Para agregar un archivo al trabajo:

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

Repita esta llamada para cada archivo que desee agregar. Si varios trabajos usan
myDownloadJob como su nombre, debe reemplazar myDownloadJob por el GUID del
trabajo para identificar el trabajo de forma única.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin addfileset
Artículo • 12/04/2023

Agrega uno o varios archivos al trabajo especificado.

Sintaxis

bitsadmin /addfileset <job> <textfile>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

textfile Un archivo de texto, cuyas líneas contienen cada una un nombre de archivo remoto
y uno local. Nota: Los nombres deben estar delimitados por espacios. Las líneas que
comienzan con un carácter # se tratan como un comentario.

Ejemplos

bitsadmin /addfileset files.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin addfilewithranges
Artículo • 12/04/2023

Agrega un archivo al trabajo especificado. BITS descarga los intervalos especificados


desde el archivo remoto. Este conmutador solo es válido para trabajos de descarga.

Sintaxis

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

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

remoteURL Dirección URL del archivo en el servidor.

localname Nombre del archivo del equipo local. Debe contener una ruta de acceso absoluta al
archivo.

rangelist Lista delimitada por comas de pares offset:length. Use dos puntos para separar el
valor de desplazamiento del valor de longitud. Por ejemplo, un valor de
0:100,2000:100,5000:eof indica a BITS que transfiera 100 bytes del desplazamiento
0, 100 bytes del desplazamiento 2000 y los bytes restantes del desplazamiento 5000
al final del archivo.

Comentarios
El token eof es un valor de longitud válido dentro de los pares de desplazamiento
y longitud en <rangelist> . Indica al servicio que lea al final del archivo
especificado.

El comando addfilewithranges producirá un error con el código 0x8020002c, si se


especifica un intervalo de longitud cero junto con otro intervalo con el mismo
desplazamiento, como:

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

100:0,100:5
Mensaje de error: no se puede agregar el archivo al trabajo: 0x8020002c. La lista
de intervalos de bytes contiene algunos intervalos superpuestos que no se
admiten.

Solución: no especifique primero el intervalo de longitud cero. Por ejemplo, use


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

100:5,100:0 .

Ejemplos
Para transferir 100 bytes del desplazamiento 0, 100 bytes del desplazamiento 2000 y los
bytes restantes del desplazamiento 5000 al final del archivo:

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


0:100,2000:100,5000:eof

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin cache
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Contiene una lista de los modificadores bitsadmin /cache.

Contiene una lista de los modificadores bitsadmin /cache.

Sintaxis

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 Descripción

bitsadmin cache y help Muestra el uso de la línea de comandos para los conmutadores
/cache.

bitsadmin cache y clear Purga la memoria caché local.

bitsadmin cache y delete Elimina una entrada de caché.

bitsadmin cache y deleteurl Elimina todas las entradas de caché de la dirección URL
especificada.

bitsadmin cache y list Enumera todas las entradas de caché.

bitsadmin cache e info Vuelca una entrada de caché específica.

bitsadmin cache y getlimit Recupera el límite de caché.


Parámetro Descripción

bitsadmin cache y setlimit Establece el límite de caché.

bitsadmin cache y Recupera la hora de expiración de la caché.


getexpirationtime

bitsadmin cache y Establece la hora de expiración de la caché.


setexpirationtime

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin cache y delete
Artículo • 14/04/2023

Elimina una entrada de caché específica.

Sintaxis

bitsadmin /cache /delete recordID

Parámetros

Parámetro Descripción

recordID El GUID asociado a la entrada de caché.

Ejemplos
Para eliminar la entrada de caché con el RecordID de {6511FB02-E195-40A2-B595-
E8E2F8F47702}:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin cache


bitsadmin cache y deleteurl
Artículo • 05/10/2023

Elimina todas las entradas de caché de la dirección URL especificada.

Sintaxis

bitsadmin /deleteURL URL

Parámetros

Parámetro Description

Resolución Localizador uniforme de recursos que identifica un archivo remoto.

Ejemplos
Para eliminar todas las entradas de caché de
https://www.contoso.com/en/us/default.aspx :

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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin cache


bitsadmin cache y getexpirationtime
Artículo • 12/04/2023

Recupera la hora de expiración de la caché.

Sintaxis

bitsadmin /cache /getexpirationtime

Ejemplos
Para recuperar la hora de expiración de la caché:

bitsadmin /cache /getexpirationtime

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin cache


bitsadmin cache y getlimit
Artículo • 12/04/2023

Recupera el límite de caché.

Sintaxis

bitsadmin /cache /getlimit

Ejemplos
Para recuperar el límite de caché:

bitsadmin /cache /getlimit

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin cache


bitsadmin cache y help
Artículo • 12/04/2023

Muestra el uso de la línea de comandos para los conmutadores cache.

Sintaxis

bitsadmin /cache /help

Ejemplos
Mostrar la ayuda de la línea de comandos para los conmutadores cache.

bitsadmin /cache /help

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin cache


bitsadmin cache e info
Artículo • 14/04/2023

Vuelca una entrada de caché específica.

Sintaxis

bitsadmin /cache /info recordID [/verbose]

Parámetros

Parámetros Descripción

recordID El GUID asociado a la entrada de caché.

Ejemplos
Para volcar la entrada de caché con el valor recordID de {6511FB02-E195-40A2-B595-
E8E2F8F47702}:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin cache


bitsadmin cache y list
Artículo • 12/04/2023

Enumera todas las entradas de caché.

Sintaxis

bitsadmin /cache /list [/verbose]

Ejemplos
Para enumerar todas las entradas de caché en formato detallado.

bitsadmin /cache /list /verbose

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin cache


bitsadmin cache y setexpirationtime
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Establece la hora de expiración de la caché.

Sintaxis

bitsadmin /cache /setexpirationtime secs

Parámetros

Parámetro Descripción

secs Número de segundos hasta que expira la memoria caché.

Ejemplos
Para establecer que la memoria caché expire en 60 segundos:

bitsadmin /cache / setexpirationtime 60

Vínculos relacionados
Clave de sintaxis de línea de comandos

comando bitsadmin cache


bitsadmin cache y setlimit
Artículo • 12/04/2023

Establece el límite de tamaño de caché.

Sintaxis

bitsadmin /cache /setlimit percent

Parámetros

Parámetro Descripción

percent Límite de caché definido como porcentaje del espacio total en el disco duro.

Ejemplos
Para establecer el límite de tamaño de caché en 50 %:

bitsadmin /cache /setlimit 50

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin cache


bitsadmin cache y clear
Artículo • 12/04/2023

Se aplica a: Windows Server (todas las versiones compatibles)

bitsadmin cache y el comando clear purga la caché local.

Sintaxis

bitsadmin /cache /clear

Ejemplos
Para purgar la memoria caché local:

bitsadmin /cache /clear

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin cache


bitsadmin cancel
Artículo • 12/04/2023

Quita el trabajo de la cola de transferencia y elimina todos los archivos temporales


asociados al trabajo.

Sintaxis

bitsadmin /cancel <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para quitar el trabajo myDownloadJob de la cola de transferencias:

bitsadmin /cancel myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

comando bitsadmin
bitsadmin complete
Artículo • 14/04/2023

Completa el trabajo. Use este modificador después de que el trabajo pase al estado
transferido. De lo contrario, solo estarán disponibles los archivos que se hayan
transferido correctamente.

Sintaxis

bitsadmin /complete <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplo
Para completar el trabajo myDownloadJob, una vez alcanzado el estado TRANSFERRED :

bitsadmin /complete myDownloadJob

Si varios trabajos usan myDownloadJob como su nombre, debe usar el GUID del trabajo
para identificarlo de forma única para su finalización.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin create
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea un trabajo de transferencia con el nombre para mostrar especificado.

7 Nota

Los tipos de parámetros /Upload y /Upload-Reply no son compatibles con BITS 1.2
ni versiones anteriores.

Sintaxis

bitsadmin /create [type] displayname

Parámetros

Parámetro Descripción

type Existen tres tipos de trabajos:


/Download. Transfiere datos de un servidor a un archivo local.
/Upload. Transfiere datos de un archivo local a un servidor.
/Upload-Reply. Transfiere datos de un archivo local a un servidor y recibe un
archivo de respuesta del servidor.

Este parámetro tiene como valor predeterminado /Download si no se especifica.

displayname El nombre para mostrar asignado al trabajo creado recientemente.

Ejemplos
Para crear un trabajo de descarga denominado myDownloadJob:

bitsadmin /create myDownloadJob


Vínculos relacionados
Clave de sintaxis de línea de comandos

comando bitsadmin resume

Comando bitsadmin
Ejemplos de bitsadmin
Artículo • 12/04/2023

En los ejemplos siguientes se muestra cómo usar la herramienta bitsadmin para realizar
las tareas más comunes.

Transferencia de un archivo
Para crear un trabajo, agregue archivos, active el trabajo en la cola de transferencia y
complete el trabajo:

bitsadmin /transfer myDownloadJob /download /priority normal


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

BITSAdmin sigue mostrando información de progreso en la ventana MS-DOS hasta que


se completa la transferencia o se produce un error.

Creación de un trabajo de descarga


Para crear un trabajo de descarga denominado myDownloadJob:

bitsadmin /create myDownloadJob

BITSAdmin devuelve un GUID que identifica de forma única el trabajo. Use el GUID o el
nombre del trabajo en las llamadas posteriores. El texto siguiente es la salida de
ejemplo.

Salida de ejemplo
created job {C775D194-090F-431F-B5FB-8334D00D1CB6}

Adición de archivos al trabajo de descarga


Para agregar un archivo al trabajo:

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


Repita esta llamada para todos los archivos que quiera agregar. Si varios trabajos usan
myDownloadJob como su nombre, debe usar el GUID del trabajo para identificarlo de
forma única para su finalización.

Activación del trabajo de descarga


Después de crear un nuevo trabajo, BITS suspende automáticamente el trabajo. Para
activar el trabajo en la cola de transferencia:

bitsadmin /resume myDownloadJob

Si varios trabajos usan myDownloadJob como su nombre, debe usar el GUID del trabajo
para identificarlo de forma única para su finalización.

Determinar el progreso del trabajo de descarga


El modificador /info devuelve el estado del trabajo y el número de archivos y bytes
transferidos. Cuando el estado se muestra como TRANSFERRED , significa que BITS ha
transferido correctamente todos los archivos del trabajo. También puede agregar el
argumento /verbose para obtener detalles completos del trabajo y /list o /monitor para
obtener todos los trabajos de la cola de transferencia.

Para devolver el estado del trabajo:

bitsadmin /info myDownloadJob /verbose

Si varios trabajos usan myDownloadJob como su nombre, debe usar el GUID del trabajo
para identificarlo de forma única para su finalización.

Completar el trabajo de descarga


Para completar el trabajo después de que el estado cambie a TRANSFERRED :

bitsadmin /complete myDownloadJob


Debe ejecutar el conmutador /complete antes de que los archivos del trabajo estén
disponibles. Si varios trabajos usan myDownloadJob como su nombre, debe usar el GUID
del trabajo para identificarlo de forma única para su finalización.

Supervisión de trabajos en la cola de


transferencia mediante el conmutador /list
Para devolver el estado del trabajo y el número de archivos y bytes transferidos para
todos los trabajos de la cola de transferencia:

bitsadmin /list

Salida de ejemplo

{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).

Supervisión de trabajos en la cola de


transferencia mediante el conmutador
/monitor
Para devolver el estado del trabajo y el número de archivos y bytes transferidos para
todos los trabajos de la cola de transferencia, actualizando los datos cada 5 segundos:

bitsadmin /monitor

7 Nota

Para detener la actualización, presione CTRL+C.


Salida de ejemplo

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

Supervisión de trabajos en la cola de


transferencia mediante el conmutador /info
Para devolver el estado del trabajo y el número de archivos y bytes transferidos:

bitsadmin /info

Salida de ejemplo

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
Eliminación de trabajos de la cola de
transferencia
Para quitar todos los trabajos de la cola de transferencia, use el conmutador /reset:

bitsadmin /reset

Salida de ejemplo

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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getaclflags
Artículo • 14/04/2023

Recupera las marcas de propagación de la lista de control de acceso (ACL), que reflejan
si los objetos secundarios heredan los elementos.

Sintaxis

bitsadmin /getaclflags <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Comentarios
Devuelve uno o varios de los siguientes valores de marca:

o: copiar la información del propietario con el archivo.

g: copiar la información del grupo con el archivo.

d: copiar la información de la lista de control de acceso discrecional (DACL) con el


archivo.

s: copiar la información de la lista de control de acceso del sistema (SACL) con el


archivo.

Ejemplos
Para recuperar las marcas de propagación de la lista de control de acceso para el trabajo
denominado myDownloadJob:

bitsadmin /getaclflags myDownloadJob


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getbytestotal
Artículo • 14/04/2023

Recupera el tamaño del trabajo especificado.

Sintaxis

bitsadmin /getbytestotal <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar el tamaño del trabajo denominado myDownloadJob:

bitsadmin /getbytestotal myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getbytestransferred
Artículo • 14/04/2023

Recupera el número de bytes transferidos para el trabajo especificado.

Sintaxis

bitsadmin /getbytestransferred <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar el número de bytes transferidos para el trabajo denominado
myDownloadJob:

bitsadmin /getbytestransferred myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getclientcertificate
Artículo • 14/04/2023

Recupera el certificado de cliente del trabajo.

Sintaxis

bitsadmin /getclientcertificate <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar el certificado de cliente del trabajo denominado myDownloadJob:

bitsadmin /getclientcertificate myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getcompletiontime
Artículo • 14/04/2023

Recupera la hora en que el trabajo finalizó la transferencia de datos.

Sintaxis

bitsadmin /getcompletiontime <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar la hora en que el trabajo denominado myDownloadJob terminó de
transferir datos:

bitsadmin /getcompletiontime myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getcreationtime
Artículo • 12/04/2023

Recupera la hora de creación del trabajo especificado.

Sintaxis

bitsadmin /getcreationtime <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar la hora de creación del trabajo denominado myDownloadJob:

bitsadmin /getcreationtime myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getcustomheaders
Artículo • 12/04/2023

Recupera los encabezados HTTP personalizados del trabajo.

Sintaxis

bitsadmin /getcustomheaders <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para obtener los encabezados personalizados del trabajo denominado myDownloadJob:

bitsadmin /getcustomheaders myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getdescription
Artículo • 14/04/2023

Recupera la descripción del trabajo especificado.

Sintaxis

bitsadmin /getdescription <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar la descripción del trabajo denominado myDownloadJob:

bitsadmin /getdescription myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getdisplayname
Artículo • 14/04/2023

Recupera el nombre para mostrar del trabajo especificado.

Sintaxis

bitsadmin /getdisplayname <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar el nombre para mostrar del trabajo denominado myDownloadJob:

bitsadmin /getdisplayname myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin geterror
Artículo • 14/04/2023

Obtiene información detallada de los errores producidos en el trabajo especificado.

Sintaxis

bitsadmin /geterror <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar la información de error del trabajo denominado myDownloadJob:

bitsadmin /geterror myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin geterrorcount
Artículo • 12/04/2023

Recupera la cantidad de veces que el trabajo especificado generó un error transitorio.

Sintaxis

bitsadmin /geterrorcount <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar información sobre el recuento de errores para el trabajo denominado
myDownloadJob:

bitsadmin /geterrorcount myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getfilestotal
Artículo • 05/10/2023

Recupera el número de archivos de trabajo especificado.

Sintaxis

bitsadmin /getfilestotal <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar el número de archivos incluidos en el trabajo denominado
myDownloadJob:

bitsadmin /getfilestotal myDownloadJob

Vea también
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getfilestransferred
Artículo • 14/04/2023

Recupera el número de archivos transferidos para el trabajo especificado.

Sintaxis

bitsadmin /getfilestransferred <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar el número de archivos transferidos en el trabajo denominado
myDownloadJob:

bitsadmin /getfilestransferred myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin gethelpertokenflags
Artículo • 14/04/2023

Devuelve las marcas de uso de un token auxiliar asociado a un trabajo de transferencia


de BITS.

7 Nota

Este comando no es compatible con BITS 3.0 ni versiones anteriores.

Sintaxis

bitsadmin /gethelpertokenflags <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Comentarios
Posibles valores devueltos, entre los que se incluyen:

0x0001. El token auxiliar se usa para abrir el archivo local de un trabajo de carga,
para crear o cambiar el nombre del archivo temporal de un trabajo de descarga o
para crear o cambiar el nombre del archivo de respuesta de un trabajo de
respuesta de carga.

0x0002. El token auxiliar se usa para abrir el archivo remoto de un trabajo de carga
o descarga de bloque de mensajes del servidor (SMB) o en respuesta a un servidor
HTTP o desafío de proxy para credenciales NTLM o Kerberos implícitas. Debe
llamar a /SetCredentialsJob TargetScheme NULL NULL para permitir que las
credenciales se envíen a través de HTTP.

Ejemplos
Para recuperar las marcas de uso de un token auxiliar asociado a un trabajo de
transferencia de BITS denominado myDownloadJob:

bitsadmin /gethelpertokenflags myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin gethelpertokensid
Artículo • 14/04/2023

Devuelve el SID del token auxiliar de un trabajo de transferencia de BITS, si se establece


uno.

7 Nota

Este comando no es compatible con BITS 3.0 ni versiones anteriores.

Sintaxis

bitsadmin /gethelpertokensid <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar el SID de un trabajo de transferencia de BITS denominado
myDownloadJob:

bitsadmin /gethelpertokensid myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin gethttpmethod
Artículo • 12/04/2023

Obtiene el verbo HTTP que se va a usar con el trabajo.

Sintaxis

bitsadmin /gethttpmethod <Job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar el verbo HTTP que se va a usar con el trabajo denominado
myDownloadJob:

bitsadmin /gethttpmethod myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getmaxdownloadtime
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Recupera el tiempo de espera de descarga en segundos.

Sintaxis

bitsadmin /getmaxdownloadtime <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para obtener el tiempo máximo de descarga del trabajo denominado myDownloadJob
en segundos:

bitsadmin /getmaxdownloadtime myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getminretrydelay
Artículo • 14/04/2023

Recupera el período de tiempo, en segundos, que el servicio esperará después de


encontrar un error transitorio antes de intentar transferir el archivo.

Sintaxis

bitsadmin /getminretrydelay <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar el retraso de reintento mínimo para el trabajo denominado
myDownloadJob:

bitsadmin /getminretrydelay myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getmodificationtime
Artículo • 14/04/2023

Recupera la última vez que se modificó el trabajo o los datos se transfirieron


correctamente.

Sintaxis

bitsadmin /getmodificationtime <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar la hora de la última modificación del trabajo denominado
myDownloadJob:

bitsadmin /getmodificationtime myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getnoprogresstimeout
Artículo • 14/04/2023

Recupera el período de tiempo, en segundos, que pasará hasta que el servicio intente
transferir el archivo después de que se produzca un error transitorio.

Sintaxis

bitsadmin /getnoprogresstimeout <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar el valor de tiempo de espera de progreso del trabajo denominado
myDownloadJob:

bitsadmin /getnoprogresstimeout myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getnotifycmdline
Artículo • 14/04/2023

Recupera el comando de línea de comandos para ejecutarse después de que el trabajo


especificado termine de transferir datos.

7 Nota

Este comando no es compatible con BITS 1.2 ni versiones anteriores.

Sintaxis

bitsadmin /getnotifycmdline <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar el comando de línea de comandos usado por el servicio cuando se
completa el trabajo denominado myDownloadJob.

bitsadmin /getnotifycmdline myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getnotifyflags
Artículo • 14/04/2023

Recupera las marcas de notificación para el trabajo especificado.

Sintaxis

bitsadmin /getnotifyflags <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Comentarios
El trabajo puede contener una o varias de las marcas de notificación siguientes:

Marca Descripción

0x001 Generar un evento cuando se hayan transferido todos los archivos del trabajo.

0x002 Generar un evento cuando se produzca un error.

0x004 Deshabilitar las notificaciones.

0x008 Generar un evento cuando se modifique el trabajo o se realice el progreso de la


transferencia.

Ejemplos
Para recuperar las marcas de notificación del trabajo denominado myDownloadJob:

bitsadmin /getnotifyflags myDownloadJob


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getnotifyinterface
Artículo • 14/04/2023

Determina si otro programa ha registrado una interfaz de devolución de llamada COM


(la interfaz de notificación) para el trabajo especificado.

Sintaxis

bitsadmin /getnotifyinterface <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Resultados

La salida de este comando muestra Registered o Unregistered.

7 Nota

No es posible determinar el programa que registró la interfaz de devolución de


llamada.

Ejemplos
Para recuperar la interfaz de notificación del trabajo denominado myDownloadJob:

bitsadmin /getnotifyinterface myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getowner
Artículo • 12/04/2023

Muestra el nombre para mostrar o el GUID del propietario del trabajo especificado.

Sintaxis

bitsadmin /getowner <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para mostrar el propietario del trabajo denominado myDownloadJob:

bitsadmin /getowner myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getpeercachingflags
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Recupera marcas que determinan si los archivos del trabajo se pueden almacenar en
caché y enviarse a elementos del mismo nivel, y si BITS puede descargar contenido para
el trabajo de elementos del mismo nivel.

Sintaxis

bitsadmin /getpeercachingflags <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar las marcas del trabajo denominado myDownloadJob:

bitsadmin /getpeercachingflags myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getpriority
Artículo • 14/04/2023

Recupera el tipo del trabajo especificado.

Sintaxis

bitsadmin /getpriority <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Resultados
La prioridad devuelta para este comando puede ser:

FOREGROUND

HIGH

NORMAL

LOW

UNKNOWN

Ejemplos
Para recuperar la prioridad del trabajo denominado myDownloadJob:

bitsadmin /getpriority myDownloadJob


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getproxybypasslist
Artículo • 30/05/2023

Se aplica a Windows Server (todas las versiones compatibles)

El comando bitsadmin /getproxybypasslist recupera la lista de omisión de proxy para


el trabajo especificado.

Sintaxis

bitsadmin /getproxybypasslist <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Comentarios
La lista de omisión contiene los nombres de host o las direcciones IP, o ambas, que no
se enrutan a través de un proxy. La lista puede contener <local> para hacer referencia a
todos los servidores de la misma LAN. La lista puede estar delimitada por punto y coma
o por espacios.

Ejemplos
Para recuperar la lista de omisión de proxy para el trabajo denominado myDownloadJob:

bitsadmin /getproxybypasslist myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando bitsadmin
bitsadmin getproxylist
Artículo • 14/04/2023

Recupera la lista delimitada por comas de los servidores proxy que se van a usar para el
trabajo especificado.

Sintaxis

bitsadmin /getproxylist <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar la lista de servidores proxy del trabajo denominado myDownloadJob:

bitsadmin /getproxylist myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getproxyusage
Artículo • 12/04/2023

Recupera la configuración de uso del proxy para el trabajo especificado.

Sintaxis

bitsadmin /getproxyusage <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Resultados
Los valores de uso de proxy devueltos pueden ser:

Preconfig: use los valores predeterminados de Internet Explorer del propietario

No_Proxy: no use un servidor proxy

Override: use una lista de proxy explícita

Autodetect: detecta automáticamente la configuración del proxy

Ejemplos
Para recuperar el uso de proxy del trabajo denominado myDownloadJob:

bitsadmin /getproxyusage myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getreplydata
Artículo • 14/04/2023

Recupera los datos de carga y respuesta del servidor en formato hexadecimal para el
trabajo.

7 Nota

Este comando no es compatible con BITS 1.2 ni versiones anteriores.

Sintaxis

bitsadmin /getreplydata <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar los datos de carga y respuesta del trabajo denominado myDownloadJob:

bitsadmin /getreplydata myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getreplyfilename
Artículo • 14/04/2023

Obtiene la ruta de acceso del archivo que contiene el servidor upload-reply para el
trabajo.

7 Nota

Este comando no es compatible con BITS 1.2 ni versiones anteriores.

Sintaxis

bitsadmin /getreplyfilename <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar el nombre de archivo upload-reply del trabajo denominado
myDownloadJob:

bitsadmin /getreplyfilename myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getreplyprogress
Artículo • 12/04/2023

Recupera el tamaño y el progreso del servidor de respuesta de carga.

7 Nota

Este comando no es compatible con BITS 1.2 ni versiones anteriores.

Sintaxis

bitsadmin /getreplyprogress <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar el progreso de respuesta de carga del trabajo denominado
myDownloadJob:

bitsadmin /getreplyprogress myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getsecurityflags
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Informa de las marcas de seguridad HTTP para la redirección de direcciones URL y


comprobaciones realizadas en el certificado de servidor durante la transferencia.

Sintaxis

bitsadmin /getsecurityflags <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar las marcas de seguridad de un trabajo denominado myDownloadJob:

bitsadmin /getsecurityflags myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getstate
Artículo • 30/05/2023

Se aplica a: Windows Server (todas las versiones compatibles)

El comando bitsadmin /getstate recupera el estado de un trabajo especificado.

Sintaxis

bitsadmin /getstate <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Resultados

Los valores de salida devueltos pueden ser:

State Descripción

Queued El trabajo está a la espera para ejecutarse.

Connecting BITS está contactando con el servidor.

Transferring BITS está transfiriendo datos.

Transferred BITS ha transferido correctamente todos los archivos del trabajo.

Suspended Se ha pausado el trabajo.

Error Se ha producido un error irrecuperable; no se reintenta la transferencia.

Transient_Error Error recuperable; se reintenta la transferencia cuando expira el retraso mínimo


de reintento.

Acknowledged Se ha completado el trabajo.

Canceled El trabajo se canceló.


Ejemplos
Para recuperar el estado del trabajo denominado myDownloadJob:

bitsadmin /getstate myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin gettemporaryname
Artículo • 12/04/2023

Informa del nombre de archivo temporal del archivo especificado dentro del trabajo.

Sintaxis

bitsadmin /gettemporaryname <job> <file_index>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

file_index Comienza a partir de 0.

Ejemplos
Para notificar el nombre de archivo temporal del archivo 2 para el trabajo denominado
myDownloadJob:

bitsadmin /gettemporaryname myDownloadJob 1

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin gettype
Artículo • 14/04/2023

Recupera el tipo del trabajo especificado.

Sintaxis

bitsadmin /gettype <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Resultados
Los valores de salida devueltos pueden ser:

Tipo Descripción

Descargar El trabajo es una descarga.

Cargar El trabajo es una carga.

Respuesta de carga El trabajo es una respuesta de carga.

Desconocido El trabajo es de tipo desconocido.

Ejemplos
Para recuperar el tipo del trabajo denominado myDownloadJob:

bitsadmin /gettype myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin getvalidationstate
Artículo • 09/10/2023

Informa del estado de validación del contenido del archivo especificado dentro del
trabajo.

Sintaxis

bitsadmin /getvalidationstate <job> <file_index>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

file_index Comienza a partir de 0.

Ejemplos
Para recuperar el estado de validación del contenido del archivo 2 dentro del trabajo
denominado myDownloadJob:

bitsadmin /getvalidationstate myDownloadJob 1

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin help
Artículo • 12/04/2023

Se aplica a: Windows Server (todas las versiones compatibles)

El comando de ayuda bitsadmin muestra información relacionada con la ayuda sobre los
parámetros y opciones de la línea de comandos bitsadmin.

Sintaxis

bitsadmin /help | /?

Ejemplos
Para recuperar la ayuda de la línea de comandos.

bitsadmin /help

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin info
Artículo • 12/04/2023

Muestra información de resumen acerca del trabajo especificado.

Sintaxis

bitsadmin /info <job> [/verbose]

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

/verbose Opcional. Proporciona información detallada sobre cada trabajo.

Ejemplos
Para recuperar información sobre el trabajo denominado myDownloadJob:

bitsadmin /info myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

bitsadmin info
bitsadmin list
Artículo • 12/04/2023

Enumera los trabajos de transferencia que pertenecen al usuario actual.

Sintaxis

bitsadmin /list [/allusers][/verbose]

Parámetros

Parámetro Descripción

/allusers Opcional. Enumera los trabajos de todos los usuarios. Debe tener privilegios de
administración para poder usar este parámetro.

/verbose Opcional. Proporciona información detallada sobre cada trabajo.

Ejemplos
Para recuperar información sobre los trabajos que pertenecen al usuario actual.

bitsadmin /list

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin listfiles
Artículo • 12/04/2023

Enumera los archivos del trabajo especificado.

Sintaxis

bitsadmin /listfiles <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar la lista de archivos del trabajo denominado myDownloadJob:

bitsadmin /listfiles myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin makecustomheaderswriteonly
Artículo • 12/04/2023

Hacer que los encabezados HTTP personalizados de un trabajo sean solo de escritura.

) Importante

Esta acción no se puede deshacer.

Sintaxis

bitsadmin /makecustomheaderswriteonly <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para que los encabezados HTTP personalizados sean solo de escritura para el trabajo
denominado myDownloadJob:

bitsadmin /makecustomheaderswriteonly myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin monitor
Artículo • 14/04/2023

Supervisa los trabajos de la cola de transferencia que pertenecen al usuario actual.

Sintaxis

bitsadmin /monitor [/allusers] [/refresh <seconds>]

Parámetros

Parámetro Descripción

/allusers Opcional. Supervisa los trabajos de todos los usuarios. Debe tener privilegios de
administrador para poder usar este parámetro.

/refresh Opcional. Actualiza los datos en un intervalo especificado por <seconds> . El


intervalo de actualización predeterminado es cada cinco segundos. Para detener la
actualización, presione CTRL+C.

Ejemplos
Para supervisar la cola de transferencia de trabajos que pertenecen al usuario actual y
actualizar la información cada 60 segundos.

bitsadmin /monitor /refresh 60

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin nowrap
Artículo • 14/04/2023

Trunca cualquier línea de texto de salida que se extienda más allá del borde más a la
derecha de la ventana de comandos. De forma predeterminada, todos los
modificadores, excepto el modificador de monitor, encapsulan la salida. Especifique el
modificador nowrap antes que otros modificadores.

Sintaxis

bitsadmin /nowrap

Ejemplos
Para recuperar el estado del trabajo denominado myDownloadJob sin encapsular la
salida:

bitsadmin /nowrap /getstate myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin peercaching
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Enumera los conmutadores /peercaching.

Enumera los conmutadores /peercaching.

Sintaxis

bitsadmin /peercaching /help


bitsadmin /peercaching /setconfigurationflags
bitsadmin /peercaching /getconfigurationflags

Parámetros

Parámetro Descripción

bitsadmin Muestra el uso de la línea de comandos para los conmutadores


peercaching y help /peercaching.

bitsadmin Establece las marcas de configuración que determinan si el equipo puede


peercaching y servir contenido a elementos del mismo nivel y si puede descargar
setconfigurationflags contenido de elementos del mismo nivel.

bitsadmin Obtiene las marcas de configuración que determinan si el equipo sirve


peercaching y contenido a elementos del mismo nivel y si puede descargar contenido
getconfigurationflags de elementos del mismo nivel.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin peercaching y
getconfigurationflags
Artículo • 12/04/2023

Obtiene las marcas de configuración que determinan si el equipo sirve contenido a


elementos del mismo nivel y si puede descargar contenido de elementos del mismo
nivel.

Sintaxis

bitsadmin /peercaching /getconfigurationflags <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para obtener las marcas de configuración del trabajo denominado myDownloadJob:

bitsadmin /peercaching /getconfigurationflags myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin

comando bitsadmin peercaching


bitsadmin peercaching y help
Artículo • 12/04/2023

Afecta a todas las versiones compatibles de Windows Server

El comando bitsadmin muestra el uso de la línea de comandos del conmutador


/peercaching cuando se combina con el conmutador /help .

Sintaxis
Se usa la sintaxis siguiente:

CLI

bitsadmin /peercaching /help

Ejemplos
Para poder ver la ayuda de la línea de comandos de los conmutadores /peercaching ,
ejecute el siguiente comando.

CLI

bitsadmin /peercaching /help

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin

comando bitsadmin peercaching


bitsadmin peercaching y
setconfigurationflags
Artículo • 12/04/2023

Establece las marcas de configuración que determinan si el equipo puede servir


contenido a elementos del mismo nivel y si puede descargar contenido de elementos
del mismo nivel.

Sintaxis

bitsadmin /peercaching /setconfigurationflags <job> <value>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

value Un entero sin signo con la siguiente interpretación de los bits de la representación
binaria:
Para permitir que los datos del trabajo se descarguen desde un elemento del
mismo nivel, establezca el bit menos significativo.
Para permitir que los datos del trabajo se sirvan a elementos del mismo nivel,
establezca el segundo bit de la derecha.

Ejemplos
Para especificar los datos del trabajo que se van a descargar de elementos del mismo
nivel para el trabajo denominado myDownloadJob:

bitsadmin /peercaching /setconfigurationflags myDownloadJob 1

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin

comando bitsadmin peercaching


bitsadmin peers
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Enumera los modificadores /peer disponibles.

Enumera los modificadores /peer disponibles.

bitsadmin /peers /help


bitsadmin /peers /discover
bitsadmin /peers /clear
bitsadmin /peers /list

Parámetros

Parámetro Descripción

bitsadmin peers y help Muestra el uso de la línea de comandos para los modificadores
/peers.

bitsadmin peers y Vuelve a detectar nodos del mismo nivel.


discover

bitsadmin peers y clear Borra la lista de nodos del mismo nivel.

bitsadmin peers y list Enumera todos los nodos del mismo nivel.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin peers y clear
Artículo • 30/05/2023

Se aplica a Windows Server (todas las versiones compatibles)

El comando bitsadmin /peers /clear borra la lista de elementos del mismo nivel.

Sintaxis

bitsadmin /peers /clear

Ejemplos
Para borrar la lista de elementos del mismo nivel.

bitsadmin /peers /clear

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin

Comando bitsadmin peers


bitsadmin peers y discover
Artículo • 12/04/2023

Se aplica a: Windows Server (todas las versiones compatibles)

Los elementos del mismo nivel bitsadmin y el comando detectar redescubren los
elementos del mismo nivel.

Sintaxis

bitsadmin /peers /discover

Ejemplos
Para redescubrir elementos del mismo nivel:

bitsadmin /peers /discover

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin

Comando bitsadmin peers


bitsadmin peers y help
Artículo • 14/04/2023

Muestra el uso de la línea de comandos para los modificadores /peers.

Sintaxis

bitsadmin /peers /help

Ejemplos
Para mostrar el uso de la línea de comandos para los modificadores /peers:

bitsadmin /peers /help

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin

Comando bitsadmin peers


bitsadmin peers y list
Artículo • 12/04/2023

Se aplica a: Windows Server (todas las versiones compatibles)

El comando bitsadmin , cuando se combina con los modificadores del mismo nivel y
lista, enumera todos los elementos del mismo nivel.

Sintaxis
CLI

bitsadmin /peers /list

Ejemplos
Para enumerar todos los elementos del mismo nivel:

CLI

bitsadmin /peers /list

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin

Comando bitsadmin peers


bitsadmin rawreturn
Artículo • 12/04/2023

Se aplica a: Windows Server (todas las versiones compatibles)

El comando bitsadmin rawreturn devuelve datos adecuados para analizar. Normalmente,


se usa este comando con los conmutadores /create y /get* para recibir solo el valor.
Debe especificar este conmutador antes de cualquier otro conmutador.

7 Nota

Este comando elimina los caracteres de nueva línea y el formato de la salida.

Sintaxis

bitsadmin /rawreturn

Ejemplos
Para recuperar los datos sin procesar del estado del trabajo denominado
myDownloadJob:

bitsadmin /rawreturn /getstate myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin removeclientcertificate
Artículo • 12/04/2023

Quita el certificado de cliente del trabajo.

Sintaxis

bitsadmin /removeclientcertificate <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para quitar el certificado de cliente del trabajo denominado myDownloadJob:

bitsadmin /removeclientcertificate myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin removecredentials
Artículo • 05/10/2023

Quita las credenciales de un trabajo.

7 Nota

Este comando no es compatible con BITS 1.2 ni versiones anteriores.

Sintaxis

bitsadmin /removecredentials <job> <target> <scheme>

Parámetros

Parámetro Descripción

trabajo GUID o nombre para mostrar del trabajo.

Destino Use SERVER o PROXY.

scheme Use uno de los siguientes:


BASIC. La autenticación es un esquema en el que el nombre de usuario y la
contraseña se envían al servidor o proxy como texto no cifrado.
DIGEST. Una autenticación de esquema de desafío-respuesta que utiliza una
cadena de datos especificada por el servidor para el desafío.
NTLM. Un esquema de autenticación de desafío-respuesta que usa las
credenciales del usuario para la autenticación en un entorno de red de
Windows.
NEGOTIATE (también conocido como protocolo de negociación simple y
protegida). El esquema de autenticación de desafío-respuesta que negocia
con el servidor o proxy para saber qué esquema se debe usar para la
autenticación. Algunos ejemplos son el protocolo Kerberos y NTLM.
PASSPORT. Un servicio de autenticación centralizado proporcionado por
Microsoft que ofrece un único inicio de sesión para sitios miembros.

Ejemplos
Para quitar las credenciales del trabajo denominado myDownloadJob:
bitsadmin /removecredentials myDownloadJob SERVER BASIC

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin replaceremoteprefix
Artículo • 06/04/2023

Cambia la dirección URL remota de todos los archivos del trabajo de oldprefix a
newprefix, según sea necesario.

Sintaxis

bitsadmin /replaceremoteprefix <job> <oldprefix> <newprefix>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

oldprefix Prefijo de dirección URL existente.

newprefix Nuevo prefijo de dirección URL.

Ejemplos
Para cambiar la dirección URL remota de todos los archivos del trabajo denominado
myDownloadJob, de http://stageserver a http://prodserver.

bitsadmin /replaceremoteprefix myDownloadJob http://stageserver


http://prodserver

Información adicional
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin reset
Artículo • 12/04/2023

Cancela todos los trabajos de la cola de transferencia propiedad del usuario actual. No
se pueden restablecer los trabajos creados por el sistema local. En su lugar, debe ser
administrador y usar el programador de tareas para programar este comando como una
tarea mediante las credenciales del sistema local.

7 Nota

Si tiene privilegios de administrador en BITSAdmin 1.5 y versiones anteriores, el


modificador /reset cancelará todos los trabajos de la cola. Además, no se admite la
opción /allusers.

Sintaxis

bitsadmin /reset [/allusers]

Parámetros

Parámetro Descripción

/allusers Opcional. Cancela todos los trabajos de la cola propiedad del usuario actual. Debe
tener privilegios de administrador para poder usar este parámetro.

Ejemplos
Para cancelar todos los trabajos de la cola de transferencia para el usuario actual.

bitsadmin /reset

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando bitsadmin
bitsadmin resume
Artículo • 14/04/2023

Activa un trabajo nuevo o suspendido en la cola de transferencia. Si reanudó el trabajo


por error o simplemente tiene que suspender el trabajo, puede usar el modificador de
suspensión bitsadmin para suspender el trabajo.

Sintaxis

bitsadmin /resume <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para reanudar el trabajo denominado myDownloadJob:

bitsadmin /resume myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

comando bitsadmin suspend

Comando bitsadmin
bitsadmin setaclflag
Artículo • 14/04/2023

Establece las marcas de propagación de la lista de control de acceso (ACL) para el


trabajo. Las marcas indican que desea mantener la información del propietario y la ACL
con el archivo que se está descargando. Por ejemplo, para mantener el propietario y el
grupo con el archivo, establezca el parámetro flags en og .

Sintaxis

bitsadmin /setaclflag <job> <flags>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

flags Especifique uno o varios de los valores, entre los que se incluyen:
o: copiar la información del propietario con el archivo.
g: copiar la información del grupo con el archivo.
d: copiar la información de la lista de control de acceso discrecional (DACL)
con el archivo.
s: copiar la información de la lista de control de acceso del sistema (SACL) con
el archivo.

Ejemplos
Para establecer las marcas de propagación de la lista de control de acceso para el
trabajo denominado myDownloadJob, por lo que mantiene la información de
propietario y grupo con los archivos descargados.

bitsadmin /setaclflags myDownloadJob og

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setclientcertificatebyid
Artículo • 14/04/2023

Especifica el identificador del certificado de cliente que se va a usar para la autenticación


de cliente en una solicitud HTTPS (SSL).

Sintaxis

bitsadmin /setclientcertificatebyid <job> <store_location> <store_name>


<hexadecimal_cert_id>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

store_location Identifica la ubicación de un almacén del sistema que se va a usar para


buscar el certificado, donde se incluye.
CURRENT_USER
LOCAL_MACHINE
CURRENT_SERVICE
SERVICES
USUARIOS
CURRENT_USER_GROUP_POLICY
LOCAL_MACHINE_GROUP_POLICY
LOCAL_MACHINE_ENTERPRISE.

store_name Nombre del almacén de certificados, donde se incluye:


CA (certificados de entidad de certificación)
MY (certificados personales)
ROOT (certificados raíz)
SPC (certificado de publicador de software).

hexadecimal_cert_id Número hexadecimal que representa el hash del certificado.

Ejemplos
Para especificar el identificador del certificado de cliente que se va a usar para la
autenticación de cliente en una solicitud HTTPS (SSL) para el trabajo denominado
myDownloadJob:

bitsadmin /setclientcertificatebyid myDownloadJob


BG_CERT_STORE_LOCATION_CURRENT_USER MY A106B52356D3FBCD1853A41B619358BD

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setclientcertificatebyname
Artículo • 12/04/2023

Especifica el nombre del firmante del certificado de cliente que se va a usar para la
autenticación de cliente en una solicitud HTTPS (SSL).

Sintaxis

bitsadmin /setclientcertificatebyname <job> <store_location> <store_name>


<subject_name>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar del trabajo o GUID.

store_location Identifica la ubicación de un almacén del sistema que se va a usar para buscar el
certificado. Los valores posibles son:
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 Nombre del almacén de certificados. Los valores posibles son:


CA (certificados de la entidad de certificación)
MY (certificados personales)
ROOT (certificados raíz)
SPC (certificado del publicador de software)

subject_name Nombre del certificado.

Ejemplos
Para especificar el nombre del certificado de cliente myCertificate que se usará para la
autenticación de cliente en una solicitud HTTPS (SSL) para el trabajo denominado
myDownloadJob:

bitsadmin /setclientcertificatebyname myDownloadJob 1 MY myCertificate

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setcredentials
Artículo • 05/10/2023

Agrega credenciales a un trabajo.

7 Nota

Este comando no es compatible con BITS 1.2 ni versiones anteriores.

Sintaxis

bitsadmin /setcredentials <job> <target> <scheme> <username> <password>

Parámetros

Parámetro Descripción

trabajo GUID o nombre para mostrar del trabajo.

Destino Use SERVER o PROXY.

scheme Use uno de los siguientes:


BASIC. La autenticación es un esquema en el que el nombre de
usuario y la contraseña se envían al servidor o proxy como texto no
cifrado.
DIGEST. Una autenticación de esquema de desafío-respuesta que
utiliza una cadena de datos especificada por el servidor para el
desafío.
NTLM. Un esquema de autenticación de desafío-respuesta que usa
las credenciales del usuario para la autenticación en un entorno de
red de Windows.
NEGOTIATE (también conocido como protocolo de negociación
simple y protegida). El esquema de autenticación de desafío-
respuesta que negocia con el servidor o proxy para saber qué
esquema se debe usar para la autenticación. Algunos ejemplos son el
protocolo Kerberos y NTLM.
PASSPORT. Un servicio de autenticación centralizado proporcionado
por Microsoft que ofrece un único inicio de sesión para sitios
miembros.
Parámetro Descripción

nombre_de_usuario Nombre del usuario.

password La contraseña asociada al nombre de usuario Username que se


proporcionó.

Ejemplos
Para agregar credenciales al trabajo denominado myDownloadJob:

bitsadmin /setcredentials myDownloadJob SERVER BASIC Edward password20

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setcustomheaders
Artículo • 14/04/2023

Agregue un encabezado HTTP personalizado a una solicitud GET enviada a un servidor


HTTP. Para obtener más información sobre las solicitudes GET, vea Definiciones de
método y Definiciones de campo de encabezado .

Sintaxis

bitsadmin /setcustomheaders <job> <header1> <header2> <...>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

<header1> <header2> , etc. Encabezados personalizados para el trabajo.

Ejemplos
Para agregar un encabezado HTTP personalizado para el trabajo denominado
myDownloadJob:

bitsadmin /setcustomheaders myDownloadJob accept-encoding:deflate/gzip

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setdescription
Artículo • 14/04/2023

Establece la descripción de la regla especificada.

Sintaxis

bitsadmin /setdescription <job> <description>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

description Texto utilizado para describir el trabajo.

Ejemplos
Para recuperar la descripción del trabajo denominado myDownloadJob:

bitsadmin /setdescription myDownloadJob music_downloads

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setdisplayname
Artículo • 12/04/2023

Establece el nombre para mostrar del trabajo especificado.

Sintaxis

bitsadmin /setdisplayname <job> <display_name>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

display_name Texto usado como nombre para mostrar para el trabajo específico.

Ejemplos
Para establecer el nombre para mostrar del trabajo en myDownloadJob:

bitsadmin /setdisplayname myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin sethelpertoken
Artículo • 12/04/2023

Establece el token principal del símbolo del sistema actual (o un token arbitrario de la
cuenta de usuario local, si se especifica) como token auxiliar del trabajo de transferencia
de BITS.

7 Nota

Este comando no es compatible con BITS 3.0 ni versiones anteriores.

Sintaxis

bitsadmin /sethelpertoken <job> [<user_name@domain> <password>]

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

<username@domain> Opcional. Credenciales de la cuenta de usuario local para las que se va


<password> a usar el token.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin sethelpertokenflags
Artículo • 14/04/2023

Establece las marcas de uso de un token auxiliar asociado a un trabajo de transferencia


de BITS.

7 Nota

Este comando no es compatible con BITS 3.0 ni versiones anteriores.

Sintaxis

bitsadmin /sethelpertokenflags <job> <flags>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

flags Posibles valores de token auxiliar, entre los que se incluyen:


0x0001. Se usa para abrir el archivo local de un trabajo de carga, para crear o
cambiar el nombre del archivo temporal de un trabajo de descarga o para
crear o cambiar el nombre del archivo de respuesta de un trabajo de
respuesta de carga.
0x0002. Se usa para abrir el archivo remoto de un trabajo de carga o
descarga de bloque de mensajes del servidor (SMB) o en respuesta a un
servidor HTTP o desafío de proxy para credenciales NTLM o Kerberos
implícitas.

Debe llamar a /setcredentialsjob targetscheme null null para enviar las


credenciales a través de HTTP.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin sethttpmethod
Artículo • 12/04/2023

El verbo HTTP que se va a usar.

Sintaxis

bitsadmin /sethttpmethod <job> <httpmethod>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar del trabajo o GUID.

httpmethod El verbo HTTP que se va a usar. Para obtener información sobre los verbos
disponibles, consulte Definiciones de método .

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setmaxdownloadtime
Artículo • 14/04/2023

Establece el tiempo de espera de descarga en segundos.

Sintaxis

bitsadmin /setmaxdownloadtime <job> <timeout>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

timeout La duración del tiempo de espera de descarga, en segundos.

Ejemplos
Para establecer el tiempo de espera del trabajo denominado myDownloadJob en
10 segundos.

bitsadmin /setmaxdownloadtime myDownloadJob 10

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setminretrydelay
Artículo • 14/04/2023

Especifica el período mínimo de tiempo, en segundos, que BITS espera antes de intentar
transferir el archivo después de encontrar un error transitorio.

Sintaxis

bitsadmin /setminretrydelay <job> <retrydelay>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

retrydelay Período mínimo de tiempo para que BITS espere después de un error durante la
transferencia, en segundos.

Ejemplos
Para establecer el retraso mínimo de reintento en 35 segundos para el trabajo
denominado myDownloadJob:

bitsadmin /setminretrydelay myDownloadJob 35

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setnoprogresstimeout
Artículo • 12/04/2023

Establece el período de tiempo, en segundos, que pasa hasta que BITS intenta transferir
el archivo después de producirse el primer error transitorio.

Sintaxis

bitsadmin /setnoprogresstimeout <job> <timeoutvalue>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

timeoutvalue El período de tiempo que BITS espera para transferir un archivo después del
primer error, en segundos.

Comentarios
El intervalo de tiempo de espera "sin progreso" comienza cuando el trabajo
encuentra el primer error transitorio.

El intervalo de tiempo de espera se detiene o restablece cuando se transfiere


correctamente un byte de datos.

Si el intervalo de tiempo de espera "sin progreso" supera timeoutvalue, el trabajo


se coloca en un estado de error irrecuperable.

Ejemplos
Para establecer el valor de tiempo de espera "sin progreso" en 20 segundos, para el
trabajo denominado myDownloadJob:

bitsadmin /setnoprogresstimeout myDownloadJob 20


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setnotifycmdline
Artículo • 12/04/2023

Establece el comando de línea de comandos que se ejecuta después de que el trabajo


termine de transferir datos o después de que un trabajo entre en un estado
especificado.

7 Nota

Este comando no es compatible con BITS 1.2 ni versiones anteriores.

Sintaxis

bitsadmin /setnotifycmdline <job> <program_name> [program_parameters]

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

program_name Nombre del comando que se va a ejecutar cuando se complete el trabajo.


Puede establecer este valor como NULL, pero si lo hace,
program_parameters también debe establecerse en NULL.

program_parameters Parámetros que quiere pasar a program_name. Puede establecer este valor
como NULL. Si program_parameters no se establece en NULL, el primer
parámetro de program_parameters debe coincidir con el program_name.

Ejemplos
Para ejecutar Notepad.exe al completarse el trabajo denominado myDownloadJob:

bitsadmin /setnotifycmdline myDownloadJob c:\winnt\system32\notepad.exe NULL


Para mostrar el texto EULA en Notepad.exe al completarse el trabajo denominado
myDownloadJob:

bitsadmin /setnotifycmdline myDownloadJob c:\winnt\system32\notepad.exe


notepad c:\eula.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setnotifyflags
Artículo • 14/04/2023

Establece las marcas de notificación de eventos para el trabajo especificado.

Sintaxis

bitsadmin /setnotifyflags <job> <notifyflags>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

notifyflags Puede incluir una o varias de las siguientes marcas de notificación, entre las que se
incluyen:
1. Genera un evento cuando se han transferido todos los archivos del trabajo.
2. Genera un evento cuando se produce un error.
3. Genera un evento cuando todos los archivos han completado la
transferencia o cuando se produce un error.
4. Deshabilita las notificaciones.

Ejemplos
Para establecer las marcas de notificación para generar un evento cuando se produce un
error, para un trabajo denominado myDownloadJob:

bitsadmin /setnotifyflags myDownloadJob 2

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setpeercachingflags
Artículo • 12/04/2023

Establece marcas que determinan si los archivos del trabajo se pueden almacenar en
caché y servir a elementos del mismo nivel y si el trabajo puede descargar contenido de
elementos del mismo nivel.

Sintaxis

bitsadmin /setpeercachingflags <job> <value>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

value Entero sin signo, que se incluye:


1. El trabajo puede descargar contenido de elementos del mismo nivel.
2. Los archivos del trabajo se pueden almacenar en caché y servirse a
elementos del mismo nivel.

Ejemplos
Para permitir que el trabajo denominado myDownloadJob descargue contenido de
elementos del mismo nivel:

bitsadmin /setpeercachingflags myDownloadJob 1

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setpriority
Artículo • 14/04/2023

Fija la prioridad del trabajo especificado.

Sintaxis

bitsadmin /setpriority <job> <priority>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

priority Establece la prioridad del trabajo, donde se incluyen:


FOREGROUND
HIGH
NORMAL
LOW

Ejemplos
Para establecer la prioridad del trabajo denominado myDownloadJob en normal:

bitsadmin /setpriority myDownloadJob NORMAL

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setproxysettings
Artículo • 12/04/2023

Establece la configuración de proxy para el trabajo especificado.

Sintaxis

bitsadmin /setproxysettings <job> <usage> [list] [bypass]

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

usage Establece el uso del proxy, como:


PRECONFIG. Use los valores predeterminados de Internet Explorer del
propietario.
NO_PROXY. No use un servidor proxy.
OVERRIDE. Use una lista de proxy explícita y una lista de omisión. A
continuación, debe haber la lista de proxy y la información de omisión de
proxy.
AUTODETECT. Detecta automáticamente la configuración de proxy.

list Se usa cuando el parámetro Usage se establece en OVERRIDE. Debe contener una
lista delimitada por comas de servidores proxy que se van a usar.

omitir Se usa cuando el parámetro Usage se establece en OVERRIDE. Debe contener una
lista delimitada por espacios de nombres de host o direcciones IP, o ambas, para las
que las transferencias no se enrutarán a través de un proxy. Puede tratarse de
<local> para hacer referencia a todos los servidores de la misma LAN. Se pueden
usar valores de NULL para una lista de omisión de proxy vacía.

Ejemplos
Para establecer la configuración de proxy mediante las distintas opciones de uso del
trabajo denominado myDownloadJob:
bitsadmin /setproxysettings myDownloadJob PRECONFIG

bitsadmin /setproxysettings myDownloadJob NO_PROXY

bitsadmin /setproxysettings myDownloadJob OVERRIDE proxy1:80

bitsadmin /setproxysettings myDownloadJob OVERRIDE proxy1,proxy2,proxy3 NULL

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setreplyfilename
Artículo • 12/04/2023

Especifica la ruta de acceso del archivo que contiene la respuesta de carga del servidor.

7 Nota

Este comando no es compatible con BITS 1.2 ni versiones anteriores.

Sintaxis

bitsadmin /setreplyfilename <job> <file_path>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

file_path Ubicación para colocar la respuesta de carga del servidor.

Ejemplos
Para establecer la ruta de acceso del archivo de nombre de archivo de respuesta de
carga para el trabajo denominado myDownloadJob:

bitsadmin /setreplyfilename myDownloadJob c:\upload-reply

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setsecurityflags
Artículo • 12/04/2023

Establece las marcas de seguridad para HTTP para determinar si BITS debe comprobar la
lista de revocación de certificados, omitir ciertos errores de certificado y definir la
directiva que se usará cuando un servidor redirige la solicitud HTTP. El valor es un
entero sin signo.

Sintaxis

bitsadmin /setsecurityflags <job> <value>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

value Puede incluir una o varias de las siguientes marcas de notificación, entre las que se
incluyen:
Establezca el bit menos significativo para habilitar la comprobación de CRL.
Establezca el segundo bit de la derecha para omitir nombres comunes
incorrectos en el certificado de servidor.
Establezca el tercer bit de la derecha para omitir fechas incorrectas en el
certificado de servidor.
Establezca el cuarto bit de la derecha para omitir entidades de certificación
incorrectas en el certificado de servidor.
Establezca el quinto bit de la derecha para omitir uso incorrecto en el
certificado de servidor.
Establezca del noveno al onceavo bit de la derecha para implementar la
directiva de redirección especificada, que incluye:
0,0,0. Los redireccionamientos se permiten automáticamente.
0,0,1. El nombre remoto de la interfaz IBackgroundCopyFile se actualiza si
se produce una redirección.
0,1,0. BITS produce un error en el trabajo si se produce una redirección.
Establezca el doceavo bit de la derecha para permitir el redireccionamiento de
HTTPS a HTTP.

Ejemplos
Para establecer las marcas de seguridad para habilitar una comprobación CRL del
trabajo denominado myDownloadJob:

bitsadmin /setsecurityflags myDownloadJob 0x0001

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin setvalidationstate
Artículo • 14/04/2023

Establece el estado de validación de contenido del archivo especificado dentro del


trabajo.

Sintaxis

bitsadmin /setvalidationstate <job> <file_index> <TRUE|FALSE>

Parámetros

Parámetro Descripción

Trabajo El nombre para mostrar o GUID del trabajo.

file_index Comienza en 0.

TRUE o TRUE activa la validación de contenido para el archivo especificado, mientras que
FALSE FALSE la desactiva.

Ejemplos
Para establecer el estado de validación de contenido del archivo 2 en TRUE para el
trabajo denominado myDownloadJob:

bitsadmin /setvalidationstate myDownloadJob 2 TRUE

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin suspend
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Suspende el trabajo especificado. Si suspendió el trabajo por error, puede usar el


conmutador bitsadmin resume para reiniciar el trabajo.

Sintaxis

bitsadmin /suspend <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplo
Para suspender el trabajo denominado myDownloadJob:

bitsadmin /suspend myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

comando bitsadmin resume

Comando bitsadmin
bitsadmin takeownership
Artículo • 14/04/2023

Permite que un usuario con privilegios administrativos tome posesión del trabajo
especificado.

Sintaxis

bitsadmin /takeownership <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para tomar posesión del trabajo denominado myDownloadJob:

bitsadmin /takeownership myDownloadJob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin transfer
Artículo • 14/04/2023

Transfiere uno o varios archivos. De forma predeterminada, el servicio BITSAdmin crea


un trabajo de descarga que se ejecuta con prioridad NORMAL y actualiza la ventana de
comandos con información de progreso hasta que se completa la transferencia o hasta
que se produce un error crítico.

El servicio completa el trabajo si transfiere correctamente todos los archivos y cancela el


trabajo si se produce un error crítico. El servicio no crea el trabajo si no puede le agregar
archivos o si especifica un valor no válido para type o job_priority. Para transferir más de
un archivo, especifique varios pares <RemoteFileName>-<LocalFileName> . Los pares deben
estar delimitados por espacios.

7 Nota

El comando BITSAdmin continúa ejecutándose si se produce un error transitorio.


Para finalizar el comando, presione CTRL+C.

Sintaxis

bitsadmin /transfer <name> [<type>] [/priority <job_priority>] [/ACLflags


<flags>] [/DYNAMIC] <remotefilename> <localfilename>

Parámetros

Parámetro Descripción

name Nombre del trabajo. Este comando no puede ser un GUID.

tipo Opcional. Establece el tipo de trabajo, entre los que se incluyen:


/DOWNLOAD. Valor predeterminado. Elija este tipo para los trabajos de
descarga.
/UPLOAD. Elija este tipo para cargar trabajos.
Parámetro Descripción

priority Opcional. Establece la prioridad del trabajo, donde se incluyen:


FOREGROUND
HIGH
NORMAL
LOW

ACLflags Opcional. Indica que desea mantener la información del propietario y la ACL
con el archivo que se está descargando. Especifique uno o varios de los valores,
entre los que se incluyen:
o: copiar la información del propietario con el archivo.
g: copiar la información del grupo con el archivo.
d: copiar la información de la lista de control de acceso discrecional
(DACL) con el archivo.
s: copiar la información de la lista de control de acceso del sistema
(SACL) con el archivo.

/DYNAMIC Configura el trabajo mediante BITS_JOB_PROPERTY_DYNAMIC_CONTENT, lo


que relaja los requisitos del lado del servidor.

remotefilename Nombre del archivo después de transferirlo al servidor.

localfilename Nombre del archivo que reside localmente.

Ejemplos
Para iniciar un trabajo de transferencia denominado myDownloadJob:

bitsadmin /transfer myDownloadJob http://prodserver/audio.wma


c:\downloads\audio.wma

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin
bitsadmin util
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Enumera los modificadores /util.

Enumera los modificadores util.

Sintaxis

bitsadmin /util /help


bitsadmin /util /getieproxy
bitsadmin /util /repairservice
bitsadmin /util /setieproxy
bitsadmin /util /version

Parámetros

Parámetro Descripción

bitsadmin util y Muestra el uso de la línea de comandos para los modificadores /Util.
help También puede especificar /?.

bitsadmin util y Recupera el uso del proxy para la cuenta de servicio especificada.
getieproxy

bitsadmin util y Repara problemas conocidos con el servicio BITS.


repairservice

bitsadmin util y Especifica la configuración de proxy que se va a usar al transferir archivos


setieproxy mediante una cuenta de servicio.

bitsadmin util y Muestra la versión del servicio BITS.


version

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando bitsadmin
bitsadmin util y enableanalyticchannel
Artículo • 12/04/2023

Habilita o deshabilita el canal analítico de cliente BITS.

Syntax

bitsadmin /util /enableanalyticchannel TRUE|FALSE

Parámetro Descripción

TRUE o TRUE activa la validación de contenido para el archivo especificado, mientras que
FALSE FALSE la desactiva.

Ejemplos
Para activar o desactivar el canal analítico de cliente de BITS.

bitsadmin /util / enableanalyticchannel TRUE

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin util

Comando bitsadmin
bitsadmin util y getieproxy
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Recupera el uso del proxy para la cuenta de servicio especificada. Este comando
muestra el valor de cada uso de proxy, no solo el uso de proxy que especificó para la
cuenta de servicio. Para más información sobre cómo establecer el uso del proxy para
cuentas de servicio específicas, consulte el comando bitsadmin util and setieproxy.

Sintaxis

bitsadmin /util /getieproxy <account> [/conn <connectionname>]

Parámetros

Parámetro Descripción

account Especifica la cuenta de servicio cuya configuración de proxy desea recuperar.


Los valores posibles son:
LOCALSYSTEM
NETWORKSERVICE
LOCALSERVICE.

connectionname Opcional. Se usa con el parámetro /conn para especificar qué conexión de
módem se va a usar. Si no especifica el parámetro /conn, BITS usa la conexión
LAN.

Ejemplos
Para mostrar el uso del proxy para la cuenta de NETWORK SERVICE:

bitsadmin /util /getieproxy NETWORKSERVICE


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin util

Comando bitsadmin
bitsadmin util y help
Artículo • 12/04/2023

Se aplica a: Windows Server (todas las versiones compatibles)

Muestra ayuda para el conmutador de comandos bitsadmin util cuando se combina


con el conmutador help.

Sintaxis

bitsadmin /util /help

Ejemplos
Exponga la ayuda de la línea de comandos de los conmutadores /util, mediante la
ejecución del siguiente comando.

CLI

bitsadmin /util /help

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin util

Comando bitsadmin
bitsadmin util y repairservice
Artículo • 12/04/2023

Si BITS no se inicia, este conmutador intenta resolver errores relacionados con la


configuración de servicio incorrecta y las dependencias de los servicios de Windows
(como LANManworkstation) y el directorio de red. Este conmutador también genera una
salida que indica si se han resuelto los problemas.

7 Nota

Este comando no es compatible con BITS 1.5 ni versiones anteriores.

Sintaxis

bitsadmin /util /repairservice [/force]

Parámetros

Parámetro Descripción

/force Opcional. Elimina y vuelve a crear el servicio.

7 Nota

Si BITS vuelve a crear el servicio, la cadena de descripción del servicio podría


establecerse en inglés incluso en un sistema localizado.

Ejemplos
Para reparar la configuración del servicio BITS:

bitsadmin /util /repairservice


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin util

Comando bitsadmin
bitsadmin util y setieproxy
Artículo • 12/04/2023

Especifique la configuración de proxy que se va a usar al transferir archivos mediante


una cuenta de servicio. Debe ejecutar este comando desde un símbolo del sistema con
privilegios elevados para que se complete correctamente.

7 Nota

Este comando no es compatible con BITS 1.5 ni versiones anteriores.

Sintaxis

bitsadmin /util /setieproxy <account> <usage> [/conn <connectionname>]

Parámetros

Parámetro Descripción

account Especifica la cuenta de servicio cuya configuración de proxy desea definir. Los
valores posibles son:
LOCALSYSTEM
NETWORKSERVICE
LOCALSERVICE.
Parámetro Descripción

usage Especifica la forma de detección de proxy que se va a usar. Los valores


posibles son:
NO_PROXY. No use un servidor proxy.
AUTODETECT. Detecte automáticamente la configuración del proxy.
MANUAL_PROXY. Use una lista de proxy y una lista de omisión
especificadas. Debe especificar las listas inmediatamente después de la
etiqueta de uso. Por ejemplo: MANUAL_PROXY proxy1,proxy2 NULL .
Lista de proxy. Lista delimitada por comas de servidores proxy que se
van a usar.
Lista de omisión. Una lista delimitada por espacios de nombres de
host o direcciones IP, o ambas, para las que las transferencias no se
enrutarán a través de un proxy. Puede ser <local> para hacer
referencia a todos los servidores de la misma LAN. Se pueden usar
valores de NULL para una lista de omisión de proxy vacía.
AUTOSCRIPT. Igual que AUTODETECT, excepto que también ejecuta un
script. Debe especificar la dirección URL del script inmediatamente
después de la etiqueta de uso. Por ejemplo: AUTOSCRIPT
http://server/proxy.js .
RESET. Igual que NO_PROXY, salvo que quita las direcciones URL de
proxy manuales (si se especifica) y las direcciones URL detectadas
mediante la detección automática.

connectionname Opcional. Se usa con el parámetro /conn para especificar qué conexión de
módem se va a usar. Si no especifica el parámetro /conn, BITS usa la conexión
LAN.

Comentarios
Cada llamada sucesiva con este conmutador reemplaza el uso especificado
anteriormente, pero no los parámetros del uso definido anteriormente. Por ejemplo, si
especifica NO_PROXY, AUTODETECT y MANUAL_PROXY en llamadas independientes,
BITS usa el último uso proporcionado, pero mantiene los parámetros del uso definido
anteriormente.

Ejemplos
Para establecer el uso del proxy para la cuenta LOCALSYSTEM:

bitsadmin /util /setieproxy localsystem AUTODETECT


bitsadmin /util /setieproxy localsystem MANUAL_PROXY proxy1,proxy2,proxy3
NULL

bitsadmin /util /setieproxy localsystem MANUAL_PROXY proxy1:80

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin util

Comando bitsadmin
bitsadmin util y version
Artículo • 14/04/2023

Muestra la versión del servicio BITS (por ejemplo, 2.0).

7 Nota

Este comando no es compatible con BITS 1.5 ni versiones anteriores.

Sintaxis

bitsadmin /util /version [/verbose]

Parámetros

Parámetro Descripción

/verbose Use este modificador para mostrar la versión del archivo para cada DLL relacionado
con BITS y para comprobar si el servicio BITS puede iniciarse.

Ejemplos
Para mostrar la versión del servicio BITS.

bitsadmin /util /version

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bitsadmin util

Comando bitsadmin
bitsadmin wrap
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Ajusta cualquier línea de texto de salida que se extiende más allá del borde derecho de
la ventana de comandos a la siguiente línea. Debe especificar este conmutador antes de
cualquier otro conmutador.

De forma predeterminada, todos los conmutadores excepto el conmutador de monitor


bitsadmin, encapsulan el texto de salida.

Sintaxis

bitsadmin /wrap <job>

Parámetros

Parámetro Descripción

trabajo El nombre para mostrar o GUID del trabajo.

Ejemplos
Para recuperar información del trabajo denominado myDownloadJob y encapsular el
texto de salida:

bitsadmin /wrap /info myDownloadJob /verbose

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando bitsadmin
bootcfg
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Configura, consulta o cambia la configuración del archivo Boot.ini.

Sintaxis

bootcfg <parameter> [arguments...]

Parámetros

Parámetro Descripción

bootcfg Agrega opciones de carga del sistema operativo para una entrada de sistema
addsw operativo especificada.

bootcfg Realiza una copia de una entrada de arranque existente a la que puede agregar
copy opciones de línea de comandos.

bootcfg Configura la depuración del puerto 1394 para una entrada de sistema operativo
dbg1394 especificada.

bootcfg Agrega o cambia la configuración de depuración de una entrada de sistema


debug operativo especificada.

bootcfg Especifica la entrada del sistema operativo que se designa como valor
default predeterminado.

bootcfg Elimina una entrada del sistema operativo en la sección [sistemas operativos] del
delete archivo Boot.ini.

bootcfg Permite al usuario agregar o cambiar la configuración de redireccionamiento de la


ems consola de Servicios de administración de emergencia a un equipo remoto.

bootcfg Consulta y muestra las entradas de la sección del [cargador de arranque] y [sistemas
query operativos] del Boot.ini.
Parámetro Descripción

bootcfg Agrega opciones de carga del sistema operativo especificadas como una cadena a
raw una entrada del sistema operativo en la sección [sistemas operativos] del archivo
Boot.ini.

bootcfg Quita opciones de carga del sistema operativo para una entrada de sistema
rmsw operativo especificada.

bootcfg Cambia el valor de tiempo de espera del sistema operativo.


timeout
bootcfg addsw
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Agrega opciones de carga del sistema operativo para una entrada de sistema operativo
especificada.

Sintaxis

bootcfg /addsw [/s <computer> [/u <domain>\<user> /p <password>]] [/mm


<maximumram>] [/bv] [/so] [/ng] /id <osentrylinenum>

Parámetros

Término Definición

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (no use barras


diagonales inversas). La opción predeterminada es el equipo local.

/u <domain>\ Ejecuta el comando con los permisos de cuenta del usuario especificado por
<user> <user> o <domain>\<user> . El valor predeterminado son los permisos del
usuario que ha iniciado sesión actualmente en el equipo que emite el
comando.

/p <password> Especifica la contraseña de la cuenta de usuario especificada en el parámetro


/u.

/mm Especifica la cantidad máxima de RAM, en megabytes, que el sistema


<maximumram> operativo puede usar. El valor debe ser igual o mayor a 32 megabytes.

/bv Agrega la opción /basevideo al <osentrylinenum> especificado, e indica al


sistema operativo que use el modo VGA estándar para el controlador de
vídeo instalado.

/so Agrega la opción /sos al <osentrylinenum> especificado, que dirige el sistema


operativo para mostrar los nombres de controladores de dispositivo mientras
se cargan.
Término Definición

/ng Agrega la opción /noguiboot al <osentrylinenum> especificado,


deshabilitando la barra de progreso que aparece antes del inicio de sesión
CTRL+ALT+DEL.

/id Especifica el número de línea de entrada de sistema operativo en la sección


<osentrylinenum> [sistemas operativos] del archivo Boot.ini al que se agregan las opciones de
carga de sistema operativo. La primera línea después del encabezado de
sección [sistemas operativos] es 1.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para usar el 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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bootcfg
bootcfg copy
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Realiza una copia de una entrada de arranque existente a la que puede agregar
opciones de línea de comandos.

Sintaxis

bootcfg /copy [/s <computer> [/u <domain>\<user> /p <password>]] [/d


<description>] [/id <osentrylinenum>]

Parámetros

Parámetro Descripción

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (no use barras


diagonales inversas). La opción predeterminada es el equipo local.

/u <domain>\ Ejecuta el comando con los permisos de cuenta del usuario especificado por
<user> <user> o <domain>\<user> . El valor predeterminado son los permisos del
usuario que ha iniciado sesión actualmente en el equipo que emite el
comando.

/p <password> Especifica la contraseña de la cuenta de usuario especificada en el parámetro


/u.

/d Especifica la descripción de la nueva entrada del sistema operativo.


<description>

/id Especifica el número de línea de entrada del sistema operativo en la sección


<osentrylinenum> [sistemas operativos] del archivo Boot.ini al que se agregan las opciones de
carga del sistema operativo. La primera línea después del encabezado de
sección [sistemas operativos] es 1.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para copiar la entrada de arranque 1 y escribir \ABC Server\ como descripción:

bootcfg /copy /d \ABC Server\ /id 1

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bootcfg
bootcfg dbg1394
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Configura la depuración del puerto 1394 para una entrada de sistema operativo
especificada.

Sintaxis

bootcfg /dbg1394 {on | off}[/s <computer> [/u <domain>\<user> /p


<password>]] [/ch <channel>] /id <osentrylinenum>

Parámetros

Parámetro Descripción

{on | off} Especifica el valor para la depuración de puertos 1394, entre los que se
incluyen:
. Habilita la compatibilidad con la depuración remota agregando la
opción /dbg1394 al <osentrylinenum> especificado.
off. Deshabilita la compatibilidad con la depuración remota quitando la
opción /dbg1394 del <osentrylinenum> especificado.

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (no use barras


diagonales inversas). La opción predeterminada es el equipo local.

/u <domain>\ Ejecuta el comando con los permisos de cuenta del usuario especificado por
<user> <user> o <domain>\<user> . El valor predeterminado son los permisos del
usuario que ha iniciado sesión actualmente en el equipo que emite el
comando.

/p <password> Especifica la contraseña de la cuenta de usuario especificada en el parámetro


/u.

/ch <channel> Especifica el canal que se va a usar para la depuración. Los valores válidos son
enteros entre 1 y 64. No use este parámetro si la depuración de puertos 1394
está deshabilitada.
Parámetro Descripción

/id Especifica el número de línea de entrada del sistema operativo en la sección


<osentrylinenum> [sistemas operativos] del archivo Boot.ini al que se agregan las opciones de
carga de sistema operativo. La primera línea después del encabezado de
sección [sistemas operativos] es 1.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para usar el 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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bootcfg
bootcfg debug
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Agrega o cambia la configuración de depuración de una entrada de sistema operativo


especificada.

7 Nota

Si intenta depurar el puerto 1394, use el comando bootcfg dbg1394 en su lugar.

Sintaxis

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 Descripción

{on | off | Especifica el valor para la depuración de puertos, lo que incluye:


edit} . Habilita la compatibilidad con la depuración remota al agregar la
opción /debug al <osentrylinenum> especificado.
off. Deshabilita la compatibilidad con la depuración remota al quitar la
opción /debug del <osentrylinenum> especificado.
edit. Permite cambios en la configuración del puerto y la velocidad en
baudios al cambiar los valores asociados con la opción /debug
velocidad de puerto y baudios cambiando los valores asociados a la
opción /debug para el <osentrylinenum> especificado.

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (no use barras


diagonales inversas). La opción predeterminada es el equipo local.
Parámetro Descripción

/u <domain>\ Ejecuta el comando con los permisos de cuenta del usuario que especifica
<user> <user> o <domain>\<user> . El valor predeterminado son los permisos del
usuario que ha iniciado sesión actualmente en el equipo que emite el
comando.

/p <password> Especifica la contraseña de la cuenta de usuario especificada en el parámetro


/u.

/port {COM1 | Especifica el puerto COM que se va a usar para la depuración. No use este
COM2 | COM3 | parámetro si la depuración de puertos está deshabilitada.
COM4}

/baud {9600 | Especifica la velocidad en baudios que se va a usar para la depuración. No use
19200 | 38400 | este parámetro si la depuración de puertos está deshabilitada.
57600 | 115200}

/id Especifica el número de línea de entrada del sistema operativo en la sección


<osentrylinenum> [sistemas operativos] del archivo Boot.ini al que se agregan las opciones de
carga del sistema operativo. La primera línea después del encabezado de
sección [sistemas operativos] es 1.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para usar el 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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bootcfg
bootcfg default
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Especifica la entrada del sistema operativo que se va a designar como predeterminada.

Sintaxis

bootcfg /default [/s <computer> [/u <domain>\<user> /p <password>]] [/id


<osentrylinenum>]

Parámetros

Parámetro Descripción

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (no use barras


diagonales inversas). La opción predeterminada es el equipo local.

/u <domain>\ Ejecuta el comando con los permisos de cuenta del usuario especificado por
<user> <user> o <domain>\<user> . El valor predeterminado son los permisos del
usuario que ha iniciado sesión actualmente en el equipo que emite el
comando.

/p <password> Especifica la contraseña de la cuenta de usuario especificada en el parámetro


/u.

/id Especifica el número de línea de entrada del sistema operativo en la sección


<osentrylinenum> [sistemas operativos] del archivo Boot.ini al que se agregan las opciones de
carga del sistema operativo. La primera línea después del encabezado de
sección [sistemas operativos] es 1.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para usar el comando bootcfg /default:
bootcfg /default /id 2
bootcfg /default /s srvmain /u maindom\hiropln /p p@ssW23 /id 2

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bootcfg
bootcfg delete
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Elimina una entrada de sistema operativo en la sección [sistemas operativos] del archivo
Boot.ini.

Sintaxis

bootcfg /delete [/s <computer> [/u <domain>\<user> /p <password>]] [/id


<osentrylinenum>]

Parámetros

Parámetro Descripción

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (no use barras


diagonales inversas). La opción predeterminada es el equipo local.

/u <domain>\ Ejecuta el comando con los permisos de cuenta del usuario especificado por
<user> <user> o <domain>\<user> . El valor predeterminado son los permisos del
usuario que ha iniciado sesión actualmente en el equipo que emite el
comando.

/p <password> Especifica la contraseña de la cuenta de usuario especificada en el parámetro


/u.

/id Especifica el número de línea de entrada del sistema operativo en la sección


<osentrylinenum> [sistemas operativos] del archivo Boot.ini al que se agregan las opciones de
carga del sistema operativo. La primera línea después del encabezado de
sección [sistemas operativos] es 1.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para usar el comando bootcfg /delete:
bootcfg /delete /id 1
bootcfg /delete /s srvmain /u maindom\hiropln /p p@ssW23 /id 3

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bootcfg
bootcfg ems
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Permite al usuario agregar o cambiar la configuración de redireccionamiento de la


consola de Servicios de administración de emergencia a un equipo remoto. Al habilitar
los Servicios de administración de emergencias, se agrega una línea de redirect=Port#
a la sección [cargador de arranque] del archivo Boot.ini junto con una opción /redirect a
la línea de entrada del sistema operativo especificada. La característica Servicios de
administración de emergencia solo está habilitada en los servidores.

Sintaxis

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 Descripción

{on | off | Especifica el valor de redirección de Servicios de administración de


edit} emergencia, entre los que se incluyen:
. Habilita la salida remota para el <osentrylinenum> especificado.
También agrega una opción /redirect al <osentrylinenum> especificado
y una configuración de redirect=com<X> a la sección [cargador de
arranque]. El valor de com<X> se establece mediante el parámetro /port.
off. Deshabilita la salida en un equipo remoto. También quita la opción
/redirect al <osentrylinenum> especificado y la configuración
redirect=com<X> de la sección [cargador de arranque].
edit. Permite cambios en la configuración del puerto cambiando la
configuración redirect=com<X> de la sección [cargador de arranque]. El
valor de com<X> se establece mediante el parámetro /port.

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (no use barras


diagonales inversas). La opción predeterminada es el equipo local.
Parámetro Descripción

/u <domain>\ Ejecuta el comando con los permisos de cuenta del usuario especificado por
<user> <user> o <domain>\<user> . El valor predeterminado son los permisos del
usuario que ha iniciado sesión actualmente en el equipo que emite el
comando.

/p <password> Especifica la contraseña de la cuenta de usuario especificada en el parámetro


/u.

/port {COM1 | Especifica el puerto COM que se va a usar para el redireccionamiento. El


COM2 | COM3 | parámetro BIOSSET indica a los Servicios de administración de emergencia
COM4 | BIOSSET} que deben obtener la configuración del BIOS para determinar qué puerto se
debe usar para el redireccionamiento. No use este parámetro si la salida
administrada remotamente está deshabilitada.

/baud {9600 | Especifica la velocidad en baudios que se va a usar para el


19200 | 38400 | redireccionamiento. No use este parámetro si la salida administrada
57600 | 115200} remotamente está deshabilitada.

/id Especifica el número de línea de entrada del sistema operativo al que se


<osentrylinenum> agrega la opción Servicios de administración de emergencia en la sección
[sistemas operativos] del archivo Boot.ini. La primera línea después del
encabezado de sección [sistemas operativos] es 1. Este parámetro es
necesario cuando el valor de Servicios de administración de emergencias se
establece en on u off.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para usar el 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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bootcfg
bootcfg query
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Consulta y muestra las entradas de la sección del [cargador de arranque] y [sistemas


operativos] del Boot.ini.

Sintaxis

bootcfg /query [/s <computer> [/u <domain>\<user> /p <password>]]

Parámetros

Parámetro Descripción

/s Especifica el nombre o la dirección IP de un equipo remoto (no use barras


<computer> diagonales inversas). La opción predeterminada es el equipo local.

/u <domain>\ Ejecuta el comando con los permisos de cuenta del usuario especificado por
<user> <user> o <domain>\<user> . El valor predeterminado son los permisos del usuario
que ha iniciado sesión actualmente en el equipo que emite el comando.

/p Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u.


<password>

/? Muestra la ayuda en el símbolo del sistema.

Salida de ejemplo
Salida de ejemplo del 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:

El área Configuración del cargador de arranque muestra cada entrada de la


sección [cargador de arranque] del Boot.ini.

El área Entradas de arranque muestra más detalles sobre cada entrada del sistema
operativo en la sección [sistemas operativos] del Boot.ini

Ejemplos
Para usar el comando bootcfg/query:

bootcfg /query
bootcfg /query /s srvmain /u maindom\hiropln /p p@ssW23
bootcfg /query /u hiropln /p p@ssW23

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bootcfg
bootcfg raw
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Agrega opciones de carga de sistema operativo especificadas como una cadena a una
entrada de sistema operativo en la sección [sistemas operativos] del archivo Boot.ini.
Este comando sobrescribe las opciones de entrada de sistema operativo existentes.

Sintaxis

bootcfg /raw [/s <computer> [/u <domain>\<user> /p <password>]]


<osloadoptionsstring> [/id <osentrylinenum>] [/a]

Parámetros

Parámetro Descripción

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (no use


barras diagonales inversas). La opción predeterminada es el equipo
local.

/u <domain>\<user> Ejecuta el comando con los permisos de cuenta del usuario especificado
por <user> o <domain>\<user> . El valor predeterminado son los
permisos del usuario que ha iniciado sesión actualmente en el equipo
que emite el comando.

/p <password> Especifica la contraseña de la cuenta de usuario especificada en el


parámetro /u.

<osloadoptionsstring> Especifica las opciones de carga de sistema operativo que se van a


agregar a la entrada de sistema operativo. Estas opciones de carga
reemplazan las opciones de carga existentes asociadas a la entrada de
sistema operativo. No hay ninguna validación con el parámetro
<osloadoptions> .

/id <osentrylinenum> Especifica el número de línea de entrada de sistema operativo en la


sección [sistemas operativos] del archivo Boot.ini al que se agregan las
opciones de carga de sistema operativo. La primera línea que aparece
después del encabezado de sección de [sistemas operativos] es 1.
Parámetro Descripción

/a Especifica qué opciones de sistema operativo se deben anexar a


cualquier opción de sistema operativo existente.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Este texto debe contener opciones de carga de sistema operativo válidas, como /debug,
/fastdetect, /nodebug, /baudrate, /crashdebug y /sos.

Para agregar /debug /fastdetect al final de la primera entrada de sistema operativo,


reemplazando las opciones anteriores de entrada de sistema operativo:

bootcfg /raw /debug /fastdetect /id 1

Para usar el comando bootcfg /raw:

bootcfg /raw /debug /sos /id 2


bootcfg /raw /s srvmain /u maindom\hiropln /p p@ssW23 /crashdebug /id 2

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bootcfg
bootcfg rmsw
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Quita opciones de carga del sistema operativo para una entrada de sistema operativo
especificada.

Sintaxis

bootcfg /rmsw [/s <computer> [/u <domain>\<user> /p <password>]] [/mm] [/bv]


[/so] [/ng] /id <osentrylinenum>

Parámetros

Parámetro Descripción

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (no use barras


diagonales inversas). La opción predeterminada es el equipo local.

/u <domain>\ Ejecuta el comando con los permisos de cuenta del usuario especificado por
<user> <user> o <domain>\<user> . El valor predeterminado son los permisos del
usuario que ha iniciado sesión actualmente en el equipo que emite el
comando.

/p <password> Especifica la contraseña de la cuenta de usuario especificada en el parámetro


/u.

/mm Quita la opción /maxmem y su valor máximo de memoria asociado del


<osentrylinenum> especificado. La opción /maxmem especifica la cantidad
máxima de RAM que puede usar el sistema operativo.

/bv Quita la opción /basevideo del <osentrylinenum> especificado. La opción


/basevideo indica al sistema operativo que debe usar el modo VGA estándar
para el controlador de vídeo instalado.

/so Quita la opción /sos del <osentrylinenum> especificado. La opción /sos indica
al sistema operativo que muestre los nombres de controladores de
dispositivo mientras se cargan.
Parámetro Descripción

/ng Quita la opción /noguiboot del <osentrylinenum> especificado. La opción


/noguiboot deshabilita la barra de progreso que aparece antes del mensaje
de inicio de sesión CTRL+ALT+SUPR.

/id Especifica el número de línea de entrada del sistema operativo en la sección


<osentrylinenum> [sistemas operativos] del archivo Boot.ini al que se agregan las opciones de
carga del sistema operativo. La primera línea después del encabezado de
sección [sistemas operativos] es 1.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para usar el 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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bootcfg
bootcfg timeout
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el valor de tiempo de espera del sistema operativo.

Sintaxis

bootcfg /timeout <timeoutvalue> [/s <computer> [/u <domain>\<user> /p


<password>]]

Parámetros

Parámetro Descripción

/timeout Especifica el valor de tiempo de espera en la sección [cargador de arranque].


<timeoutvalue> <timeoutvalue> es el número de segundos que tiene el usuario para seleccionar
un sistema operativo en la pantalla del cargador de arranque antes de que
NTLDR cargue el valor predeterminado. El intervalo válido para <timeoutvalue>
es 0-999. Si el valor es 0, NTLDR inicia inmediatamente el sistema operativo
predeterminado sin mostrar la pantalla del cargador de arranque.

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (no use barras


diagonales inversas). La opción predeterminada es el equipo local.

/u <domain>\ Ejecuta el comando con los permisos de cuenta del usuario especificado por
<user> <user> o <domain>\<user> . El valor predeterminado son los permisos del
usuario que ha iniciado sesión actualmente en el equipo que emite el comando.

/p <password> Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para usar el comando bootcfg /timeout:
bootcfg /timeout 30
bootcfg /s srvmain /u maindom\hiropln /p p@ssW23 /timeout 50

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando bootcfg
break
Artículo • 12/04/2023

) Importante

Este comando ya no está en uso. Sólo está incluido para conservar la


compatibilidad con archivos de MS-DOS existentes, pero no tiene ningún efecto en
la línea de comandos debido a que la funcionalidad es automática.

Establece o borra la comprobación de CTRL+C extendida en sistemas MS-DOS. Si se usa


sin parámetros, break muestra el valor de configuración existente.

Si las extensiones de comandos están habilitadas y se ejecutan en la plataforma


Windows, al insertar el comando break en un archivo por lotes, se escribe un punto de
interrupción codificado de forma rígida si un depurador lo depura.

Sintaxis

break=[on|off]

7 Nota

Dado que el comando break no tiene ningún efecto, a menudo se usa para crear
archivos vacíos o eliminar el contenido de un archivo existente. Por ejemplo:

rem -- cleans the content of the file --


break>log

Vínculos relacionados
Clave de sintaxis de línea de comandos

comando break
cacls
Artículo • 12/04/2023

) Importante

Este comando está en desuso. Use en su lugar icacls.

Muestra o cambia las listas de control de acceso discrecional (DACL) de los archivos
especificados.

Sintaxis

cacls <filename> [/t] [/m] [/l] [/s[:sddl]] [/e] [/c] [/g user:<perm>] [/r
user [...]] [/p user:<perm> [...]] [/d user [...]]

Parámetros

Parámetro Descripción

<filename> Necesario. Muestra las ACL de los archivos especificados.

/t Cambia las ACL de los archivos especificados en el directorio actual y en todos los
subdirectorios.

/m Cambia las ACL de los volúmenes montados en un directorio.

/l Funciona en el vínculo simbólico y no en el destino.

/s:sddl Reemplaza las ACL con las especificadas en la cadena SDDL. El uso de este
parámetro no es válido con los parámetros /e, /g, /r, /p o /d.

/e Edite una ACL en lugar de reemplazarla.

/C Continúe después de los errores de acceso denegado.


Parámetro Descripción

/g user: Concede derechos de acceso de usuario especificados, entre los que se incluyen
<perm> estos valores válidos para el permiso:
n: ninguno
r: lectura
w: escritura
c: cambio (escritura)
f: control total

/r usuario [...] Revoca los derechos de acceso del usuario especificado. Solo es válido al usarse
con el parámetro /e.

[/p user: Reemplace derechos de acceso de usuario especificados, entre los que se incluyen
<perm> [...] estos valores válidos para el permiso:
n: ninguno
r: lectura
w: escritura
c: cambio (escritura)
f: control total

[/d usuario Deniega el acceso de usuario especificado.


[...]

/? Muestra la ayuda en el símbolo del sistema.

Salida de ejemplo

Resultados La entrada de control de acceso (ACE) afecta a

OI Herencia de objeto. Esta carpeta y archivos.

CI Herencia de contenedor. Esta carpeta y subcarpetas.

IO Solo herencia. La ACE no afecta al archivo o directorio actual.

Sin mensaje de salida Solo esta carpeta.

(OI)(CI) Esta carpeta, subcarpetas y archivos.

(OI)(CI)(IO) Solo subcarpetas y archivos.

(CI)(IO) Solo subcarpetas.

(OI)(IO) Solo archivos.

Comentarios
Se pueden usar caracteres comodín (? y *) para especificar varios archivos.

Se puede especificar más de un usuario.

Vínculos relacionados
Clave de sintaxis de línea de comandos

icacls
llamada
Artículo • 14/04/2023

Llama a un programa por lotes desde otro sin detener el programa por lotes primario. El
comando call acepta etiquetas como destino de la llamada.

7 Nota

La llamada no tiene ningún efecto en el símbolo del sistema cuando se usa fuera
de un script o un archivo por lotes.

Sintaxis

call [drive:][path]<filename> [<batchparameters>]]


call [:<label> [<arguments>]]

Parámetros

Parámetro Descripción

[<drive>:] Especifica la ubicación y el nombre del programa por lotes al que desea
[<path>] llamar. El parámetro <filename> es obligatorio y debe tener una extensión
<filename> .bat o .cmd.

<batchparameters> Especifica cualquier información de la línea de comandos que el programa


por lotes requiere.

:<label> Especifica la etiqueta a la que desea que salte un control de programa por
lotes.

<arguments> Especifica la información de la línea de comandos que se va a pasar a la


instancia nueva del programa por lotes, empezando por :<label> .

/? Muestra la ayuda en el símbolo del sistema.

Parámetros por lotes


Las referencias de argumento de script por lotes (%0, %1, …) se enumeran en las tablas
siguientes.
El uso del valor %* en un script por lotes hace referencia a todos los argumentos (por
ejemplo, %1, %2, %3…).

Puede usar las sintaxis opcionales siguientes como sustituciones para los parámetros
por lotes (%n):

Parámetros Descripción
por lotes

%~1 Expande %1 y quita las comillas circundantes.

%~f1 Expande %1 a una ruta de acceso completa.

%~d1 Expande %1 a una letra de unidad solamente.

%~p1 Expande %1 a una ruta de acceso solamente.

%~n1 Expande %1 a un nombre de archivo solamente.

%~x1 Expande %1 a una extensión de nombre de archivo solamente.

%~s1 Expande %1 a una ruta de acceso completa que contiene nombres cortos
solamente.

%~a1 Expande %1 a los atributos de archivo.

%~t1 Expande %1 a la fecha y hora del archivo.

%~z1 Expande %1 al tamaño del archivo.

%~$PATH:1 Busca en los directorios enumerados en la variable de entorno PATH y expande %1


al nombre completo del primer directorio que encuentra. Si el nombre de la
variable de entorno no está definido o la búsqueda no encuentra el archivo, este
modificador se expande a la cadena vacía.

En la tabla siguiente, se muestra cómo puede combinar modificadores con los


parámetros por lotes para obtener resultados compuestos:

Parámetro por Descripción


lotes con
modificador

%~dp1 Expande %1 a una letra de unidad y una ruta de acceso solamente.

%~nx1 Expande %1 a una extensión y nombre de archivo solamente.

%~dp$PATH:1 Busca en los directorios que aparecen en la variable de entorno PATH para %1
y se expande a la letra de unidad y la ruta de acceso del primer directorio que
encuentra.
Parámetro por Descripción
lotes con
modificador

%~ftza1 Expande %1 para mostrar una salida similar al comando dir.

En los ejemplos anteriores, %1 y PATH se pueden reemplazar por otros valores válidos.
La sintaxis %~ finaliza con un número de argumento válido. Los modificadores %~ no
se pueden usar con %*.

Comentarios
Uso de parámetros por lotes:

Los parámetros por lotes pueden contener cualquier información que se puede
pasar a un programa por lotes, incluidas opciones de la línea de comandos,
nombres de archivos, los parámetros por lotes %0 a %9 y variables (por ejemplo,
%baud%).

Uso del parámetro <label> :

Mediante el uso de call con el parámetro <label> , se crea un contexto de archivo


por lotes y el control se pasa a la instrucción después de la etiqueta especificada.
La primera vez que se encuentra el final del archivo por lotes (es decir, después de
saltar a la etiqueta), el control vuelve a la instrucción después de la instrucción call.
La segunda vez que se encuentra el final del archivo por lotes, se sale del script por
lotes.

Uso de canalizaciones y símbolos de redireccionamiento:

No use canalizaciones (|) ni símbolos de redireccionamiento ( < o > ) con call.

Realización de una llamada recursiva

Puede crear un programa por lotes que se llame a sí mismo. Sin embargo, debe
proporcionar una condición de salida. De lo contrario, los programas por lotes
primarios y secundarios pueden repetirse en un bucle sin fin.

Uso de extensiones de comandos

Si las extensiones de comandos están habilitadas, call acepta <label> como


destino de la llamada. La sintaxis correcta es call :<label> <arguments> .
Ejemplos
Para ejecutar el programa checknew.bat desde otro programa por lotes, escriba el
comando siguiente en el programa por lotes primario:

call checknew

Si el programa por lotes primario acepta dos parámetros por lotes y desea que pase
esos parámetros a checknew.bat, escriba el comando siguiente en el programa por lotes
primario:

call checknew %1 %2

Vínculos relacionados
Clave de sintaxis de línea de comandos
cd
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra el nombre del directorio actual o cambia el directorio actual. Si se usa solo con
una letra de unidad (por ejemplo, cd C: ), cd muestra los nombres del directorio actual
en la unidad especificada. Si se usa sin parámetros, cd muestra la unidad y el directorio
actuales.

7 Nota

Este comando es el mismo que el comando chdir.

Sintaxis

cd [/d] [<drive>:][<path>]
cd [..]
chdir [/d] [<drive>:][<path>]
chdir [..]

Parámetros

Parámetro Descripción

/d Cambia la unidad actual, así como el directorio actual de una unidad.

<drive>: Especifica la unidad que se va a mostrar o cambiar (si es diferente de la unidad


actual).

<path> Especifica la ruta de acceso al directorio que quiere mostrar o cambiar.

[..] Especifica que desea cambiar a la carpeta primaria.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si las extensiones de comandos están habilitadas, se aplican las condiciones siguientes
al comando cd:

La cadena de directorio actual se convierte para usar el mismo caso que los
nombres del disco. Por ejemplo, cd c:\temp establecería el directorio actual en
C:\Temp si ese es el caso en el disco.

Los espacios no se tratan como delimitadores, por lo que <path> puede contener
espacios sin comillas envolventes. Por ejemplo:

cd username\programs\start menu

es igual que:

cd "username\programs\start menu"

Si las extensiones están deshabilitadas, se requieren las comillas.

Para deshabilitar las extensiones de comandos, escriba lo siguiente:

cmd /e:off

Ejemplos
Para volver al directorio raíz, la parte superior de la jerarquía de directorios de una
unidad:

cd\

Para cambiar el directorio predeterminado en una unidad diferente a la que está:

cd [<drive>:[<directory>]]
Para comprobar el cambio en el directorio, escriba lo siguiente:

cd [<drive>:]

Vínculos relacionados
Clave de sintaxis de línea de comandos

comando chdir
certreq
Artículo • 21/09/2023

El comando certreq se puede usar para solicitar certificados de una entidad de certificación (CA), recuperar una respuesta a
una solicitud anterior de una CA, crear una nueva solicitud a partir de un archivo .inf, aceptar e instalar una respuesta a una
solicitud, crear una solicitud de certificación cruzada o de subordinación completa a partir de una solicitud o un certificado de
CA existente e iniciar una solicitud de certificación cruzada o de subordinación completa.

) Importante

Es posible que las versiones anteriores del comando certreq no proporcionen todas las opciones descritas aquí. Para ver
las opciones admitidas en función de versiones específicas de certreq, ejecute la opción de ayuda de la línea de
comandos, certreq -v -? .

El comando certreq no admite la creación de una nueva solicitud de certificado basada en una plantilla de atestación de
claves cuando se encuentra en un entorno de CEP/CES.

2 Advertencia

El contenido de este tema se basa en la configuración predeterminada de Windows Server; por ejemplo, si se selecciona
la longitud de la clave en 2048, se selecciona el proveedor de almacenamiento de claves de software de Microsoft como
CSP y se usa el algoritmo hash seguro 1 (SHA1). Evalúe estas selecciones en función de los requisitos de la directiva de
seguridad de su empresa.

Sintaxis

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 Descripción

-submit Envía una solicitud a una entidad de certificación.

-retrieve <requestid> Recupera una respuesta a una solicitud anterior de una entidad de certificación.

-new Crea una nueva solicitud a partir de un archivo .inf.

-accept Acepta e instala una respuesta a una solicitud de certificado.

-policy Establece la directiva para una solicitud.

-sign Firma una solicitud de subordinación completa o certificación cruzada.

-enroll Se inscribe o renueva un certificado.

-? Muestra una lista de sintaxis, opciones y descripciones de certreq.

<parameter> -? Muestra ayuda para el parámetro especificado.

-v -? Muestra una lista detallada de la sintaxis, las opciones y las descripciones de certreq.
Ejemplos

certreq -submit
Para enviar una solicitud de certificado básica:

certreq –submit certrequest.req certnew.cer certnew.pfx

Comentarios
Este es el parámetro certreq.exe predeterminado. Si no se especifica ninguna opción en el símbolo de la línea de
comandos, certreq.exe intenta enviar una solicitud de certificado a una entidad de certificación. Debe especificar un
archivo de solicitud de certificado al usar la opción –submit. Si se omite este parámetro, aparece una ventana común
Abrir archivo, lo que le permite seleccionar el archivo de solicitud de certificado adecuado.

Para solicitar un certificado especificando el atributo SAN, consulte la sección Cómo usar la utilidad certreq.exe para crear
y enviar una solicitud de certificado del archivo de Microsoft Knowledge Base 931351 Cómo agregar un nombre
alternativo del firmante a un certificado LDAP seguro .

certreq -retrieve
Para recuperar el identificador de certificado 20 y para crear un archivo de certificado (.cer), denominado MyCertificate:

certreq -retrieve 20 MyCertificate.cer

Comentarios

Use certreq -retrieve requestid para recuperar el certificado después de que la entidad de certificación la haya emitido. El
requestid PKC puede ser un decimal o hexadecimal con prefijo 0x y puede ser un número de serie de certificado sin
prefijo 0x. También puede usarlo para recuperar cualquier certificado que haya sido emitido por la entidad de
certificación, incluidos los certificados revocados o expirados, sin tener en cuenta si la solicitud del certificado estaba
pendiente.

Si envía una solicitud a la entidad de certificación, el módulo de directivas de la entidad de certificación podría dejar la
solicitud en un estado pendiente y devolver el requestid al autor de la llamada certreq para su presentación. Finalmente,
el administrador de la entidad de certificación emite el certificado o deniega la solicitud.

certreq -new
Para crear una nueva solicitud:

[newrequest]
; At least one value must be set in this section
subject = CN=W2K8-BO-DC.contoso2.com

A continuación, se muestran algunas de las posibles secciones que se pueden agregar al archivo INF:

[newrequest]

Esta área del archivo INF es obligatoria para cualquier nueva plantilla de solicitud de certificado y debe incluir al menos un
parámetro con un valor.
Clave1 Descripción Valor2 Ejemplo

Asunto Hay varias Valores de cadena del nombre distintivo relativo Firmante = CN=computer1.contoso.com
aplicaciones que se Firmante=CN=John
basan en la Smith,CN=Users,DC=Contoso,DC=com
información del
firmante de un
certificado. Se
recomienda
especificar un valor
para esta clave. Si no
se establece aquí el
firmante, se
recomienda incluir
un nombre de
firmante como parte
de la extensión del
certificado del
nombre alternativo
del firmante.

Exportable Si se establece en true | false Exportable = TRUE . Las claves CNG


TRUE, la clave pueden distinguir entre esto y el texto sin
privada se puede formato exportable. Las claves CAPI1 no
exportar con el pueden.
certificado. Para
garantizar un alto
nivel de seguridad,
no deben exportarse
las claves privadas;
sin embargo, en
algunos casos,
podría ser necesario
si varios equipos o
usuarios deben
compartir la misma
clave privada.

ExportableEncrypted Especifica si se debe true | false ExportableEncrypted = true


establecer la clave
privada para que se Consejo: No todos los tamaños y
pueda exportar. algoritmos de clave pública funcionan con
todos los algoritmos hash. El CSP
especificado también debe admitir el
algoritmo hash especificado. Para ver la
lista de algoritmos hash admitidos, puede
ejecutar el comando: certutil -oid 1 |
findstr pwszCNGAlgid | findstr /v
CryptOIDInfo

HashAlgorithm Algoritmo hash que Sha256, sha384, sha512, sha1, md5, md4, md2 HashAlgorithm = sha1 . Para ver la lista de
se va a usar para esta algoritmos hash admitidos, use: certutil -
solicitud. oid 1 | findstr pwszCNGAlgid | findstr /v
CryptOIDInfo

KeyAlgorithm Algoritmo que usará RSA, DH, DSA, ECDH_P256, ECDH_P521, KeyAlgorithm = RSA
el proveedor de ECDSA_P256, ECDSA_P384, ECDSA_P521
servicios para
generar un par de
claves pública y
privada.

KeyContainer No se recomienda Valor de cadena aleatorio KeyContainer = {C347BD28-7F69-4090-AA16-


establecer este Consejo: Use comillas dobles alrededor de BC58CF4D749C}
parámetro para las cualquier valor de clave INF que tenga espacios
nuevas solicitudes en en blanco o caracteres especiales para evitar
las que se genera el posibles problemas de análisis de INF.
nuevo material de
clave. El sistema
Clave1 Descripción Valor2 Ejemplo

genera y mantiene
automáticamente el
contenedor de
claves.
Para las solicitudes
en las que se debe
usar el material de
clave existente, este
valor se puede
establecer en el
nombre del
contenedor de claves
de la clave existente.
Use el comando
certutil –key para
mostrar la lista de
contenedores de
claves disponibles
para el contexto de
la máquina. Use el
comando certutil –
key –user para el
contexto del usuario
actual.

KeyLength Define la longitud de Cualquier longitud de clave válida compatible KeyLength = 2048
la clave pública y con el proveedor de servicios criptográficos.
privada. La longitud
de la clave tiene un
impacto en el nivel
de seguridad del
certificado. Una
mayor longitud de
clave normalmente
proporciona un nivel
de seguridad más
alto; sin embargo,
algunas aplicaciones
pueden tener
limitaciones con
respecto a la
longitud de la clave.

KeySpec Determina si la clave AT_NONE, AT_SIGNATURE, AT_KEYEXCHANGE KeySpec = AT_KEYEXCHANGE


se puede usar para
firmas, para
Exchange (cifrado) o
para ambas.

KeyUsage Define para qué se CERT_DIGITAL_SIGNATURE_KEY_USAGE -- 80 KeyUsage =


debe usar la clave de (128) CERT_DIGITAL_SIGNATURE_KEY_USAGE |
certificado. CERT_NON_REPUDIATION_KEY_USAGE -- 40 CERT_KEY_ENCIPHERMENT_KEY_USAGE
(64)
CERT_KEY_ENCIPHERMENT_KEY_USAGE -- 20 Consejo: Si se escriben varios valores, se
(32)
usa una pleca (|) como símbolo separador.
Asegúrese de usar comillas dobles al usar
CERT_DATA_ENCIPHERMENT_KEY_USAGE -- 10
varios valores para evitar problemas de
(16)
análisis INF. Los valores que se muestran
CERT_KEY_AGREEMENT_KEY_USAGE -- 8
son valores hexadecimales (decimales)
CERT_KEY_CERT_SIGN_KEY_USAGE -- 4
para cada definición de bits. También se
CERT_OFFLINE_CRL_SIGN_KEY_USAGE -- 2
puede usar la sintaxis anterior: un único
CERT_CRL_SIGN_KEY_USAGE -- 2
valor hexadecimal con varios bits
CERT_ENCIPHER_ONLY_KEY_USAGE -- 1
establecidos, en lugar de la representación
CERT_DECIPHER_ONLY_KEY_USAGE -- 8000
simbólica. Por ejemplo, KeyUsage = 0xa0 .
(32768)
Clave1 Descripción Valor2 Ejemplo

KeyUsageProperty Recupera un valor NCRYPT_ALLOW_DECRYPT_FLAG -- 1 KeyUsageProperty =


que identifica el NCRYPT_ALLOW_SIGNING_FLAG -- 2 NCRYPT_ALLOW_DECRYPT_FLAG |
propósito específico NCRYPT_ALLOW_KEY_AGREEMENT_FLAG -- 4 NCRYPT_ALLOW_SIGNING_FLAG
para el que se puede NCRYPT_ALLOW_ALL_USAGES -- ffffff
usar una clave (16777215)
privada.

MachineKeySet Esta clave es true | false . El valor predeterminado es false. MachineKeySet = true
importante cuando
necesita crear
certificados que
pertenecen a la
máquina y no a un
usuario. El material
clave que se genera
se mantiene en el
contexto de
seguridad de la
entidad de seguridad
(cuenta de usuario o
equipo) que ha
creado la solicitud.
Cuando un
administrador crea
una solicitud de
certificado en
nombre de un
equipo, el material
de clave debe
crearse en el
contexto de
seguridad de la
máquina y no en el
contexto de
seguridad del
administrador. De lo
contrario, la máquina
no podrá acceder a
su clave privada, ya
que estaría en el
contexto de
seguridad del
administrador.

NotBefore Especifica una fecha Fecha o fecha y hora NotBefore = 7/24/2012 10:31 AM
o una fecha y hora
antes de la cual no Consejo: NotBefore y NotAfter son solo
se puede emitir la para R equestType=cert . El análisis de
solicitud. NotBefore fechas intenta distinguir la configuración
se puede usar con regional. Usar el nombre de los meses
ValidityPeriod y servirá para eliminar la ambigüedad y
ValidityPeriodUnits . debería funcionar en cada configuración
regional.

NotAfter Especifica una fecha Fecha o fecha y hora NotAfter = 9/23/2014 10:31 AM
o una fecha y hora
después de las Consejo: NotBefore y NotAfter son solo
cuales no se puede para RequestType=cert . El análisis de
emitir la solicitud. fechas intenta distinguir la configuración
NotAfter no se regional. Usar el nombre de los meses
puede usar con servirá para eliminar la ambigüedad y
ValidityPeriod o debería funcionar en cada configuración
ValidityPeriodUnits . regional.

PrivateKeyArchive La configuración true | false PrivateKeyArchive = true


PrivateKeyArchive
solo funciona si el
Clave1 Descripción Valor2 Ejemplo

RequestType
correspondiente está
establecido en CMC
porque solo el
formato de solicitud
de administración de
certificados a través
de CMS (CMC)
permite transferir de
forma segura la clave
privada del
solicitante a la CA
para el archivo de
claves.

EncryptionAlgorithm El algoritmo de Las opciones posibles varían en función de la EncryptionAlgorithm = 3des


cifrado que se va a versión del sistema operativo y el conjunto de
usar. proveedores criptográficos instalados. Para ver la
lista de algoritmos disponibles, ejecute el
comando: certutil -oid 2 | findstr
pwszCNGAlgid . El CSP especificado que se ha
usado también debe ser compatible con el
algoritmo de cifrado simétrico y la longitud
especificados.

EncryptionLength Longitud del Cualquier longitud permitida por el EncryptionLength = 128


algoritmo de cifrado EncryptionAlgorithm especificado.
que se va a usar.

ProviderName El nombre del Si no conoce el nombre de proveedor del CSP ProviderName = Microsoft RSA SChannel
proveedor es el que está usando, ejecute certutil –csplist Cryptographic Provider
nombre para mostrar desde una línea de comandos. El comando
del CSP. muestra los nombres de todos los CSP
disponibles en el sistema local

ProviderType El tipo de proveedor Si no conoce el tipo de proveedor del CSP que ProviderType = 1
se usa para está usando, ejecute certutil –csplist desde
seleccionar un símbolo del sistema. El comando muestra el
proveedores tipo de proveedor de todos los CSP disponibles
específicos en en el sistema local.
función de la
funcionalidad de
algoritmo específica,
como RSA Full.

RenewalCert Si necesita renovar Hash de certificado de cualquier certificado que RenewalCert =


un certificado que esté disponible en el equipo donde se crea la 4EDF274BD2919C6E9EC6A522F0F3B153E9B1582D
exista en el sistema solicitud de certificado. Si no conoce el hash de
donde se genera la certificado, use el complemento MMC de
solicitud de certificados y examine el certificado que se debe
certificado, debe renovar. Abra las propiedades del certificado y
especificar su hash vea el atributo Thumbprint del certificado. La
de certificado como renovación del certificado requiere un formato
el valor de esta clave. de solicitud PKCS#7 o CMC .

RequesterName Realiza la solicitud Domain\User Requestername = Contoso\BSmith


para inscribirse en
nombre de otra
solicitud de usuario.
La solicitud también
debe estar firmada
con un certificado
del agente de
inscripción o, de lo
contrario, la entidad
de certificación
rechaza la solicitud.
Clave1 Descripción Valor2 Ejemplo

Use la opción -cert


para especificar el
certificado del
agente de
inscripción. El
nombre del
solicitante se puede
especificar para las
solicitudes de
certificado si se
establece
RequestType en
PKCS#7 o CMC . Si
RequestType se
establece en
PKCS#10 , esta clave
se omite. El
Requestername solo
se puede establecer
como parte de la
solicitud. No puede
manipular el
Requestername en
una solicitud
pendiente.

RequestType Determina el PKCS10 -- 1 RequestType = CMC


estándar que se usa PKCS7 -- 2
para generar y enviar CMC -- 3
la solicitud de Cert -- 4
certificado. SCEP -- fd00 (64768)

Consejo: Esta opción indica un certificado


autofirmado o emitido automáticamente. No
genera una solicitud, sino un nuevo certificado y,
a continuación, instala el certificado. El valor
predeterminado es un certificado autofirmado.
Especifique un certificado de firma mediante la
opción –cert para crear un certificado
autoemitido que no esté autofirmado.

SecurityDescriptor Contiene la SecurityDescriptor = D:P(A;;GA;;;SY)


información de (A;;GA;;;BA)
seguridad asociada a
objetos protegibles.
Para la mayoría de
los objetos
protegibles, puede
especificar el
descriptor de
seguridad de un
objeto en la llamada
de función que crea
el objeto. Cadenas
basadas en el
lenguaje de
definición del
descriptor de
seguridad.

Consejo: Esto solo es


relevante para las
claves de tarjeta no
inteligentes del
contexto de la
máquina.
Clave1 Descripción Valor2 Ejemplo

AlternateSignatureAlgorithm Especifica y recupera true | false AlternateSignatureAlgorithm = false


un valor booleano
que indica si el Para una firma RSA, false indica un Pkcs1
identificador de v1.5 , mientras que true indica una firma

objeto de algoritmo v2.1 .

de firma (OID) de
una solicitud
PKCS#10 o firma de
certificado es
discreto o
combinado.

Silencioso De forma true | false Silent = true


predeterminada, esta
opción permite que
el CSP acceda al
escritorio de usuario
interactivo y solicite
información como
un PIN de tarjeta
inteligente del
usuario. Si esta clave
se establece en
TRUE, el CSP no
debe interactuar con
el escritorio y se
bloqueará para no
mostrar ninguna
interfaz de usuario al
usuario.

SMIME Si este parámetro se true | false SMIME = true


establece en TRUE,
se agrega una
extensión con el
valor de identificador
de objeto
1.2.840.113549.1.9.15
a la solicitud. El
número de
identificadores de
objeto depende de
la versión del sistema
operativo instalada y
de la capacidad de
CSP, que hacen
referencia a
algoritmos de cifrado
simétricos que
pueden usar las
aplicaciones Secure
Multipurpose
Internet Mail
Extensions (S/MIME),
como Outlook.

UseExistingKeySet Este parámetro se true | false UseExistingKeySet = true


usa para especificar
que se debe usar un
par de claves
existente en la
creación de una
solicitud de
certificado. Si esta
clave se establece en
TRUE, también debe
especificar un valor
Clave1 Descripción Valor2 Ejemplo

para la clave
RenewalCert o el
nombre
KeyContainer. No
debe establecer la
clave Exportable
porque no puede
cambiar las
propiedades de una
clave existente. En
este caso, no se
genera ningún
material de clave
cuando se crea la
solicitud de
certificado.

KeyProtection Especifica un valor XCN_NCRYPT_UI_NO_PROTCTION_FLAG -- 0 KeyProtection =


que indica cómo se XCN_NCRYPT_UI_PROTECT_KEY_FLAG -- 1 NCRYPT_UI_FORCE_HIGH_PROTECTION_FLAG
protege una clave XCN_NCRYPT_UI_FORCE_HIGH_PROTECTION_FLAG
privada antes de su -- 2
uso.

SuppressDefaults Especifica un valor true | false SuppressDefaults = true


booleano que indica
si las extensiones y
atributos
predeterminados se
incluyen en la
solicitud. Los valores
predeterminados se
representan
mediante sus
identificadores de
objeto (OID).

FriendlyName Nombre descriptivo Texto FriendlyName = Server1


del nuevo
certificado.

ValidityPeriodUnits Especifica numerosas Numeric ValidityPeriodUnits = 3


unidades que se van
a usar con
ValidityPeriod. Nota:
Esto solo se usa
cuando request
type=cert .

ValidityPeriod ValidityPeriod debe Years | Months | Weeks | Days | Hours | ValidityPeriod = Years
ser un período de Minutes | Seconds
tiempo plural en
inglés de EE. UU.
Nota: Solo se usa
cuando la solicitud
type=cert.

1
Parámetro a la izquierda del signo igual (=)

2
Parámetro a la derecha del signo igual (=)

[Extensions]

Esta sección es opcional.


OID de extensión Definición Ejemplo

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&

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
OID de extensión Definición Ejemplo

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)

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 Nota

SubjectNameFlags permite que el archivo INF especifique qué campos de extensión Subject y SubjectAltName deben

rellenar automáticamente certreq en función del usuario actual o de las propiedades actuales de la máquina: nombre
DNS, UPN, etc. Si se usa la plantilla literal, esto implica que se usarán las marcas de nombre de plantilla en su lugar. Esto
permite usar un único archivo INF en varios contextos para generar solicitudes con información de asunto específica del
contexto.

X500NameFlags especifica las marcas que se van a pasar directamente a la API CertStrToName cuando el valor Subject INF
keys se convierte en un nombre distintivo codificado ASN.1.

Ejemplo

Para crear un archivo de directiva (.inf) en el Bloc de notas de Windows y guardarlo 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

En el equipo para el que está solicitando un certificado:

certreq –new requestconfig.inf certrequest.req

Para usar la sintaxis de la sección [Strings] para los OID y otros datos difíciles de interpretar. El nuevo ejemplo de sintaxis {text}
para la extensión EKU, que usa una lista separada por comas de OID:

[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%

Para especificar un nombre alternativo del firmante (SAN), agréguelo en la sección [Extensions] del archivo INF. Por ejemplo:

[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]
2.5.29.17 = "{text}"
_continue_ = "DNS=example.com"
_continue_ = "DNS=www.example.com"
_continue_ = "IP Address=192.168.1.1"

En este ejemplo, 2.5.29.17 es el OID que define la SAN. Para especificar varias SAN, se usa el OID de extensión _continue_ ,
que permite separar y especificar cada extensión de SAN.

certreq -accept
El parámetro –accept vincula la clave privada generada anteriormente con el certificado emitido y quita la solicitud de
certificado pendiente del sistema donde se solicita el certificado (si hay una solicitud que coincida).

Para aceptar manualmente un certificado:

certreq -accept certnew.cer


2 Advertencia

El uso del parámetro -accept con las opciones -user y –machine indica si el certificado de instalación debe instalarse en
el contexto del usuario o de la máquina. Si hay una solicitud pendiente en cualquier contexto que coincida con la clave
pública que se va a instalar, estas opciones no son necesarias. Si no hay ninguna solicitud pendiente, se debe especificar
una de ellas.

certreq -policy
El archivo policy.inf es un archivo de configuración que define las restricciones aplicadas a una certificación de CA cuando se
define una subordinación completa.

Para crear una solicitud de certificado cruzado:

certreq -policy certsrv.req policy.inf newcertsrv.req

Si se usa certreq -policy sin ningún otro parámetro, se abre una ventana de diálogo que permite seleccionar el archivo
solicitado (.req, .cmc, .txt, .der, .cer o .crt). Después de seleccionar el archivo solicitado y hacer clic en Abrir, se abre otra
ventana de diálogo, lo que le permite seleccionar el archivo policy.inf.

Ejemplos

Busque un ejemplo del archivo policy.inf en la sintaxis CAPolicy.inf.

certreq -sign
Para crear una nueva solicitud de certificado, fírmela y envíela:

certreq -new policyfile.inf myrequest.req


certreq -sign myrequest.req myrequest.req
certreq -submit myrequest_sign.req myrequest_cert.cer

Comentarios
Si se usa certreq -sign sin ningún otro parámetro, se abre una ventana de diálogo que permite seleccionar el archivo
solicitado (.req, .cmc, .txt, .der, .cer o .crt).

La firma de la solicitud de la subordinación completa puede requerir las credenciales del administrador de la empresa.
Se trata de un procedimiento recomendado para emitir certificados de firma para la subordinación completa.

El certificado que se usa para firmar la solicitud de subordinación completa utiliza la plantilla de subordinación completa.
Los administradores de empresa tienen que firmar la solicitud o conceder permisos de usuario a los usuarios individuales
que firman el certificado.

Es posible que tras firmarla usted, la solicitud de CMC la tenga que firmar personal adicional. Esto depende del nivel de
garantía asociado a la subordinación completa.

Si la CA primaria de la CA subordinada completa que va a instalar está sin conexión, debe obtener el certificado de CA
para la CA subordinada completa del elemento primario sin conexión. Si la CA primaria está en línea, especifique el
certificado de CA para la CA subordinada completa durante el asistente para la instalación de servicios de certificados.

certreq -enroll
Puede usar este comentario para inscribir o renovar los certificados.

Ejemplos
Para inscribir un certificado mediante la plantilla WebServer y seleccionando el servidor de directivas con U/I:

certreq -enroll –machine –policyserver * WebServer

Para renovar un certificado mediante un número de serie:

certreq –enroll -machine –cert 61 2d 3c fe 00 00 00 00 00 05 renew

Solo puede renovar certificados válidos. Los certificados caducados no se pueden renovar; deben reemplazarse por un nuevo
certificado.

Opciones
Opciones Descripción

-any Force ICertRequest::Submit para determinar el tipo de codificación.

-attrib Especifica los pares de cadena nombre y valor, separados por dos puntos.
<attributestring>
Separe los pares de cadena nombre y valor mediante \n (por ejemplo, Name1:value1\nName2:value2).

-binary Da formato a los archivos de salida como binarios en lugar de codificados en Base64.

-policyserver ldap: <path>


<policyserver> Inserte el URI o el identificador único de un equipo que ejecute el servicio web de directiva de inscripción de
certificados.

Para especificar que desea usar un archivo de solicitud mediante exploración, basta con que use un signo menos (-)
para <policyserver> .

-config Procesa la operación utilizando la CA especificada en la cadena de configuración, es decir, CAHostName\CAName.


<ConfigString> Para una conexión https:\\\, especifique el URI del servidor de inscripción. Para la CA del almacén de máquinas local,
use un signo menos (-).

-anonymous Use credenciales anónimas para los servicios web de inscripción de certificados.

-kerberos Use las credenciales de Kerberos (dominio) para los servicios web de inscripción de certificados.

-clientcertificate Puede reemplazar el <ClientCertId> con una huella digital de certificado, un CN, un EKU, una plantilla, un correo
<ClientCertId> electrónico, un UPN o la nueva sintaxis name=value .

-username <username> Se usa con servicios web de inscripción de certificados. Puede sustituir <username> por el nombre SAM o el valor
domain\user. Esta opción se usa con la opción -p .

-p <password> Se usa con servicios web de inscripción de certificados. Sustituya <password> por la contraseña del usuario real. Esta
opción se usa con la opción -username .

-user Configura el contexto -user de una nueva solicitud de certificado o especifica el contexto de una aceptación de
certificado. Este es el contexto predeterminado si no se especifica ninguno el INF o en la plantilla.

-machine Configura una nueva solicitud de certificado o especifica el contexto de una aceptación de certificado para el
contexto de la máquina. Para las nuevas solicitudes, debe ser coherente con la clave INF MachineKeyset y el
contexto de la plantilla. Si no se especifica esta opción y la plantilla no establece un contexto, el valor
predeterminado es el contexto del usuario.

-crl Incluye listas de revocación de certificados (CRL) en la salida al archivo PKCS #7 codificado en Base64 especificado
por certchainfileout o al archivo codificado en Base64 especificado por requestfileout .
Opciones Descripción

-rpc Indica a los Servicios de certificados de Active Directory (AD CS) que usen una conexión de servidor de llamada a
procedimiento remoto (RPC) en lugar de COM distribuido.

-adminforcemachine Use el servicio de claves o la suplantación para enviar la solicitud desde el contexto del sistema local. Requiere que
el usuario que invoca esta opción sea miembro de los administradores locales.

-renewonbehalfof Envíe una renovación en nombre del firmante identificado en el certificado de firma. Esto establece CR_IN_ROBO al
llamar al método ICertRequest::Submit

-f Forzar la sobrescritura de los archivos existentes. Esto también omite las plantillas de almacenamiento en caché y la
directiva.

-q Use modo silencioso; suprima todos los avisos interactivos.

-unicode Escribe la salida Unicode cuando la salida estándar se redirige o canaliza a otro comando, lo que ayuda cuando se
invoca desde scripts de Windows PowerShell.

-unicodetext Envía una salida Unicode al escribir blobs de datos codificados en Base64 en archivos.

Formatos
Formatos Descripción

requestfilein Nombre de archivo de entrada binario o codificado en Base64: solicitud de certificado PKCS #10, solicitud de certificado
CMS, solicitud de renovación de certificados PKCS #7, certificado X.509 que se va a certificar de forma cruzada o solicitud
de certificado de formato de etiqueta KeyGen.

requestfileout Nombre del archivo de salida codificado en Base64.

certfileout Nombre del archivo X-509 codificado en Base64.

PKCS10fileout Para su uso exclusivamente con el parámetro certreq -policy . Nombre de archivo de salida PKCS10 codificado en
Base64.

certchainfileout Nombre de archivo PKCS #7 codificado en Base64.

fullresponsefileout Nombre de archivo de respuesta completa codificado en Base64.

policyfilein Para su uso exclusivamente con el parámetro certreq -policy . Archivo INF que contiene una representación textual de
las extensiones usadas para calificar una solicitud.

Recursos adicionales
Los siguientes artículos contienen ejemplos de uso de certreq:

Cómo agregar un nombre alternativo del firmante a un certificado LDAP seguro

Test Lab Guide: Deploying an AD CS Two-Tier PKI Hierarchy

Apéndice 3: sintaxis de Certreq.exe

Cómo crear un certificado SSL de servidor web de forma manual

Inscripción de certificados para el agente de System Center Operations Manager

Introducción a los Servicios de certificados de Active Directory

Cómo habilitar LDAP a través de SSL con una entidad de certificación de terceros
certutil
Artículo • 19/10/2023

U Precaución

Certutil no se recomienda usar en ningún código de producción y no

proporciona ninguna garantía de compatibilidad con sitios activos ni


compatibilidad de aplicaciones. Es una herramienta utilizada por desarrolladores y
administradores de TI para ver la información de contenido del certificado en los
dispositivos.

Certutil.exe es un programa de línea de comandos que se instala como parte de los


servicios de certificados. Puede usar certutil.exe para mostrar la información de
configuración de la entidad de certificación (CA), configurar los servicios de certificados,
realizar copias de seguridad y restaurar los componentes de la CA. El programa también
comprueba los certificados, los pares de claves y las cadenas de certificados.

Si certutil se ejecuta en una entidad de certificación sin otros parámetros, muestra la


configuración actual de la entidad de certificación. Si certutil se ejecuta en una
entidad que no es de certificación sin otros parámetros, el comando ejecuta el comando
certutil -dump de forma predeterminada. No todas las versiones de certutil

proporcionan todos los parámetros y opciones que se describen este documento.


Puede ver las opciones que proporciona una versión específica de certutil mediante la
ejecución de certutil -? o certutil <parameter> -? .

 Sugerencia

Para ver la ayuda completa de todos los verbos y opciones de certutil, incluidos los
que están ocultos del argumento -? , ejecute certutil -v -uSAGE . El modificador
uSAGE distingue mayúsculas de minúsculas.

Parámetros

-dump
Vuelca la información o los archivos de configuración.

Símbolo del sistema de Windows


certutil [options] [-dump]
certutil [options] [-dump] File

Opciones:

Símbolo del sistema de Windows

[-f] [-user] [-Silent] [-split] [-p Password] [-t Timeout]

-dumpPFX
Vuelca la estructura PFX.

Símbolo del sistema de Windows

certutil [options] [-dumpPFX] File

Opciones:

Símbolo del sistema de Windows

[-f] [-Silent] [-split] [-p Password] [-csp Provider]

-asn
Analiza y muestra el contenido de un archivo mediante notación de sintaxis abstracta
(ASN.1). Los tipos de archivo incluyen archivos con formato .CER, .DER y PKCS #7.

Símbolo del sistema de Windows

certutil [options] -asn File [type]

[type] : tipo de descodificación de CRYPT_STRING_* numérico

-decodehex
Descodifica un archivo con codificación hexadecimal.

Símbolo del sistema de Windows


certutil [options] -decodehex InFile OutFile [type]

[type] : tipo de descodificación de CRYPT_STRING_* numérico

Opciones:

Símbolo del sistema de Windows

[-f]

-encodehex
Codifica un archivo en codificación hexadecimal.

Símbolo del sistema de Windows

certutil [options] -encodehex InFile OutFile [type]

[type] : tipo de codificación numérica CRYPT_STRING_*

Opciones:

Símbolo del sistema de Windows

[-f] [-nocr] [-nocrlf] [-UnicodeText]

-decode
Descodifica un archivo codificado en Base64.

Símbolo del sistema de Windows

certutil [options] -decode InFile OutFile

Opciones:

Símbolo del sistema de Windows

[-f]

-encode
Codifica un archivo en Base64.

Símbolo del sistema de Windows

certutil [options] -encode InFile OutFile

Opciones:

Símbolo del sistema de Windows

[-f] [-unicodetext]

-deny
Deniega una solicitud pendiente.

Símbolo del sistema de Windows

certutil [options] -deny RequestId

Opciones:

Símbolo del sistema de Windows

[-config Machine\CAName]

-resubmit
Vuelve a enviar una solicitud pendiente.

Símbolo del sistema de Windows

certutil [options] -resubmit RequestId

Opciones:

Símbolo del sistema de Windows

[-config Machine\CAName]

-setattributes
Establece atributos para una solicitud de certificado pendiente.

Símbolo del sistema de Windows

certutil [options] -setattributes RequestId AttributeString

Donde:

RequestID es el identificador numérico de solicitud para la solicitud pendiente.


AttributeString son los pares de nombre y valor del atributo de solicitud.

Opciones:

Símbolo del sistema de Windows

[-config Machine\CAName]

Comentarios
Los nombres y los valores deben estar separados por dos puntos, mientras que
varios pares de nombre y valor deben estar separados por una nueva línea. Por
ejemplo: CertificateTemplate:User\nEMail:User@Domain.com donde la secuencia \n
se convierte en un separador de nueva línea.

-setextension
Establece una extensión para una solicitud de certificado pendiente.

Símbolo del sistema de Windows

certutil [options] -setextension RequestId ExtensionName Flags {Long | Date


| String | @InFile}

Donde:

requestID es el identificador numérico de solicitud para la solicitud pendiente.


ExtensionName es la cadena ObjectId de la extensión.
Flags establece la prioridad de la extensión. Se recomienda 0 , mientras que 1
establece la extensión en crítica, 2 deshabilita la extensión y 3 hace ambas cosas.

Opciones:

Símbolo del sistema de Windows


[-config Machine\CAName]

Comentarios
Si el último parámetro es numérico, se toma como long.
Si el último parámetro se puede analizar como una fecha, se toma como un valor
Date.
Si el último parámetro comienza por \@ , el resto del token se toma como nombre
de archivo con datos binarios o un volcado hexadecimal de texto ASCII.
Si el último parámetro es cualquier otra cosa, se toma como una cadena.

-revoke
Revoca un certificado.

Símbolo del sistema de Windows

certutil [options] -revoke SerialNumber [Reason]

Donde:

SerialNumber es una lista separada por comas de números de serie de certificados


que se van a revocar.
Reason es la representación numérica o simbólica del motivo de revocación, por
ejemplo:
0. CRL_REASON_UNSPECIFIED: sin especificar (valor predeterminado)
1. CRL_REASON_KEY_COMPROMISE: riesgo clave
2. CRL_REASON_CA_COMPROMISE: riesgo de la entidad de certificación
3. CRL_REASON_AFFILIATION_CHANGED: cambio de afiliación
4. CRL_REASON_SUPERSEDED: reemplazado
5. CRL_REASON_CESSATION_OF_OPERATION: cese de funcionamiento
6. CRL_REASON_CERTIFICATE_HOLD: suspensión del certificado
8. CRL_REASON_REMOVE_FROM_CRL: supresión de CRL
9: CRL_REASON_PRIVILEGE_WITHDRAWN: privilegios retirados
10: CRL_REASON_AA_COMPROMISE: riesgo de AA
-1. Anula la revocación - Unrevokes

Opciones:

Símbolo del sistema de Windows


[-config Machine\CAName]

-isvalid
Muestra la disposición del certificado actual.

Símbolo del sistema de Windows

certutil [options] -isvalid SerialNumber | CertHash

Opciones:

Símbolo del sistema de Windows

[-config Machine\CAName]

-getconfig
Obtiene la cadena de configuración predeterminada.

Símbolo del sistema de Windows

certutil [options] -getconfig

Opciones:

Símbolo del sistema de Windows

[-idispatch] [-config Machine\CAName]

-getconfig2
Obtiene la cadena de configuración predeterminada mediante ICertGetConfig.

Símbolo del sistema de Windows

certutil [options] -getconfig2

Opciones:

Símbolo del sistema de Windows


[-idispatch]

-getconfig3
Obtiene la configuración mediante ICertConfig.

Símbolo del sistema de Windows

certutil [options] -getconfig3

Opciones:

Símbolo del sistema de Windows

[-idispatch]

-ping
Intenta ponerse en contacto con la interfaz de solicitud de Servicios de certificados de
Active Directory.

Símbolo del sistema de Windows

certutil [options] -ping [MaxSecondsToWait | CAMachineList]

Donde:

CAMachineList es una lista separada por comas de nombres de máquina de la


entidad de certificación. Para una sola máquina, use una coma de terminación. Esta
opción también muestra el costo del sitio para cada máquina de la entidad de
certificación (CA).

Opciones:

Símbolo del sistema de Windows

[-config Machine\CAName] [-Anonymous] [-Kerberos] [-ClientCertificate


ClientCertId] [-UserName UserName] [-p Password]

-pingadmin
Intenta ponerse en contacto con la interfaz de administración de Servicios de
certificados de Active Directory.

Símbolo del sistema de Windows

certutil [options] -pingadmin

Opciones:

Símbolo del sistema de Windows

[-config Machine\CAName]

-CAInfo
Muestra la información sobre la entidad de certificación.

Símbolo del sistema de Windows

certutil [options] -CAInfo [InfoName [Index | ErrorCode]]

Donde:

InfoName indica la propiedad de la entidad de certificación que se va a mostrar,


en función de la siguiente sintaxis del argumento infoname:
*: muestra todas las propiedades
ads: servidor avanzado
aia [Índice]: direcciones URL de AIA
cdp [Índice]: direcciones URL de CDP
cert [Índice]: certificado de entidad de certificación
cadena de certificados [Índice]: cadena de certificados de entidad de
certificación
certcount: recuento de certificados de entidad de certificación
certcrlchain [Índice]: cadena de certificados de entidad de certificación con CRL
certstate [Índice]: certificado de entidad de certificación
certstatuscode [Índice]: estado de comprobación del certificado de entidad de
certificación
certversion [Índice]: versión del certificado de entidad de certificación
CRL [Índice]: CRL base
crlstate [Índice]: CRL
crlstatus [Índice]: estado de publicación de CRL
cross- [Índice]: certificado cruzado regresivo
cross+ [Índice]: certificado cruzado directo
crossstate- [Índice]: certificado cruzado regresivo
crossstate+ [Índice]: certificado cruzado directo
deltacrl [Índice]: CRL Delta
deltacrlstatus [Índice]: estado de publicación de CRL Delta
dns: nombre del servicio de nombres de dominio
dsname: nombre corto de la entidad de certificación saneada (nombre de DS)
error1 ErrorCode: texto del mensaje de error
error2 ErrorCode: texto del mensaje de error y código de error
exit [Índice]: descripción del módulo de salida
exitcount: recuento de módulos de salida
file: versión del archivo
info: información de la entidad de certificación
kra [Índice]: certificado KRA
kracount: recuento de certificados de KRA
krastate [Índice]: certificado KRA
kraused: recuento usado del certificado KRA
localename: nombre de configuración regional de la entidad de certificación
name: nombre de entidad de certificación
ocsp [Índice]: URL de OCSP
primario: entidad de certificación primaria
policy: descripción del módulo de directivas
product: versión del producto
propidmax: valor máximo de PropId de la entidad de certificación
role: separación de roles
sanitizedname: nombre de entidad de certificación saneada
sharedfolder: carpeta compartida
subjecttemplateoids: OID de plantilla del firmante
templates: plantillas
type: tipo de entidad de certificación
xchg [Índice]: certificado de intercambio de CA
xchgchain [Índice]: cadena de certificados de intercambio de CA
xchgcount: recuento de certificados de intercambio de entidad de certificación
xchgcrlchain [Índice]: cadena de certificados de intercambio de CA con CRL
index es el índice de propiedad de base cero opcional.
errorcode es el código de error numérico.

Opciones:

Símbolo del sistema de Windows


[-f] [-split] [-config Machine\CAName]

-CAPropInfo
Muestra información sobre el tipo de propiedad de CA.

Símbolo del sistema de Windows

certutil [options] -CAInfo [InfoName [Index | ErrorCode]]

Opciones:

Símbolo del sistema de Windows

[-idispatch] [-v1] [-admin] [-config Machine\CAName]

-ca.cert
Recupera el certificado de la entidad de certificación.

Símbolo del sistema de Windows

certutil [options] -ca.cert OutCACertFile [Index]

Donde:

OutCACertFile es el archivo de salida.


Index es el índice de renovación de certificados de entidad de certificación (el
valor predeterminado es el más reciente).

Opciones:

Símbolo del sistema de Windows

[-f] [-split] [-config Machine\CAName]

-ca.chain
Recupera la cadena de certificados para la entidad de certificación.

Símbolo del sistema de Windows


certutil [options] -ca.chain OutCACertChainFile [Index]

Donde:

OutCACertChainFile es el archivo de salida.


Index es el índice de renovación de certificados de entidad de certificación (el
valor predeterminado es el más reciente).

Opciones:

Símbolo del sistema de Windows

[-f] [-split] [-config Machine\CAName]

-GetCRL
Obtiene una lista de revocación de certificados (CRL).

Símbolo del sistema de Windows

certutil [options] -GetCRL OutFile [Index] [delta]

Donde:

Index es el índice de CRL o de clave (el valor predeterminado es CRL para la clave
más reciente).
delta es el CRL delta (el valor predeterminado es CRL base).

Opciones:

Símbolo del sistema de Windows

[-f] [-split] [-config Machine\CAName]

-CRL
Publica nuevas listas de revocación de certificados (CRL) o CRL delta.

Símbolo del sistema de Windows

certutil [options] -CRL [dd:hh | republish] [delta]


Donde:

dd:hh es el nuevo período de validez de la CRL en días y horas.


republish vuelve a publicar las CRL más recientes.
delta publica solo las CRL delta (el valor predeterminado es CRL base y delta).

Opciones:

Símbolo del sistema de Windows

[-split] [-config Machine\CAName]

-shutdown
Apaga los Servicios de certificados de Active Directory.

Símbolo del sistema de Windows

certutil [options] -shutdown

Opciones:

Símbolo del sistema de Windows

[-config Machine\CAName]

-installCert
Instala un certificado de entidad de certificación.

Símbolo del sistema de Windows

certutil [options] -installCert [CACertFile]

Opciones:

Símbolo del sistema de Windows

[-f] [-silent] [-config Machine\CAName]

-renewCert
Renueva un certificado de entidad de certificación.

Símbolo del sistema de Windows

certutil [options] -renewCert [ReuseKeys] [Machine\ParentCAName]

Opciones:

Símbolo del sistema de Windows

[-f] [-silent] [-config Machine\CAName]

Use -f para omitir una solicitud de renovación pendiente y para generar una
nueva solicitud.

-schema
Vuelca el esquema del certificado.

Símbolo del sistema de Windows

certutil [options] -schema [Ext | Attrib | CRL]

Donde:

El comando tiene como valor predeterminado la tabla de certificados y solicitudes.


Ext es la tabla de extensiones.
Attribute es la tabla de atributos.
CRL es la tabla de CRL.

Opciones:

Símbolo del sistema de Windows

[-split] [-config Machine\CAName]

-view
Vuelca la vista de certificado.

Símbolo del sistema de Windows


certutil [options] -view [Queue | Log | LogFail | Revoked | Ext | Attrib |
CRL] [csv]

Donde:

Queue vuelca una cola de solicitudes específica.


Log vuelca los certificados emitidos o revocados, además de las solicitudes con
errores.
LogFail vuelca las solicitudes con errores.
Revoked vuelca los certificados revocados.
Ext vuelca la tabla de extensiones.
Attrib vuelca la tabla de atributos.
CRL vuelca la tabla de CRL.
csv proporciona la salida mediante valores separados por comas.

Opciones:

Símbolo del sistema de Windows

[-silent] [-split] [-config Machine\CAName] [-restrict RestrictionList] [-


out ColumnList]

Comentarios

Para mostrar la columna StatusCode para todas las entradas, escriba -out
StatusCode .

Para mostrar todas las columnas de la última entrada, escriba -restrict


RequestId==$ .

Para mostrar RequestId y Disposition para tres solicitudes, escriba: -restrict


requestID>=37,requestID<40 -out requestID,disposition

Para mostrar los identificadores de fila y los números de CRL de todas las CRL
base, escriba -restrict crlminbase=0 -out crlrowID,crlnumber crl
Para mostrar el número 3 de la CRL base, escriba: -v -restrict
crlminbase=0,crlnumber=3 -out crlrawcrl crl

Para mostrar toda la tabla CRL, escriba CRL .


Use Date[+|-dd:hh] para restricciones de fecha.
Use now+dd:hh para una fecha relativa a la hora actual.
Las plantillas contienen usos de clave extendida (EKU), que son identificadores de
objeto (OID) que describen cómo se usa el certificado. Los certificados no siempre
incluyen nombres comunes de plantilla o nombres para mostrar, pero siempre
contienen los EKU de plantilla. Puede extraer los EKU de una plantilla de certificado
específica de Active Directory y, después, restringir las vistas en función de esa
extensión.

-db
Vuelca la base de datos sin procesar.

Símbolo del sistema de Windows

certutil [options] -db

Opciones:

Símbolo del sistema de Windows

[-config Machine\CAName] [-restrict RestrictionList] [-out ColumnList]

-deleterow
Elimina una fila de la base de datos del servidor.

Símbolo del sistema de Windows

certutil [options] -deleterow RowId | Date [Request | Cert | Ext | Attrib |


CRL]

Donde:

Request elimina las solicitudes con errores y pendientes, en función de la fecha de


envío.
Cert elimina los certificados expirados y revocados, en función de la fecha de
expiración.
Ext elimina la tabla de extensiones.
Attrib elimina la tabla de atributos.
CRL elimina la tabla de CRL.

Opciones:

Símbolo del sistema de Windows

[-f] [-config Machine\CAName]


Ejemplos
Para eliminar solicitudes con errores y pendientes enviadas el 22 de enero de 2001,
escriba 1/22/2001 request .
Para eliminar todos los certificados que expiraron el 22 de enero de 2001, escriba
1/22/2001 cert .

Para eliminar la fila de certificado, los atributos y las extensiones de RequestID 37,
escriba 37 .
Para eliminar las CRL que expiraron el 22 de enero de 2001, escriba 1/22/2001 crl .

7 Nota

Date espera el formato mm/dd/yyyy en lugar de dd/mm/yyyy , por ejemplo


1/22/2001 , en lugar de 22/1/2001 para el 22 de enero de 2001. Si el servidor no

está configurado con la configuración regional de EE. UU., el uso del argumento
Date podría generar resultados inesperados.

-backup
Realiza una copia de seguridad de Servicios de certificados de Active Directory.

Símbolo del sistema de Windows

certutil [options] -backup BackupDirectory [Incremental] [KeepLog]

Donde:

BackupDirectory es el directorio para almacenar los datos de copia de seguridad.


Incremental realiza solo una copia de seguridad incremental (el valor
predeterminado es la copia de seguridad completa).
KeepLog conserva los archivos de registro de la base de datos (el valor
predeterminado es truncar los archivos de registro).

Opciones:

Símbolo del sistema de Windows

[-f] [-config Machine\CAName] [-p Password] [-ProtectTo SAMNameAndSIDList]

-backupDB
Realiza una copia de seguridad de la base de datos de Servicios de certificados de
Active Directory.

Símbolo del sistema de Windows

certutil [options] -backupdb BackupDirectory [Incremental] [KeepLog]

Donde:

BackupDirectory es el directorio para almacenar los archivos de base de datos de


copia de seguridad.
Incremental realiza solo una copia de seguridad incremental (el valor
predeterminado es la copia de seguridad completa).
KeepLog conserva los archivos de registro de la base de datos (el valor
predeterminado es truncar los archivos de registro).

Opciones:

Símbolo del sistema de Windows

[-f] [-config Machine\CAName]

-backupkey
Realiza una copia de seguridad del certificado de Servicios de certificados de Active
Directory y la clave privada.

Símbolo del sistema de Windows

certutil [options] -backupkey BackupDirectory

Donde:

BackupDirectory es el directorio para almacenar el archivo PFX de copia de


seguridad.

Opciones:

Símbolo del sistema de Windows

[-f] [-config Machine\CAName] [-p password] [-ProtectTo SAMNameAndSIDList]


[-t Timeout]
-restore
Restaura los Servicios de certificados de Active Directory.

Símbolo del sistema de Windows

certutil [options] -restore BackupDirectory

Donde:

BackupDirectory es el directorio que contiene los datos que se van a restaurar.

Opciones:

Símbolo del sistema de Windows

[-f] [-config Machine\CAName] [-p password]

-restoredb
Restaura la base de datos de Servicios de certificados de Active Directory.

Símbolo del sistema de Windows

certutil [options] -restoredb BackupDirectory

Donde:

BackupDirectory es el directorio que contiene los archivos de base de datos que


se van a restaurar.

Opciones:

Símbolo del sistema de Windows

[-f] [-config Machine\CAName]

-restorekey
Restaura el certificado de Servicios de certificados de Active Directory y la clave privada.

Símbolo del sistema de Windows


certutil [options] -restorekey BackupDirectory | PFXFile

Donde:

BackupDirectory es el directorio que contiene el archivo PFX que se va a restaurar.


PFXFile es el archivo PFX que se va a restaurar.

Opciones:

Símbolo del sistema de Windows

[-f] [-config Machine\CAName] [-p password]

-exportPFX
Exporta los certificados y las claves privadas. Para más información, vea el parámetro -
store en este artículo.

Símbolo del sistema de Windows

certutil [options] -exportPFX [CertificateStoreName] CertId PFXFile


[Modifiers]

Donde:

CertificateStoreName es el nombre del almacén de certificados.


CertId es el certificado o token de coincidencia de CRL.
PFXFile es el archivo PFX que se va a exportar.
Modifiers son la lista separada por comas, que puede incluir uno o varios de los
siguientes elementos:
CryptoAlgorithm= especifica el algoritmo criptográfico que se va a usar para
cifrar el archivo PFX, como TripleDES-Sha1 o Aes256-Sha256 .
EncryptCert: cifra la clave privada asociada al certificado con una contraseña.
ExportParameters: exporta los parámetros de clave privada además del
certificado y la clave privada.
ExtendedProperties: incluye todas las propiedades extendidas asociadas al
certificado en el archivo de salida.
NoEncryptCert: exporta la clave privada sin cifrarla.
NoChain: no importa la cadena de certificados.
NoRoot: no importa el certificado raíz.
-importPFX
Importa los certificados y las claves privadas. Para más información, vea el parámetro -
store en este artículo.

Símbolo del sistema de Windows

certutil [options] -importPFX [CertificateStoreName] PFXFile [Modifiers]

Donde:

CertificateStoreName es el nombre del almacén de certificados.


PFXFile es el archivo PFX que se va a importar.
Modifiers son la lista separada por comas, que puede incluir uno o varios de los
siguientes elementos:
AT_KEYEXCHANGE:: cambia la especificación de claves a intercambio de claves.
AT_SIGNATURE: cambia la especificación de claves a firma.
ExportEncrypted: exporta la clave privada asociada al certificado con cifrado de
contraseña.
FriendlyName=: especifica un nombre descriptivo para el certificado importado.
KeyDescription=: especifica una descripción para la clave privada asociada al
certificado importado.
KeyFriendlyName=: especifica un nombre descriptivo para la clave privada
asociada al certificado importado.
NoCert: no importa el certificado.
NoChain: no importa la cadena de certificados.
NoExport: hace que la clave privada no se pueda exportar.
NoProtect: no protege las claves mediante una contraseña.
NoRoot: no importa el certificado raíz.
Pkcs8: usa el formato PKCS8 para la clave privada en el archivo PFX.
Protect: protege las claves mediante una contraseña.
ProtectHigh: especifica que una contraseña de alta seguridad debe estar
asociada a la clave privada.
VSM: almacena la clave privada asociada al certificado importado en el
contenedor de tarjeta inteligente virtual (VSC).

Opciones:

Símbolo del sistema de Windows

[-f] [-Enterprise] [-user] [-GroupPolicy] [-Silent] [-p Password] [-csp


Provider]
Comentarios
El valor predeterminado es el almacén de máquinas personales.

-dynamicfilelist
Muestra una lista de archivos dinámicos.

Símbolo del sistema de Windows

certutil [options] -dynamicfilelist

Opciones:

Símbolo del sistema de Windows

[-config Machine\CAName]

-databaselocations
Muestra las ubicaciones de la base de datos.

Símbolo del sistema de Windows

certutil [options] -databaselocations

Opciones:

Símbolo del sistema de Windows

[-config Machine\CAName]

-hashfile
Genera y muestra un hash criptográfico a través de un archivo.

Símbolo del sistema de Windows

certutil [options] -hashfile InFile [HashAlgorithm]

-store
Vuelca el almacén de certificados.

Símbolo del sistema de Windows

certutil [options] -store [CertificateStoreName [CertId [OutputFile]]]

Donde:

CertificateStoreName es el nombre del almacén de certificados. Por ejemplo:


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 es el certificado o token de coincidencia de CRL. Este identificador puede


ser un:
Número de serie
Certificado SHA-1
CRL, CTL o hash de clave pública
Índice de certificado numérico (0, 1, etc.)
Índice de CRL numérico (,0, ,1, etc.)
Índice de CTL numérico (,,0, ,,1, etc.)
Clave pública
ObjectId de firma o extensión
Nombre común del firmante del certificado
Dirección de correo electrónico
Nombre UPN o DNS
Nombre del contenedor de claves o nombre de CSP
Nombre de plantilla u ObjectId
ObjectId de EKU o directivas de aplicación
Nombre común del emisor de la CRL.

Es posible que muchos de estos identificadores puedan dar lugar a varias coincidencias.

OutputFile es el archivo que se usa para guardar los certificados coincidentes.

Opciones:

Símbolo del sistema de Windows

[-f] [-Enterprise] [-user] [-GroupPolicy] [-Silent] [-split] [-dc DCName]

La opción -user accede a un almacén de usuarios en lugar de a un almacén de


máquinas.
La opción -enterprise accede a un almacén empresarial de máquinas.
La opción -service accede a un almacén de servicio de máquina.
La opción -grouppolicy accede a un almacén de directivas de grupo de máquinas.

Por ejemplo:

-enterprise NTAuth

-enterprise Root 37
-user My 26e0aaaf000000000004

CA .11

7 Nota

Los problemas de rendimiento se observan al usar el parámetro -store dados


estos dos aspectos:

1. Cuando el número de certificados del almacén supera los 10.


2. Cuando se especifica un CertId, se usa para hacer coincidir todos los tipos
enumerados para cada certificado. Por ejemplo, si se proporciona un número
de serie, también intentará coincidir con todos los demás tipos enumerados.

Si le preocupa los problemas de rendimiento, se recomiendan comandos de


PowerShell en los que solo coincidirá con el tipo de certificado especificado.

-enumstore
Enumera los almacenes de certificados.
Símbolo del sistema de Windows

certutil [options] -enumstore [\\MachineName]

Donde:

MachineName es el nombre del equipo remoto.

Opciones:

Símbolo del sistema de Windows

[-enterprise] [-user] [-grouppolicy]

-addstore
Agrega un certificado al almacén. Para más información, vea el parámetro -store en
este artículo.

Símbolo del sistema de Windows

certutil [options] -addstore CertificateStoreName InFile

Donde:

CertificateStoreName es el nombre del almacén de certificados.


InFile es el certificado o archivo CRL que quiere agregar al almacén.

Opciones:

Símbolo del sistema de Windows

[-f] [-Enterprise] [-user] [-GroupPolicy] [-dc DCName]

-delstore
Elimina un certificado del almacén. Para más información, vea el parámetro -store en
este artículo.

Símbolo del sistema de Windows

certutil [options] -delstore CertificateStoreName certID


Donde:

CertificateStoreName es el nombre del almacén de certificados.


CertId es el certificado o token de coincidencia de CRL.

Opciones:

Símbolo del sistema de Windows

[-f] [-Enterprise] [-user] [-GroupPolicy] [-Silent] [-dc DCName]

-verifystore
Comprueba un certificado en el almacén. Para más información, vea el parámetro -
store en este artículo.

Símbolo del sistema de Windows

certutil [options] -verifystore CertificateStoreName [CertId]

Donde:

CertificateStoreName es el nombre del almacén de certificados.


CertId es el certificado o token de coincidencia de CRL.

Opciones:

Símbolo del sistema de Windows

[-Enterprise] [-user] [-GroupPolicy] [-Silent] [-split] [-dc DCName] [-t


Timeout]

-repairstore
Repara una asociación de claves o actualiza las propiedades del certificado o el
descriptor de seguridad de la clave. Para más información, vea el parámetro -store en
este artículo.

Símbolo del sistema de Windows

certutil [options] -repairstore CertificateStoreName CertIdList


[PropertyInfFile | SDDLSecurityDescriptor]
Donde:

CertificateStoreName es el nombre del almacén de certificados.

CertIdList es la lista separada por comas de tokens de coincidencia de certificados


o CRL. Para más información, vea la descripción de -store CertId en este artículo.

PropertyInfFile es el archivo INF que contiene propiedades externas, entre las que
se incluyen las siguientes:

Símbolo del sistema de Windows

[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,

Opciones:

Símbolo del sistema de Windows

[-f] [-Enterprise] [-user] [-GroupPolicy] [-Silent] [-split] [-csp Provider]

-viewstore
Vuelca el almacén de certificados. Para más información, vea el parámetro -store en
este artículo.

Símbolo del sistema de Windows

certutil [options] -viewstore [CertificateStoreName [CertId [OutputFile]]]


Donde:

CertificateStoreName es el nombre del almacén de certificados. Por ejemplo:


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 es el certificado o token de coincidencia de CRL. Esto puede ser:


Número de serie
Certificado SHA-1
CRL, CTL o hash de clave pública
Índice de certificado numérico (0, 1, etc.)
Índice de CRL numérico (,0, ,1, etc.)
Índice de CTL numérico (,,0, ,,1, etc.)
Clave pública
ObjectId de firma o extensión
Nombre común del firmante del certificado
Dirección de correo electrónico
Nombre UPN o DNS
Nombre del contenedor de claves o nombre de CSP
Nombre de plantilla u ObjectId
ObjectId de EKU o directivas de aplicación
Nombre común del emisor de la CRL.

Muchos de estos pueden dar lugar a varias coincidencias.

OutputFile es el archivo que se usa para guardar los certificados coincidentes.

Opciones:
Símbolo del sistema de Windows

[-f] [-Enterprise] [-user] [-GroupPolicy] [-dc DCName]

La opción -user accede a un almacén de usuarios en lugar de a un almacén de


máquinas.
La opción -enterprise accede a un almacén empresarial de máquinas.
La opción -service accede a un almacén de servicio de máquina.
La opción -grouppolicy accede a un almacén de directivas de grupo de máquinas.

Por ejemplo:

-enterprise NTAuth

-enterprise Root 37
-user My 26e0aaaf000000000004

CA .11

-viewdelstore
Elimina un certificado del almacén.

Símbolo del sistema de Windows

certutil [options] -viewdelstore [CertificateStoreName [CertId


[OutputFile]]]

Donde:

CertificateStoreName es el nombre del almacén de certificados. Por ejemplo:


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 es el certificado o token de coincidencia de CRL. Esto puede ser:


Número de serie
Certificado SHA-1
CRL, CTL o hash de clave pública
Índice de certificado numérico (0, 1, etc.)
Índice de CRL numérico (,0, ,1, etc.)
Índice de CTL numérico (,,0, ,,1, etc.)
Clave pública
ObjectId de firma o extensión
Nombre común del firmante del certificado
Dirección de correo electrónico
Nombre UPN o DNS
Nombre del contenedor de claves o nombre de CSP
Nombre de plantilla u ObjectId
ObjectId de EKU o directivas de aplicación
Nombre común del emisor de la CRL. Muchos de estos pueden dar lugar a
varias coincidencias.

OutputFile es el archivo que se usa para guardar los certificados coincidentes.

Opciones:

Símbolo del sistema de Windows

[-f] [-Enterprise] [-user] [-GroupPolicy] [-dc DCName]

La opción -user accede a un almacén de usuarios en lugar de a un almacén de


máquinas.
La opción -enterprise accede a un almacén empresarial de máquinas.
La opción -service accede a un almacén de servicio de máquina.
La opción -grouppolicy accede a un almacén de directivas de grupo de máquinas.

Por ejemplo:

-enterprise NTAuth

-enterprise Root 37
-user My 26e0aaaf000000000004

CA .11
-UI
Invoca la interfaz de certutil.

Símbolo del sistema de Windows

certutil [options] -UI File [import]

-TPMInfo
Muestra información del módulo de plataforma segura.

Símbolo del sistema de Windows

certutil [options] -TPMInfo

Opciones:

Símbolo del sistema de Windows

[-f] [-Silent] [-split]

-attest
Especifica que se debe atestiguar el archivo de solicitud de certificado.

Símbolo del sistema de Windows

certutil [options] -attest RequestFile

Opciones:

Símbolo del sistema de Windows

[-user] [-Silent] [-split]

-getcert
Selecciona un certificado de una interfaz de usuario de selección.

Símbolo del sistema de Windows


certutil [options] [ObjectId | ERA | KRA [CommonName]]

Opciones:

Símbolo del sistema de Windows

[-Silent] [-split]

-ds
Muestra nombres distintivos (DN) del servicio de directorios (DS).

Símbolo del sistema de Windows

certutil [options] -ds [CommonName]

Opciones:

Símbolo del sistema de Windows

[-f] [-user] [-split] [-dc DCName]

-dsDel
Elimina los DN de DS.

Símbolo del sistema de Windows

certutil [options] -dsDel [CommonName]

Opciones:

Símbolo del sistema de Windows

[-user] [-split] [-dc DCName]

-dsPublish
Publica un certificado o una lista de revocación de certificados (CRL) en Active Directory.

Símbolo del sistema de Windows


certutil [options] -dspublish CertFile [NTAuthCA | RootCA | SubCA | CrossCA
| KRA | User | Machine]
certutil [options] -dspublish CRLfile [DSCDPContainer [DSCDPCN]]

Donde:

CertFile es el nombre del archivo de certificado que se va a publicar.


NTAuthCA publica el certificado en el almacén de DS Enterprise.
RootCA publica el certificado en el almacén raíz de confianza de DS.
SubCA publica el certificado de entidad de certificación en el objeto de entidad de
certificación de DS.
CrossCA publica el certificado cruzado en el objeto de entidad de certificación de
DS.
KRA publica el certificado en el objeto Key Recovery Agent de DS.
User publica el certificado en el objeto User de DS.
Machine publica el certificado en el objeto Machine de DS.
CRLfile es el nombre del archivo CRL que se va a publicar.
DSCDPContainer es el CN del contenedor CDP de DS, normalmente el nombre de
la máquina de la entidad de certificación.
DSCDPCN es el CN del objeto CDP de DS basado en el nombre corto y el índice de
clave de la entidad de certificación saneados.

Opciones:

Símbolo del sistema de Windows

[-f] [-user] [-dc DCName]

Use -f para crear un nuevo objeto de DS.

-dsCert
Muestra los certificados DS.

Símbolo del sistema de Windows

certutil [options] -dsCert [FullDSDN] | [CertId [OutFile]]

Opciones:

Símbolo del sistema de Windows


[-Enterprise] [-user] [-config Machine\CAName] [-dc DCName]

-dsCRL
Muestra las CRL de DS.

Símbolo del sistema de Windows

certutil [options] -dsCRL [FullDSDN] | [CRLIndex [OutFile]]

Opciones:

Símbolo del sistema de Windows

[-idispatch] [-Enterprise] [-user] [-config Machine\CAName] [-dc DCName]

-dsDeltaCRL
Muestra las CRL delta de DS.

Símbolo del sistema de Windows

certutil [options] -dsDeltaCRL [FullDSDN] | [CRLIndex [OutFile]]

Opciones:

Símbolo del sistema de Windows

[-Enterprise] [-user] [-config Machine\CAName] [-dc DCName]

-dsTemplate
Muestra los atributos de plantilla de DS.

Símbolo del sistema de Windows

certutil [options] -dsTemplate [Template]

Opciones:

Símbolo del sistema de Windows


[Silent] [-dc DCName]

-dsAddTemplate
Agrega plantillas de DS.

Símbolo del sistema de Windows

certutil [options] -dsAddTemplate TemplateInfFile

Opciones:

Símbolo del sistema de Windows

[-dc DCName]

-ADTemplate
Muestra plantillas de Active Directory.

Símbolo del sistema de Windows

certutil [options] -ADTemplate [Template]

Opciones:

Símbolo del sistema de Windows

[-f] [-user] [-ut] [-mt] [-dc DCName]

-Template
Muestra las plantillas de directiva de inscripción de certificados.

Opciones:

Símbolo del sistema de Windows

certutil [options] -Template [Template]

Opciones:
Símbolo del sistema de Windows

[-f] [-user] [-Silent] [-PolicyServer URLOrId] [-Anonymous] [-Kerberos] [-


ClientCertificate ClientCertId] [-UserName UserName] [-p Password]

-TemplateCA
Muestra las entidades de certificación (CA) de una plantilla de certificado.

Símbolo del sistema de Windows

certutil [options] -TemplateCAs Template

Opciones:

Símbolo del sistema de Windows

[-f] [-user] [-dc DCName]

-CATemplates
Muestra plantillas para la entidad de certificación.

Símbolo del sistema de Windows

certutil [options] -CATemplates [Template]

Opciones:

Símbolo del sistema de Windows

[-f] [-user] [-ut] [-mt] [-config Machine\CAName] [-dc DCName]

-SetCATemplates
Establece las plantillas de certificado que puede emitir la entidad de certificación.

Símbolo del sistema de Windows

certutil [options] -SetCATemplates [+ | -] TemplateList


Donde:

El signo + agrega plantillas de certificado a la lista de plantillas disponibles de la


entidad de certificación.
El signo - quita plantillas de certificado de la lista de plantillas disponibles de la
entidad de certificación.

-SetCASites
Administra los nombres de sitio, incluida la configuración, comprobación y eliminación
de nombres de sitio de la entidad de certificación.

Símbolo del sistema de Windows

certutil [options] -SetCASites [set] [SiteName]


certutil [options] -SetCASites verify [SiteName]
certutil [options] -SetCASites delete

Donde:

SiteName solo se permite cuando el destino es una única entidad de certificación.

Opciones:

Símbolo del sistema de Windows

[-f] [-config Machine\CAName] [-dc DCName]

Comentarios
La opción -config tiene como destino una única entidad de certificación (el valor
predeterminado son todas las entidades de certificación).
La opción -f se puede usar para invalidar los errores de validación del valor
SiteName especificado, o bien para eliminar todos los nombres de sitio de la
entidad de certificación.

7 Nota

Para más información sobre la configuración de entidades de certificación para el


reconocimiento del sitio de Active Directory Domain Services (AD DS), consulte
Reconocimiento del sitio de AD DS para clientes de AD CS y PKI.
-enrollmentServerURL
Muestra, agrega o elimina las direcciones URL del servidor de inscripción asociadas a
una entidad de certificación.

Símbolo del sistema de Windows

certutil [options] -enrollmentServerURL [URL AuthenticationType [Priority]


[Modifiers]]
certutil [options] -enrollmentserverURL URL delete

Donde:

AuthenticationType especifica uno de los métodos de autenticación de cliente


siguientes, al agregar una dirección URL:
Kerberos: usa las credenciales SSL de Kerberos.
.: usa una cuenta con nombre para las credenciales SSL.
ClientCertificate: usa credenciales SSL de certificado X.509.
Anonymous: usa credenciales SSL anónimas.
delete elimina la dirección URL especificada asociada a la entidad de certificación.
Priority tiene como valor predeterminado 1 si no se especifica al agregar una
dirección URL.
Modifiers es una lista separada por comas, que incluye uno o varios de los
siguientes elementos:
AllowRenewalsOnly: solo se pueden enviar solicitudes de renovación a esta
entidad de certificación mediante esta dirección URL.
AllowKeyBasedRenewal: permite el uso de un certificado que no tiene ninguna
cuenta asociada en AD. Esto solo se aplica con el modo ClientCertificate y
AllowRenewalsOnly.

Opciones:

Símbolo del sistema de Windows

[-config Machine\CAName] [-dc DCName]

-ADCA
Muestra las entidades de certificación de Active Directory.

Símbolo del sistema de Windows


certutil [options] -ADCA [CAName]

Opciones:

Símbolo del sistema de Windows

[-f] [-split] [-dc DCName]

-CA
Muestra las entidades de certificación de la directiva de inscripción.

Símbolo del sistema de Windows

certutil [options] -CA [CAName | TemplateName]

Opciones:

Símbolo del sistema de Windows

[-f] [-user] [-Silent] [-split] [-PolicyServer URLOrId] [-Anonymous] [-


Kerberos] [-ClientCertificate ClientCertId] [-UserName UserName] [-p
Password]

-Policy
Muestra la directiva de inscripción.

Símbolo del sistema de Windows

certutil [options] -Policy

Opciones:

Símbolo del sistema de Windows

[-f] [-user] [-Silent] [-split] [-PolicyServer URLOrId] [-Anonymous] [-


Kerberos] [-ClientCertificate ClientCertId] [-UserName UserName] [-p
Password]

-PolicyCache
Muestra o elimina entradas de caché de directivas de inscripción.

Símbolo del sistema de Windows

certutil [options] -PolicyCache [delete]

Donde:

delete elimina las entradas de caché del servidor de directivas.


-f elimina todas las entradas de caché.

Opciones:

Símbolo del sistema de Windows

[-f] [-user] [-policyserver URLorID]

-CredStore
Muestra, agrega o elimina entradas del almacén de credenciales.

Símbolo del sistema de Windows

certutil [options] -CredStore [URL]


certutil [options] -CredStore URL add
certutil [options] -CredStore URL delete

Donde:

URL es la dirección URL de destino. También puede usar * para buscar


coincidencias con todas las entradas o https://machine* para que coincidan con
un prefijo de dirección URL.
add agrega una entrada de almacén de credenciales. El uso de esta opción
también requiere el uso de credenciales SSL.
delete elimina las entradas del almacén de credenciales.
-f sobrescribe una sola entrada o elimina varias entradas.

Opciones:

Símbolo del sistema de Windows

[-f] [-user] [-Silent] [-Anonymous] [-Kerberos] [-ClientCertificate


ClientCertId] [-UserName UserName] [-p Password]
-InstallDefaultTemplates
Instala las plantillas de certificado predeterminadas.

Símbolo del sistema de Windows

certutil [options] -InstallDefaultTemplates

Opciones:

Símbolo del sistema de Windows

[-dc DCName]

-URL
Comprueba las direcciones URL de certificado o CRL.

Símbolo del sistema de Windows

certutil [options] -URL InFile | URL

Opciones:

Símbolo del sistema de Windows

[-f] [-split]

-URLCache
Muestra o elimina entradas de caché de direcciones URL.

Símbolo del sistema de Windows

certutil [options] -URLcache [URL | CRL | * [delete]]

Donde:

URL es la dirección URL almacenada en caché.


CRL solo se ejecuta en todas las direcciones URL de CRL almacenadas en caché.
* funciona en todas las direcciones URL almacenadas en caché.
delete elimina las direcciones URL pertinentes de la caché local del usuario actual.
-f fuerza la captura de una dirección URL específica y la actualización de la
memoria caché.

Opciones:

Símbolo del sistema de Windows

[-f] [-split]

-pulse
Pulsa un evento de inscripción automática o una tarea NGC.

Símbolo del sistema de Windows

certutil [options] -pulse [TaskName [SRKThumbprint]]

Donde:

TaskName es la tarea que se va a desencadenar.


Pregen es la tarea de pregen de la clave NGC.
AIKEnroll es la tarea de inscripción de certificados AIK de NGC. (El valor
predeterminado es el evento de inscripción automática).
SRKThumbprint es la huella digital de la clave raíz de almacenamiento
Modificadores:
Pregen
PregenDelay
AIKEnroll
CryptoPolicy
NgcPregenKey
DIMSRoam

Opciones:

Símbolo del sistema de Windows

[-user]

-MachineInfo
Muestra información sobre el objeto de máquina de Active Directory.
Símbolo del sistema de Windows

certutil [options] -MachineInfo DomainName\MachineName$

-DCInfo
Muestra información sobre el controlador de dominio. El valor predeterminado muestra
los certificados de controlador de dominio sin comprobación.

Símbolo del sistema de Windows

certutil [options] -DCInfo [Domain] [Verify | DeleteBad | DeleteAll]

Modificadores:
Comprobar
DeleteBad
DeleteAll

Opciones:

Símbolo del sistema de Windows

[-f] [-user] [-urlfetch] [-dc DCName] [-t Timeout]

 Sugerencia

La capacidad de especificar un dominio de Active Directory Domain Services (AD


DS) [Dominio] y especificar un controlador de dominio (-dc) se agregó en
Windows Server 2012. Para ejecutar correctamente el comando, debe usar una
cuenta que sea miembro de administradores de dominio o administradores de
empresa. Las modificaciones de comportamiento de este comando son las
siguientes:

Si no se especifica un dominio ni un controlador de dominio específico, esta


opción devuelve una lista de controladores de dominio para procesar desde
el controlador de dominio predeterminado.
Si no se especifica un dominio, pero sí un controlador de dominio, se genera
un informe de los certificados en el controlador de dominio especificado.
Si se especifica un dominio, pero no un controlador de dominio, se genera
una lista de controladores de dominio junto con informes sobre los
certificados de cada controlador de dominio de la lista.
Si se especifican el dominio y el controlador de dominio, se genera una lista
de controladores de dominio a partir del controlador de dominio de destino.
También se genera un informe de los certificados de cada controlador de
dominio de la lista.

Por ejemplo, supongamos que hay un dominio denominado CPANDL con un


controlador de dominio denominado CPANDL-DC1. Puede ejecutar el siguiente
comando para recuperar una lista de controladores de dominio y sus certificados
de CPANDL-DC1: certutil -dc cpandl-dc1 -DCInfo cpandl .

-EntInfo
Muestra información sobre una entidad de certificación empresarial.

Símbolo del sistema de Windows

certutil [options] -EntInfo DomainName\MachineName$

Opciones:

Símbolo del sistema de Windows

[-f] [-user]

-TCAInfo
Muestra información sobre la entidad de certificación.

Símbolo del sistema de Windows

certutil [options] -TCAInfo [DomainDN | -]

Opciones:

Símbolo del sistema de Windows

[-f] [-Enterprise] [-user] [-urlfetch] [-dc DCName] [-t Timeout]

-SCInfo
Muestra información sobre la tarjeta inteligente.

Símbolo del sistema de Windows

certutil [options] -scinfo [ReaderName [CRYPT_DELETEKEYSET]]

Donde:

CRYPT_DELETEKEYSET elimina todas las claves de la tarjeta inteligente.

Opciones:

Símbolo del sistema de Windows

[-Silent] [-split] [-urlfetch] [-t Timeout]

-SCRoots
Administra certificados raíz de tarjeta inteligente.

Símbolo del sistema de Windows

certutil [options] -SCRoots update [+][InputRootFile] [ReaderName]


certutil [options] -SCRoots save @OutputRootFile [ReaderName]
certutil [options] -SCRoots view [InputRootFile | ReaderName]
certutil [options] -SCRoots delete [ReaderName]

Opciones:

Símbolo del sistema de Windows

[-f] [-split] [-p Password]

-key
Enumera las claves almacenadas en un contenedor de claves.

Símbolo del sistema de Windows

certutil [options] -key [KeyContainerName | -]

Donde:
KeyContainerName es el nombre del contenedor de claves para la clave que se va
a comprobar. Esta opción tiene como valor predeterminado las claves de máquina.
Para cambiar a las claves de usuario, use -user .
El signo - hace referencia al uso del contenedor de claves predeterminado.

Opciones:

Símbolo del sistema de Windows

[-user] [-Silent] [-split] [-csp Provider] [-Location


AlternateStorageLocation]

-delkey
Elimina el contenedor de claves con nombre.

Símbolo del sistema de Windows

certutil [options] -delkey KeyContainerName

Opciones:

Símbolo del sistema de Windows

[-user] [-Silent] [-split] [-csp Provider] [-Location


AlternateStorageLocation]

-DeleteHelloContainer
Elimina el contenedor de Windows Hello, quitando todas las credenciales asociadas
almacenadas en el dispositivo, incluidas las credenciales de WebAuthn y FIDO.

Los usuarios tienen que cerrar sesión después de usar esta opción para que se
complete.

Símbolo del sistema de Windows

certutil [options] -DeleteHelloContainer

-verifykeys
Comprueba un conjunto de claves públicas o privadas.
Símbolo del sistema de Windows

certutil [options] -verifykeys [KeyContainerName CACertFile]

Donde:

KeyContainerName es el nombre del contenedor de claves para la clave que se va


a comprobar. Esta opción tiene como valor predeterminado las claves de máquina.
Para cambiar a las claves de usuario, use -user .
CACertFile firma o cifra los archivos de certificado.

Opciones:

Símbolo del sistema de Windows

[-f] [-user] [-Silent] [-config Machine\CAName]

Comentarios
Si no se especifica ningún argumento, cada certificado de entidad de certificación
de firma se comprueba con su clave privada.
Esta operación solo se puede realizar en una entidad de certificación local o en
claves locales.

-verify
Comprueba un certificado, una lista de revocación de certificados (CRL) o una cadena de
certificados.

Símbolo del sistema de Windows

certutil [options] -verify CertFile [ApplicationPolicyList | -


[IssuancePolicyList]] [Modifiers]
certutil [options] -verify CertFile [CACertFile [CrossedCACertFile]]
certutil [options] -verify CRLFile CACertFile [IssuedCertFile]
certutil [options] -verify CRLFile CACertFile [DeltaCRLFile]

Donde:

CertFile es el nombre del certificado que se va a comprobar.


ApplicationPolicyList es la lista opcional separada por comas de los identificadores
de objeto de directiva de aplicación necesarios.
IssuancePolicyList es la lista opcional separada por comas de los identificadores de
objeto de directiva de emisión necesarios.
CACertFile es el certificado de entidad de certificación emisora opcional con el que
se va a realizar la comprobación.
CrossedCACertFile es el certificado opcional con certificación cruzada por CertFile.
CRLFile es el archivo CRL que se usa para comprobar CACertFile.
IssuedCertFile es el certificado emitido opcional cubierto por el archivo CRL.
DeltaCRLFile es el archivo CRL delta opcional.
Modificadores:
Strong: comprobación de firma segura
MSRoot: debe encadenar a una raíz de Microsoft
MSTestRoot: debe encadenar a una raíz de prueba de Microsoft
AppRoot: debe encadenar a una raíz de aplicación de Microsoft
EV: aplicación de la directiva de validación extendida

Opciones:

Símbolo del sistema de Windows

[-f] [-Enterprise] [-user] [-Silent] [-split] [-urlfetch] [-t Timeout] [-


sslpolicy ServerName]

Comentarios
El uso de ApplicationPolicyList restringe la creación de cadenas solo a cadenas
válidas para las directivas de aplicación especificadas.
El uso de IssuancePolicyList restringe la creación de cadenas solo a cadenas
válidas para las directivas de emisión especificadas.
El uso de CACertFile comprueba los campos del archivo en CertFile o CRLfile.
Si no se especifica CACertFile, se crea la cadena completa y se comprueba en
CertFile.
Si se especifican CACertFile y CrossedCACertFile, los campos de ambos archivos
se comprueban en CertFile.
El uso de IssuedCertFile comprueba los campos del archivo en CRLfile.
El uso de DeltaCRLFile comprueba los campos del archivo en CertFile.

-verifyCTL
Comprueba el CTL de certificados AuthRoot o Disallowed.

Símbolo del sistema de Windows


certutil [options] -verifyCTL CTLobject [CertDir] [CertFile]

Donde:

CTLObject identifica el CTL que se va a comprobar, incluido lo siguiente:


AuthRootWU lee el CAB de AuthRoot y los certificados coincidentes de la caché
de direcciones URL. Use -f para descargar desde Windows Update en su lugar.
DisallowedWU lee el CAB de certificados no permitidos y el archivo de almacén
de certificados no permitidos de la caché de direcciones URL. Use -f para
descargar desde Windows Update en su lugar.
PinRulesWU lee el CAB de PinRules de la caché de direcciones URL. Use -f
para descargar desde Windows Update en su lugar.
AuthRoot lee el CTL de AuthRoot en la caché del Registro. Úselo con -f y un
CertFile que no sea de confianza para forzar la AuthRootde los CTL de
certificado AuthRoot y Disallowed en caché del Registro.
Disallowed lee el CTL de certificados Disallowed almacenados en caché en el
Registro. Úselo con -f y un CertFile que no sea de confianza para forzar la
AuthRootde los CTL de certificado AuthRoot y Disallowed en caché del Registro.
PinRules lee el CTL de PinRules almacenado en caché del Registro. El uso de
-f tiene el mismo comportamiento que con PinRulesWU.

CTLFileName especifica el archivo o la ruta de acceso http al archivo CTL o CAB.

CertDir especifica la carpeta que contiene certificados que coinciden con las
entradas de CTL. El valor predeterminado es la misma carpeta o sitio web que el
CTLobject. El uso de una ruta de acceso de carpeta http requiere un separador de
rutas de acceso al final. Si no especifica AuthRoot o Disallowed, los certificados
coincidentes se buscan en varias ubicaciones, incluidos almacenes de certificados
locales, recursos crypt32.dll y la caché de direcciones URL local. Use -f para
descargar desde Windows Update, según sea necesario.

CertFile especifica los certificados que se van a comprobar. Los certificados se


comparan con las entradas de CTL, mostrando los resultados. Esta opción suprime
la mayoría de las salidas predeterminadas.

Opciones:

Símbolo del sistema de Windows

[-f] [-user] [-split]


-syncWithWU
Sincroniza certificados con Windows Update.

Símbolo del sistema de Windows

certutil [options] -syncWithWU DestinationDir

Donde:

DestinationDir es el directorio especificado.


f fuerza una sobrescritura.
Unicode escribe la salida redirigida en Unicode.
gmt muestra las horas como GMT.
seconds muestra las horas con segundos y milisegundos.
v es una operación detallada.
PIN es el PIN de tarjeta inteligente.
WELL_KNOWN_SID_TYPE es un SID numérico:
22: Sistema local
23: servicio local
24: Servicio de red

Comentarios
Los siguientes archivos se descargan mediante el mecanismo de actualización
automática:

authrootstl.cab contiene las CTL de certificados raíz que no son de Microsoft.


disallowedcertstl.cab contiene las CTL de certificados que no son de confianza.
disallowedcert.sst contiene el almacén de certificados en serie, incluidos los que no
son de confianza.
thumbprint.crt contiene certificados raíz que no son de Microsoft.

Por ejemplo, certutil -syncWithWU \\server1\PKI\CTLs .

Si usa como carpeta de destino una carpeta o una ruta de acceso local que no
existen, verá el error The system can't find the file specified. 0x80070002
(WIN32: 2 ERROR_FILE_NOT_FOUND)

Si usa como carpeta de destino una ubicación de red que no existe o no está
disponible, verá el error The network name can't be found. 0x80070043 (WIN32: 67
ERROR_BAD_NET_NAME)
Si el servidor no puede conectarse desde el puerto TCP 80 a los servidores de
actualización automática de Microsoft, se le notificará el error A connection with
the server couldn't be established 0x80072efd (INet: 12029
ERROR_INTERNET_CANNOT_CONNECT)

Si el servidor no puede obtener acceso a los servidores de actualización


automática de Microsoft con el nombre DNS ctldl.windowsupdate.com , se le
notificará el error The server name or address couldn't be resolved 0x80072ee7
(INet: 12007 ERROR_INTERNET_NAME_NOT_RESOLVED).

Si no usa el conmutador -f , y si alguno de los archivos CTL ya existe en el


directorio, recibirá un error certutil: -syncWithWU command FAILED: 0x800700b7
(WIN32/HTTP: 183 ERROR_ALREADY_EXISTS) Certutil: Can't create a file when that
file already exists. de que ya existe el archivo

Si se produce un cambio en los certificados raíz de confianza, verá Warning!


Encountered the following no longer trusted roots: <folder path>\

<thumbprint>.crt. Use "-f" option 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.

Opciones:

Símbolo del sistema de Windows

[-f] [-Unicode] [-gmt] [-seconds] [-v] [-privatekey] [-pin PIN] [-sid


WELL_KNOWN_SID_TYPE]

-generateSSTFromWU
Genera un archivo de almacén que se sincroniza con Windows Update.

Símbolo del sistema de Windows

certutil [options] -generateSSTFromWU SSTFile

Donde:

SSTFile es el archivo .sst que se va a generar y que contiene las raíces de terceros
descargadas de Windows Update.

Opciones:
Símbolo del sistema de Windows

[-f] [-split]

-generatePinRulesCTL
Genera un archivo de lista de confianza de certificados (CTL) que contiene una lista de
reglas de asignación.

Símbolo del sistema de Windows

certutil [options] -generatePinRulesCTL XMLFile CTLFile [SSTFile


[QueryFilesPrefix]]

Donde:

XMLFile es el archivo XML de entrada que se va a analizar.


CTLFile es el archivo CTL de salida que se va a generar.
SSTFile es el archivo .sst opcional que se va a crear y que contiene todos los
certificados usados para la asignación.
QueryFilesPrefix son archivos Domains.csv y Keys.csv opcionales que se van a crear
para la consulta de base de datos.
La cadena QueryFilesPrefix se antepone a cada archivo creado.
El archivo Domains.csv contiene el nombre de regla, las filas de dominio.
El archivo Keys.csv contiene el nombre de la regla, las filas de huella digital
SHA256 de clave.

Opciones:

Símbolo del sistema de Windows

[-f]

-downloadOcsp
Descarga las respuestas OCSP y escribe en el directorio.

Símbolo del sistema de Windows

certutil [options] -downloadOcsp CertificateDir OcspDir [ThreadCount]


[Modifiers]
Donde:

CertificateDir es el directorio de un certificado, un almacén y archivos PFX.


OcspDir es el directorio para escribir respuestas OCSP.
ThreadCount es el número máximo opcional de subprocesos para la descarga
simultánea. El valor predeterminado es 10.
Modifiers es la lista separada por comas para uno o varios de los siguientes
elementos:
DownloadOnce: descarga una vez y sale.
ReadOcsp: lee de OcspDir en lugar de escribir.

-generateHpkpHeader
Genera el encabezado HPKP mediante certificados en un archivo o directorio
especificados.

Símbolo del sistema de Windows

certutil [options] -generateHpkpHeader CertFileOrDir MaxAge [ReportUri]


[Modifiers]

Donde:

CertFileOrDir es el archivo o directorio de certificados, que es el origen de pin-


sha256.
MaxAge es el valor de antigüedad máxima en segundos.
ReportUri es el URI de informe opcional.
Modifiers es la lista separada por comas para uno o varios de los siguientes
elementos:
includeSubDomains: anexa includeSubDomains.

-flushCache
Vacía las memorias caché especificadas en el proceso seleccionado, como lsass.exe.

Símbolo del sistema de Windows

certutil [options] -flushCache ProcessId CacheMask [Modifiers]

Donde:
ProcessId es el identificador numérico de un proceso que se va a vaciar.
Establézcalo en 0 para vaciar todos los procesos en los que está habilitado el
vaciado.

CacheMask es la máscara de bits de las memorias caché que se van a vaciar, ya


sean numéricas o los bits siguientes:
0: ShowOnly
0x01: CERT_WNF_FLUSH_CACHE_REVOCATION
0x02: CERT_WNF_FLUSH_CACHE_OFFLINE_URL
0x04: CERT_WNF_FLUSH_CACHE_MACHINE_CHAIN_ENGINE
0x08: CERT_WNF_FLUSH_CACHE_USER_CHAIN_ENGINES
0x10: CERT_WNF_FLUSH_CACHE_SERIAL_CHAIN_CERTS
0x20: CERT_WNF_FLUSH_CACHE_SSL_TIME_CERTS
0x40: CERT_WNF_FLUSH_CACHE_OCSP_STAPLING

Modifiers es la lista separada por comas para uno o varios de los siguientes
elementos:
Show: muestra las memorias caché que se vacían. Certutil se debe terminar de
forma explícita.

-addEccCurve
Agrega una curva ECC.

Símbolo del sistema de Windows

certutil [options] -addEccCurve [CurveClass:]CurveName CurveParameters


[CurveOID] [CurveType]

Donde:

CurveClass es el tipo de clase de la curva ECC:


WEIERSTRASS (valor predeterminado)
MONTGOMERY
TWISTED_EDWARDS

CurveName es el nombre de la curva ECC.

CurveParameters es uno de los siguientes:


Un nombre de archivo de certificado que contiene parámetros codificados por
ASN.
Un archivo que contiene parámetros codificados por ASN.
CurveOID es el OID de la curva ECC y es uno de los siguientes:
Un nombre de archivo de certificado que contiene un OID codificado por ASN.
Un OID explícito de la curva ECC.

CurveType es el punto de Schannel ECC NamedCurve (numérico).

Opciones:

Símbolo del sistema de Windows

[-f]

-deleteEccCurve
Elimina la curva ECC.

Símbolo del sistema de Windows

certutil [options] -deleteEccCurve CurveName | CurveOID

Donde:

CurveName es el nombre de la curva ECC.


CurveOID es el OID de la curva ECC.

Opciones:

Símbolo del sistema de Windows

[-f]

-displayEccCurve
Muestra la curva ECC.

Símbolo del sistema de Windows

certutil [options] -displayEccCurve [CurveName | CurveOID]

Donde:

CurveName es el nombre de la curva ECC.


CurveOID es el OID de la curva ECC.
Opciones:

Símbolo del sistema de Windows

[-f]

-csplist
Enumera los proveedores de servicios criptográficos (CSP) instalados en esta máquina
para las operaciones criptográficas.

Símbolo del sistema de Windows

certutil [options] -csplist [Algorithm]

Opciones:

Símbolo del sistema de Windows

[-user] [-Silent] [-csp Provider]

-csptest
Comprueba los CSP instalados en esta máquina.

Símbolo del sistema de Windows

certutil [options] -csptest [Algorithm]

Opciones:

Símbolo del sistema de Windows

[-user] [-Silent] [-csp Provider]

-CNGConfig
Muestra la configuración criptográfica de CNG en esta máquina.

Símbolo del sistema de Windows


certutil [options] -CNGConfig

Opciones:

Símbolo del sistema de Windows

[-Silent]

-sign
Vuelva a firmar una lista de revocación de certificados (CRL) o un certificado.

Símbolo del sistema de Windows

certutil [options] -sign InFileList | SerialNumber | CRL OutFileList


[StartDate [+ | -dd:hh] + | -dd:hh] [+SerialNumberList | -SerialNumberList |
-ObjectIdList | @ExtensionFile]
certutil [options] -sign InFileList | SerialNumber | CRL OutFileList
[#HashAlgorithm] [+AlternateSignatureAlgorithm | -
AlternateSignatureAlgorithm]
certutil [options] -sign InFileList OutFileList [Subject:CN=...] [Issuer:hex
data]

Donde:

InFileList es la lista separada por comas de archivos de certificado o CRL que se


van a modificar y volver a firmar.

SerialNumber es el número de serie del certificado que se va a crear. El período de


validez y otras opciones no pueden estar presentes.

CRL crea una CRL vacía. El período de validez y otras opciones no pueden estar
presentes.

OutFileList es la lista separada por comas de archivos de salida de CRL o


certificados modificados. El número de archivos debe coincidir con infilelist.

StartDate+dd:hh es el nuevo período de validez para los archivos de certificado o


CRL, entre los que se incluyen los siguientes:
fecha opcional más
período de validez de días y horas opcionales Si se usan varios campos, use un
separador (+) o (-). Use now[+dd:hh] para iniciar en la hora actual. Use now-
dd:hh+dd:hh para el inicio en un desplazamiento fijo desde la hora actual y un
período de validez fijo. Use never para no tener ninguna fecha de expiración
(solo para CRL).

SerialNumberList es la lista de números de serie separados por comas de los


archivos que se van a agregar o quitar.

ObjectIdList es la lista ObjectId de extensiones separada por comas de los archivos


que se van a quitar.

@ExtensionFile es el archivo INF que contiene las extensiones que se van a


actualizar o quitar. Por ejemplo:

Símbolo del sistema de Windows

[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 es el nombre del algoritmo hash. Este solo debe ser el texto
precedido por el signo # .

AlternateSignatureAlgorithm es el especificador de algoritmo de firma alternativo.

Opciones:

Símbolo del sistema de Windows

[-nullsign] [-f] [-user] [-Silent] [-Cert CertId] [-csp Provider]

Comentarios

El uso del signo menos (-) quita los números de serie y las extensiones.
El uso del signo más (+) agrega números de serie a una CRL.
Puede usar una lista para quitar los números de serie y los valores ObjectId de una
CRL al mismo tiempo.
El uso del signo menos antes de AlternateSignatureAlgorithm permite utilizar el
formato de firma heredado.
El uso del signo más le permite usar el formato de firma alternativo.
Si no especifica AlternateSignatureAlgorithm, se usa el formato de firma en el
certificado o CRL.

-vroot
Crea o elimina raíces virtuales web y recursos compartidos de archivos.

Símbolo del sistema de Windows

certutil [options] -vroot [delete]

-vocsproot
Crea o elimina raíces virtuales web para un proxy web OCSP.

Símbolo del sistema de Windows

certutil [options] -vocsproot [delete]

-addEnrollmentServer
Agrega una aplicación del servidor de inscripción y un grupo de aplicaciones si es
necesario, para la entidad de certificación especificada. Este comando no instala
archivos binarios ni paquetes.

Símbolo del sistema de Windows

certutil [options] -addEnrollmentServer Kerberos | UserName |


ClientCertificate [AllowRenewalsOnly] [AllowKeyBasedRenewal]

Donde:

addEnrollmentServer requiere que use un método de autenticación para la


conexión de cliente con el servidor de inscripción de certificados, entre los que se
incluyen:
Kerberos usa credenciales SSL de Kerberos.
UserName usa la cuenta con nombre para las credenciales SSL.
ClientCertificate usa credenciales SSL de certificado X.509.

Modificadores:
AllowRenewalsOnly solo permite envíos de solicitudes de renovación a la
entidad de certificación desde la dirección URL.
AllowKeyBasedRenewal permite el uso de un certificado sin ninguna cuenta
asociada en Active Directory. Esto se aplica cuando se usa con el modo
ClientCertificate y AllowRenewalsOnly.

Opciones:
Símbolo del sistema de Windows

[-config Machine\CAName]

-deleteEnrollmentServer
Elimina una aplicación del servidor de inscripción y un grupo de aplicaciones si es
necesario, para la entidad de certificación especificada. Este comando no instala
archivos binarios ni paquetes.

Símbolo del sistema de Windows

certutil [options] -deleteEnrollmentServer Kerberos | UserName |


ClientCertificate

Donde:

deleteEnrollmentServer requiere que use un método de autenticación para la


conexión de cliente con el servidor de inscripción de certificados, entre los que se
incluyen:
Kerberos usa credenciales SSL de Kerberos.
UserName usa la cuenta con nombre para las credenciales SSL.
ClientCertificate usa credenciales SSL de certificado X.509.

Opciones:

Símbolo del sistema de Windows

[-config Machine\CAName]

-addPolicyServer
Agrega una aplicación del servidor de directivas y un grupo de aplicaciones, si es
necesario. Este comando no instala archivos binarios ni paquetes.

Símbolo del sistema de Windows

certutil [options] -addPolicyServer Kerberos | UserName | ClientCertificate


[KeyBasedRenewal]

Donde:
addPolicyServer requiere que use un método de autenticación para la conexión de
cliente con el servidor de directivas de certificados, entre los que se incluyen:
Kerberos usa credenciales SSL de Kerberos.
UserName usa la cuenta con nombre para las credenciales SSL.
ClientCertificate usa credenciales SSL de certificado X.509.
KeyBasedRenewal permite el uso de directivas devueltas al cliente con plantillas
keybasedrenewal. Esta opción solo se aplica a la autenticación UserName y
ClientCertificate.

-deletePolicyServer
Elimina una aplicación del servidor de directivas y un grupo de aplicaciones, si es
necesario. Este comando no quita archivos binarios ni paquetes.

Símbolo del sistema de Windows

certutil [options] -deletePolicyServer Kerberos | UserName |


ClientCertificate [KeyBasedRenewal]

Donde:

deletePolicyServer requiere que se use un método de autenticación para la


conexión de cliente con el servidor de directivas de certificados, entre los que se
incluyen:
Kerberos usa credenciales SSL de Kerberos.
UserName usa la cuenta con nombre para las credenciales SSL.
ClientCertificate usa credenciales SSL de certificado X.509.
KeyBasedRenewal permite el uso de un servidor de directivas KeyBasedRenewal.

-Class
Muestra información del registro COM.

Símbolo del sistema de Windows

certutil [options] -Class [ClassId | ProgId | DllName | *]

Opciones:

Símbolo del sistema de Windows

[-f]
-7f
Comprueba en el certificado codificaciones de longitud de 0x7f.

Símbolo del sistema de Windows

certutil [options] -7f CertFile

-oid
Muestra el identificador de objeto o establece un nombre para mostrar.

Símbolo del sistema de Windows

certutil [options] -oid ObjectId [DisplayName | delete [LanguageId [type]]]


certutil [options] -oid GroupId
certutil [options] -oid AlgId | AlgorithmName [GroupId]

Donde:

ObjectId es el identificador que se va a mostrar o agregar al nombre para mostrar.


GroupId es el número GroupId (decimal) que enumeran los identificadores de
objeto.
AlgId es el identificador hexadecimal que busca objectID.
AlgorithmName es el nombre del algoritmo que busca objectID.
DisplayName muestra el nombre que se va a almacenar en DS.
Delete elimina el nombre para mostrar.
LanguageId es el valor del identificador de idioma (el valor predeterminado es
actual: 1033).
Type es el tipo de objeto DS que se va a crear, entre los que se incluyen:
1 : plantilla (valor predeterminado)

2 : directiva de emisión
3 : directiva de aplicación

-f crea un objeto DS.

Opciones:

Símbolo del sistema de Windows

[-f]
-error
Muestra el texto del mensaje asociado a un código de error.

Símbolo del sistema de Windows

certutil [options] -error ErrorCode

-getsmtpinfo
Obtiene información del Protocolo simple de transferencia de correo (SMTP).

Símbolo del sistema de Windows

certutil [options] -getsmtpinfo

-setsmtpinfo
Establece información de SMTP.

Símbolo del sistema de Windows

certutil [options] -setsmtpinfo LogonName

Opciones:

Símbolo del sistema de Windows

[-config Machine\CAName] [-p Password]

-getreg
Muestra un valor del Registro.

Símbolo del sistema de Windows

certutil [options] -getreg [{ca | restore | policy | exit | template |


enroll | chain | PolicyServers}\[ProgId\]] [RegistryValueName]

Donde:

ca usa la clave del Registro de una entidad de certificación.


restore usa la clave del Registro de restauración de la entidad de certificación.
policy usa la clave del Registro del módulo de directivas.
exit usa la primera clave del Registro del módulo de salida.
template usa la clave del Registro de plantilla (use -user para plantillas de
usuario).
enroll usa la clave del Registro de inscripción (use -user para el contexto de
usuario).
chain usa la clave del Registro de configuración de cadena.
PolicyServers usa la clave del Registro de servidores de directivas.
ProgId usa el valor ProgID del módulo de directiva o salida (nombre de subclave
del Registro).
RegistryValueName usa el nombre del valor del Registro (use Name* para hacer
coincidir el prefijo).
value usa el nuevo valor numérico, cadena o fecha del Registro o nombre de
archivo. Si un valor numérico comienza con + o - , los bits especificados en el
nuevo valor se establecen o borran en el valor del Registro existente.

Opciones:

Símbolo del sistema de Windows

[-f] [-Enterprise] [-user] [-GroupPolicy] [-config Machine\CAName]

Comentarios

Si un valor de cadena comienza con + o - y el valor existente es un valor


REG_MULTI_SZ , la cadena se agrega o quita del valor del Registro existente. Para

forzar la creación de un valor REG_MULTI_SZ , agregue \n al final del valor de


cadena.
Si el valor comienza por \@ , el resto del valor es el nombre del archivo que
contiene la representación de texto hexadecimal de un valor binario.
Si no hace referencia a un archivo válido, en su lugar se analiza como [Date][+|-]
[dd:hh] , que es una fecha opcional más o menos días y horas opcionales.

Si se especifican ambos, use un separador de signo más (+) o signo menos (-). Use
now+dd:hh para una fecha relativa a la hora actual.

Use i64 como sufijo para crear un valor REG_QWORD.


Use chain\chaincacheresyncfiletime @now para vaciar de forma eficaz las CRL
almacenadas en caché.
Alias del Registro:
Configuración
CA
Directiva: PolicyModules
Salida: ExitModules
Restauración: RestoreInProgress
Plantilla: Software\Microsoft\Cryptography\CertificateTemplateCache
Inscripción: Software\Microsoft\Cryptography\AutoEnrollment
(Software\Policies\Microsoft\Cryptography\AutoEnrollment)
MSCEP: Software\Microsoft\Cryptography\MSCEP
Cadena: Software\Microsoft\Cryptography\OID\EncodingType
0\CertDllCreateCertificateChainEngine\Config
PolicyServers: Software\Microsoft\Cryptography\PolicyServers
(Software\Policies\Microsoft\Cryptography\PolicyServers)
Crypt32: System\CurrentControlSet\Services\crypt32
NGC: System\CurrentControlSet\Control\Cryptography\Ngc
AutoUpdate: Software\Microsoft\SystemCertificates\AuthRoot\AutoUpdate
Passport: Software\Policies\Microsoft\PassportForWork
MDM: Software\Microsoft\Policies\PassportForWork

-setreg
Establece un valor del Registro.

Símbolo del sistema de Windows

certutil [options] -setreg [{ca | restore | policy | exit | template |


enroll | chain | PolicyServers}\[ProgId\]] RegistryValueName Value

Donde:

ca usa la clave del Registro de una entidad de certificación.


restore usa la clave del Registro de restauración de la entidad de certificación.
policy usa la clave del Registro del módulo de directivas.
exit usa la primera clave del Registro del módulo de salida.
template usa la clave del Registro de plantilla (use -user para plantillas de
usuario).
enroll usa la clave del Registro de inscripción (use -user para el contexto de
usuario).
chain usa la clave del Registro de configuración de cadena.
PolicyServers usa la clave del Registro de servidores de directivas.
ProgId usa el valor ProgID del módulo de directiva o salida (nombre de subclave
del Registro).
RegistryValueName usa el nombre del valor del Registro (use Name* para hacer
coincidir el prefijo).
Value usa el nuevo valor numérico, cadena o fecha del Registro o nombre de
archivo. Si un valor numérico comienza con + o - , los bits especificados en el
nuevo valor se establecen o borran en el valor del Registro existente.

Opciones:

Símbolo del sistema de Windows

[-f] [-Enterprise] [-user] [-GroupPolicy] [-config Machine\CAName]

Comentarios
Si un valor de cadena comienza con + o - y el valor existente es un valor
REG_MULTI_SZ , la cadena se agrega o quita del valor del Registro existente. Para

forzar la creación de un valor REG_MULTI_SZ , agregue \n al final del valor de


cadena.
Si el valor comienza por \@ , el resto del valor es el nombre del archivo que
contiene la representación de texto hexadecimal de un valor binario.
Si no hace referencia a un archivo válido, en su lugar se analiza como [Date][+|-]
[dd:hh] , que es una fecha opcional más o menos días y horas opcionales.

Si se especifican ambos, use un separador de signo más (+) o signo menos (-). Use
now+dd:hh para una fecha relativa a la hora actual.

Use i64 como sufijo para crear un valor REG_QWORD.


Use chain\chaincacheresyncfiletime @now para vaciar de forma eficaz las CRL
almacenadas en caché.

-delreg
Elimina un valor del Registro.

Símbolo del sistema de Windows

certutil [options] -delreg [{ca | restore | policy | exit | template |


enroll |chain | PolicyServers}\[ProgId\]][RegistryValueName]

Donde:

ca usa la clave del Registro de una entidad de certificación.


restore usa la clave del Registro de restauración de la entidad de certificación.
policy usa la clave del Registro del módulo de directivas.
exit usa la primera clave del Registro del módulo de salida.
template usa la clave del Registro de plantilla (use -user para plantillas de
usuario).
enroll usa la clave del Registro de inscripción (use -user para el contexto de
usuario).
chain usa la clave del Registro de configuración de cadena.
PolicyServers usa la clave del Registro de servidores de directivas.
ProgId usa el valor ProgID del módulo de directiva o salida (nombre de subclave
del Registro).
RegistryValueName usa el nombre del valor del Registro (use Name* para hacer
coincidir el prefijo).
Value usa el nuevo valor numérico, cadena o fecha del Registro o nombre de
archivo. Si un valor numérico comienza con + o - , los bits especificados en el
nuevo valor se establecen o borran en el valor del Registro existente.

Opciones:

Símbolo del sistema de Windows

[-f] [-Enterprise] [-user] [-GroupPolicy] [-config Machine\CAName]

Comentarios

Si un valor de cadena comienza con + o - y el valor existente es un valor


REG_MULTI_SZ , la cadena se agrega o quita del valor del Registro existente. Para

forzar la creación de un valor REG_MULTI_SZ , agregue \n al final del valor de


cadena.
Si el valor comienza por \@ , el resto del valor es el nombre del archivo que
contiene la representación de texto hexadecimal de un valor binario.
Si no hace referencia a un archivo válido, en su lugar se analiza como [Date][+|-]
[dd:hh] , que es una fecha opcional más o menos días y horas opcionales.

Si se especifican ambos, use un separador de signo más (+) o signo menos (-). Use
now+dd:hh para una fecha relativa a la hora actual.

Use i64 como sufijo para crear un valor REG_QWORD.


Use chain\chaincacheresyncfiletime @now para vaciar de forma eficaz las CRL
almacenadas en caché.
Alias del Registro:
Configuración
CA
Directiva: PolicyModules
Salida: ExitModules
Restauración: RestoreInProgress
Plantilla: Software\Microsoft\Cryptography\CertificateTemplateCache
Inscripción: Software\Microsoft\Cryptography\AutoEnrollment
(Software\Policies\Microsoft\Cryptography\AutoEnrollment)
MSCEP: Software\Microsoft\Cryptography\MSCEP
Cadena: Software\Microsoft\Cryptography\OID\EncodingType
0\CertDllCreateCertificateChainEngine\Config
PolicyServers: Software\Microsoft\Cryptography\PolicyServers
(Software\Policies\Microsoft\Cryptography\PolicyServers)
Crypt32: System\CurrentControlSet\Services\crypt32
NGC: System\CurrentControlSet\Control\Cryptography\Ngc
AutoUpdate: Software\Microsoft\SystemCertificates\AuthRoot\AutoUpdate
Passport: Software\Policies\Microsoft\PassportForWork
MDM: Software\Microsoft\Policies\PassportForWork

-importKMS
Importa claves de usuario y certificados en la base de datos del servidor para el
archivado de claves.

Símbolo del sistema de Windows

certutil [options] -importKMS UserKeyAndCertFile [CertId]

Donde:

UserKeyAndCertFile es un archivo de datos con claves privadas de usuario y


certificados que se van a archivar. Este archivo puede ser:
Un archivo de exportación del servidor de administración de claves (KMS) de
Exchange.
Un archivo PFX.
CertId es un token de coincidencia de certificado de descifrado para archivos de
exportación de KMS. Para más información, vea el parámetro -store en este
artículo.
-f importa certificados no emitidos por la entidad de certificación.

Opciones:

Símbolo del sistema de Windows


[-f] [-Silent] [-split] [-config Machine\CAName] [-p Password] [-symkeyalg
SymmetricKeyAlgorithm[,KeyLength]]

-ImportCert
Importa un archivo de certificado en la base de datos.

Símbolo del sistema de Windows

certutil [options] -ImportCert Certfile [ExistingRow]

Donde:

ExistingRow importa el certificado en lugar de una solicitud pendiente para la


misma clave.
-f importa certificados no emitidos por la entidad de certificación.

Opciones:

Símbolo del sistema de Windows

[-f] [-config Machine\CAName]

Comentarios

Es posible que la entidad de certificación también deba configurarse para admitir


certificados externos mediante la ejecución de certutil -setreg ca\KRAFlags
+KRAF_ENABLEFOREIGN .

-GetKey
Recupera un blob de recuperación de clave privada archivada, genera un script de
recuperación o recupera claves archivadas.

Símbolo del sistema de Windows

certutil [options] -GetKey SearchToken [RecoveryBlobOutFile]


certutil [options] -GetKey SearchToken script OutputScriptFile
certutil [options] -GetKey SearchToken retrieve | recover OutputFileBaseName

Donde:
script genera un script para recuperar claves (comportamiento predeterminado si
se encuentran varios candidatos de recuperación coincidentes o si no se especifica
el archivo de salida).
retrieve recupera uno o varios blobs de recuperación de claves (comportamiento
predeterminado si se encuentra exactamente un candidato de recuperación
coincidente y si se especifica el archivo de salida). Con esta opción se trunca
cualquier extensión y se anexa la cadena específica del certificado y la extensión
.rec para cada blob de recuperación de claves. Cada archivo contiene una cadena

de certificados y una clave privada asociada, aún cifrada en uno o varios


certificados de Key Recovery Agent.
recover recupera y recupera claves privadas en un paso (requiere certificados de
Key Recovery Agent y claves privadas). El uso de esta opción trunca cualquier
extensión y anexa la extensión .p12 . Cada archivo contiene las cadenas de
certificados recuperadas y las claves privadas asociadas, almacenadas como un
archivo PFX.
SearchToken selecciona las claves y los certificados que se van a recuperar, entre
los que se incluyen:
Nombre común del certificado
Número de serie del certificado.
Hash SHA-1 de certificado (huella digital)
Hash SHA-1 de KeyId de certificado (identificador de clave del firmante)
Nombre del solicitante (dominio\usuario)
UPN (usuario@dominio)
RecoveryBlobOutFile genera un archivo con una cadena de certificados y una
clave privada asociada, aún cifrada en uno o varios certificados de Key Recovery
Agent.
OutputScriptFile genera un archivo con un script por lotes para recuperar claves
privadas.
OutputFileBaseName genera un nombre base de archivo.

Opciones:

Símbolo del sistema de Windows

[-f] [-UnicodeText] [-Silent] [-config Machine\CAName] [-p Password] [-


ProtectTo SAMNameAndSIDList] [-csp Provider]

Comentarios
Para la recuperación, cualquier extensión se trunca y una cadena específica del
certificado y las extensiones .rec se anexan para cada blob de recuperación de
claves. Cada archivo contiene una cadena de certificados y una clave privada
asociada, aún cifrada en uno o varios certificados de Key Recovery Agent.
Para la recuperación, se trunca cualquier extensión y se anexa la extensión .p12 .
Contiene las cadenas de certificados recuperadas y las claves privadas asociadas,
almacenadas como un archivo PFX.

-RecoverKey
Recupera una clave privada archivada.

Símbolo del sistema de Windows

certutil [options] -RecoverKey RecoveryBlobInFile [PFXOutFile


[RecipientIndex]]

Opciones:

Símbolo del sistema de Windows

[-f] [-user] [-Silent] [-split] [-p Password] [-ProtectTo SAMNameAndSIDList]


[-csp Provider] [-t Timeout]

-mergePFX
Combina archivos PFX.

Símbolo del sistema de Windows

certutil [options] -MergePFX PFXInFileList PFXOutFile [Modifiers]

Donde:

PFXInFileList es una lista separada por comas de archivos de entrada PFX.


PFXOutFile es el nombre del archivo de salida PFX.
Modifiers son listas separadas por comas para uno o varios de los siguientes
elementos:
ExtendedProperties incluye cualquier propiedad extendida.
NoEncryptCert especifica que no se cifren los certificados.
EncryptCert especifica que se cifren los certificados.

Opciones:

Símbolo del sistema de Windows


[-f] [-user] [-split] [-p password] [-ProtectTo SAMNameAndSIDList] [-csp
Provider]

Comentarios
La contraseña especificada en la línea de comandos debe ser una lista de
contraseñas separadas por comas.
Si se especifica más de una contraseña, se usa la última contraseña para el archivo
de salida. Si solo se proporciona una contraseña o si la última es * , se pedirá al
usuario la contraseña del archivo de salida.

-convertEPF
Convierte un archivo PFX en un archivo EPF.

Símbolo del sistema de Windows

certutil [options] -ConvertEPF PFXInFileList EPFOutFile [cast | cast-]


[V3CACertId][,Salt]

Donde:

PFXInFileList es una lista separada por comas de archivos de entrada PFX.


EPFOutFile es el nombre del archivo de salida PFX.
EPF es el nombre del archivo de salida EPF.
cast usa el cifrado CAST 64.
cast- usa el cifrado CAST 64 (exportación).
V3CACertId es el token de coincidencia del certificado de entidad de certificación
V3. Para más información, vea el parámetro -store en este artículo.
Salt es la cadena de sal del archivo de salida EPF.

Opciones:

Símbolo del sistema de Windows

[-f] [-Silent] [-split] [-dc DCName] [-p Password] [-csp Provider]

Comentarios
La contraseña especificada en la línea de comandos debe ser una lista de
contraseñas separadas por comas.
Si se especifica más de una contraseña, se usa la última contraseña para el archivo
de salida. Si solo se proporciona una contraseña o si la última es * , se pedirá al
usuario la contraseña del archivo de salida.

-add-chain
Agrega una cadena de certificados.

Símbolo del sistema de Windows

certutil [options] -add-chain LogId certificate OutFile

Opciones:

Símbolo del sistema de Windows

[-f]

-add-pre-chain
Agrega una cadena de certificados previos.

Símbolo del sistema de Windows

certutil [options] -add-pre-chain LogId pre-certificate OutFile

Opciones:

Símbolo del sistema de Windows

[-f]

-get-sth
Obtiene un encabezado de árbol con firma.

Símbolo del sistema de Windows

certutil [options] -get-sth [LogId]

Opciones:
Símbolo del sistema de Windows

[-f]

-get-sth-consistency
Obtiene los cambios de encabezado de árbol firmados.

Símbolo del sistema de Windows

certutil [options] -get-sth-consistency LogId TreeSize1 TreeSize2

Opciones:

Símbolo del sistema de Windows

[-f]

-get-proof-by-hash
Obtiene una prueba de un hash de un servidor de marca de tiempo.

Símbolo del sistema de Windows

certutil [options] -get-proof-by-hash LogId Hash [TreeSize]

Opciones:

Símbolo del sistema de Windows

[-f]

-get-entries
Recupera entradas de un registro de eventos.

Símbolo del sistema de Windows

certutil [options] -get-entries LogId FirstIndex LastIndex

Opciones:
Símbolo del sistema de Windows

[-f]

-get-roots
Recupera los certificados raíz del almacén de certificados.

Símbolo del sistema de Windows

certutil [options] -get-roots LogId

Opciones:

Símbolo del sistema de Windows

[-f]

-get-entry-and-proof
Recupera una entrada del registro de eventos y su prueba criptográfica.

Símbolo del sistema de Windows

certutil [options] -get-entry-and-proof LogId Index [TreeSize]

Opciones:

Símbolo del sistema de Windows

[-f]

-VerifyCT
Comprueba un certificado en el registro de transparencia de certificados.

Símbolo del sistema de Windows

certutil [options] -VerifyCT Certificate SCT [precert]

Opciones:
Símbolo del sistema de Windows

[-f]

-?
Muestra la lista de parámetros.

Símbolo del sistema de Windows

certutil -?
certutil <name_of_parameter> -?
certutil -? -v

Donde:

-? muestra la lista de parámetros


-<nombre_del_parámetro> -? muestra el contenido de ayuda para el parámetro
especificado.
-? -v muestra una lista detallada de parámetros y opciones.

Opciones
En esta sección se definen todas las opciones que se pueden especificar, en función del
comando. Cada parámetro incluye información sobre qué opciones son válidas para su
uso.

Opción Descripción

-admin Use ICertAdmin2 para las propiedades de CA.

-anonymous Usa credenciales SSL anónimas.

-cert CertId Certificado de firma

-clientcertificate clientCertId Usa las credenciales SSL de certificado X.509. Para la


interfaz de usuario de selección, use -clientcertificate .

-config Machine\CAName Entidad de certificación y cadena de nombre de equipo.

-csp provider Proveedor:


KSP: proveedor de almacenamiento de claves de software
de Microsoft
TPM: proveedor criptográfico de la plataforma Microsoft
NGC: proveedor de almacenamiento de claves de
Opción Descripción

Microsoft Passport
SC: proveedor de almacenamiento de claves de tarjeta
inteligente de Microsoft

-dc DCName Tiene como destino un controlador de dominio específico.

-enterprise Usa el almacén de certificados del Registro de empresa de


la máquina local.

-f Fuerza la sobrescritura.

-generateSSTFromWU SSTFile Generación de SST utilizando el mecanismo de


actualización automática.

-gmt Muestra las horas mediante GMT.

-GroupPolicy Usa el almacén de certificados de directiva de grupo.

-idispatch Use IDispatch en lugar de métodos nativos de COM.

-kerberos Usa las credenciales SSL de Kerberos.

-location alternatestoragelocation (-loc) AlternateStorageLocation.

-mt Muestra las plantillas de máquina.

-nocr Codifique el texto sin caracteres CR.

-nocrlf Codifique el texto sin caracteres CR-LF.

-nullsign Usa el hash de los datos como firma.

-oldpfx Use el cifrado PFX antiguo.

-out columnlist Lista de columnas separadas por comas.

-p password Contraseña

-pin PIN PIN de tarjeta inteligente.

-policyserver URLorID Dirección URL o identificador del servidor de directivas.


Para la selección de U/I, usa -policyserver . Para todos los
servidores de directivas, usa -policyserver *

-privatekey Muestra los datos de contraseña y clave privada.

-protect Proteja las claves con contraseña.

-protectto SAMnameandSIDlist Lista de nombres SAM/SID separados por comas.

-restrict restrictionlist Lista de restricciones separadas por comas. Cada


restricción consta de un nombre de columna, un operador
Opción Descripción

relacional y un entero constante, cadena o fecha. Un


nombre de columna puede ir precedido por un signo más
o menos para indicar el criterio de ordenación. Por
ejemplo: requestID = 47 , +requestername >= a,
requestername o -requestername > DOMAIN, Disposition =
21 .

-reverse Invierta las columnas de registro y cola.

-seconds Muestra las horas con segundos y milisegundos.

-service Use el almacén de certificados de servicio.

-sid SID numérico:


22: sistema local
23: servicio local
24: servicio de red

-silent Use la marca silent para adquirir el contexto de cifrado.

-split Divide los elementos ASN.1 insertados y los guarda en los


archivos.

-sslpolicy servername Directiva SSL que coincide con ServerName.

-symkeyalg Nombre del algoritmo de clave simétrica con longitud de


symmetrickeyalgorithm[,keylength] clave opcional. Por ejemplo: AES,128 o 3DES .

-syncWithWU DestinationDir Sincronización con Windows Update.

-t timeout Tiempo de espera de captura de direcciones URL en


milisegundos.

-Unicode Escribe la salida redirigida en Unicode.

-UnicodeText Escribe el archivo de salida en Unicode.

-urlfetch Recupera y comprueba los certificados de AIA y las CRL de


CDP.

-user Usa las claves HKEY_CURRENT_USER o el almacén de


certificados.

-username username Usa la cuenta con nombre para las credenciales SSL. Para la
interfaz de usuario de selección, use -username .

-ut Muestra las plantillas de usuario.

-v Proporciona información más detallada.


Opción Descripción

-v1 Use interfaces V1.

Algoritmos hash: MD2 MD4 MD5 SHA1 SHA256 SHA384 SHA512.

Vínculos relacionados
Para obtener más ejemplos de cómo usar este comando, vea los artículos siguientes:

Active Directory Certificate Services (AD CS)


Tareas certutil para administrar certificados.
Configurar raíces de confianza y certificados no permitidos en Windows
cambiar
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia la configuración del servidor host de sesión de Escritorio remoto para inicios de
sesión, asignaciones de puertos COM e modo de instalación.

7 Nota

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de Escritorio remoto en Windows Server.

Sintaxis

change logon
change port
change user

Parámetros

Parámetro Descripción

Comando Habilita o deshabilita los inicios de sesión de las sesiones de cliente en un servidor
change host de sesión de Escritorio remoto o muestra el estado de inicio de sesión actual.
logon

Comando Muestra o cambia las asignaciones de puertos COM para que sean compatibles con
change las aplicaciones MS-DOS.
port

Comando Cambia el modo de instalación del servidor host de sesión de Escritorio remoto.
change
user

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


change logon
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Habilita o deshabilita los inicios de sesión de las sesiones de cliente o muestra el estado
del inicio de sesión actual. Esta utilidad es útil para el mantenimiento del sistema. Hay
que ser administrador para usar este comando.

7 Nota

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de Escritorio remoto en Windows Server.

Sintaxis

change logon {/query | /enable | /disable | /drain | /drainuntilrestart}

Parámetros

Parámetro Descripción

/query Muestra el estado del inicio de sesión actual, ya sea habilitado o deshabilitado.

/enable Habilita inicios de sesión desde sesiones de cliente, pero no desde la consola.

/disable Deshabilita inicios de sesión subsiguientes desde sesiones de cliente, pero no


desde la consola. No afecta a los usuarios con la sesión iniciada.

/drain Deshabilita los inicios de sesión de nuevas sesiones de cliente, pero permite
reconexiones a sesiones existentes.

/drainuntilrestart Deshabilita los inicios de sesión de nuevas sesiones de cliente hasta que se
reinicie el equipo, pero permite reconexiones a sesiones existentes.

/? Muestra la ayuda en el símbolo del sistema.


Comentarios
Los inicios de sesión se vuelven a habilitar al reiniciar el sistema.

Si está conectado al servidor host de sesión de Escritorio remoto desde una sesión
de cliente y, después, deshabilita los inicios de sesión y se desconecta antes de
volver a habilitar los inicios de sesión, no podrá volver a conectarse a la sesión.
Para volver a habilitar los inicios de sesión desde sesiones de cliente, inicie sesión
en la consola.

Ejemplos
Para mostrar el estado del inicio de sesión actual, escriba:

change logon /query

Para habilitar los inicios de sesión desde sesiones de cliente, escriba:

change logon /enable

Para deshabilitar los inicios de sesión de cliente, escriba:

change logon /disable

Vínculos relacionados
Clave de sintaxis de línea de comandos

comando change

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


change port
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra o cambia las asignaciones de puertos COM para que sean compatibles con las
aplicaciones MS-DOS.

7 Nota

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de Escritorio remoto en Windows Server.

Sintaxis

change port [<portX>=<portY>| /d <portX> | /query]

Parámetros

Parámetro Descripción

<portX> = <portY> Asigna COM <portX> a <portY>

/d <portX> Elimina la asignación de COM. <portX>

/query Muestra las asignaciones de puertos actuales.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

La mayoría de las aplicaciones de MS-DOS solo admiten puertos serie COM1 a


COM4. El comando change port asigna un puerto serie a un número de puerto
diferente, lo que permite que las aplicaciones que no admitan puertos COM con
un número alto tengan acceso al puerto serie. La reasignación solo funciona para
la sesión actual y no se conserva si inicia sesión desde una sesión y, a continuación,
vuelve a iniciar sesión.

Use change port sin parámetros para mostrar los puertos COM disponibles y sus
asignaciones actuales.

Ejemplos
Para asignar COM12 a COM1 para su uso por una aplicación basada en MS-DOS,
escriba:

change port com12=com1

Para mostrar las asignaciones de puertos actuales, escriba:

change port /query

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando change

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


change user
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el modo de instalación del servidor host de sesión de Escritorio remoto.

7 Nota

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de Escritorio remoto en Windows Server.

Sintaxis

change user {/execute | /install | /query}

Parámetros

Parámetro Descripción

/execute Habilita la asignación de archivos .ini al directorio principal. Esta es la configuración


predeterminada.

/install Deshabilita la asignación de archivos .ini al directorio principal. Todos los archivos
.ini se leen y escriben en el directorio del sistema. Debe deshabilitar la asignación de
archivos .ini al instalar aplicaciones en un servidor host de sesión de Escritorio
remoto.

/query Muestra la configuración actual para la asignación de archivos .ini.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Use change user /install antes de instalar una aplicación para crear archivos .ini
para la aplicación en el directorio del sistema. Estos archivos se usan como origen
cuando se crean archivos .ini específicos del usuario. Después de instalar la
aplicación, use change user /execute para revertir a la asignación de archivos .ini
estándar.

La primera vez que ejecute la aplicación, busca sus archivos .ini en el directorio
principal. Si los archivos .ini no se encuentran en el directorio principal, pero se
encuentran en el directorio del sistema, Servicios de Escritorio remoto copia los
archivos .ini en el directorio principal y se asegura de que cada usuario tenga una
copia única de los archivos .ini de la aplicación. Los nuevos archivos .ini se crean en
el directorio principal.

Cada usuario debe tener una copia única de los archivos .ini para una aplicación.
Esto evita instancias en las que distintos usuarios puedan tener configuraciones de
aplicación incompatibles (por ejemplo, directorios predeterminados o resoluciones
de pantalla diferentes).

Cuando el sistema ejecuta change user /install, ocurren varias cosas. Se crea una
instantánea para todas las entradas del registro que se crean en
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
NT\Currentversion\Terminal Server\Install, en la subclave \SOFTWARE o en la
subclave \MACHINE. Las subclaves agregadas a HKEY_CURRENT_USER se copian
en la subclave \SOFTWARE y las subclaves agregadas a HKEY_LOCAL_MACHINE se
copian en la subclave \MACHINE. Si la aplicación consulta el directorio de
Windows mediante llamadas del sistema, como GetWindowsdirectory, el servidor
host de sesión rd devuelve el directorio systemroot. Si se agregan entradas de
archivo .ini mediante llamadas del sistema, como WritePrivateProfileString, se
agregan a los archivos .ini en el directorio systemroot.

Cuando el sistema vuelve a change user /execute y la aplicación intenta leer una
entrada del registro en HKEY_CURRENT_USER que no existe, Servicios de Escritorio
remoto comprueba si existe una copia de la clave en la subclave \Terminal
Server\Install. Si es así, las subclaves se copian en la ubicación adecuada en
HKEY_CURRENT_USER. Si la aplicación intenta leer desde un archivo de .ini que no
existe, Servicios de Escritorio remoto busca ese archivo .ini en la raíz del sistema. Si
el archivo .ini está en la raíz del sistema, se copia en el subdirectorio \Windows del
directorio principal del usuario. Si la aplicación consulta el directorio de Windows,
el servidor host de sesión de Escritorio remoto devuelve el subdirectorio \Windows
del directorio principal del usuario.

Al iniciar sesión, Servicios de Escritorio remoto comprueba si sus archivos de .ini


del sistema son más recientes que los archivos .ini del equipo. Si la versión del
sistema es más reciente, el archivo .ini se reemplaza o se combina con la versión
más reciente. Esto depende de si el bit INISYNC, 0x40, se establece para este
archivo .ini. Se cambia el nombre de la versión anterior del archivo .ini como
Inifile.ctx. Si los valores del registro del sistema en la subclave \Terminal
Server\Install son más recientes que su versión en HKEY_CURRENT_USER, la
versión de las subclaves se elimina y se reemplaza por las nuevas subclaves de
\Terminal Server\Install.

Ejemplos
Para deshabilitar la asignación de archivos .ini en el directorio principal, escriba:

change user /install

Para habilitar la asignación de archivos .ini en el directorio principal, escriba:

change user /execute

Para mostrar la configuración actual de la asignación de archivos .ini, escriba:

change user /query

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando change

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


chcp
Artículo • 14/04/2023

Cambia la página de códigos de la consola activa. Si se usa sin parámetros, chcp


muestra el número de la página de códigos de la consola activa.

Sintaxis

chcp [<nnn>]

Parámetros

Parámetro Descripción

<nnn> Especifica la página de códigos.

/? Muestra la ayuda en el símbolo del sistema.

En la tabla siguiente se enumeran todas las páginas de códigos admitidas y su


país/región o idioma:

Página de códigos País/región o idioma

437 Estados Unidos

850 Multilingüe (latino I)

852 Eslavo (latino II)

855 Cirílico (ruso)

857 Turco

860 Portugués

861 Islandés

863 Francés canadiense

865 Nórdico

866 Ruso
Página de códigos País/región o idioma

869 Griego moderno

936 Chino

Comentarios

Solo la página de códigos del fabricante de equipos originales (OEM) que se


instala con Windows aparece correctamente en una ventana del símbolo del
sistema que usa fuentes de mapa de bits. Otras páginas de códigos aparecen
correctamente en modo de pantalla completa o en ventanas del símbolo del
sistema que usan fuentes TrueType.

No es necesario preparar páginas de códigos (como en MS-DOS).

Los programas que se inician después de asignar una nueva página de códigos
usan la nueva página de códigos. Sin embargo, los programas (excepto Cmd.exe)
que ha iniciado antes de asignar la nueva página de códigos seguirán usando la
página de códigos original.

Ejemplos
Para ver la configuración de página de códigos activa, escriba:

chcp

Aparece un mensaje similar al siguiente: Active code page: 437

Para cambiar la página de códigos activa a 850 (multilingüe), escriba:

chcp 850

Si la página de códigos especificada no es válida, aparece el siguiente mensaje de error:


Invalid code page

Vínculos relacionados
Clave de sintaxis de línea de comandos
Campos de bits de página de códigos
Identificadores de página de códigos
chdir
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra el nombre del directorio actual o cambia el directorio actual. Si se usa solo con
una letra de unidad (por ejemplo, chdir C: ), chdir muestra los nombres del directorio
actual en la unidad especificada. Si se usa sin parámetros, chdir muestra la unidad y el
directorio actuales.

7 Nota

Este comando ha sido reemplazado por el comando cd. Para obtener más
información, como sintaxis y detalles del parámetro, consulte el comando cd.

Vínculos relacionados
Clave de sintaxis de línea de comandos

comando cd
chglogon
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Habilita o deshabilita los inicios de sesión de las sesiones de cliente en un servidor host
de sesión de Escritorio remoto o muestra el estado de inicio de sesión actual.

7 Nota

Este comando se ha reemplazado por el comando change log. Para más


información, como la sintaxis y los detalles del parámetro, consulte el comando
change logon.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando change logon

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


chgport
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra o cambia las asignaciones de puertos COM para que sean compatibles con las
aplicaciones MS-DOS.

7 Nota

Este comando se ha reemplazado por el comando change port. Para obtener más
información, incluida la sintaxis y los detalles del parámetro, vea Comando change
port.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando change port

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


chgusr
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el modo de instalación del servidor host de sesión de Escritorio remoto.

7 Nota

Este comando se ha reemplazado por el comando change user. Para más


información, como la sintaxis y los detalles del parámetro, consulte el comando
change user.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando change user

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


chkdsk
Artículo • 14/04/2023

Comprueba los metadatos del sistema de archivos y del sistema de archivos de un


volumen en busca de errores lógicos y físicos. Si se usa sin parámetros, chkdsk muestra
solo el estado del volumen y no corrige ningún error. Si se usa con los parámetros /f, /r,
/x o /b, corrige errores en el volumen.

) Importante

Para ejecutar chkdsk procedimiento, se requiere como mínimo la pertenencia al


grupo local Administradores o equivalente. Para abrir una ventana del símbolo del
sistema como administrador, haga clic con el botón derecho en símbolo del
sistema en el menú Inicio y, a continuación, haga clic en Ejecutar como
administrador.

) Importante

No se recomienda interrumpir chkdsk. Sin embargo, cancelar o interrumpir chkdsk


no debe dejar el volumen más dañado que antes de ejecutar chkdsk. Al ejecutar
chkdsk, se vuelven a comprobar y se deben reparar los daños restantes en el
volumen.

7 Nota

Chkdsk solo se puede usar para discos locales. El comando no se puede usar con
una letra de unidad local que se haya redirigido a través de la red.

Sintaxis
Símbolo del sistema de Windows

chkdsk [<volume>[[<path>]<filename>]] [/f] [/v] [/r] [/x] [/i] [/c] [/l[:


<size>]] [/b]

Parámetros
Parámetro Descripción

<volume> Especifica la letra de unidad (seguida de dos puntos), el punto de montaje


o el nombre del volumen.

[ [<path>] Use solo con la tabla de asignación de archivos (FAT) y FAT32. Especifica la
<filename> ubicación y el nombre de un archivo o conjunto de archivos que desea
que chkdsk compruebe la fragmentación. Puede usar los caracteres
comodín ? y * para especificar varios archivos.

/f Corrige errores en el disco. El disco debe estar bloqueado. Si chkdsk no


puede bloquear la unidad, aparece un mensaje que le pregunta si desea
comprobar la unidad la próxima vez que reinicie el equipo.

/v Muestra el nombre de cada archivo de cada directorio a medida que se


comprueba el disco.

/r Busca sectores incorrectos y recupera información legible. El disco debe


estar bloqueado. /r incluye la funcionalidad de /f, con el análisis adicional
de errores de disco físico.

/x Si es necesario, fuerza el desmontaje del volumen en primer lugar. Todos


los identificadores abiertos a la unidad se invalidan. /x también incluye la
funcionalidad de /f.

/i Use solo con NTFS. Realiza una comprobación menos rigurosa de las
entradas de índice, lo que reduce la cantidad de tiempo necesario para
ejecutar chkdsk.

/C Use solo con NTFS. No comprueba los ciclos dentro de la estructura de


carpetas, lo que reduce la cantidad de tiempo necesario para ejecutar
chkdsk.

/l[: <size> ] Use solo con NTFS. Cambia el tamaño del archivo de registro al tamaño
que escriba. Si omite el parámetro size, /l muestra el tamaño actual.

/b Use solo con NTFS. Borra la lista de clústeres incorrectos en el volumen y


vuelve a examinar todos los clústeres asignados y libres de errores. /b
incluye la funcionalidad de /r. Use este parámetro después de crear una
imagen de un volumen en una nueva unidad de disco duro.

/scan Use solo con NTFS. Ejecuta un examen en línea en el volumen.

/forceofflinefix Use solo con NTFS (debe usarse con /scan). Omita toda reparación en
línea; todos los defectos encontrados se ponen en cola para la reparación
sin conexión (por ejemplo, chkdsk /spotfix ).

/perf Use solo con NTFS (debe usarse con /scan). Usa más recursos del sistema
para completar un examen lo más rápido posible. Esto puede tener un
impacto negativo en el rendimiento en otras tareas que se ejecutan en el
sistema.
Parámetro Descripción

/spotfix Use solo con NTFS. Ejecuta la corrección puntual en el volumen.

/sdcleanup Use solo con NTFS. Recolección de elementos no utilizados de datos de


descriptores de seguridad innecesarios (implica /f).

/offlinescanandfix Ejecuta un examen sin conexión y se corrige en el volumen.

/freeorphanedchains Use solo con FAT/FAT32/exFAT. Libera las cadenas de clúster huérfanas en
lugar de recuperar su contenido.

/markclean Use solo con FAT/FAT32/exFAT. Marca el volumen limpio si no se detectó


ningún daño, incluso si no se especificó /f.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
El modificador /i o /c reduce la cantidad de tiempo necesario para ejecutar chkdsk
omitiendo determinadas comprobaciones de volumen.

Puede ejecutar chkdsk para corregir errores de disco. No puede tener archivos
abiertos en la unidad. Si los archivos están abiertos, aparece el siguiente mensaje
de error:

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)

Si decide comprobar la unidad la próxima vez que reinicie el equipo, chkdsk


comprueba la unidad y corrige los errores automáticamente al reiniciar el equipo.
Si la partición de unidad es una partición de arranque, chkdsk reinicia
automáticamente el equipo después de comprobar la unidad.

También puede usar el comando chkntfs /c para programar la comprobación del


volumen la próxima vez que se reinicie el equipo. Use el comando fsutil dirty
set para establecer el bit de integridad del volumen (lo que indica daños), de
modo que Windows ejecute chkdsk cuando se reinicie el equipo.

Debe usar chkdsk ocasionalmente en sistemas de archivos FAT y NTFS para


comprobar si hay errores de disco. Chkdsk examina el espacio en disco y el uso del
disco y proporciona un informe de estado específico para cada sistema de
archivos. El informe de estado muestra los errores encontrados en el sistema de
archivos. Si ejecuta chkdsk sin el parámetro /f en una partición activa, podría
notificar errores falsos porque no puede bloquear la unidad.

Chkdsk corrige los errores de disco lógico solo si especifica el parámetro /f.
Chkdsk debe poder bloquear la unidad para corregir los errores.

Dado que las reparaciones en sistemas de archivos FAT normalmente cambian la


tabla de asignación de archivos de un disco y, a veces, provocan una pérdida de
datos, chkdsk podría mostrar un mensaje de confirmación similar al siguiente:

10 lost allocation units found in 3 chains.


Convert lost chains to files?

Si presiona Y, Windows guarda cada cadena perdida en el directorio raíz como


un archivo con un nombre en el formato File.chk <nnnn> . Cuando finalice
chkdsk, puede comprobar estos archivos para ver si contienen datos que
necesite.

Si presiona N, Windows corrige el disco, pero no guarda el contenido de las


unidades de asignación perdidas.

Si no usa el parámetro /f, chkdsk muestra un mensaje que indica que el archivo
debe corregirse, pero no corrige ningún error.

Si usa chkdsk /f* en un disco muy grande o en un disco con un gran número de
archivos (por ejemplo, millones de archivos), chkdsk /f puede tardar mucho
tiempo en completarse.

Use el parámetro /r para buscar errores de disco físico en el sistema de archivos e


intentar recuperar datos de cualquier sector de disco afectado.

Si especifica el parámetro /f, chkdsk muestra un mensaje de error si hay archivos


abiertos en el disco. Si no especifica el parámetro /f y existen archivos abiertos,
chkdsk podría notificar las unidades de asignación perdidas en el disco. Esto
podría ocurrir si aún no se han registrado archivos abiertos en la tabla de
asignación de archivos. Si chkdsk notifica la pérdida de un gran número de
unidades de asignación, considere la posibilidad de reparar el disco.

Dado que el volumen de origen Instantáneas para carpetas compartidas no se


puede bloquear mientras las Instantáneas para carpetas compartidas están
habilitadas, la ejecución de chkdsk en el volumen de origen podría notificar
errores falsos o provocar que chkdsk se cierre inesperadamente. Sin embargo,
puede comprobar si existen errores en las instantáneas mediante la ejecución de
chkdsk en modo de solo lectura (sin parámetros) para comprobar el volumen de
almacenamiento de Instantáneas para carpetas compartidas.

El comando format, con diferentes parámetros, está disponible en la Consola de


recuperación.

En los servidores que se reinician con poca frecuencia, es posible que desee usar
los chkntfs o los comandos fsutil dirty query para determinar si el bit de
integridad del volumen ya está establecido antes de ejecutar chkdsk.

Descripción de los códigos de salida


En la tabla siguiente se enumeran los códigos de salida que chkdsk notifica después de
haber finalizado.

Código Descripción
de
salida

0 No se ha encontrado ningún error.

1 Se encontraron errores y se corrigieron.

2 Se ha realizado la liberación de espacio en disco (como la recolección de elementos


no utilizados) o no se ha realizado porque no se ha especificado /f.

3 No se pudo comprobar el disco, no se pudieron corregir errores o no se solucionaron


los errores porque no se especificó /f.

Ejemplos
Para comprobar el disco en la unidad D y hacer que Windows corrija errores, escriba:

Símbolo del sistema de Windows

chkdsk d: /f

Si encuentra errores, chkdsk pausa y muestra mensajes. Chkdsk finaliza mostrando un


informe que muestra el estado del disco. No puede abrir ningún archivo en la unidad
especificada hasta que finalice chkdsk.
Para comprobar todos los archivos de un disco FAT en el directorio actual para bloques
no contiguos, escriba:

Símbolo del sistema de Windows

chkdsk *.*

Chkdsk muestra un informe de estado y, a continuación, enumera los archivos que


coinciden con las especificaciones de archivo que tienen bloques no contiguos.

Visualización de registros de chkdsk


Hay dos métodos que se pueden usar para recuperar archivos de registro chkdsk en
Windows. Vea los métodos descritos a continuación:

Visor de eventos

Para ver los registros con Visor de eventos, vaya a:

1. Inicie >Panel de control>Herramientas administrativas>Visor de eventos.

Como alternativa, presione las teclas Win + R para abrir el cuadro de diálogo
de ejecución, escriba eventvwr.msc y seleccione Aceptar.

2. Expanda los Registros de Windows>, haga clic con el botón derecho en


Aplicación>, seleccione Filtrar registro actual.

3. En la ventana Filtrar registro actual, vaya al menú desplegable Orígenes de


eventos, seleccione Chkdsk y Wininit.

4. Haga clic en Aceptar para finalizar el filtrado de estos dos orígenes.

Vínculos relacionados
Clave de sintaxis de línea de comandos
chkntfs
Artículo • 12/04/2023

Muestra o modifica la comprobación automática del disco cuando se inicia el equipo. Si


se usa sin opciones, chkntfs muestra el sistema de archivos del volumen especificado. Si
la comprobación automática de archivos está programada para ejecutarse, chkntfs
muestra si el volumen especificado está sucio o está programado para comprobarse la
próxima vez que se inicie el equipo.

7 Nota

Para ejecutar chkntfs, debe ser miembro del grupo de administradores.

Sintaxis

chkntfs <volume> [...]


chkntfs [/d]
chkntfs [/t[:<time>]]
chkntfs [/x <volume> [...]]
chkntfs [/c <volume> [...]]

Parámetros

Parámetro Descripción

<volume> Especifica uno o varios volúmenes para comprobar cuándo se inicia el equipo. Los
[...] volúmenes válidos incluyen letras de unidad (seguidas de dos puntos), puntos de
montaje o nombres de volumen.

/d Restaura todas las configuraciones predeterminadas de chkntfs, excepto el tiempo


de cuenta atrás para la comprobación automática de archivos. De forma
predeterminada, todos los volúmenes se comprueban cuando se inicia el equipo y
chkdsk se ejecuta en aquellos que están sucios.

/t [ : Cambia el tiempo de cuenta atrás de inicio de Autochk.exe a la cantidad de tiempo


<time> ] especificado en segundos. Si no se introduce una hora, /t muestra el tiempo de
cuenta atrás actual.
Parámetro Descripción

/x Especifica uno o varios volúmenes que se excluirán de la comprobación de cuándo


<volume> se inicia el equipo, incluso si el volumen está marcado como chkdsk necesario.
[...]

/c Programa uno o varios volúmenes para comprobarse cuando se inicia el equipo y


<volume> ejecuta chkdsk en aquellos que están sucios.
[...]

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para mostrar el tipo de sistema de archivos para la unidad C, escriba:

chkntfs c:

7 Nota

Si la comprobación automática de archivos está programada para ejecutarse, se


mostrará una salida adicional, que indica si la unidad está desfasada o se ha
programado manualmente para comprobarse la próxima vez que se inicie el
equipo.

Para mostrar el tiempo de cuenta atrás de inicio de Autochk.exe, escriba:

chkntfs /t

Para cambiar el tiempo de cuenta atrás de inicio de Autochk.exe a 30 segundos, escriba:

chkntfs /t:30

7 Nota
Aunque puede establecer el tiempo de cuenta atrás de inicio de Autochk.exe en
cero, si lo hace, evitará que cancele una comprobación automática de archivos que
puede llevar mucho tiempo.

Para excluir que se comprueben varios volúmenes, debe enumerar cada uno de ellos en
un solo comando. Por ejemplo, para excluir los volúmenes D y E, escriba:

chkntfs /x d: e:

) Importante

La opción de línea de comandos /x no es acumulativa. Si lo escribe más de una vez,


la entrada más reciente invalida la entrada anterior.

Para programar la comprobación automática de archivos en el volumen D, pero no en


los volúmenes C o E, escriba los siguientes comandos en orden:

chkntfs /d
chkntfs /x c: d: e:
chkntfs /c d:

) Importante

La opción de línea de comandos /c es acumulativa. Si escribe /c más de una vez,


cada entrada permanece. Para asegurarse de que solo se comprueba un volumen
determinado, restablezca los valores predeterminados para borrar todos los
comandos anteriores, excluir todos los volúmenes de que se comprueben y, a
continuación, programar la comprobación automática de archivos en el volumen
deseado.

Vínculos relacionados
Clave de sintaxis de línea de comandos
choice
Artículo • 12/04/2023

Pide al usuario que seleccione un elemento de una lista de opciones de un solo carácter
en un programa por lotes y, a continuación, devuelve el índice de la opción
seleccionada. Si se usa sin parámetros, choice muestra las opciones predeterminadas Y
y N.

Sintaxis

choice [/c [<choice1><choice2><…>]] [/n] [/cs] [/t <timeout> /d <choice>]


[/m <text>]

Parámetros

Parámetro Descripción

/c Especifica la lista de opciones que se van a crear. Las opciones válidas incluyen a-z,
<choice1> A-Z, 0-9 y caracteres ASCII extendidos (128-254). La lista predeterminada es YN, que
<choice2> se muestra como [Y,N]? .
<…>

/n Oculta la lista de opciones, aunque las opciones siguen habilitadas y el texto del
mensaje (si se especifica por /m) todavía se muestra.

/cs Especifica que las opciones distinguen mayúsculas de minúsculas. De forma


predeterminada, las opciones no distinguen mayúsculas de minúsculas.

/t Especifica el número de segundos que se van a pausar antes de usar la opción


<timeout> predeterminada especificada por /d. Los valores aceptables son de 0 a 9999. Si /t
está establecido en 0, choice no se pausa antes de devolver la opción
predeterminada.

/d Especifica la opción predeterminada que se va a usar después de esperar el número


<choice> de segundos especificados por /t. La opción predeterminada debe estar en la lista
de opciones especificadas por /c.

/m <text> Especifica un mensaje que se va a mostrar antes de la lista de opciones. Si no se


especifica /m , solo se muestra el símbolo del sistema de la opción.

/? Muestra la ayuda en el símbolo del sistema.


Comentarios
La variable de entorno ERRORLEVEL se establece en el índice de la clave que el
usuario selecciona en la lista de opciones. La primera opción de la lista devuelve un
valor de 1 , el segundo un valor de 2 , etc. Si el usuario presiona una tecla que no
es una opción válida, choice emite un sonido de advertencia.

Si choice detecta una condición de error, devuelve un valor ERRORLEVEL de 255 .


Si el usuario presiona CTRL+BREAK o CTRL+C, choice devuelve un valor
ERRORLEVEL de 0 .

7 Nota

Al usar valores ERRORLEVEL en un programa por lotes, debe enumerarlos en orden


decreciente.

Ejemplos
Para presentar las opciones Y, N y C, escriba la siguiente línea en un archivo por lotes:

choice /c ync

Aparece el siguiente símbolo del sistema cuando el archivo por lotes ejecuta el
comando choice:

[Y,N,C]?

Para ocultar las opciones Y, N y C, pero mostrar el texto Sí, No o Continuar, escriba la
línea siguiente en un archivo por lotes:

choice /c ync /n /m "Yes, No, or Continue?"

7 Nota
Si usa el parámetro /n, pero no usa /m, no se le pedirá al usuario cuando choice
esté esperando la entrada.

Para mostrar tanto el texto como las opciones usadas en los ejemplos anteriores, escriba
la siguiente línea en un archivo por lotes:

choice /c ync /m "Yes, No, or Continue"

Para establecer un límite de tiempo de cinco segundos y especificar N como valor


predeterminado, escriba la siguiente línea en un archivo por lotes:

choice /c ync /t 5 /d n

7 Nota

En este ejemplo, si el usuario no presiona una tecla en cinco segundos, choice


selecciona N de forma predeterminada y devuelve un valor de error de 2 . De lo
contrario, choice devuelve el valor correspondiente a la elección del usuario.

Vínculos relacionados
Clave de sintaxis de línea de comandos
cipher
Artículo • 12/04/2023

Muestra o cambia el cifrado de directorios y archivos en volúmenes NTFS. Si se utiliza


sin parámetros, cipher muestra el estado de cifrado del directorio actual y los archivos
que contiene.

Sintaxis

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 Descripción

/b Anula si se encuentra un error. De forma predeterminada, el cifrado continúa


ejecutándose aunque se encuentren errores.

/C Muestra información sobre el archivo cifrado.

/d Descifra los archivos o directorios especificados.

/e Cifra los archivos o directorios especificados. Los directorios se marcan para


que los archivos que se agreguen posteriormente se cifren.

/h Muestra archivos con atributos ocultos o del sistema. De forma


predeterminada, estos archivos no están cifrados ni descifrados.

/k Crea un nuevo certificado y una clave para su uso con archivos del Sistema de
cifrado de archivos (EFS). Si se especifica el parámetro /k, se omiten todos los
demás parámetros.
Parámetros Descripción

/r: <filename> Genera una clave y un certificado del agente de recuperación de EFS y, a
[/smartcard] continuación, los escribe en un archivo .pfx (que contiene el certificado y la
clave privada) y en un archivo .cer (que solo contiene el certificado). Si se
especifica /smartcard, escribe la clave de recuperación y el certificado en una
tarjeta inteligente y no se genera ningún archivo .pfx.

/s: <directory> Realiza la operación especificada en todos los subdirectorios del directorio
especificado.

/u [/n] Busca todos los archivos cifrados en las unidades locales. Si se usa con el
parámetro /n, no se realizan actualizaciones. Si se usa sin /n, /u compara la
clave de cifrado de archivos del usuario o la clave del agente de recuperación
con las actuales y las actualiza si han cambiado. Este parámetro solo funciona
con /n.

/w: <directory> Quita los datos del espacio en disco no utilizado disponible en todo el
volumen. Si usa el parámetro /w, se omiten todos los demás parámetros. El
directorio especificado se puede ubicar en cualquier parte de un volumen
local. Si es un punto de montaje o apunta a un directorio de otro volumen, se
quitan los datos de ese volumen.

/x[:efsfile] Realiza una copia de seguridad del certificado y las claves de EFS en el
[ <FileName> ] nombre de archivo especificado. Si se usa con :efsfile, /x realiza una copia de
seguridad de los certificados del usuario que se usaron para cifrar el archivo.
De lo contrario, se realiza una copia de seguridad del certificado y las claves
de EFS actuales del usuario.

/y Muestra la miniatura actual del certificado EFS en el equipo local.

/adduser /certfile: <filename> ]


[/certhash: <hash>

/rekey Actualiza los archivos cifrados especificados para usar la clave EFS
configurada actualmente.

/removeuser Quita un usuario de los archivos especificados. El hash proporcionado para


/certhash: <hash> /certhash debe ser el hash SHA1 del certificado que se va a quitar.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si el directorio primario no está cifrado, un archivo cifrado se podría descifrar
cuando se modifica. Por lo tanto, al cifrar un archivo, también debe cifrar el
directorio primario.
Un administrador puede agregar el contenido de un archivo .cer a la directiva de
recuperación de EFS para crear el agente de recuperación para los usuarios y, a
continuación, importar el archivo .pfx para recuperar archivos individuales.

Puede usar varios nombres de directorio y caracteres comodín.

Debe colocar espacios entre varios parámetros.

Ejemplos
Para mostrar el estado de cifrado de cada uno de los archivos y subdirectorios en el
directorio actual, escriba lo siguiente:

cipher

Los archivos y directorios cifrados se marcan con una E. Los archivos y directorios sin
cifrar se marcan con una U. Por ejemplo, la siguiente salida indica que el directorio
actual y todo su contenido están actualmente sin cifrar:

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 el cifrado en el directorio privado usado en el ejemplo anterior, escriba lo


siguiente:

cipher /e private

Se muestra el resultado siguiente:

Encrypting files in C:\Users\MainUser\Documents\


Private [OK]
1 file(s) [or directorie(s)] within 1 directorie(s) were encrypted.
El comando cipher muestra la salida siguiente:

Listing C:\Users\MainUser\Documents\
New files added to this directory will not be encrypted.
E Private
U hello.doc
U hello.txt

Donde el directorio privado ahora está marcado como cifrado.

Vínculos relacionados
Clave de sintaxis de línea de comandos
clean
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Quita todas las particiones o el formato de volumen del disco con el foco.

7 Nota

Para una versión de PowerShell de este comando, Comando clear-disk.

Sintaxis

clean [all]

Parámetros

Parámetro Descripción

all Especifica que se graben ceros en todos los sectores del disco, con lo que se
eliminan completamente los datos contenidos en él.

Comentarios

En discos de registro de arranque maestro (MBR), solo se sobrescribe la


información de particiones MBR y de sectores ocultos.

En discos de la tabla de particiones GUID (GPT), se sobrescribe la información de


particiones GPT, incluido el MBR de protección; no hay información de sectores
ocultos. No hay información oculta del sector.

Se debe seleccionar un disco para que esta operación se realice correctamente.


Use el comando select disk para seleccionar un disco y desplazar el foco a él.

Ejemplos
Para quitar todo el formato del disco seleccionado, escriba:

clean

Vínculos relacionados
Comando clear-disk

Clave de sintaxis de línea de comandos


cleanmgr
Artículo • 25/09/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 y Windows Server 2008 R2

Borra los archivos innecesarios del disco duro del equipo. Puede usar opciones de línea
de comandos para especificar que Cleanmgr limpia archivos temporales, archivos de
Internet, archivos descargados y archivos de papelera de reciclaje. Después, puede
programar la tarea para que se ejecute en un momento concreto mediante la
herramienta Tareas programadas.

Sintaxis

cleanmgr [/d <driveletter>] [/sageset:n] [/sagerun:n] [/TUNEUP:n]


[/LOWDISK] [/VERYLOWDISK]

Parámetros

Parámetro Descripción

/d Especifica la unidad que desea que limpie el Liberador de espacio en disco.


<driveletter> NOTA: La opción /d no se utiliza con /sagerun:n .

/sageset:n Muestra el cuadro de diálogo Configuración del Liberador de espacio en disco


y también crea una clave del registro para almacenar la configuración que
seleccione. El valor n , que se almacena en el registro, permite especificar tareas
para que se ejecute el Liberador de espacio en disco. El valor n puede ser
cualquier valor entero comprendido entre 0 y 9999. Para obtener más
información, consulte la sección Información de la tabla Registry.

/sagerun:n Ejecuta las tareas especificadas que se asignan al valor n si usa la opción
/sageset. Todas las unidades del equipo se enumeran y el perfil seleccionado se
ejecuta en cada unidad.

/tuneup:n Ejecute /sageset y /sagerun para el mismo n .

/lowdisk Ejecute con la configuración predeterminada.

/verylowdisk Ejecute con la configuración predeterminada, sin mensajes de usuario.


Parámetro Descripción

/autoclean Elimina automáticamente los archivos que han quedado atrás después de
actualizar Windows.

/? Muestra la ayuda en el símbolo del sistema.

Opciones
Las opciones de los archivos que puede especificar para el Liberador de espacio en
disco mediante /sageset y /sagerun incluyen:

Archivos de instalación temporal: son archivos creados por un programa de


instalación que ya no se está ejecutando.

Archivos de programa descargados: los archivos de programa descargados son


controles ActiveX y programas de Java que se descargan automáticamente desde
Internet cuando se ven determinadas páginas. Estos archivos se guardan
temporalmente en la carpeta Archivos de programa descargados en el disco duro.
Esta opción incluye un botón Ver archivos para que pueda ver los archivos antes
de que el Liberador de espacio en disco los quite. El botón abre la carpeta
C:\Winnt\Downloaded Program Files.

Archivos temporales de Internet: la carpeta Archivos temporales de Internet


contiene páginas web que se almacenan en el disco duro para una visualización
rápida. El Liberador de espacio en disco quita estas páginas, pero deja intacta la
configuración personalizada de las páginas web. Esta opción también incluye un
botón Ver archivos, que abre la carpeta C:\Documents and
Settings\Username\Local Settings\Temporary Internet Files\Content.IE5.

Archivos chkdsk antiguos: cuando Chkdsk comprueba si hay errores en un disco,


Chkdsk podría guardar fragmentos de archivos perdidos como archivos en la
carpeta raíz del disco. Estos archivos no son necesarios.

Papelera de reciclaje: la Papelera de reciclaje contiene archivos que se han


eliminado del equipo. Estos archivos no se quitan permanentemente hasta que se
vacía la Papelera de reciclaje. Esta opción incluye un botón Ver archivos que abre la
Papelera de reciclaje.

Nota: Una papelera de reciclaje puede aparecer en más de una unidad, por
ejemplo, no solo en %SystemRoot%.

Archivos temporales: los programas a veces guardan información temporal en una


carpeta Temp. Antes de que un programa se cierre, el programa normalmente
elimina esta información. Puede eliminar de forma segura los archivos temporales
que no se han modificado en la última semana.

Archivos sin conexión temporales: los archivos sin conexión temporales son
copias locales de los archivos de red usados recientemente. Estos archivos se
almacenan automáticamente en caché para que pueda usarlos después de
desconectarse de la red. Un botón Ver archivos abre la carpeta Archivos sin
conexión.

Archivos sin conexión: los archivos sin conexión son copias locales de los archivos
de red que desea tener disponibles específicamente sin conexión para que pueda
usarlos después de desconectarse de la red. Un botón Ver archivos abre la carpeta
Archivos sin conexión.

Comprimir archivos antiguos: Windows puede comprimir los archivos que no se


han usado recientemente. La compresión de archivos ahorra espacio en disco,
pero todavía se pueden usar los archivos. No se elimina ningún archivo. Dado que
los archivos se comprimen a diferentes velocidades, la cantidad mostrada de
espacio en disco que se obtendrá es aproximada. Un botón Opciones permite
especificar el número de días que hay que esperar antes de que el Liberador de
espacio en disco comprima un archivo sin usar.

Archivos de catálogo para el indizador de contenido: el servicio de indización


acelera y mejora las búsquedas de archivos, además de mantener un índice de los
archivos que están en el disco. Estos archivos de catálogo son restos de una
operación de indización anterior y pueden eliminarse con seguridad.

Nota: El archivo de catálogo puede aparecer en más de una unidad, por ejemplo,
no solo en %SystemRoot% .

7 Nota

Si especifica que desea liberar espacio en la unidad que contiene la instalación de


Windows, todas estas opciones están disponibles en la pestaña Liberador de
espacio en disco. Si especifica cualquier otra unidad, solo la Papelera de reciclaje y
los archivos de catálogo para las opciones de índice de contenido están disponibles
en la pestaña Liberador de espacio en disco.

Ejemplos
Para ejecutar la app Liberador de espacio en disco para que usted pueda usar su cuadro
de diálogo para especificar opciones para usarlas más adelante, guardando la
configuración en el conjunto 1, escriba lo siguiente:

cleanmgr /sageset:1

Para ejecutar el Liberador de espacio en disco e incluir las opciones que ha especificado
con el comando cleanmgr /sageset:1, escriba:

cleanmgr /sagerun:1

Para ejecutar cleanmgr /sageset:1 y cleanmgr /sagerun:1 juntos, escriba:

cleanmgr /tuneup:1

Vínculos relacionados
Liberar espacio en la unidad en Windows 10

Clave de sintaxis de línea de comandos


clip
Artículo • 14/04/2023

Redirige la salida del comando desde la línea de comandos al Portapapeles de Windows.


Puede usar este comando para copiar datos directamente en cualquier aplicación que
pueda recibir texto del Portapapeles. También puede pegar esta salida de texto en otros
programas.

Sintaxis

<command> | clip
clip < <filename>

Parámetros

Parámetro Descripción

<command> Especifica un comando cuya salida desea enviar al Portapapeles de Windows.

<filename> Especifica un archivo cuyo contenido desea enviar al Portapapeles de Windows.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para copiar la lista de directorios actual en el Portapapeles de Windows, escriba:

dir | clip

Para copiar la salida de un programa denominado generic.awk en el Portapapeles de


Windows, escriba:

awk -f generic.awk input.txt | clip


Para copiar el contenido de un archivo denominado readme.txt en el Portapapeles de
Windows, escriba:

clip < readme.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos
cls
Artículo • 12/04/2023

Borra la ventana del símbolo del sistema.

Sintaxis

cls

Parámetros

Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para borrar toda la información de la ventana del símbolo del sistema y volver a una
ventana en blanco, escriba:

cls

Vínculos relacionados
Clave de sintaxis de línea de comandos
cmd
Artículo • 07/10/2023

Inicia una nueva instancia del intérprete de comandos Cmd.exe. Si se usa sin
parámetros, cmd muestra la información de versión y propiedad intelectual del sistema
operativo.

Sintaxis

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 Descripción

/c Lleva a cabo el comando especificado por <string> y a continuación, sale del


procesador de comandos.

/k Lleva a cabo el comando especificado por <string> y mantiene el procesador de


comandos en ejecución.

/s Cuando se usa con /c o /k , desencadena reglas especiales que no son de análisis


que quitan las comillas primera y última ( " ) alrededor del <string> pero dejan sin
cambios el resto del comando.

/q Desactiva el eco.

/d Deshabilita la ejecución de comandos AutoRun.

/a Da formato a la salida del comando como American National Standards Institute


(ANSI).

/U Da formato a la salida del comando como Unicode.

/t:{ <b><f> | Establece los colores de fondo (b) y de primer plano (f).
<f> }

/e:on Habilita las extensiones de comando.

/e:off Deshabilita las extensiones de comandos.

/f:on Habilita la terminación del nombre de archivo y directorio.


Parámetro Descripción

/f:off Deshabilita la terminación del nombre de archivo y directorio.

/v:on Habilita la expansión diferida de variables de entorno.

/v:off Deshabilita la expansión diferida de variables de entorno.

<string> Especifica el comando que desea llevar a cabo.

/? Muestra la ayuda en el símbolo del sistema.

En la tabla siguiente se enumeran los dígitos hexadecimales válidos que puede usar
como valores para <b> y <f> :

Valor Color

0 Negro

1 Azul

2 Verde

3 Aqua

4 Rojo

5 Púrpura

6 Amarillo

7 Blanco

8 Gris

9 Azul claro

a Verde claro

b Aguamarina claro

c Rojo claro

d Púrpura claro

e Amarillo claro

f Blanco brillante

Comentarios
Para redirigir la salida del comando a la entrada de otro comando, use el carácter
de canalización ( | ). Por ejemplo:

<command1> | <command2>

Para redirigir la salida del comando a un archivo, use el carácter de corchete


angular mayor que > . Por ejemplo:

<command1> > <file1.txt>

Para usar varios comandos para <string> , separe mediante el separador de


comandos && . Por ejemplo:

<command1>&&<command2>&&<command3>

Si la ruta de acceso del directorio, los archivos o cualquier información que


proporcione contiene espacios, debe usar comillas dobles ( " ) alrededor del texto,
como "Computer Name" . Por ejemplo:

mkdir Test&&mkdir "Test 2"&&move "Test 2" Test

Debe usar comillas en torno a los siguientes caracteres especiales: &<> [ ] | { } ^ =


; ! ' + , ` ~ [espacio en blanco].

Si especifica /c o /k , los procesos de cmd , el resto de <string> , y las comillas solo


se conservan si se cumplen todas las condiciones siguientes:
Tampoco se usa /s .
Usa exactamente un conjunto de comillas.
No usa caracteres especiales entre comillas (por ejemplo: &<> ( ) @ ^ | ).
Puede usar uno o varios caracteres de espacio en blanco entre comillas.
El <string> entre comillas es el nombre de un archivo ejecutable.

Si no se cumplen las condiciones anteriores, <string> se procesa examinando el


primer carácter para comprobar si es una comilla de apertura. Si el primer carácter
es una comilla de apertura, se quita junto con la comilla de cierre. El texto que
sigue a las comillas de cierre se conserva.

Si no especifica /d , Cmd.exe busca las siguientes subclaves del registro:

HKEY_LOCAL_MACHINE\Software\Microsoft\Command
Processor\AutoRun\REG_SZ

HKEY_CURRENT_USER\Software\Microsoft\Command
Processor\AutoRun\REG_EXPAND_SZ

Si hay una o ambas subclaves del registro, se ejecutan antes que todas las demás
variables.

U Precaución

La edición incorrecta del Registro puede dañar gravemente el sistema. Antes


de realizar cambios en el Registro, debe hacer una copia de seguridad de los
datos de valor guardados en el equipo.

Puede deshabilitar las extensiones de comandos para un proceso concreto


mediante /e:off . Puede habilitar o deshabilitar extensiones para todas las
opciones de línea de comandos de cmd en un equipo o sesión de usuario
estableciendo los siguientes valores de REG_DWORD :

HKEY_LOCAL_MACHINE\Software\Microsoft\Command
Processor\EnableExtensions\REG_DWORD

HKEY_CURRENT_USER\Software\Microsoft\Command
Processor\EnableExtensions\REG_DWORD

Establezca el valor REG_DWORD en 0×1 (habilitado) o 0×0 (deshabilitado) en el


registro mediante Regedit.exe. La configuración especificada por el usuario tiene
prioridad sobre la configuración del equipo y las opciones de línea de comandos
tienen prioridad sobre la configuración del registro.

U Precaución

La edición incorrecta del Registro puede dañar gravemente el sistema. Antes


de realizar cambios en el Registro, debe hacer una copia de seguridad de los
datos de valor guardados en el equipo.
Al habilitar extensiones de comandos, se ven afectados los siguientes comandos:
assoc

call
chdir ( cd )

color

del ( erase )
endlocal

for
ftype

goto

if
mkdir ( md )

popd
prompt

pushd

set
setlocal

shift
start (también incluye cambios en los procesos de comandos externos)

Si habilita la expansión retardada de variables de entorno, puede utilizar el carácter


de signo de exclamación ( ! ) para sustituir el valor de una variable de entorno en
tiempo de ejecución.

La finalización del nombre de archivo y directorio no está habilitada de forma


predeterminada. Puede habilitar o deshabilitar la finalización del nombre de
archivo para un proceso determinado del comando cmd con /f:{on | off} .

Puede habilitar o deshabilitar la finalización del nombre de archivo y directorio


para todos los procesos del comando cmd en un equipo o para una sesión de
inicio de sesión de usuario estableciendo los siguientes 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 establecer el valor de REG_DWORD, ejecute Regedit.exe y use el valor


hexadecimal de un carácter de control para una función determinada (por ejemplo,
0×9 es TAB y 0×08 es RETROCESO). Use el valor [0×20] para espacios en blanco,
ya que no es un carácter de control válido. La configuración especificada por el
usuario tiene prioridad sobre la configuración del equipo y las opciones de línea
de comandos tienen prioridad sobre la configuración del registro.

U Precaución

La edición incorrecta del Registro puede dañar gravemente el sistema. Antes


de realizar cambios en el Registro, debe hacer una copia de seguridad de los
datos de valor guardados en el equipo.

Si habilita la finalización de nombres de archivo y directorio mediante /f:on , use


CTRL+D para completar el nombre del directorio y CTRL+F para la finalización del
nombre de archivo. La única diferencia entre las combinaciones de teclas CTRL+D
y CTRL+F es que CTRL+D solo coincide con los nombres de directorio y CTRL+F
coincide con los nombres de archivo y directorio. Si utiliza la finalización de
nombres de archivos y directorios en los comandos de directorio integrados cd ,
md o rd , se asume la finalización del directorio.

Al presionar CTRL+D o CTRL+F se procesa la terminación del nombre del archivo y


del directorio. Estas características de combinación de teclas agregan un carácter
comodín a <string> si no hay ninguno presente, compilan una lista de rutas que
coinciden y luego muestran la primera ruta coincidente. Si ninguna de las rutas
coincide, la función de finalización de nombres de archivos y directorios emite un
sonido y no cambia la pantalla.
Para desplazarse por la lista de rutas de acceso coincidentes, presione CTRL+D
o CTRL+F repetidamente.
Para desplazarse por la lista hacia atrás, presione la tecla MAYÚS y CTRL+D o
CTRL+F simultáneamente.
Para descartar la lista guardada de rutas de acceso coincidentes y generar una
nueva lista, edite <string> y presione ctrl+D o CTRL+F.
Si cambia entre CTRL+D y CTRL+F, se descarta la lista guardada de rutas de
acceso coincidentes y se genera una nueva lista.

La terminación de nombres de archivo y directorio procesa correctamente los


nombres de archivo que contienen espacios en blanco o caracteres especiales si
coloca comillas alrededor de la ruta de acceso coincidente.

Si procesa la finalización de nombres de archivos y directorios desde dentro de


<string> , en el punto <string> donde se procesó la finalización, se descarta

cualquier parte de la ruta y a la derecha del cursor.

Vínculos relacionados
Clave de sintaxis de línea de comandos
cmdkey
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea, enumera y elimina los nombres de usuario y las contraseñas o credenciales


almacenados.

Sintaxis

cmdkey [{/add:<targetname>|/generic:<targetname>}] {/smartcard | /user:


<username> [/pass:<password>]} [/delete{:<targetname> | /ras}] /list:
<targetname>

Parámetros

Parámetros Descripción

/add: <targetname> Agrega un nombre de usuario y una contraseña a la lista.


Requiere el parámetro de <targetname> que identifica el equipo o el
nombre de dominio al que se asociará esta entrada.

/generic: <targetname> Agrega credenciales genéricas a la lista.


Requiere el parámetro de <targetname> que identifica el equipo o el
nombre de dominio al que se asociará esta entrada.

/smartcard Recupera la credencial de una tarjeta inteligente. Si se encuentra más de


una tarjeta inteligente en el sistema cuando se usa esta opción, cmdkey
muestra información sobre todas las tarjetas inteligentes disponibles y, a
continuación, solicita al usuario que especifique cuál se va a usar.

/user: <username> Especifica el nombre de usuario o cuenta que se va a almacenar con esta
entrada. Si no se proporciona <username> , se solicitará.

/pass: <password> Especifica la contraseña que se va a almacenar con esta entrada. Si no se


proporciona <password> , se solicitará. Las contraseñas no se muestran
después de almacenarse.
Parámetros Descripción

/delete: {<targetname> Elimina un nombre de usuario y una contraseña de la lista. Si se


\| /ras} especifica <targetname> , se elimina esa entrada. Si se especifica /ras , se
elimina la entrada de acceso remoto almacenada.

/list: <targetname> Muestra la lista de nombres de usuario almacenados y credenciales. Si


no se especifica <targetname> , se muestran todos los nombres de
usuario almacenados y las credenciales.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para mostrar una lista de todos los nombres de usuario y credenciales que se
almacenan, escriba:

cmdkey /list

Para agregar un nombre de usuario y una contraseña para que el usuario Mikedan
acceda al equipo Server01 con la contraseña Kleo, escriba:

cmdkey /add:server01 /user:mikedan /pass:Kleo

Para agregar un nombre de usuario y una contraseña para que el usuario Mikedan
acceda al equipo Server01 y solicite la contraseña cada vez que se accede a Server01,
escriba:

cmdkey /add:server01 /user:mikedan

Para eliminar una credencial almacenada por acceso remoto, escriba:

cmdkey /delete /ras

Para eliminar una credencial almacenada para Server01, escriba:


cmdkey /delete:server01

Vínculos relacionados
Clave de sintaxis de línea de comandos
cmstp
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Instala o quita un perfil de servicio de Administrador de conexiones. Se usa sin


parámetros opcionales, cmstp instala un perfil de servicio con la configuración
predeterminada adecuada para el sistema operativo y para los permisos del usuario.

Sintaxis
Sintaxis 1: esta es la sintaxis típica que se usa en una aplicación de instalación
personalizada. Para usar esta sintaxis, debe ejecutar cmstp desde el directorio que
contiene el archivo <serviceprofilefilename>.exe .

<serviceprofilefilename>.exe /q:a /c:cmstp.exe <serviceprofilefilename>.inf


[/nf] [/s] [/u]

Sintaxis 2:

cmstp.exe [/nf] [/s] [/u] [drive:][path]serviceprofilefilename.inf

Parámetros

Parámetro Descripción

<serviceprofilefilename>.exe Especifica, por nombre, el paquete de instalación que contiene el


perfil que desea instalar.
Obligatorio para la sintaxis 1, pero no válido para la sintaxis 2.

/q:a Especifica que el perfil debe instalarse sin preguntar al usuario. El


mensaje de comprobación de que la instalación se ha realizado
correctamente seguirá apareciendo.
Obligatorio para la sintaxis 1, pero no válido para la sintaxis 2.
Parámetro Descripción

[drive:][path] Necesario. Especifica, por nombre, el archivo de configuración


<serviceprofilefilename>.inf que determina cómo se debe instalar el perfil.
El parámetro [drive:][path] no es válido para la sintaxis 1.

/nf Especifica que los archivos de soporte técnico no deben


instalarse.

/s Especifica que el perfil de servicio debe instalarse o desinstalarse


de forma silenciosa (sin solicitar la respuesta del usuario ni
mostrar el mensaje de comprobación). Este es el único
parámetro que puede usar en combinación con /u.

/U Especifica que el perfil de servicio se debe desinstalar.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para instalar el perfil de servicio fiction sin ningún archivo de soporte técnico, escriba:

fiction.exe /c:cmstp.exe fiction.inf /nf

Para instalar silenciosamente el perfil de servicio fiction para un solo usuario, escriba:

fiction.exe /c:cmstp.exe fiction.inf /s /su

Para desinstalar silenciosamente el perfil de servicio fiction, escriba:

fiction.exe /c:cmstp.exe fiction.inf /s /u

Vínculos relacionados
Clave de sintaxis de línea de comandos
color
Artículo • 09/10/2023

Cambia los colores de primer plano y de fondo en la ventana del símbolo del sistema de
la sesión actual. Si se usa sin parámetros, color restaura los colores predeterminados de
fondo y de primer plano de la ventana del símbolo del sistema.

Sintaxis
Símbolo del sistema de Windows

color [attr]

Parámetros

Parámetro Descripción

attr Especifique el atributo de color de la salida de la consola.

/? Muestra la ayuda en el símbolo del sistema.

En la tabla siguiente se enumeran los dígitos hexadecimales válidos que puede usar
como valores para attr :

Valor Color

0 Negro

1 Azul

2 Verde

3 Aqua

4 Rojo

5 Púrpura

6 Amarillo

7 Blanco

8 Gris

9 Azul claro
Valor Color

a Verde claro

b Aguamarina claro

c Rojo claro

d Púrpura claro

e Amarillo claro

f Blanco brillante

Comentarios
Puede especificar uno o dos dígitos hexadecimales. La primera se usa como color
de primer plano y la segunda se usa como color de fondo. Si especifica dos dígitos
hexadecimales, no use caracteres de espacio entre ellos.

Si especifica solo un dígito hexadecimal, el color correspondiente se usa como


color de primer plano y el color de fondo se establece en el color predeterminado.

Para establecer el color predeterminado de la ventana del símbolo del sistema,


seleccione la esquina superior izquierda de la ventana del símbolo del sistema,
seleccione Valores predeterminados, seleccione la pestaña Colores y, a
continuación, seleccione los colores que desea usar para el texto de pantalla y el
fondo de pantalla.

Si especifica el mismo valor para dos dígitos hexadecimales, ERRORLEVEL se


establece en 1 y no se realiza ningún cambio en el primer plano o en el color de
fondo.

Ejemplos
Para cambiar el color de fondo de la ventana del símbolo del sistema a gris y el color de
primer plano a rojo, escriba:

Símbolo del sistema de Windows

color 84

Para cambiar el color de primer plano de la ventana del símbolo del sistema a amarillo
claro, escriba:
Símbolo del sistema de Windows

color e

7 Nota

En este ejemplo, el fondo se establece en el color predeterminado porque solo se


especifica un dígito hexadecimal.

Vínculos relacionados
Clave de sintaxis de línea de comandos
comp
Artículo • 14/04/2023

Compara el contenido de dos archivos o conjuntos de archivos byte a byte. Estos


archivos pueden estar almacenados en la misma unidad o directorio o en unidades y
directorios diferentes. Cuando este comando compara los archivos, muestra su
ubicación y los nombres de los archivos. Si se usa sin parámetros, comp le pide que
escriba los archivos que se van a comparar.

Sintaxis

comp [<data1>] [<data2>] [/d] [/a] [/l] [/n=<number>] [/c]

Parámetros

Parámetro Descripción

<data1> Especifica la ubicación y el nombre del primer archivo o conjunto de archivos que
quiere comparar. Puede usar caracteres comodín (* y ?) para especificar varios
archivos.

<data2> Especifica la ubicación y el nombre del segundo archivo o conjunto de archivos


que quiere comparar. Puede usar caracteres comodín (* y ?) para especificar varios
archivos.

/d Muestra las diferencias en formato decimal. (El formato predeterminado es


hexadecimal).

/a Muestra las diferencias como caracteres.

/l Muestra el número de la línea en la que se produce una diferencia, en lugar de


mostrar el desplazamiento de bytes.

/n= <number> Compara solo el número de líneas especificadas para cada archivo, incluso si los
archivos tienen tamaños diferentes.

/C La comparación que realiza no distingue mayúsculas de minúsculas.

/off[line] Procesa archivos con el conjunto de atributos sin conexión.

/? Muestra la Ayuda en el símbolo del sistema.


Notas
Durante la comparación, comp muestra mensajes que identifican las ubicaciones
de información desigual entre los archivos. Cada mensaje indica la dirección de
memoria de desplazamiento de los bytes desiguales y el contenido de los bytes
(en notación hexadecimal, a menos que se especifique el parámetro de la línea de
comandos /a o /d). Los mensajes aparecen con el formato siguiente:

Compare error at OFFSET xxxxxxxx


file1 = xx
file2 = xx

Después de diez comparaciones desiguales, comp deja de comparar los archivos y


muestra este mensaje:

10 Mismatches - ending compare

Si omite los componentes necesarios de data1 o data2, o bien si omite data2 por
completo, este comando le pedirá la información que falta.

Si data1 contiene solo una letra de unidad o un nombre de directorio sin nombre
de archivo, este comando compara todos los archivos del directorio especificado
con el archivo especificado en data1.

Si data2 contiene solo una letra de unidad o un nombre de directorio, el nombre


de archivo predeterminado para data2 pasa a ser el mismo nombre que para
data1.

Si el comando comp no encuentra los archivos especificados, se le preguntará si


desea comparar otros archivos.

Los archivos que se comparan pueden tener el mismo nombre de archivo, siempre
que estén en directorios o unidades diferentes. Puede usar caracteres comodín (* y
?) para especificar nombres de archivo.

Debe especificar /n para comparar archivos de tamaños diferentes. Si los tamaños


de archivo son diferentes y no se especifica /n, se muestra este mensaje:

Files are different sizes


Compare more files (Y/N)?
Si desea comparar estos archivos de todos modos, presione N para detener el
comando. Luego, vuelva a ejecutar el comando comp con la opción /n para
comparar solo la primera parte de cada archivo.

Si usa caracteres comodín (* y ?) para especificar varios archivos, comp busca el


primer archivo que coincide con data1 y lo compara con el archivo
correspondiente en data2, si existe. El comando comp informa los resultados de la
comparación de cada archivo que coincide con data1. Cuando termine, comp
muestra el mensaje siguiente:

Compare more files (Y/N)?

Para comparar más archivos, presione Y. El comando comp le pedirá las


ubicaciones y los nombres de los archivos nuevos. Para detener las comparaciones,
presione N. Si presiona Y, se le preguntará qué opciones de la línea de comandos
usar. Si no especifica ninguna opción de la línea de comandos, comp usa las que
especificó antes.

Ejemplos
Para comparar el contenido del directorio c:\reports con el directorio de copia de
seguridad \\sales\backup\april , escriba:

comp c:\reports \\sales\backup\april

Para comparar las diez primeras líneas de los archivos de texto del el directorio \invoice
y mostrar el resultado en formato decimal, escriba:

comp \invoice\*.txt \invoice\backup\*.txt /n=10 /d

Vínculos relacionados
Clave de sintaxis de línea de comandos
compacto
Artículo • 12/04/2023

Muestra o modifica la compresión de archivos o directorios en particiones NTFS. Si se


utiliza sin parámetros, compact muestra el estado de compresión del directorio actual y
los archivos que contiene.

Sintaxis

compact [/C | /U] [/S[:dir]] [/A] [/I] [/F] [/Q] [/EXE[:algorithm]]


[/CompactOs[:option] [/windir:dir]] [filename [...]]

Parámetros

Parámetro Descripción

/C Comprime el directorio o archivo especificados. Los directorios se marcan para que


los archivos agregados posteriormente se compriman, a menos que se especifique
el parámetro /EXE.

/U Descomprime el directorio o archivo especificados. Los directorios se marcan para


que los archivos agregados posteriormente no se compriman. Si se especifica el
parámetro /EXE, solo se descomprimen los archivos comprimidos como
ejecutables. Si no especifica el parámetro /EXE, solo los archivos comprimidos
NTFS se descomprimen.

/s [:<dir>] Realiza la operación elegida en los archivos del directorio especificado y de todos
los subdirectorios. De manera predeterminada, el directorio actual se usa como el
valor <dir> .

/a Muestra archivos ocultos o del sistema. De manera predeterminada, estos archivos


no se incluyen.

/i Continúa realizando la operación especificada, ignorando los errores. De manera


predeterminada, este comando se detiene cuando encuentra un error.

/f Fuerza la compresión o descompresión del directorio o archivo especificados. Los


archivos ya comprimidos se omiten de manera predeterminada. El parámetro /f se
usa en caso de un archivo que se comprimió parcialmente cuando se interrumpió
la operación por un bloqueo del sistema. Para forzar que el archivo se comprima
en su totalidad, use los parámetros /c y /f y especifique el archivo comprimido
parcialmente.
Parámetro Descripción

/q Informa solo de la información más esencial.

/EXE Usa la compresión optimizada para archivos ejecutables que se leen con
frecuencia, pero que no se modifican. Los algoritmos admitidos son:
XPRESS4K (valor más rápido y predeterminado)
XPRESS8K
XPRESS16K
LZX (más compacto)

/CompactOs Establece o consulta el estado de compresión del sistema. Opciones admitidas:


query: Consulta el estado Compact del sistema.
always: Comprime todos los archivos binarios del sistema operativo y
establece el estado del sistema en Compact, que se mantiene a menos que
el administrador lo cambie.
never: Descomprime todos los archivos binarios del sistema operativo y
establece el estado del sistema en non-Compact, que se mantiene a menos
que el administrador lo cambie.

/windir Se usa con el parámetro /CompactOs:query al consultar el sistema operativo sin


conexión. Especifica el directorio donde está instalado Windows.

<filename> Especifica un patrón, un archivo o un directorio. Puede usar varios nombres de


archivo y los caracteres comodín * y ?.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Este comando es la versión de la línea de comandos de la característica de
compresión del sistema de archivos NTFS. El estado de compresión de un
directorio indica si los archivos se comprimen automáticamente cuando se
agregan al directorio. Establecer el estado de compresión de un directorio no
cambia necesariamente el estado de compresión de los archivos que ya están en el
directorio.

No puede usar este comando para leer, escribir o montar volúmenes comprimidos
mediante DriveSpace o DoubleSpace. Tampoco puede usar este comando para
comprimir las particiones de la tabla de asignación de archivos (FAT) o FAT32.

Ejemplos
Para establecer el estado de compresión del directorio actual, sus subdirectorios y
archivos existentes, escriba:

compact /c /s

Para establecer el estado de compresión de archivos y subdirectorios dentro del


directorio actual, sin modificar el estado de compresión del propio directorio actual,
escriba:

compact /c /s *.*

Para comprimir un volumen, desde el directorio raíz del volumen, escriba:

compact /c /i /s:\

7 Nota

En este ejemplo se establece el estado de compresión de todos los directorios


(incluido el directorio raíz del volumen) y se comprimen todos los archivos del
volumen. El parámetro /i impide que los mensajes de error interrumpan el proceso
de compresión.

Para comprimir todos los archivos con la extensión de nombre de archivo .bmp en el
directorio \tmp y todos los subdirectorios de \tmp, sin modificar el atributo comprimido
de los directorios, escriba:

compact /c /s:\tmp *.bmp

Para forzar la compresión completa del archivo zebra.bmp, que se comprimió


parcialmente durante un bloqueo del sistema, escriba:

compact /c /f zebra.bmp
Para quitar el atributo comprimido del directorio c:\tmp, sin cambiar el estado de
compresión de los archivos de ese directorio, escriba:

compact /u c:\tmp

Vínculos relacionados
Clave de sintaxis de línea de comandos
compact vdisk
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Reduce el tamaño físico de un archivo de disco duro virtual (VHD) de expansión


dinámica. Este parámetro es útil porque los VHD de expansión dinámica aumentan de
tamaño a medida que se agregan archivos, pero no se reducen automáticamente de
tamaño cuando se eliminan.

Sintaxis

compact vdisk

Comentarios
Debe seleccionarse un VHD de expansión dinámica para que esta operación se
realice correctamente. Use el comando select vdisk para seleccionar un VHD y
desplazar el foco a él.

Solo puede usar VHD de expansión dinámica compacta que están desasociados o
conectados como de solo lectura.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando attach vdisk

Comando detail vdisk

Comando detach vdisk

Comando expand vdisk

Comando merge vdisk

Comando select vdisk


Comando list
convert
Artículo • 14/04/2023

Convierte un disco de un tipo de disco en otro.

Sintaxis

convert basic
convert dynamic
convert gpt
convert mbr

Parámetros

Parámetro Descripción

Comando Convierte un disco dinámico vacío en un disco básico.


convert
basic

comando Convierte un disco básico en un disco dinámico.


convert
dynamic

Comando Convierte un disco básico vacío con el estilo de partición de registro de arranque
convert maestro (MBR) en un disco básico con el estilo de partición de tabla de particiones
gpt GUID (GPT).

Comando Convierte un disco básico vacío con el estilo de tabla de particiones GUID (GPT) en
convert un disco básico con el estilo partición de registro de arranque maestro (MBR).
mbr

Vínculos relacionados
Clave de sintaxis de línea de comandos
convert basic
Artículo • 12/04/2023

Convierte un disco dinámico vacío en un disco básico. Se debe seleccionar un disco


dinámico para que esta operación se realice correctamente. Use el comando select disk
para seleccionar un disco y desplazar el foco a él.

) Importante

El disco debe estar vacío para poder convertirlo en un disco básico. Haga una copia
de seguridad de los datos y, a continuación, elimine todas las particiones o
volúmenes antes de convertir el disco.

7 Nota

Para obtener instrucciones sobre cómo usar este comando, consulte Conversión de
un disco dinámico a un disco básico.

Sintaxis

convert basic [noerr]

Parámetros

Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para convertir el disco dinámico seleccionado en básico, escriba:
convert basic

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando convert
convert dynamic
Artículo • 12/04/2023

Convierte un disco básico en un disco dinámico. Se debe seleccionar un disco básico


para que esta operación se realice correctamente. Use el comando select disk para
seleccionar un disco básico y desplazar la concentración hacia dicho disco.

7 Nota

Para obtener instrucciones sobre cómo usar este comando, consulte Conversión de
un disco dinámico a un disco básico.

Sintaxis

convert dynamic [noerr]

Parámetros

Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Comentarios
Cualquier partición existente en el disco básico se convierte en un simple volumen.

Ejemplos
Para convertir un disco básico en un disco dinámico, escriba:

convert dynamic
Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando convert
convert gpt
Artículo • 14/04/2023

Convierte un disco básico vacío con el estilo de partición de registro de arranque


maestro (MBR) en un disco básico con el estilo de partición de tabla de particiones
GUID (GPT). Se debe seleccionar un disco MBR básico para que esta operación se realice
correctamente. Use el comando select disk para seleccionar un disco básico y cambiar el
foco hacia dicho disco.

) Importante

El disco debe estar vacío para poder convertirlo en un disco básico. Haga una copia
de seguridad de los datos y, a continuación, elimine todas las particiones o
volúmenes antes de convertir el disco. El tamaño mínimo de disco necesario para la
conversión a GPT es de 128 megabytes.

7 Nota

Para instrucciones sobre cómo usar este comando, consulte Cambiar un disco de
registro de arranque maestro por un disco de tabla de particiones GUID.

Sintaxis

convert gpt [noerr]

Parámetros

Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para convertir un disco básico del estilo de partición MBR al estilo de partición GPT,
escriba:

convert gpt

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando convert
convert mbr
Artículo • 14/04/2023

Convierte un disco básico vacío con el estilo de tabla de particiones GUID (GPT) en un
disco básico con el estilo partición de registro de arranque maestro (MBR). Se debe
seleccionar un disco básico para que esta operación se realice correctamente. Use el
comando select disk para seleccionar un disco básico y cambiar la concentración hacia
dicho disco.

) Importante

El disco debe estar vacío para poder convertirlo en un disco básico. Haga una copia
de seguridad de los datos y, a continuación, elimine todas las particiones o
volúmenes antes de convertir el disco.

7 Nota

Para obtener instrucciones sobre cómo usar este comando, consulte Cambiar un
disco de tabla de particiones GUID por un disco de registro de arranque maestro.

Sintaxis

convert mbr [noerr]

Parámetros

Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para convertir un disco básico del estilo de partición GPT al estilo de partición MBR,
escriba>:
convert mbr

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando convert
copy
Artículo • 14/04/2023

Copia uno o varios archivos de una ubicación a otra.

7 Nota

También puede usar el comando copy, con otros parámetros, desde la Consola de
recuperación. Para más información sobre la Consola de recuperación, consulte
Entorno de recuperación de Windows (Windows RE).

Sintaxis

copy [/d] [/v] [/n] [/y | /-y] [/z] [/a | /b] <source> [/a | /b] [+<source>
[/a | /b] [+ ...]] [<destination> [/a | /b]]

Parámetros

Parámetro Descripción

/d Permite que los archivos cifrados se guarden como archivos descifrados en el


destino.

/v Comprueba que los archivos nuevos se escriban correctamente.

/n Usa un nombre de archivo corto, si está disponible, al copiar un archivo con un


nombre de más de ocho caracteres o con una extensión de nombre de archivo
superior a tres caracteres.

/y Suprime la solicitud para confirmar que desea sobrescribir un archivo de destino


existente.

/-y Solicita que confirme que desea sobrescribir un archivo de destino existente.

/z Copia los archivos en red en modo de reinicio.

/a Indica un archivo de texto ASCII.

/b Indica un archivo binario.


Parámetro Descripción

<source> Necesario. Especifica la ubicación desde la que desea copiar un archivo o un


conjunto de archivos. El valor de origen puede ser una letra de unidad con dos
puntos, un nombre de directorio, un nombre de archivo o una combinación de
varios de estos elementos.

<destination> Necesario. Especifica la ubicación en la que desea copiar un archivo o un


conjunto de archivos. El valor de destino puede ser una letra de unidad con dos
puntos, un nombre de directorio, un nombre de archivo o una combinación de
varios de estos elementos.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Puede copiar un archivo de texto ASCII que use un carácter de fin de archivo
(CTRL+Z) para indicar el final del archivo.

Si /a precede o sigue a una lista de archivos en la línea de comandos, se aplica a


todos los archivos enumerados hasta que el comando copy encuentra /b. En este
caso, /b se aplica al archivo que precede a /b.

El efecto de /a depende de su posición en la cadena de la línea de comandos: - Si


/a sigue al origen, el comando copy trata el archivo como un archivo ASCII y copia
los datos que preceden al primer carácter de fin de archivo (CTRL+Z). - Si /a sigue
al destino, el comando copy agrega un carácter de fin de archivo (CTRL+Z) como el
último carácter del archivo.

/b indica al intérprete de comandos que lea el número de bytes especificados por


el tamaño del archivo en el directorio. /b es el valor predeterminado de copy, a
menos que copy combine archivos.

Si /b precede o sigue a una lista de archivos en la línea de comandos, se aplica a


todos los archivos enumerados hasta que el comando copy encuentra /a. En este
caso, /a se aplica al archivo que precede a /a.

El efecto de /b depende de su posición en la cadena de la línea de comandos: - Si


/b sigue al origen, el comando copy copia todo el archivo, incluido todos los
caracteres de fin de archivo (CTRL+Z). - Si /b sigue al destino, el comando copy no
agrega nngún carácter de fin de archivo (CTRL+Z).

Si no se puede comprobar una operación de escritura, aparece un mensaje de


error. Aunque es poco común que se produzcan errores de registro con el
comando copy, puede usar /v para comprobar que los datos críticos se registraron
correctamente. La opción de la línea de comandos /v también ralentiza el
comando copy, ya que se debe comprobar cada sector registrado en el disco.

Si /y está preestablecido en la variable de entorno COPYCMD, puede usar /-y en la


línea de comandos para invalidar esta configuración. De manera predeterminada,
se le pedirá que reemplace esta configuración, a menos que el comando copy se
ejecute en un script por lotes.

Para anexar archivos, especifique un archivo único como destino y varios archivos
como origen (use caracteres comodín o el formato archivo1+archivo2+archivo3).

Si se pierde la conexión durante la fase de copia (por ejemplo, si el servidor se


desconecta y se interrumpe la conexión), puede usar copy /z para reanudar la
operación después de restablecer la conexión. La opción /z también muestra el
porcentaje de la operación de copia completada para cada archivo.

Puede sustituir un nombre de dispositivo por una o varias apariciones de origen o


destino.

Si el destino es un dispositivo (por ejemplo, Com1 o Lpt1), la opción /b copia los


datos en el dispositivo en modo binario. En modo binario, copy /b copia todos los
caracteres (incluidos caracteres especiales como CTRL+C, CTRL+S, CTRL+Z y
ENTRAR) en el dispositivo, como datos. Sin embargo, si omite /b, los datos se
copian en el dispositivo en modo ASCII. En modo ASCII, los caracteres especiales
pueden hacer que los archivos se combinen durante el proceso de copia.

Si no especifica un archivo de destino, se crea una copia con el mismo nombre,


fecha de modificación y hora de modificación que el archivo original. La copia
nueva se almacena en el directorio actual de la unidad actual. Si el archivo de
origen está en la unidad actual y en el directorio actual y no se especifica una
unidad o directorio diferente para el archivo de destino, el comando copy se
detiene y muestra el mensaje de error siguiente:

File cannot be copied onto itself


0 File(s) copied

Si especifica más de un archivo en el origen, el comando copy los combina todos


en un archivo único con el nombre de archivo especificado en el destino. El
comando copy presupone que los archivos combinados son archivos ASCII, a
menos que se use la opción /b.
Para copiar archivos de 0 bytes de longitud o para copiar todos los archivos y
subdirectorios de un directorio, use el comando xcopy.

Para asignar la hora y la fecha actuales a un archivo sin modificarlo, use la sintaxis
siguiente:

copy /b <source> +,,

Donde las comas indican que el parámetro de destino se dejó fuera de manera
intencional.

Ejemplos
Para copiar un archivo denominado memo.doc en letter.doc en la unidad actual y
asegurarse de que haya un carácter de fin de archivo (CTRL+Z) al final del archivo
copiado, escriba:

copy memo.doc letter.doc /a

Para copiar un archivo denominado robin.typ desde la unidad y el directorio actuales a


un directorio existente denominado Birds que se encuentra en la unidad C, escriba:

copy robin.typ c:\birds

7 Nota

Si el directorio Birds no existe, el archivo robin.typ se copia en un archivo


denominado Birds que se encuentra en el directorio raíz del disco en la unidad C.

Para combinar Mar89.rpt, Apr89.rpt y May89.rpt, que se encuentran en el directorio


actual, y colocarlos en un archivo denominado Report (también en el directorio actual),
escriba:

copy mar89.rpt + apr89.rpt + may89.rpt Report


7 Nota

Si combina archivos, el comando copy marca el archivo de destino con la fecha y


hora actuales. Si omite el destino, los archivos se combinan y almacenan bajo el
nombre del primer archivo de la lista.

Para combinar todos los archivos en Report, cuando ya exista un archivo denominado
Report, escriba:

copy report + mar89.rpt + apr89.rpt + may89.rpt

Para combinar todos los archivos del directorio actual que tienen la extensión de
nombre de archivo .txt en un archivo único denominado Combined.doc, escriba:

copy *.txt Combined.doc

Para combinar varios archivos binarios en un archivo mediante caracteres comodín,


incluya /b. Esto impide que Windows trate a CTRL+Z como un carácter de fin de archivo.
Por ejemplo, escriba:

copy /b *.exe Combined.exe

U Precaución

Si combina archivos binarios, es posible que el archivo resultante no se pueda usar


debido al formato interno.

Al combinar cada archivo que tiene una extensión .txt con su archivo .ref
correspondiente, se crea un archivo con el mismo nombre de archivo, pero con
una extensión .doc. El comando Copy combina file1.txt con file1.ref para formar
file1.doc y, a continuación, el comando combina file2.txt con file2.ref para formar
file2.doc, y así sucesivamente. Por ejemplo, escriba:
copy *.txt + *.ref *.doc

Para combinar todos los archivos que tienen la extensión .txt y, luego, combinar todos
los archivos que tienen la extensión .ref en un archivo denominado Combined.doc,
escriba:

copy *.txt + *.ref Combined.doc

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando xcopy
create
Artículo • 14/04/2023

Crea una partición o partición de instantáneas en un disco, un volumen en uno o varios


discos o un disco duro virtual (VHD). Si usa este comando para crear un volumen en el
disco de instantáneas, ya debe tener al menos un volumen en el conjunto de
instantáneas.

Sintaxis

create partition
create volume

Parámetros

Parámetro Descripción

Comando create Crea una partición principal en el disco básico con el foco.
partition primary

Comando create Crea una partición del sistema de la interfaz extensible de firmware (EFI) en un
partition efi disco de tabla de particiones GUID (gpt) en equipos basados en Itanium.

Comando create Crea una partición extendida en el disco con el foco.


partition
extended

Comando create Crea una partición lógica en una partición extendida existente.
partition logical

Comando create Crea una partición reservada de Microsoft (MSR) en un disco de tabla de
partition msr particiones GUID (gpt).

Comando create Crea un volumen simple en el disco dinámico especificado.


volume simple

Comando create Crea un volumen reflejado con los dos discos dinámicos especificados.
volume mirror

Comando create Crea un volumen RAID-5 con tres o más discos dinámicos especificados.
volume raid
Parámetro Descripción

Comando create Crea un volumen seccionado usando dos o más discos dinámicos
volume stripe especificados.

Vínculos relacionados
Clave de sintaxis de línea de comandos
create partition efi
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea una partición del sistema de la Interfaz extensible de firmware (EFI) en un disco de
tabla de particiones GUID (gpt) en equipos basados en Itanium. Después de crear la
partición, esta recibe el foco.

7 Nota

Se debe seleccionar un disco GPT para que esta operación se realice


correctamente. Use el comando select disk para seleccionar un disco y desplazar el
foco a él.

Sintaxis

create partition efi [size=<n>] [offset=<n>] [noerr]

Parámetros

Parámetro Descripción

size= <n> El tamaño de la partición en megabytes (MB). Si no se indica un tamaño, la partición


continuará mientras haya espacio libre en la región actual.

offset= <n> El desplazamiento en kilobytes (KB), en el que se crea la partición. Si no se indica un


desplazamiento, la partición se colocará en la primera zona del disco que sea lo
suficientemente grande como para albergarla.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Comentarios
Debe agregar al menos un volumen con el comando add volume para poder usar
el comando create.

Después de ejecutar el comando create, puede usar el comando exec para ejecutar
un script de duplicación para la copia de seguridad desde la instantánea.

Puede usar el comando begin backup para especificar una copia de seguridad
completa, en lugar de una copia de la copia de seguridad.

Ejemplos
Para crear una partición EFI de 1000 megabytes en el disco seleccionado, escriba:

create partition efi size=1000

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando create

select disk
create partition extended
Artículo • 05/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea una partición extendida en el disco con foco. Después de crear la partición, ésta
recibe el foco automáticamente.

) Importante

Puede usar este comando solo en discos de registro de arranque maestro (MBR).
Debe usar el comando select disk para seleccionar un disco MBR básico y cambiar
la concentración hacia dicho disco.

Se debe crear una partición extendida para poder crear unidades lógicas. Sólo es
posible crear una partición extendida por disco. Este comando produce un error si
se intenta crear una partición extendida dentro de otra partición extendida.

Sintaxis

create partition extended [size=<n>] [offset=<n>] [align=<n>] [noerr]

Parámetros

Parámetro Descripción

size= <n> Especifica el tamaño de la partición en megabytes (MB). Si no se indica un tamaño,


la partición continuará mientras haya espacio libre en la región.

offset= Especifica el desplazamiento en kilobytes (KB), en el que se crea la partición. Si no se


<n> proporciona ningún desplazamiento, la partición se iniciará al principio del espacio
libre en el disco que sea lo suficientemente grande como para contener la nueva
partición.

align= <n> Alinea todas las extensiones de partición con el límite de alineación más cercano. Se
utiliza normalmente con matrices de número de unidad lógica (LUN) de RAID de
Parámetro Descripción

hardware para mejorar el rendimiento. <n> es el número de kilobytes (KB) desde el


principio del disco hasta el límite de alineación más cercano.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para crear una partición extendida de 1000 megabytes de tamaño, escriba:

create partition extended size=1000

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando create

select disk
create partition logical
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea una partición lógica en una partición extendida existente. Después de crear la
partición, ésta recibe el foco automáticamente.

) Importante

Puede usar este comando solo en discos de registro de arranque maestro (MBR).
Debe usar el comando select disk para seleccionar un disco MBR básico y cambiar
la concentración hacia dicho disco.

Se debe crear una partición extendida para poder crear unidades lógicas.

Sintaxis

create partition logical [size=<n>] [offset=<n>] [align=<n>] [noerr]

Parámetros

Parámetro Descripción

size= <n> Especifica el tamaño de la partición lógica en megabytes (MB), que debe ser menor
que la partición extendida. Si no se indica un tamaño, la partición continuará
mientras haya espacio libre en la partición extendida.

offset= <n> Especifica el desplazamiento en kilobytes (KB), en el que se crea la partición. El


desplazamiento redondea hacia arriba para llenar el tamaño de cilindro que se
utilice. Si no se indica un desplazamiento, la partición se ubicará en la primera zona
del disco que sea lo suficientemente grande como para albergarla. La longitud en
bytes de la partición es, como mínimo, el número especificado por size= <n> . Si se
especifica el tamaño de la partición lógica, debe ser menor que el de la partición
extendida.
Parámetro Descripción

align= <n> Alinea todas las extensiones de volumen o partición con el límite de alineación más
cercano. Se utiliza normalmente con matrices de número de unidad lógica (LUN) de
RAID de hardware para mejorar el rendimiento. <n> es el número de kilobytes (KB)
desde el principio del disco hasta el límite de alineación más cercano.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Comentarios
Si no se especifican los parámetros de tamaño y desplazamiento, la partición
lógica se crea en la extensión de disco más grande disponible en la partición
extendida.

Ejemplos
Para crear una partición lógica de 1000 megabytes de tamaño, en la partición extendida
del disco seleccionado, escriba:

create partition logical size=1000

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando create

select disk
create partition msr
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea una partición reservada de Microsoft (MSR) en un disco de tabla de particiones


GUID (gpt). Se requiere una partición reservada de Microsoft en cada disco GPT. El
tamaño de esta partición depende del tamaño total del disco GPT. El tamaño del disco
GPT debe ser de al menos 32 MB para crear una partición reservada de Microsoft.

) Importante

Tenga mucho cuidado al usar este comando. Dado que los discos GPT requieren un
diseño de particiones específico, la creación de particiones reservadas de Microsoft
podría hacer ilegible el disco.

Se debe seleccionar un disco GPT básico para que esta operación se realice
correctamente. Debe usar el comando select disk para seleccionar un disco GPT
básico y cambiar la concentración hacia dicho disco.

Sintaxis

create partition msr [size=<n>] [offset=<n>] [noerr]

Parámetros

Parámetro Descripción

size= <n> El tamaño de la partición en megabytes (MB). La longitud en bytes de la partición


es, como mínimo, el número especificado por <n> . Si no se indica un tamaño, la
partición continuará mientras haya espacio libre en la región actual.

offset= <n> Especifica el desplazamiento en kilobytes (KB), en el que se crea la partición. El


desplazamiento redondea hacia arriba para llenar el tamaño de sector que se utilice.
Si no se indica un desplazamiento, la partición se colocará en la primera zona del
disco que sea lo suficientemente grande como para albergarla.
Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Comentarios
En los discos GPT que se usan para arrancar el sistema operativo Windows, la
partición del sistema de la Extensible Firmware Interface (EFI) es la primera
partición del disco, seguida de la partición reservada de Microsoft. Los discos GPT
que solo se usan para almacenamiento de datos no tienen una partición de
sistema EFI; la primera partición es la partición reservada de Microsoft.

Windows no monta particiones reservadas de Microsoft. No se puede almacenar


datos en ellas y no se pueden eliminar.

Ejemplos
Para crear una partición reservada de Microsoft de 1000 megabytes de tamaño, escriba:

create partition msr size=1000

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando create

select disk
create partition primary
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea una partición principal en el disco básico con concentración. Después de crear la
partición, ésta recibe el foco automáticamente.

) Importante

Se debe seleccionar un disco básico para que esta operación se realice


correctamente. Debe usar el comando select disk para seleccionar un disco básico
y desplazar la concentración a él.

Sintaxis

create partition primary [size=<n>] [offset=<n>] [id={ <byte> | <guid> }]


[align=<n>] [noerr]

Parámetros

Parámetro Descripción

size= <n> Especifica el tamaño de la partición en megabytes (MB). Si no indica un tamaño, la


partición continuará mientras haya espacio no asignado en la región actual.

offset= <n> El desplazamiento en kilobytes (KB), en el que se crea la partición. Si no se indica


ningún desplazamiento, la partición se iniciará al principio de la mayor extensión del
disco que sea lo suficientemente grande como para contenerla.

align= <n> Alinea todas las extensiones de partición con el límite de alineación más cercano. Se
utiliza normalmente con matrices de número de unidad lógica (LUN) de RAID de
hardware para mejorar el rendimiento. <n> es el número de kilobytes (KB) desde el
principio del disco hasta el límite de alineación más cercano.
Parámetro Descripción

id={ Especifica el tipo de partición. Este parámetro está pensado solo para el uso del
<byte> | fabricante de equipos originales (OEM). El byte de tipo de partición o GUID se
<guid> } puede especificar con este parámetro. DiskPart no comprueba la validez del tipo de
partición excepto para asegurarse de que es un byte en forma hexadecimal o un
GUID. Precaución: La creación de particiones con este parámetro puede hacer que
el equipo deje de funcionar o no se pueda iniciar. A menos que sea un fabricante de
equipo original (OEM) o un profesional de TI con experiencia en discos GPT, no
debe crear particiones en discos GPT con este parámetro. En su lugar, use siempre
el comando create partition efi para crear particiones de sistema EFI, el comando
create partition msr para crear particiones reservadas de Microsoft y el comando
create partition primary (sin el parámetro id={ <byte> | <guid> ) para crear
particiones primarias en discos GPT.

En el caso de los discos de registro de arranque maestro (MBR), se puede


especificar un byte de tipo de partición, en forma hexadecimal, para la partición. Si
no se especifica este parámetro, el comando crea una partición de tipo 0x06 , que
especifica que un sistema de archivos no está instalado. Algunos ejemplos son:

Partición de datos LDM: 0x42


Partición de recuperación: 0x27
Partición OEM reconocida: 0x12, 0x84, 0xDE, 0xFE, 0xA0

En el caso de los discos de tabla de particiones GUID (GPT), se puede especificar


un GUID de tipo de partición para la partición. Los GUID reconocidos incluyen:

Partición del sistema EFI: c12a7328-f81f-11d2-ba4b-00a0c93ec93b


Partición reservada de Microsoft: e3c9e316-0b5c-4db8-817d-f92df00215ae
Partición de datos básicos: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
Partición de metadatos LDM (disco dinámico): 5808c8aaa-7e8f-42e0-85d2-
e1e90434cfb3
Partición de datos LDM (disco dinámico): af9b60a0-1431-4f62-bc68-
3311714a69ad
Partición de recuperación: de94bba4-06d1-4d40-a16a-bfd50179d6ac

Si no se especifica este parámetro para un disco GPT, el comando crea una


partición de datos básica.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Si no se especifica el parámetro noerr,
un error hará que DiskPart se cierre con un código de error.

Ejemplos
Para crear una partición principal de 1000 megabytes de tamaño, escriba:
create partition primary size=1000

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando assign

Comando create

select disk
create volume mirror
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea un volumen reflejado con dos discos dinámicos especificados. Después de crear el
volumen, el foco pasa automáticamente al nuevo volumen.

Sintaxis

create volume mirror [size=<n>] disk=<n>,<n>[,<n>,...] [align=<n>] [noerr]

Parámetros

Parámetro Descripción

size= <n> Cantidad de espacio en disco, en megabytes (MB), que ocupará el volumen en
cada disco. Si no se especifica tamaño, el nuevo volumen ocupará todo el
espacio que quede libre en el disco más pequeño y cantidades equivalentes de
espacio en los discos sucesivos.

disk= <n> , <n> [ , Especifica los discos dinámicos en los que se crea el volumen reflejado.
<n>,... ] Necesita dos discos dinámicos para crear un volumen reflejado. Se asigna una
cantidad de espacio igual al tamaño especificado con el parámetro size en
cada disco.

align= <n> Alinea todas las extensiones de volumen con el límite de alineación más
cercano. Este parámetro se usa normalmente con matrices de número de
unidad lógica RAID (LUN) de hardware para mejorar el rendimiento. <n> es el
número de kilobytes (KB) desde el principio del disco hasta el límite de
alineación más cercano.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hará
que DiskPart se cierre con un error.

Ejemplos
Para crear un volumen reflejado de 1000 megabytes de tamaño, en los discos 1 y 2,
escriba:

create volume mirror size=1000 disk=1,2

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando create
create volume raid
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea un volumen RAID-5 con tres o más discos dinámicos especificados. Después de
crear el volumen, el foco cambiará automáticamente al nuevo volumen.

Sintaxis

create volume raid [size=<n>] disk=<n>,<n>,<n>[,<n>,...] [align=<n>] [noerr]

Parámetros

Parámetro Descripción

size= <n> Cantidad de espacio en disco, en megabytes (MB), que ocupará el volumen en cada
disco. Si no se indica ningún tamaño, se creará el volumen RAID-5 más grande
posible. El disco con el menor espacio contiguo libre determina el tamaño del
volumen RAID-5, pues se asigna la misma cantidad de espacio de cada disco. La
cantidad real de espacio de disco que se puede utilizar en el volumen RAID-5 es
inferior a la cantidad conjunta de espacio de disco porque parte del espacio del
disco es necesario para la paridad.

disk= <n>, Los discos dinámicos en los que se va a crear el volumen RAID-5. Necesitará al
<n>,<n>[, menos tres discos dinámicos para crear un volumen RAID-5. En cada disco se asigna
<n>,...] un espacio equivalente a size=<n> .

align= <n> Alinea todas las extensiones de volumen con el límite de alineación más cercano. Se
utiliza normalmente con matrices de número de unidad lógica (LUN) de RAID de
hardware para mejorar el rendimiento. <n> es el número de kilobytes (KB) desde el
principio del disco hasta el límite de alineación más cercano.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para crear un volumen RAID-5 de 1000 megabytes de tamaño, con discos 1, 2 y 3,
escriba:

create volume raid size=1000 disk=1,2,3

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando create
create volume simple
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea un volumen simple en el disco dinámico especificado. Después de crear el


volumen, el foco cambiará automáticamente al nuevo volumen.

Sintaxis

create volume simple [size=<n>] [disk=<n>] [align=<n>] [noerr]

Parámetros

Parámetro Descripción

size= <n> Tamaño del volumen en megabytes (MB). Si no se especifica tamaño, el nuevo
volumen ocupará todo el espacio que quede libre en el disco.

disk= <n> Disco dinámico en el que se crea el volumen. Si no se especifica ningún disco, se
utilizará el disco actual.

align= <n> Alinea todas las extensiones de volumen con el límite de alineación más cercano. Se
utiliza normalmente con matrices de número de unidad lógica (LUN) de RAID de
hardware para mejorar el rendimiento. <n> es el número de kilobytes (KB) desde el
principio del disco hasta el límite de alineación más cercano.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para crear un volumen de 1000 megabytes de tamaño, en el disco 1, escriba:

create volume simple size=1000 disk=1


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando create
create volume stripe
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea un volumen seccionado usando dos o más discos dinámicos especificados.


Después de crear el volumen, el foco cambiará automáticamente al nuevo volumen.

Sintaxis

create volume stripe [size=<n>] disk=<n>,<n>[,<n>,...] [align=<n>] [noerr]

Parámetros

Parámetro Descripción

size= <n> Cantidad de espacio en disco, en megabytes (MB), que ocupará el volumen en cada
disco. Si no se especifica tamaño, el nuevo volumen ocupará todo el espacio que
quede libre en el disco más pequeño y cantidades equivalentes de espacio en los
discos sucesivos.

disk= <n>, Los discos dinámicos en los que se crea el volumen seccionado. Necesitará al menos
<n>[, dos discos dinámicos para crear un volumen seccionado. En cada disco se asigna un
<n>,...] espacio equivalente a size=<n> .

align= <n> Alinea todas las extensiones de volumen con el límite de alineación más cercano. Se
utiliza normalmente con matrices de número de unidad lógica (LUN) de RAID de
hardware para mejorar el rendimiento. <n> es el número de kilobytes (KB) desde el
principio del disco hasta el límite de alineación más cercano.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para crear un volumen seccionado de 1000 megabytes de tamaño, en los discos 1 y 2,
escriba:
create volume stripe size=1000 disk=1,2

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando create
cscript
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Inicia un script para ejecutarse en un entorno de línea de comandos.

) Importante

La realización de esta tarea no le exige que tenga credenciales administrativas. Por


consiguiente, como medida de seguridad recomendada, considere la posibilidad de
realizar esta tarea como un usuario sin credenciales administrativas.

Sintaxis

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 Descripción

scriptname.extension Especifica la ruta de acceso y el nombre de archivo del archivo de script


con la extensión de nombre de archivo opcional.

/b Especifica el modo por lotes, que no muestra alertas, errores de scripting


o mensajes de entrada.

/d Inicia el depurador.

/e: <engine> Especifica el motor que se usa para ejecutar el script.

/h:cscript Registra cscript.exe como host de script predeterminado para ejecutar


scripts.

/h:wscript Registra wscript.exe como host de script predeterminado para ejecutar


scripts. El valor predeterminado.
Parámetro Descripción

/i Especifica el modo interactivo, que muestra alertas, errores de scripting y


mensajes de entrada. Valor predeterminado y lo contrario de /b .

/job: <identifier> Ejecuta el trabajo identificado por identificador en un archivo de script


.wsf.

/logo Especifica que el banner host de Windows Script se muestra en la consola


antes de que se ejecute el script. Valor predeterminado y lo contrario de
/nologo .

/nologo Especifica que el banner del host de Windows Script no se muestra antes
de que se ejecute el script.

/s Guarda las opciones actuales del símbolo del sistema para el usuario
actual.

/t: <seconds> Especifica el tiempo máximo que puede ejecutar el script (en segundos).
Puede especificar hasta 32 767 segundos. El valor predeterminado no es
un límite de tiempo.

/U Especifica Unicode para la entrada y salida que se redirige desde la


consola.

/x Inicia el script en el depurador.

/? Muestra los parámetros de comando disponibles y proporciona ayuda


para su uso. Lo mismo que escribir cscript.exe sin parámetros y ningún
script.

scriptarguments Especifica los argumentos pasados al script en el inicio. Cada argumento


de script debe ir precedido de una barra diagonal (/).

Comentarios
Cada parámetro es opcional; sin embargo, no se pueden especificar argumentos
de script sin especificar un script. Si no especifica un script ni ningún argumento de
script, cscript.exe muestra la sintaxis de cscript.exe y las opciones de host válidas.

El parámetro /t impide la ejecución excesiva de scripts estableciendo un


temporizador. Cuando el tiempo de ejecución supera el valor especificado, cscript
interrumpe el motor de scripts y finaliza el proceso.

Los archivos de script de Windows suelen tener una de las siguientes extensiones
de nombre de archivo: .wsf, .vbs, .js. Windows Script Host puede usar archivos de
script .wsf. Cada archivo .wsf puede usar varios motores de scripting y realizar
varios trabajos.
Si hace doble clic en un archivo de script con una extensión que no tiene ninguna
asociación, aparecerá el cuadro de diálogo Abrir con. Seleccione wscript o cscript
y, a continuación, seleccione Usar siempre este programa para abrir este tipo de
archivo. Esto registra wscript.exe o cscript como host de script predeterminado
para los archivos de este tipo de archivo.

Vínculos relacionados
Clave de sintaxis de línea de comandos
date
Artículo • 12/04/2023

Muestra o establece la fecha del sistema. Si se usa sin parámetros, date muestra la
configuración de fecha actual del sistema y le pide que introduzca una nueva fecha.

) Importante

Debe ser administrador para usar este comando.

Sintaxis

date [/t | <month-day-year>]

Parámetros

Parámetro Descripción

<month- Establece la fecha especificada, donde month es el mes (uno o dos dígitos, incluidos
day-year> los valores del 1 al 12), day es el día (uno o dos dígitos, incluidos los valores del 1 al
31), y year es el año (dos o cuatro dígitos, incluidos los valores de 00 a 99 o de 1980
a 2099). Debe separar los valores de month, day y year con puntos (.), guiones (-) o
barra diagonal (/).

Nota: Tenga en cuenta si usa dos dígitos para representar el año, los valores del 80
al 99 corresponden a 1980 a 1999.

/t Muestra la fecha actual sin solicitarle una nueva fecha.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Si las extensiones de comandos están habilitadas, para mostrar la fecha actual del
sistema, escriba:

date /t
Para cambiar la fecha actual del sistema al 3 de agosto de 2007, puede escribir
cualquiera de las siguientes opciones:

date 08.03.2007
date 08-03-07
date 8/3/07

Para mostrar la fecha actual del sistema seguida de una solicitud para escribir una fecha
nueva, escriba:

date

Para mantener la fecha actual y volver al símbolo del sistema, presione ENTRAR. Para
cambiar la fecha actual, escriba la nueva fecha en función de la configuración de fecha
actual, como se muestra en el segundo ejemplo anterior y, a continuación, presione
ENTRAR.

Vínculos relacionados
Clave de sintaxis de línea de comandos
Dcdiag
Artículo • 20/11/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016

DCDiag.exe analiza el estado de los controladores de dominio (DC) en un bosque o empresa e

informa de cualquier problema que le ayude a solucionar problemas. Como programa de


informes de usuarios finales, DCDiag es una herramienta de línea de comandos que encapsula
conocimientos detallados sobre cómo identificar el comportamiento anómalo en el sistema.

De forma predeterminada, DCDiag está disponible fácilmente si ha iniciado sesión en un


controlador de dominio. Un método alternativo para acceder a DCDiag es instalar las
Herramientas de administración remota del servidor (RSAT) en el dispositivo. DCDiag debe
ejecutarse con derechos administrativos desde un símbolo del sistema con privilegios elevados
(CMD) o PowerShell.

DCDiag consta de un marco para ejecutar pruebas y una serie de pruebas para comprobar
diferentes áreas funcionales del sistema. Este marco selecciona qué controlador de dominio se
prueba según las directivas de ámbito del usuario, como empresa, sitio o servidor único. Probar
la conectividad general y la capacidad de respuesta del controlador de dominio incluye la
comprobación:

El controlador de dominio se puede ubicar en DNS.


El controlador de dominio responde a pings del Protocolo de mensajes de control de
Internet (ICMP)
El controlador de dominio permite la conectividad del Protocolo ligero de acceso a
directorios (LDAP) mediante el enlace a la instancia.
El controlador de dominio permite enlazar a la interfaz RPC de AD mediante la función
DsBindWithCred.

7 Nota

Bloquear ICMP impide que DCDiag funcione según lo previsto. Aunque se recomienda
bloquear ICMP en el borde de Internet de la red, el bloqueo interno del tráfico ICMP
provoca problemas administrativos que interrumpen las directivas de grupo heredadas, la
detección de enrutadores de agujero negro o tamaños MTU ineficaces debido a la falta de
una opción de detección. Las herramientas de solución de problemas como ping.exe o
tracert.exe también se ven afectadas.

Sintaxis 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>]

DCDiag usa los parámetros siguientes:

Parámetro Descripción

/s: <DomainController> Especifica el nombre del servidor en el que se va a ejecutar el comando. Si


no se especifica este parámetro, las pruebas se ejecutan en el controlador de
dominio local.

Este parámetro se omite para las pruebas DcPromo y RegisterInDns, que


solo se pueden ejecutar localmente.

/n: <NamingContext> Usa NamingContext como contexto de nomenclatura para probar. Puede
especificar dominios en el formato de NetBIOS, del Sistema de nombres de
dominio (DNS) o de nombre distintivo.

/u: <Domain> \ <UserName> /p: Uses Domain\UserName. DCDiag usa las credenciales actuales del usuario (o
{ <Password> | ""} proceso) que ha iniciado sesión. Si se necesitan credenciales alternativas, use
las siguientes opciones para proporcionar esas credenciales para el enlace
con contraseña como contraseña: use comillas ("") para una contraseña vacía
o nula. Use el carácter comodín (*) para solicitar la contraseña.

/a Prueba todos los servidores de este sitio de AD DS.

/e Prueba todos los servidores de la empresa. Esto invalida /a .

/q Discreto. Solo imprime los mensajes de error.

/v Detallado. Imprime información adicional.

/fix Afecta solo a la prueba MachineAccount. Este parámetro hace que la prueba
corrija los nombres de entidades de seguridad de servicio (SPN) en el objeto
Cuenta de máquina del controlador de dominio.

/f: <LogFile> Redirige toda la salida a un archivo de registro.

/C Completo. Ejecuta todas las pruebas excepto DCPromo y RegisterInDNS,


incluidas las pruebas no predeterminadas. Opcionalmente, puede usar este
parámetro con el parámetro /skip para omitir las pruebas especificadas.

Las siguientes pruebas no se ejecutan de forma predeterminada:

Topología
CutoffServers
OutboundSecureChannels.

/h o /? Muestra la ayuda en el símbolo del sistema.

/test: <Test> Ejecuta solo esta prueba. La prueba de conectividad no se puede omitir con
el parámetro /skip .
Parámetro Descripción

/ReplSource: Comprueba la conexión entre el controlador de dominio en el que se


<SourceDomainController> ejecuta el comando y el controlador de dominio de origen. (Este parámetro
se usa para la prueba CheckSecurityError).

SourceDomainController es el nombre DNS, el nombre NetBIOS o el nombre


distintivo de un servidor real o potencial que será el controlador de dominio
de origen para la replicación, tal como lo representa un objeto de conexión
real o potencial.

Pruebas conocidas de DCDiag


En la tabla siguiente se muestran las pruebas conocidas que se ejecutan de forma
predeterminada a menos que se especifique lo contrario.

Prueba Descripción

Publicidad Comprueba si cada controlador de dominio se anuncia en los roles que debe ser
capaz de realizar. Esta prueba valida que la función pública DsGetDcName que usan
los equipos para buscar controladores de dominio localizará correctamente los
controladores de dominio.

Esta prueba produce un error si el servicio Netlogon se ha detenido o no se ha podido


iniciar. Si se detiene el servicio Clave de distribución de claves (KDC), se produce un
error en la prueba de publicidad, ya que la marca devuelta desde DsGetDcName no
incluirá KDC. Si el puerto 88 a través de TCP y UDP está bloqueado en un firewall, la
prueba de publicidad pasará a pesar de que el KDC no pueda responder a las
solicitudes de vales Kerberos.

CheckSDRefDom Comprueba que todas las particiones del directorio de aplicaciones tienen dominios
de referencia de descriptores de seguridad adecuados.

Esta prueba usa LDAP y valida objetos de referencia cruzada ubicados en


cn=partitions,cn=configuration,dc=<dominio raíz del bosque>contienen los
nombres de dominio correctos en sus atributos de msDS-SDReferenceDomain.

CheckSecurityError La prueba no se ejecuta de forma predeterminada. Realiza varias comprobaciones de


seguridad para los errores relacionados con los componentes de seguridad del
controlador de dominio, como problemas con la directiva de seguridad o la base de
datos de seguridad mediante LDAP, RPC, RPC a través de SMB e ICMP. Comprueba:

Que al menos un KDC está en línea para cada dominio y es accesible.


Ese objeto de equipo de controladores de dominio se ha replicado en otros
controladores de dominio.
Si la fragmentación de paquetes de Kerberos a través de UDP podría ser un
problema basado en el tamaño de MTU actual mediante el envío de paquetes
ICMP sin fragmentación.
No hay ningún problema de conexión del comprobador de coherencia de
conocimiento (KCC) ni de replicación para asociados conectados consultando la
función DsReplicaGetInfo para obtener errores relacionados con la seguridad.
Prueba Descripción

Si la cuenta de equipo de controladores de dominio existe en Active Directory


(AD) como parte de la unidad organizativa predeterminada "Controladores de
dominio" junto con las marcas UserAccountControl correctas para los
controladores de dominio, se establecen los atributos ServerReference correctos
y tiene configurados los nombres de entidad de seguridad de servicio (SPN)
mínimos necesarios.

Cuando se agrega el parámetro /ReplSource, el asociado también comprueba lo


siguiente:

La asimetría de tiempo calculada entre los servidores para comprobar que es


inferior a 300 segundos (5 minutos) para Kerberos. No comprueba la directiva
Kerberos para ver si se ha modificado la asimetría permitida.
Permisos en todos los contextos de nomenclatura (como Esquema,
Configuración, etc.) en el controlador de dominio de origen que valida las
funciones de replicación y conectividad entre controladores de dominio.
Conectividad para validar que el usuario que ejecuta DCDiag puede conectarse
y leer los recursos compartidos SYSVOL y NETLOGON sin errores de seguridad.
El Acceso a este equipo desde el privilegio dered en el controlador de dominio
está comprobado para comprobar que los administradores de , usuarios
autenticadosy Todos los grupos.
El objeto de equipo del controlador de dominio se comprueba para asegurarse
de que es la versión más reciente en los controladores de dominio. Esto se hace
para probar convergencia de replicación junto con la comprobación de
versiones, USN, servidores de origen y marcas de tiempo.

Conectividad Comprueba que las DSA y DNS están registradas y accesibles mediante LDAP y RPC.

CrossRefValidation Recupera una lista de contextos de nomenclatura ubicados en


cn=partitions,cn=configuration,dc=<dominio de raiz del bosque> con sus referencias
cruzadas y, a continuación, los valida de forma similar a la prueba CheckSDRefDom
mediante LDAP. Esta prueba examina los atributos nCName, dnsRoot, nETBIOSName y
systemFlags para:

Asegúrese de que los nombres de los DN no son válidos o null.


Confirme que CNF o 0ADEL no han modificado los DN.
Asegúrese de que systemFlags es correcto para ese objeto.
Llame a conjuntos de réplicas vacíos (huérfanos).

CutoffServers Prueba la replicación de AD para asegurarse de que no hay controladores de dominio


sin objetos de conexión entre asociados. Los servidores que no se pueden replicar
entrantes o salientes desde ningún DCs se consideran "cortados" mediante la función
DsReplicaSyncAll, que desencadena la replicación en los controladores de dominio.
Use el /e parámetro con precaución si hay vínculos WAN mal implementados que se
mantienen limpios mediante programaciones.

Si no se puede ponerse en contacto con un servidor o no está disponible para LDAP


en la red, no proporciona ningún error ni resultados de prueba, incluso si se especifica
el parámetro /v . Esta prueba usa RPC.
Prueba Descripción

DcPromo Comprueba el servidor especificado en la configuración DNS del cliente si la


infraestructura cumple los requisitos necesarios para promover el dispositivo a un
controlador de dominio. Esta prueba usa DNS en la red y comprueba:

Si al menos un adaptador de red tiene establecido un servidor DNS principal.


Si hay un espacio de nombres separado basado en el sufijo DNS.
Se puede contactar con esa zona DNS autoritativa propuesta.
Si las actualizaciones dinámicas de DNS son posibles para el registro A del
servidor’. Comprueba tanto la configuración en la zona DNS autoritativa como
en la configuración del registro de cliente para DnsUpdateOnAllAdapters y
DisableDynamicUpdate.
Si un registro DClocator LDAP, como _ldap._tcp.dc._msdcs.<dominio>, se
devuelve al consultar bosques existentes.

Se requieren los argumentos siguientes:

/DnsDomain :<Active_Directory_Domain_DNS_Name>
El uso de este parámetro requiere uno de los argumentos siguientes:
/ChildDomain , /NewForest , /NewTree , o /ReplicaDC
Si se especifica /NewTree , se requiere el siguiente argumento:
/ForestRoot :<Forest_Root_Domain_DNS_Name>

DFSREvent Esta prueba valida el estado del servicio Replicación del sistema de archivos
distribuido (DFSR) comprobando la advertencia del registro de eventos DFSR y las
entradas de error de las últimas 24 horas. Esta prueba usa RPC y EventLog Remoting
Protocol.

DNS Prueba las comprobaciones de estado de DNS de toda la empresa mediante


protocolos DNS, RPC y WMI. No se ejecutó de forma predeterminada y debe
solicitarse explícitamente. Vea sintaxis DNS.

FrsEvent Comprueba si hay errores en el registro de eventos del Servicio de replicación de


archivos (FRS) de las últimas 24 horas, ya que la replicación con errores del recurso
compartido SysVol puede causar problemas de directiva. Esta prueba usa RPC y
EventLog Remoting Protocol.

Intersite Comprueba si hay errores que impedirían o almacenarían temporalmente la


replicación entre sitios y predice cuánto tiempo tardaría el KCC en recuperarse. Esta
prueba usa funciones de DRS para comprobar si hay condiciones que impedirían la
replicación de AD entre sitios dentro de un sitio específico o todos los sitios mediante:

Buscar y conectarse a los generadores de topologías entre sitios (ISTG).


Buscar y conectarse a los servidores de cabeza de puente.
Notificar los errores de replicación después de desencadenar una replicación.
La validación de todos los controladores de dominio dentro de sitios con
conexiones entrantes a este sitio está disponible.
Comprobar los valores de KCC para IntersiteFailuresAllowed y
MaxFailureTimeForIntersiteLink invalidaciones dentro de la clave del Registro:
KEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\NTDS\Parameters.
Prueba Descripción

El parámetro /a o /e debe usarse, ya que no proporcionar un sitio permitiría que la


prueba se ejecute, pero omita las pruebas reales. Esta prueba usa RPC a través de la
red para probar los aspectos de replicación y pide a las conexiones del Registro que
comprueben si hay entradas de invalidación de NTDS. LDAP también se usa para
buscar información de conexión.

KccEvent Esta prueba consulta el KCC en el controlador de dominio para ver si hay errores y
advertencias generados en el registro de eventos de Servicios de directorio durante
los últimos 15 minutos. El umbral de 15 minutos es independientemente del valor del
Registro del período de actualización de la topología Repl (s) en el controlador de
dominio.

Si las reglas de firewall están causando un error en esta prueba, vea KB2512643 que
abarca la habilitación de esas reglas para permitir que la prueba se realice
correctamente. Esta prueba usa RPC junto con el protocolo de comunicación remota
de EventLog.

KnowsOfRoleHolders Esta prueba devuelve el conocimiento de los controladores de dominio de los cinco
roles de operación maestra única flexible (FSMO), pero no comprueba todos los
conocimientos de controladores de dominio para obtener coherencia. El uso del /e
parámetro proporciona datos para la comparación. Esta prueba usa RPC para devolver
DSListRoles dentro de las funciones del Servicio de replicación de directorios (DRS).

MachineAccount Comprueba si la cuenta del equipo se ha registrado correctamente y que los servicios
se anuncian mediante LDAP y RPC a través de SMB, incluida la comprobación:

La cuenta de equipo del controlador de dominio existe en AD.


Está dentro de la unidad organizativa controladores de dominio.
Tiene las marcas UserAccountControl correctas para los controladores de
dominio.
Se establecen los atributos ServerReference correctos.
Se establecen los nombres de entidad de seguridad de servicio mínimos (SPN).
Esta prueba es idéntica a CheckSecurityError, ya que usan la misma prueba
interna.

Esta prueba también tiene dos opciones de reparación:

/RecreateMachineAccount : vuelve a crear un objeto de equipo de controlador de


dominio que falta. Esta no es una corrección recomendada, ya que no vuelve a
crear ningún objeto secundario de un controlador de dominio, como las
suscripciones FRS y DFSR. El procedimiento recomendado es usar una copia de
seguridad de SystemState válida para restaurar autoritativamente el objeto
eliminado del controlador de dominio y los objetos secundarios. Si usa esta
opción, el controlador de dominio debe degradarse correctamente y
promoverse para reparar todas las relaciones que faltan.
/FixMachineAccount : Agrega las marcas UserAccountControl
TRUSTED_FOR_DELEGATION y SERVER_TRUST_ACCOUNT a un objeto de
equipo de controladores de dominio. Con esta opción de reparación se prefiere
intentar establecer estas marcas usted mismo a través de ADSIEDIT u otros
editores LDAP.
Prueba Descripción

NCSecDesc Comprueba los permisos en todos los contextos de nomenclatura (como Esquema,
Configuración, etc.) en el controlador de dominio de origen para validar que la
replicación y la conectividad funcionan entre controladores de dominio. Se asegura de
que controladores de dominio de empresa y administradores de grupos tengan los
permisos mínimos correctos, que es la misma prueba realizada en CheckSecurityError.
Esta prueba usa LDAP.

NetLogons Valida que el usuario que ejecuta DCDiag puede conectarse y leer los recursos
compartidos SYSVOL y NETLOGON sin errores de seguridad. También comprueba que
los administradores de, usuarios autenticadosy todos losgrupos tienen el acceso a este
equipo desde la redde privilegios en el controlador de dominio.

ObjectsReplicated Comprueba que se han replicado los objetos Cuenta de máquina y Agente de servicio
de directorio (DSA). De forma predeterminada, se validan dos objetos y existen en
cada controlador de dominio y están actualizados en todos los demás controladores
de dominio:

CN=configuración de NTDS
CN=<Nombre del controlador de dominio>

Puede usar el parámetro /objectdn:dn con el parámetro /n:nc para especificar un


objeto adicional que se va a comprobar. Esta prueba se realiza mediante RPC con
funciones DRS.

OutboundSecureChannels Esta prueba no se ejecuta de forma predeterminada. Comprueba que existen canales
seguros de todos los controladores de dominio del dominio en los dominios
especificados por el parámetro /testdomain . El parámetro /nositerestriction impide
que DCDiag limite la prueba a los controladores de dominio del sitio.

RegisterInDNS Comprueba si el servidor de directorios puede registrar los registros DNS del
localizador de servidores de directorios. Estos registros deben estar presentes en DNS
para que otros equipos busquen este servidor de directorios para el dominio de
<Active_Directory_Domain_DNS_Name>. Esto también informa si se requieren
modificaciones en la infraestructura DNS existente. Se debe usar el parámetro
/DnsDomain :<Active_Directory_Domain_DNS_Name>. Esta prueba comprueba:

Se puede contactar con la zona DNS autoritativa.


Si al menos un adaptador de red tiene establecido un servidor DNS principal.
Si tendría un espacio de nombres separado en función del sufijo DNS.
Se puede contactar con la zona DNS autoritativa propuesta.
Si las actualizaciones dinámicas de DNS son posibles para el registro A del
servidor’. Comprueba la configuración de la zona DNS autoritativa y la
configuración del registro de cliente de DnsUpdateOnAllAdapters y
DisableDynamicUpdate.
Si un registro DClocator LDAP, como _ldap._tcp.dc._msdcs.<dominio>, se
devuelve al consultar bosques existentes.

Replicaciones Esta prueba comprueba todos los objetos de conexión de replicación de AD para
todos los contextos de nomenclatura en los controladores de dominio especificados
si:
Prueba Descripción

La última replicación intentó ser correcta o devuelve un error.


Esa replicación está deshabilitada.
La latencia de replicación es superior a 12 horas.

RidManager Comprueba si el identificador relativo (RID) maestro es accesible y si:

Contiene la información adecuada.


Se puede localizar y ponerse en contacto con él a través de DsBind.
Tiene valores de grupo de RID válidos.

El titular del rol debe estar en línea y accesible para que los controladores de dominio
puedan crear entidades de seguridad (usuarios, equipos y grupos), así como para que
se promuevan más controladores de dominio dentro de un dominio. Esta prueba usa
LDAP y RPC.

Servicios Esta prueba valida que varios servicios dependientes de AD se ejecutan, son accesibles
y se establecen en tipos de inicio específicos. Estos servicios se inician
automáticamente y se ejecutan en un proceso compartido a menos que se especifique
lo contrario:

DFSR (se ejecuta en un proceso propio)


DNSCACHE
EVENTSYSTEM
IISADMIN (si se usa la replicación de AD basada en SMTP)
ISMSERV
KDC
NETLOGON
NTDS
NTFRS (se ejecuta en un proceso propio)
RPCSS
SAMSS
SERVER
SMTPSVC (si se usa la replicación de AD basada en SMTP)
W32TIME (se inicia automáticamente o manualmente)
ESTACIÓN DE TRABAJO

Estos nombres de servicio se enumeran en la ruta de acceso del registro


HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services. Esta prueba usa RPC y
el protocolo remoto de Service Control Manager.

SysVolCheck Esta prueba lee los controladores de dominio Netlogon SysVolReady clave del registro
para validar que SYSVOL está listo. El nombre del valor debe existir con un valor de 1
para pasar esta prueba y funciona con SYSVOLs replicados de FRS o DFSR. No
comprueba si los recursos compartidos SYSVOL y NELOGON son accesibles, ya que lo
realiza CheckSecurityError. Esta prueba usa RPC a través de SMB.

SystemLog Valida el estado del registro de eventos del sistema leyendo y escribiendo entradas de
los últimos 60 minutos para cualquier error y advertencia. Esta prueba usa RPC y el
protocolo remoto de Service Control Manager.
Prueba Descripción

Topología Comprueba que la topología de replicación de AD generada está totalmente


conectada para todas las DSA. Esta prueba no se realiza de forma predeterminada y se
debe ejecutar explícitamente. Comprueba:

Si la generación automática de topologías dentro del sitio está deshabilitada.


Si la generación automática de topología entre sitios está deshabilitada.
Para topologías desconectadas (objetos de conexión que faltan), tanto
ascendentes como descendentes de cada controlador de dominio de referencia.

Esta prueba usa RPC, LDAP y DsReplicaSyncAll con la marca


DS_REPSYNCALL_DO_NOT_SYNC, lo que significa que analiza y valida la topología de
replicación sin replicar realmente los cambios. Esta prueba no valida la disponibilidad
de los asociados de replicación. Tener un asociado sin conexión no provocará errores
en esta prueba. Tampoco prueba si la programación está cerrada, lo que impide la
replicación. Para ver esos resultados de replicación activa, use pruebas Replicaciones o
CutoffServers.

VerifyEnterpriseReferences Comprueba que las referencias del sistema especificadas están intactas para FRS y
para la infraestructura de replicación en todos los objetos de la empresa en cada
controlador de dominio. Esto incluye los siguientes atributos y objetos de sitio de
controlador de dominio:

frsComputerReference: cn=domain system volume (sysvol share),cn=ntfrs


subscriptions,cn=<DC Name>,ou=domain controllers,DC=<domain>
frsComputerReferenceBL: cn=<DC Name>,cn=domain system volume (sysvol
share),cn=file replication service,cn=system,dc=<domain>
hasMasterNCs: cn=ntds settings,cn=<DC Name>,cn=
<site>,cn=sites,cn=configuration,dc=<dominio>
msDFSR-ComputerReference: cn=<DC Name>,cn=topology,cn=domain system
volume,cn=dfsr-blobalsettings,cn=system,dc=<dominio>
msDFSR-ComputerReferenceBL: cn=<DC Name>,ou=domain controllers,dc=
<domain>
nCName: cn=<nombre de partición>,cn=partitions,cn=configuration,dc=
<dominio>
ServerReference: cn=<nombre de controlador de dominio>,cn=
<sitio>,cn=sites,cn=configuration,dc=<dominio>
ServerReferenceBL: cn=<dc Name>,ou=domain controllers,dc=<dominio>

Las dos pruebas de \DFSR solo se realizan si el nivel funcional del dominio es
Windows Server 2008 o superior. Esto significa que habrá un error esperado si DFSRno
se ha migrado a SYSVOL. Esta prueba usa LDAP y solo se contactan los controladores
de dominio especificados.

VerifyReferences Comprueba que ciertas referencias del sistema están intactas para FRS y la
infraestructura de replicación. Esta prueba comprueba los atributos de referencia del
equipo para un único controlador de dominio, incluidos los siguientes atributos y
objetos del sitio de controlador de dominio:

frsComputerReference: cn=domain system volume (sysvol share),cn=ntfrs


subscriptions,cn=<DC Name>,ou=domain controllers,DC=<domain>
Prueba Descripción

frsComputerReferenceBL: cn=<DC Name>,cn=domain system volume (sysvol


share),cn=file replication service,cn=system,dc=<domain>
msDFSR-ComputerReference: cn=<DC Name>,cn=topology,cn=domain system
volume,cn=dfsr-blobalsettings,cn=system,dc=<dominio>
msDFSR-ComputerReferenceBL: cn=<DC Name>,ou=domain controllers,dc=
<domain>
ServerReference: cn=<nombre de controlador de dominio>,cn=
<sitio>,cn=sites,cn=configuration,dc=<dominio>
ServerReferenceBL: cn=<dc Name>,ou=domain controllers,dc=<dominio>

Esta prueba usa LDAP y es similar a la VerifyEnterpriseRefrences prueba, excepto que


no comprueba las referencias cruzadas de particiones ni todos los demás objetos de
controlador de dominio.

VerifyReplicas Comprueba que se han creado instancias de todas las particiones del directorio de
aplicaciones en todos los servidores de réplicas. Comprueba que el servidor
especificado hospeda las particiones de aplicación especificadas por sus atributos de
referencia cruzada en el contenedor de particiones. Funciona como CheckSDRefDom,
salvo que no muestra los datos de salida y valida el hospedaje. Esta prueba usa LDAP.

7 Nota

Las comprobaciones de conectividad en los controladores de dominio registrados en la red


y que se conectan con otros recursos como DNS, LDAP y RPC no se pueden omitir.

Sintaxis 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]

La prueba de DNS utiliza los parámetros siguientes:

Parámetro Descripción

/test:DNS Realiza la prueba de DNS especificada. Si no se especifica ninguna


prueba, el valor predeterminado es /DnsAll .

/DnsBasic Realiza pruebas básicas de DNS, incluida la de conectividad de red, la


configuración del cliente DNS, la disponibilidad del servicio y la existencia
de zonas.

/DnsForwarders Realiza las pruebas /DnsBasic y también comprueba la configuración de


los reenviadores.
Parámetro Descripción

/DnsDelegation Realiza las pruebas /DnsBasic y también comprueba si hay delegaciones


adecuadas.

/DnsDynamicUpdate Realiza las pruebas /DnsBasic y también determina si la actualización


dinámica está habilitada en la zona de Active Directory.

/DnsRecordRegistration Realiza las pruebas /DnsBasic y también comprueba si se han registrado


los registros de recursos de dirección (A), nombre canónico (CNAME) y
servicio conocido (SRV). Además, crea un informe de inventario basado en
los resultados de la prueba.

/DnsResolveExtName Realiza las pruebas /DnsBasic e intenta también resolver InternetName. Si


[/DnsInternetName:\ /DnsInternetName no se especifica, intenta resolver el nombre
<InternetName> ] <www.microsoft.com>. Si /DnsInternetName se especifica, intenta resolver
el nombre de Internet proporcionado por el usuario.

/DnsAll Realiza todas las pruebas, excepto la prueba /DnsResolveExtName , y


genera un informe.

/f: <LogFile> Redirige toda la salida a un archivo de registro.

/s: <DomainController> Ejecuta las pruebas en el controlador de dominio. Si no se especifica este


parámetro, las pruebas se ejecutan en el controlador de dominio local.

/e Ejecuta todas las pruebas especificadas por /test:DNS en todos los


controladores de dominio del bosque de Active Directory.

/v Detallado. Presenta información ampliada sobre los resultados de pruebas


correctas, además de información sobre errores y advertencias.
Cuando no se usa el parámetro /v , solo proporciona información sobre
errores y advertencias. Use el modificador /v cuando se notifiquen
errores o advertencias en la tabla de resumen.

/x: <XMLLog.xml> Redirige toda la salida a xmllog.xml. Este parámetro solo funciona con la
opción /test:DNS .

/xsl: <XSLFile.xsl> o Agrega las instrucciones de procesamiento que hacen referencia a la hoja
/xsl: <XSLTFile.xslt> especificada. Este parámetro solo funciona con la opción /test:DNS /x:
<XMLLog.xml .

7 Nota

Los tiempos de ejecución de las pruebas de DNS pueden ser significativos en grandes
empresas cuando se usa el parámetro /e . Los controladores de dominio y los servidores
DNS sin conexión aumentarán los tiempos de ejecución debido a los largos períodos de
tiempo de espera para RPC y otros protocolos.

Ejemplos
Prueba de conectividad
Para ejecutar una serie de pruebas de conectividad en el dominio local, ejecute el siguiente
comando:

PowerShell

dcdiag

Una salida de prueba de conectividad correcta:

Resultados

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.contoso.com

Starting test: LocatorCheck


......................... corp.contoso.com passed test
LocatorCheck

Starting test: Intersite


......................... corp.contoso.com passed test
Intersite

Para ejecutar una serie de pruebas de conectividad en un controlador de dominio específico,


ejecute el siguiente comando:

PowerShell

dcdiag /s:<DomainControllerName>

Debe generar resultados similares a la prueba local si no se encuentra ningún problema.

Salida a un archivo de registro


DCDiag puede guardar los resultados de salida en un archivo de texto mediante la ejecución de:

PowerShell

dcdiag /s:<DomainControllerName> /f:<FileName.txt>

Si no se especifica ningún <FilePath> , los resultados se guardan en C:\Users\<UserName>\


<FileName.txt> de forma predeterminada.

Para guardar en una ubicación específica, ejecute:

PowerShell

dcdiag /s:<DomainControllerName> /f:<DriveLetter>\<FilePath>\<FileName.txt>

Consulte también
Clave de sintaxis de línea de comandos
dcgpofix
Artículo • 14/04/2023

Vuelve a crear los objetos de la directiva de grupo (GPO) predeterminados para un


dominio. Para acceder a la Consola de administración de directivas de grupo (GPMC),
debe instalar la Administración de directivas de grupo como una característica a través
del administrador del servidor.

) Importante

Como procedimiento recomendado, debe configurar el GPO de la directiva


predeterminada de dominio solo para administrar la configuración predeterminada
de las directivas de cuenta, la directiva de contraseñas, la directiva de bloqueo de
cuentas y la directiva Kerberos. Además, debe configurar el GPO de la directiva
predeterminada de controladores de dominio solo para establecer los derechos de
usuario y las directivas de auditoría.

Sintaxis

dcgpofix [/ignoreschema] [/target: {domain | dc | both}] [/?]

Parámetros

Parámetro Descripción

/ignoreschema Omite la versión del esquema de Active Directory al ejecutar este comando. De
lo contrario, el comando solo funciona en la misma versión de esquema que la
versión de Windows en la que se envió el comando.

/target Especifica si se debe establecer como destino la directiva predeterminada de


{domain | dc | dominio, la directiva predeterminada de controladores de dominio o ambos
both tipos de directivas.

/? Muestra la Ayuda en el símbolo del sistema.

Ejemplos
Para administrar la configuración predeterminada de las directivas de cuenta, la
directiva de contraseñas, la directiva de bloqueo de cuenta y la directiva Kerberos,
mientras se omite la versión del esquema de Active Directory, escriba:

dcgpofix /ignoreschema /target:domain

Para configurar el GPO de la directiva predeterminada de controladores de dominio solo


para establecer los derechos de usuario y las directivas de auditoría, mientras se omite
la versión del esquema de Active Directory, escriba:

dcgpofix /ignoreschema /target:dc

Vínculos relacionados
Clave de sintaxis de línea de comandos
defrag
Artículo • 28/09/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 11, Windows 10,
Windows Server 2016, Windows Server 2012 R2, Windows Server 2012

Localiza y consolida archivos fragmentados en volúmenes locales para mejorar el


rendimiento del sistema.

La pertenencia al grupo Administradores local, o equivalente, es el mínimo requerido


para ejecutar este comando.

Sintaxis

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 Descripción

<volume> Especifica ruta de acceso de la letra de unidad o del punto de montaje del volumen
que se va a desfragmentar o analizar.

/a Realiza un análisis en los volúmenes especificados.

/b Realiza una optimización del arranque para aumentar el rendimiento de arranque.

/c Realiza la operación en todos los volúmenes.

/d Realiza la desfragmentación tradicional (este es el valor predeterminado). Sin


embargo, en un volumen en capas, la desfragmentación tradicional solo se realiza
en el nivel de capacidad.

/e Realiza la operación en todos los volúmenes excepto en los especificados.

/g Optimiza la capas de almacenamiento en los volúmenes especificados.

/h Ejecuta la operación con una prioridad normal (el valor predeterminado es bajo).
Parámetro Descripción

/i [n] La optimización de nivel se ejecutaría durante un máximo de n segundos en cada


volumen.

/k Realiza consolidación de bloques en los volúmenes especificados.

/l Vuelve a optimizar en los volúmenes especificados.

/m [n] Ejecuta la operación en cada volumen en paralelo y en segundo plano. Como


máximo, n subprocesos optimizan los niveles de almacenamiento en paralelo.

/o Realiza la optimización adecuada para cada tipo de medio.

/t Realiza un seguimiento de una operación ya en curso en el volumen especificado.

/U Captura el progreso de la operación en la pantalla.

/v Captura la salida detallada que contiene las estadísticas de fragmentación.

/x Realiza consolidación de espacio disponible en los volúmenes especificados.

/? Muestra esta información de ayuda.

Comentarios
No se pueden desfragmentar volúmenes o unidades de sistema de archivos
específicos, como por ejemplo:

Volúmenes bloqueados por el sistema de archivos.

Volúmenes que el sistema de archivos marca como dañados, lo que indica


posibles errores.
Debe ejecutar chkdsk para poder desfragmentar este volumen o unidad. Puede
determinar si un volumen está dañado mediante el comando fsutil dirty .

Unidades de red.

CD-ROMs.

Volúmenes del sistema de archivos que no son NTFS, ReFS, Fat o Fat32.

Para llevar a cabo este procedimiento, debe ser miembro del grupo
Administradores del equipo local o tener delegada la autoridad adecuada. Si el
equipo está unido a un dominio, los miembros del grupo Administradores de
dominio podrían llevar a cabo este procedimiento. Como procedimiento
recomendado de seguridad, considere la posibilidad de utilizar la opción Run As
para realizar este procedimiento.
Un volumen debe disponer de al menos un 15 % de espacio disponible para que
defrag lo desfragmente completamente y de forma adecuada. defrag utiliza este
espacio como área de ordenación para fragmentos de archivo. Si un volumen tiene
menos de un 15 % de espacio disponible, defrag solo lo desfragmentará
parcialmente. Para aumentar el espacio disponible en un volumen, elimine los
archivos innecesarios o muévalos a otro disco.

Mientras defrag analiza y desfragmenta un volumen, muestra un cursor que


parpadea. Cuando defrag finaliza el análisis y la desfragmentación del volumen,
muestra el informe de análisis, el informe de desfragmentación o ambos, y, a
continuación, sale del símbolo del sistema.

De forma predeterminada, defrag muestra un resumen de ambos informes si no


especifica los parámetros /a o /v.

Puede enviar los informes a un archivo de texto escribiendo >FileName.txt, donde


FileName.txt es el nombre de archivo que el usuario especifique. Por ejemplo:
defrag volume /v > FileName.txt

Para interrumpir el proceso de desfragmentación, en la línea de comandos,


presione CTRL+C.

La ejecución del comando defrag y del desfragmentador de disco son


mutuamente excluyentes. Si usa el Desfragmentador de disco para desfragmentar
un volumen y ejecuta el comando defrag en una línea de comandos, se produce
un error en el comando defrag. Por el contrario, si ejecuta el comando defrag y
abre el Desfragmentador de disco, las opciones de desfragmentación del
Desfragmentador de disco no están disponibles.

Ejemplos
Para desfragmentar el volumen de la unidad C al proporcionar el progreso y la salida
detallada, escriba lo siguiente:

defrag c: /u /v

Para desfragmentar los volúmenes en las unidades C y D en paralelo de fondo, escriba


lo siguiente:
defrag c: d: /m

Para realizar un análisis de fragmentación de un volumen montado en la unidad C y


proporcionar progreso, escriba lo siguiente:

defrag c: mountpoint /a /u

Para desfragmentar todos los volúmenes con prioridad normal y proporcionar una
salida detallada, escriba lo siguiente:

defrag /c /h /v

Tarea programada
El proceso de desfragmentación ejecuta la tarea programada como una tarea de
mantenimiento, que normalmente se ejecuta cada semana. Como administrador, puede
cambiar la frecuencia con la que se ejecuta la tarea usando la aplicación Optimizar
unidades.

Cuando se ejecuta desde la tarea programada, defrag utiliza las siguientes


directrices de directiva para SSD:

Procesos de optimización tradicionales. La desfragmentación tradicional, por


ejemplo, que mueve archivos para hacer que sean razonablemente contiguos o
Volver a optimizar. Esto se hace una vez al mes. Sin embargo, si se omiten tanto
la desfragmentación tradicional como la opción volver a optimizar, el análisis
no se ejecuta. Cambiar la frecuencia de la tarea programada no afecta a la
cadencia de una vez al mes de los SSD.

Si ejecuta manualmente la desfragmentación tradicional en un SSD, entre las


ejecuciones programadas normalmente, la siguiente ejecución de tareas
programadas realiza análisis y volver a optimizar, pero omite la
desfragmentación tradicional en ese SSD.

Si se omite el análisis, no verá la hora de Última ejecución actualizada en la


aplicación Optimizar unidades. Por eso, la hora de Última ejecución puede
tener hasta un mes de antigüedad.
Es posible que la tarea programada no haya desfragmentado todos los
volúmenes. Esto suele deberse a lo siguiente:

El proceso no reactivará el equipo para que se ejecute.

El equipo no está conectado. El proceso no se ejecutará si el equipo está


funcionando con batería.

El equipo, que estaba inactivo, se reanuda.

Vínculos relacionados
Clave de sintaxis de línea de comandos

chkdsk

fsutil

fsutil dirty

Comando Optimize-Volume de PowerShell


del
Artículo • 12/04/2023

Elimina uno o varios archivos. Este comando realiza las mismas acciones que el
comando erase.

El comando del también se puede ejecutar desde la Consola de recuperación de


Windows mediante parámetros diferentes. Para obtener más información, consulte
Entorno de recuperación de Windows (WinRE).

2 Advertencia

Si usa del para eliminar un archivo del disco, no puede recuperarlo.

Sintaxis

del [/p] [/f] [/s] [/q] [/a[:]<attributes>] <names>


erase [/p] [/f] [/s] [/q] [/a[:]<attributes>] <names>

Parámetros

Parámetro Descripción

<names> Especifica una lista de uno o varios archivos o directorios. Los caracteres
comodín se pueden usar para eliminar varios archivos. Si especifica un
directorio, se eliminarán todos los archivos que contenga.

/p Solicita confirmación antes de eliminar el archivo especificado.

/f Fuerza la eliminación de archivos de solo lectura.

/s Elimina los archivos especificados del directorio actual y de todos los


subdirectorios. Muestra los nombres de los archivos a medida que se
eliminan.

/q Especifica el modo silencioso. No se le pedirá confirmación de eliminación.


Parámetro Descripción

/a[:] <attributes> Elimina archivos basados en los siguientes atributos de archivo:


r Archivos de solo lectura
h Archivos ocultos
i Archivos no indexados por contenido
s Archivos de sistema
a Archivos listos para archivar
l Puntos de repetición de análisis
- Se usa como prefijo que significa "no"

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Si usa el comando del /p , verá el siguiente mensaje:

FileName, Delete (Y/N)?

Para confirmar la eliminación, presione Y. Para cancelar la eliminación y mostrar el


siguiente nombre de archivo (si especificó un grupo de archivos), presione N. Para
detener el comando del, presione CTRL+C.

Si deshabilita la extensión de comando, el parámetro /s mostrará los nombres de


los archivos que no se encontraron, en lugar de mostrar los nombres de los
archivos que se van a eliminar.

Si especifica carpetas concretas en el parámetro <names> , también se eliminarán


todos los archivos incluidos. Por ejemplo, si desea eliminar todos los archivos de la
carpeta \work, escriba llo siguiente:

del \work

Puede usar caracteres comodín (* and ?) para eliminar más de un archivo a la vez.
Sin embargo, para evitar eliminar archivos involuntariamente, debe usar caracteres
comodín con precaución. Por ejemplo, si escribe el siguiente comando:

del *.*
El comando del muestra el siguiente símbolo del sistema:

Are you sure (Y/N)?

Para eliminar todos los archivos del directorio actual, presione Y y, a continuación,
presione ENTRAR. Para cancelar la eliminación, presione N y, a continuación,
presione ENTRAR.

7 Nota

Antes de usar caracteres comodín con el comando del, use los mismos
caracteres comodín con el comando dir para enumerar todos los archivos que
se eliminarán.

Ejemplos
Para eliminar todos los archivos de una carpeta denominada Test en la unidad C, escriba
cualquiera de las siguientes opciones:

del c:\test
del c:\test\*.*

Para eliminar todos los archivos de una carpeta cuyo nombre contiene un espacio, la
ruta de acceso completa debe encapsularse entre comillas dobles. Escriba alguna de las
acciones siguientes:

del "c:\test folder\"


del "c:\test folder\*.*"

Para eliminar todos los archivos con la extensión de nombre de archivo .bat del
directorio actual, escriba lo siguiente:

del *.bat

Para eliminar todos los archivos de solo lectura del directorio actual, escriba lo siguiente:
del /a:r *.*

Vínculos relacionados
Clave de sintaxis de línea de comandos

Entorno de recuperación de Windows (WinRE)


delete
Artículo • 18/10/2023

Elimina una partición o un volumen. Elimina también un disco dinámico de la lista de


discos.

Sintaxis

delete disk
delete partition
delete volume

Parámetros

Parámetro Descripción

Eliminar disco Elimina un disco dinámico que falta de la lista de discos.

Eliminar partición Elimina una partición.

Eliminación de un volumen Elimina un volumen.

Vínculos relacionados
Clave de sintaxis de línea de comandos
delete disk
Artículo • 12/04/2023

Elimina un disco dinámico que falta de la lista de discos.

7 Nota

Para obtener instrucciones detalladas sobre cómo usar este comando, consulte
Eliminación de un disco dinámico que falta.

Sintaxis

delete disk [noerr] [override]

Parámetros

Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

override Permite que DiskPart elimine todos los volúmenes simples del disco. Si el disco
contiene la mitad de un volumen reflejado, se eliminará la mitad del reflejo del
disco. El comando delete disk override no funciona si el disco forma parte de un
volumen RAID-5.

Ejemplos
Para eliminar un disco dinámico que falta de la lista de discos, escriba:

delete disk

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando delete
delete partition
Artículo • 14/04/2023

Elimina la partición con el foco. Antes de comenzar, debe seleccionar una partición para
que esta operación se realice correctamente. Use el comando select partition para
seleccionar una partición y desplazar el foco a ella.

2 Advertencia

Al eliminar una partición de un disco dinámico se pueden eliminar todos los


volúmenes dinámicos del disco, con lo que se destruirán los datos y el disco
quedará dañado.

No se puede eliminar la partición del sistema, la partición de arranque ni una


partición que contenga el archivo de paginación o la información del volcado de
memoria.

Sintaxis

delete partition [noerr] [override]

Parámetros

Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

override Permite que DiskPart elimine una partición con independencia de su tipo.
Normalmente, DiskPart solo permite eliminar particiones de datos conocidas.

Comentarios
Para eliminar un volumen dinámico, es preferible que utilice siempre el comando
delete volume.
Las particiones se pueden eliminar de los discos dinámicos, pero no se deben
crear. Por ejemplo, es posible eliminar una partición de tabla de particiones GUID
(GPT) no reconocida en un disco GPT dinámico. Sin embargo, al eliminar dicha
partición, el espacio libre resultante no estará disponible. En lugar de ello, este
comando está pensado para permitirle la recuperación de espacio en un disco
dinámico sin conexión dañado en una situación de emergencia, cuando no se
puede utilizar el comando clean en DiskPart.

Ejemplos
Para eliminar la partición con el foco, escriba:

delete partition

Vínculos relacionados
Clave de sintaxis de línea de comandos

select partition

Comando delete

Comando delete volume

Comando clean
delete shadows
Artículo • 14/04/2023

Elimina instantáneas.

Sintaxis

delete shadows [all | volume <volume> | oldest <volume> | set <setID> | id


<shadowID> | exposed {<drive> | <mountpoint>}]

Parámetros

Parámetro Descripción

all Elimina todas las instantáneas.

volume Elimina todas las instantáneas del volumen especificado.


<volume>

oldest Elimina la instantánea más antigua del volumen especificado.


<volume>

set <setID> Elimina las instantáneas en el conjunto de instantáneas del id. especificado.
Puede especificar un alias mediante el símbolo % si el alias existe en el entorno
actual.

id <shadowID> Elimina una instantánea del id. especificado. Puede especificar un alias
mediante el símbolo % si el alias existe en el entorno actual.

exposed Elimina instantáneas expuestas en la unidad o el punto de montaje


{ <drive> | especificados.
<mountpoint> }

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando delete
delete volume
Artículo • 12/04/2023

Elimina el volumen seleccionado. Antes de comenzar, debe seleccionar un volumen para


que esta operación se realice correctamente. Use el comando select volume para
seleccionar un volumen y desplazar el foco a él.

) Importante

No puede eliminar el volumen del sistema, el volumen de arranque o cualquier otro


volumen que incluya el archivo de paginación activo o de volcado (volcado de
memoria).

Sintaxis

delete volume [noerr]

Parámetros

Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para eliminar el volumen con foco, escriba:

delete volume

Vínculos relacionados
Clave de sintaxis de línea de comandos
select volume

Comando delete
detach vdisk
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Detiene que el disco duro virtual (VHD) seleccionado aparezca como una unidad de
disco duro local en el equipo host. Cuando se desasocia un VHD, puede copiarlo en
otras ubicaciones. Antes de comenzar, debe seleccionar un disco duro virtual para que
esta operación se realice correctamente. Use el comando select vdisk para seleccionar
un VHD y desplazar el foco a él.

Sintaxis

detach vdisk [noerr]

Parámetros

Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para desasociar el disco duro virtual seleccionado, escriba:

detach vdisk

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando attach vdisk

Comando compact vdisk

Comando detail vdisk

Comando expand vdisk

Comando merge vdisk

Comando select vdisk

Comando list
detalles
Artículo • 12/04/2023

Muestra información sobre el disco seleccionado, la partición, el volumen o el disco


duro virtual (VHD).

Sintaxis

detail disk
detail partition
detail volume
detail vdisk

Parámetros

Parámetro Descripción

detail disk Muestra las propiedades del disco seleccionado y los volúmenes del mismo.

detail partition Muestra las propiedades de la partición seleccionada.

detail volume Muestra los discos en los que reside el volumen actual.

detail vdisk Muestra las propiedades del VHD.

Vínculos relacionados
Clave de sintaxis de línea de comandos
detail disk
Artículo • 06/10/2023

Muestra las propiedades del disco seleccionado y los volúmenes del mismo. Antes de
comenzar, debe seleccionar un disco para que esta operación se realice correctamente.
Use el comando select disk para seleccionar un disco y desplazar el foco a él. Si
selecciona un disco duro virtual (VHD), este comando mostrará el tipo de bus del disco
como Virtual.

Sintaxis

detail disk

Ejemplos
Para ver las propiedades del disco seleccionado e información sobre los volúmenes del
disco, escriba:

detail disk

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando detail
detail partition
Artículo • 14/04/2023

Muestra las propiedades de la partición seleccionada. Antes de comenzar, debe


seleccionar una partición para que esta operación se realice correctamente. Use el
comando select partition para seleccionar una partición y desplazar el foco a ella.

Sintaxis

detail partition

Ejemplos
Para ver las propiedades de la partición seleccionada, escriba:

detail partition

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando detail
detail vdisk
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra las propiedades del disco duro virtual (VHD) seleccionado. Antes de comenzar,
debe seleccionar un disco duro virtual para que esta operación se realice correctamente.
Use el comando select vdisk para seleccionar un VHD y desplazar el foco a él.

Sintaxis

detail vdisk

Ejemplos
Para ver los detalles sobre el VHD seleccionado, escriba:

detail vdisk

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando detail

Comando attach vdisk

Comando compact vdisk

Comando detach vdisk

Comando expand vdisk

Comando merge vdisk


select vdisk

Comando list
detail volume
Artículo • 12/04/2023

Muestra los discos en los que reside el volumen actual. Antes de comenzar, debe
seleccionar un volumen para que esta operación se realice correctamente. Use el
comando select volume para seleccionar un volumen y que reciba el enfoque. Los
detalles del volumen no son aplicables a los volúmenes de solo lectura, como una
unidad de DVD-ROM o CD-ROM.

Sintaxis

detail volume

Ejemplos
Para ver todos los discos en los que reside el volumen actual, escriba:

detail volume

Vínculos relacionados
Clave de sintaxis de línea de comandos

select volume

detail command
dfsdiag
Artículo • 12/04/2023

Proporciona información de diagnóstico para espacios de nombres DFS.

Sintaxis

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 Descripción

dfsdiag testdcs Comprueba la configuración del controlador de dominio.

dfsdiag testsites Comprueba las asociaciones del sitio.

dfsdiag testdfsconfig Comprueba la configuración de espacios de nombres DFS

dfsdiag testdfsintegrity Comprueba la integridad del espacio de nombres DFS.

dfsdiag testreferral Comprueba las respuestas de referencia.

/? Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
dfsdiag testdcs
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Comprueba la configuración de los controladores de dominio realizando las siguientes


pruebas en cada controlador del dominio especificado:

Comprueba que el servicio de espacio de nombres del Sistema de archivos


distribuido (DFS) se está ejecutando y que su tipo de inicio está establecido en
Automático.

Comprueba si se admiten las referencias que dependen del espacio en el sitio para
NETLOGON y SYSvol.

Comprueba la coherencia de la asociación del sitio por nombre de host y dirección


IP.

Sintaxis

dfsdiag /testdcs [/domain:<domain_name>]

Parámetros

Parámetro Descripción

/domain: <domain_name> Nombre del dominio que se va a comprobar. Este parámetro es


opcional. El valor predeterminado es el dominio local al que está unido
el host local.

Ejemplos
Para comprobar la configuración de controladores de dominio en el dominio
contoso.com, escriba:
dfsdiag /testdcs /domain:contoso.com

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando dfsdiag
dfsdiag testdfsconfig
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Comprueba la configuración de un espacio de nombres del Sistema de archivos


distribuido (DFS) realizando las siguientes acciones:

Comprueba que el servicio de espacio de nombres del Sistema de archivos


distribuido (DFS) se esté ejecutando y que su tipo de inicio esté establecido en
Automático en todos los servidor de espacio de nombres.

Comprueba que la configuración del Registro DFS es coherente entre los


servidores de espacios de nombres.

Valida las siguientes dependencias en servidores de espacios de nombres en


clúster:

Dependencia de recursos de raíz de espacio de nombres en el recurso de


nombre de red.

Dependencia de recursos de nombre de red en el recurso de dirección IP.

Dependencia de recursos raíz de espacio de nombres en el recurso de disco


físico.

Sintaxis

dfsdiag /testdfsconfig /DFSroot:<namespace>

Parámetros

Parámetro Descripción

/DFSroot: <namespace> Espacio de nombres (raíz DFS) que se va a diagnosticar.

Ejemplos
Para comprobar la configuración de espacios de nombres del Sistema de archivos
distribuido (DFS) en contoso.com\MyNamespace, escriba lo siguiente:

dfsdiag /testdfsconfig /DFSroot:\\contoso.com\MyNamespace

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando dfsdiag
dfsdiag testdfsintegrity
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Comprueba la integridad del espacio de nombres del Sistema de archivos distribuido


(DFS) realizando las siguientes pruebas:

Comprueba si hay daños en los metadatos DFS o incoherencias entre los


controladores de dominio.

Valida la configuración de la enumeración basada en acceso para asegurarse de


que es coherente entre los metadatos DFS y el recurso compartido del servidor de
espacio de nombres.

Detecta carpetas DFS superpuestas (vínculos), carpetas duplicadas y carpetas con


destinos de carpeta superpuestos.

Sintaxis

dfsdiag /testdfsintegrity /DFSroot: <DFS root path> [/recurse] [/full]

Parámetros

Parámetro Descripción

/DFSroot: Espacio de nombres DFS que se va a diagnosticar.


<DFS root
path>

/recurse Realiza las pruebas, incluidos los vínculos entre espacios de nombres.

/full Comprueba la coherencia del recurso compartido y las ACL de NTFS, junto con la
configuración del lado del cliente en todos los destinos de carpeta. También
comprueba que se establece la propiedad en línea.

Ejemplos
Para comprobar la integridad y la coherencia de los espacios de nombres del Sistema de
archivos distribuido (DFS) en contoso.com\MyNamespace, incluidos los intervínculos,
escriba:

dfsdiag /testdfsintegrity /DFSRoot:\contoso.com\MyNamespace /recurse /full

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando dfsdiag
dfsdiag testreferral
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Comprueba las referencias del Sistema de archivos distribuido (DFS) mediante la


realización de las siguientes pruebas:

Si usa el parámetro DFSpath* sin argumentos, el comando valida que la lista de


referencias incluya todos los dominios de confianza.

Si especifica un dominio, el comando realiza una comprobación de estado de los


controladores de dominio ( dfsdiag /testdcs ) y prueba las asociaciones de sitio y
la caché de dominios del host local.

Si especifica un dominio y \SYSvol o \NETLOGON, el comando realiza las mismas


comprobaciones de estado del controlador de dominio, junto con la
comprobación de que el período de vida (TTL) de las referencias de SYSvol o
NETLOGON coincide con el valor predeterminado de 900 segundos.

Si especifica una raíz de espacio de nombres, el comando realiza las mismas


comprobaciones de estado del controlador de dominio, junto con la realización de
una comprobación de configuración DFS ( dfsdiag /testdfsconfig ) y una
comprobación de integridad del espacio de nombres ( dfsdiag /testdfsintegrity ).

Si especifica una carpeta DFS (vínculo), el comando realiza las mismas


comprobaciones de estado de raíz de espacio de nombres, junto con la validación
de la configuración del sitio para destinos de carpeta (dfsdiag /testsites) y la
validación de la asociación de sitio del host local.

Sintaxis

dfsdiag /testreferral /DFSpath:<DFS path to get referrals> [/full]

Parámetros

Parámetro Descripción
Parámetro Descripción

/DFSpath: <path Puede ser uno de los siguientes:


to get Blanco: Prueba solo dominios de confianza.
referrals> \\Domain: Prueba solo las referencias del controlador de dominio.
\\Domain\SYSvol: Prueba solo las referencias de SYSvol.
\\Domain\NETLOGON: Prueba solo las referencias de NETLOGON.
\\<domain or server>\<namespace root>: Prueba solo las referencias de
raíz de espacio de nombres.
\\<domain or server>\<namespace root>\<DFS folder>: Prueba solo las
referencias de la carpeta DFS (vínculo).

/full Solo se aplica a las referencias de dominio y raíz. Comprueba la coherencia de


la información de asociación del sitio entre el registro y Active Directory
Domain Services (AD DS).

Ejemplos
Para comprobar las referencias del Sistema de archivos distribuido (DFS) en
contoso.com\MyNamespace, escriba lo siguiente:

dfsdiag /testreferral /DFSpath:\\contoso.com\MyNamespace

Para comprobar las referencias del Sistema de archivos distribuido (DFS) en todos los
dominios de confianza, escriba lo siguiente:

dfsdiag /testreferral /DFSpath:

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando dfsdiag
dfsdiag testsites
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Comprueba la configuración de sitios de Active Directory Domain Services (AD DS)


comprobando que los servidores que actúan como servidores de espacio de nombres o
destinos de carpeta (vínculo) tienen las mismas asociaciones de sitio en todos los
controladores de dominio.

Sintaxis

dfsdiag /testsites </machine:<server name>| /DFSpath:<namespace root or DFS


folder> [/recurse]> [/full]

Parámetros

Parámetro Descripción

/machine:<server Nombre del servidor en el que se va a comprobar la asociación del sitio.


name>

/DFSpath: La raíz de espacio de nombres o la carpeta del Sistema de archivos


<namespace root or distribuido (DFS) (vínculo) con destinos para los que verificar la asociación
DFS folder> del sitio.

/recurse Enumera y comprueba las asociaciones de sitio para todos los destinos de
carpeta en la raíz de espacio de nombres especificada.

/full Comprueba que AD DS y el registro del servidor contienen la misma


información de asociación de sitio.

Ejemplos
Para comprobar las asociaciones de sitio en machine\MyServer, escriba lo siguiente:
dfsdiag /testsites /machine:MyServer

Para comprobar una carpeta del Sistema de archivos distribuido (DFS) para verificar la
asociación del sitio, junto con la comprobación de que AD DS y el registro del servidor
contienen la misma información de asociación de sitio, escriba lo siguiente:

dfsdiag /TestSites /DFSpath:\\contoso.com\namespace1\folder1 /full

Para comprobar una raíz de espacio de nombres para verificar la asociación del sitio,
junto con la enumeración y verificación de las asociaciones de sitio para todos los
destinos de carpeta en la raíz de espacio de nombres especificado y la verificación de
que AD DS y el registro del servidor contienen la misma información de asociación de
sitio, escriba lo siguiente:

dfsdiag /testsites /DFSpath:\\contoso.com\namespace2 /recurse /full

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando dfsdiag
dfsrmig
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

La herramienta de migración para el servicio de Replicación DFS, dfsrmig.exe, se instala


con el servicio de Replicación DFS. Esta herramienta migra la replicación SYSvol desde el
Servicio de replicación de archivos (FRS) a la replicación del Sistema de archivos
distribuido (DFS). También proporciona información sobre el progreso de la migración y
modifica los objetos de Active Directory Domain Services (AD DS) para admitir la
migración.

Sintaxis

dfsrmig [/setglobalstate <state> | /getglobalstate | /getmigrationstate |


/createglobalobjects |
/deleterontfrsmember [<read_only_domain_controller_name>] |
/deleterodfsrmember [<read_only_domain_controller_name>] | /?]

Parámetros

Parámetro Descripción

/setglobalstate <state> Establece el estado de migración global del dominio en


uno que corresponde al valor especificado por estado.
Solo puede establecer el estado de migración global en
un estado estable. Los valores de estado son:

0 - Estado de inicio
1 - Estado preparado
2 - Estado redirigido
3 - Estado eliminado
Parámetro Descripción

/getglobalstate Recupera el estado de migración global actual del


dominio a partir de la copia local de la base de datos de
AD DS, cuando se ejecuta en el emulador de PDC. Use
esta opción para confirmar que establece el estado de
migración global correcto.
Importante: Solo debe ejecutar este comando en el
emulador de PDC.

/getmigrationstate Recupera el estado de migración local actual para todos


los controladores de dominio del dominio y determina si
esos estados locales coinciden con el estado de
migración global actual. Use esta opción para
determinar si todos los controladores de dominio han
alcanzado el estado de migración global.

/createglobalobjects Crea los objetos globales y la configuración en AD DS


que usa la Replicación DFS. Las únicas situaciones en las
que debe usar esta opción para crear objetos y
configuraciones manualmente son:
Se promueve un nuevo controlador de dominio
de solo lectura durante la migración. Si se
promueve un nuevo controlador de dominio de
solo lectura en el dominio después de pasar al
estado Preparado, pero antes de la migración al
estado Eliminado, los objetos que corresponden al
nuevo controlador de dominio no se crean, lo que
provoca un error en la replicación y la migración.
No se dispone de la configuración global del
servicio de Replicación DFS o se ha eliminado. En
el caso de que un controlador de dominio no
disponga de esta configuración, la migración
desde el estado Inicio al estado Preparado se
detendrá en el estado de transición Preparación.
Nota: Dado que la configuración global de AD DS
para el servicio de Replicación DFS para un
controlador de dominio de solo lectura se crea en
el emulador de PDC, esta configuración debe
replicarse en el controlador de dominio de solo
lectura desde el emulador de PDC antes de que el
servicio de Replicación DFS en el controlador de
dominio de solo lectura pueda usar esta
configuración. Debido a las latencias de
replicación de Active Directory, esta replicación
puede tardar un tiempo en producirse.
Parámetro Descripción

/deleterontfrsmember Elimina la configuración global de AD DS para la


[<read_only_domain_controller_name>] Replicación FRS que corresponde al controlador de
dominio de solo lectura especificado o elimina la
configuración global de AD DS para la Replicación FRS
para todos los controladores de dominio de solo lectura
si no se especifica ningún valor para
<read_only_domain_controller_name> .

No es necesario usar esta opción durante un proceso de


migración normal, ya que el servicio de Replicación DFS
elimina automáticamente esta configuración de AD DS
durante la migración desde el estado Redirigido al
estado Eliminado. Use esta opción para eliminar
manualmente la configuración de AD DS solo cuando se
produce un error en la eliminación automática en un
controlador de dominio de solo lectura y detiene el
controlador de dominio de solo lectura durante mucho
tiempo durante la migración desde el estado Redirigido
al estado Eliminado.

/deleterodfsrmember Elimina la configuración global de AD DS para la


[<read_only_domain_controller_name>] Replicación DFS que corresponde al controlador de
dominio de solo lectura especificado o elimina la
configuración global de AD DS para la Replicación DFS
para todos los controladores de dominio de solo lectura
si no se especifica ningún valor para
<read_only_domain_controller_name> .

Use esta opción para eliminar manualmente la


configuración de AD DS solo cuando se produce un
error en la eliminación automática en un controlador de
dominio de solo lectura y detiene el controlador de
dominio de solo lectura durante mucho tiempo al
revertir la migración desde el estado Preparado al
estado de Inicio.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Use el comando /setglobalstate <state> para establecer el estado de migración
global en AD DS en el emulador de PDC para iniciar y controlar el proceso de
migración. Si el emulador de PDC no está disponible, se produce un error en este
comando.
La migración al estado Eliminado es irreversible y no se puede revertir, por lo que
debe usar un valor de 3 para el estado solo cuando se confirma completamente el
uso de la Replicación DFS para la replicación de SYSvol.

Los estados de migración global deben ser un estado de migración estable.

La replicación de Active Directory replica el estado global en otros controladores


de dominio del dominio, pero debido a las latencias de replicación, puede obtener
incoherencias si se ejecuta dfsrmig /getglobalstate en un controlador de dominio
distinto del emulador de PDC.

La salida de dfsrmig /getmigrationstate indica si la migración al estado global


actual está completa, enumerando el estado de migración local para los
controladores de dominio que aún no han alcanzado el estado de migración
global actual. El estado de migración local para los controladores de dominio
también puede incluir estados de transición para los controladores de dominio
que no han alcanzado el estado de migración global actual.

Los controladores de dominio de solo lectura no pueden eliminar la configuración


de AD DS, el emulador de PDC realiza esta operación y los cambios se replican
finalmente en los controladores de dominio de solo lectura después de las
latencias aplicables para la replicación de Active Directory.

El comando dfsrmig solo se admite en controladores de dominio que se ejecutan


en el nivel funcional del dominio de Windows Server, ya que la migración de
SYSvol de replicación FRS a DFS solo es posible en controladores de dominio que
operan en ese nivel.

Puede ejecutar el comando dfsrmig en cualquier controlador de dominio, pero las


operaciones que crean o manipulan objetos de AD DS solo se permiten en
controladores de dominio compatibles con lectura y escritura (no en controladores
de dominio de solo lectura).

Ejemplos
Para establecer el estado de migración global en Preparado (1) e iniciar la migración o
revertir desde el estado Preparado, escriba lo siguiente:

dfsrmig /setglobalstate 1
Para establecer el estado de migración global en Inicio (0) e iniciar la reversión al estado
de Inicio, escriba lo siguiente:

dfsrmig /setglobalstate 0

Para mostrar el estado de migración global, escriba lo siguiente:

dfsrmig /getglobalstate

Salida del comando dfsrmig /getglobalstate :

Current DFSR global state: Prepared


Succeeded.

Para mostrar información sobre si los estados de migración local en todos los
controladores de dominio coinciden con el estado de migración global y si hay algún
estado de migración local en el que el estado local no coincida con el estado global,
escriba lo siguiente:

dfsrmig /GetMigrationState

Salida del comando dfsrmig /getmigrationstate cuando los estados de migración local
en todos los controladores de dominio coinciden con el estado de migración global:

All Domain Controllers have migrated successfully to Global state


(Prepared).
Migration has reached a consistent state on all Domain Controllers.
Succeeded.

Salida del comando dfsrmig /getmigrationstate cuando los estados de migración local
en algunos de los controladores de dominio no coinciden con el estado de migración
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 crear los objetos globales y la configuración que usa Replicación DFS en AD DS en
controladores de dominio en los que esa configuración no se creó automáticamente
durante la migración o en la que falta esa configuración, escriba lo siguiente:

dfsrmig /createglobalobjects

Para eliminar la configuración global de AD DS para la Replicación FRS para un


controlador de dominio de solo lectura denominado contoso-dc2 si el proceso de
migración no eliminó automáticamente la configuración, escriba lo siguiente:

dfsrmig /deleterontfrsmember contoso-dc2

Para eliminar la configuración global de AD DS para la Replicación FRS para todos los
controladores de dominio de solo lectura si el proceso de migración no eliminó
automáticamente la configuración, escriba lo siguiente:

dfsrmig /deleterontfrsmember

Para eliminar la configuración global de AD DS para la Replicación DFS para un


controlador de dominio de solo lectura denominado contoso-dc2 si el proceso de
migración no eliminó automáticamente la configuración, escriba lo siguiente:

dfsrmig /deleterodfsrmember contoso-dc2

Para eliminar la configuración global de AD DS para la Replicación DFS para todos los
controladores de dominio de solo lectura si el proceso de migración no eliminó
automáticamente la configuración, escriba lo siguiente:

dfsrmig /deleterodfsrmember

Para mostrar la ayuda en el símbolo del sistema:

dfsrmig

dfsrmig /?

Vínculos relacionados
Clave de sintaxis de línea de comandos

Serie sobre los estados de la migración SYSvol Parte 2 - Dfsrmig.exe: la


herramienta de migración de SYSvol

Active Directory Domain Services


diantz
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Empaquete los archivos existentes en un archivo contenedor (.cab). Este comando


realiza las mismas acciones que el comando makecab actualizado.

Sintaxis

diantz [/v[n]] [/d var=<value> ...] [/l <dir>] <source> [<destination>]


diantz [/v[<n>]] [/d var=<value> ...] /f <directives_file> [...]

Parámetros

Parámetro Descripción

<source> Archivo que se va a comprimir.

<destination> Nombre de archivo que se va a asignar al archivo comprimido. Si se omite,


el último carácter del nombre de archivo de origen se reemplaza por un
guion bajo (_) y se usa como destino.

/f Un archivo con directivas diantz (puede repetirse).


<directives_file>

/d var= <value> Define la variable con un valor especificado.

/l <dir> Ubicación para colocar el destino (el valor predeterminado es el directorio


actual).

/v[ <n> ] Establece el nivel de detalle de depuración (0=ninguno,...,3=total).

/? Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
Formato .cab de Microsoft
dir
Artículo • 12/04/2023

Muestra una lista de los archivos y subdirectorios de un directorio. Si se usa sin


parámetros, este comando muestra la etiqueta de volumen y el número de serie del
disco, seguido de una lista de directorios y archivos del disco (como los nombres y la
fecha y hora en que se modificó por última vez). En el caso de archivos, este comando
muestra la extensión de nombre y el tamaño en bytes. Este comando también muestra
el total de archivos y directorios que aparecen, el tamaño acumulado y el espacio libre
(en bytes) que queda en el disco.

El comando dir también se puede ejecutar desde la Consola de recuperación de


Windows mediante parámetros diferentes. Para obtener más información, consulte
Entorno de recuperación de Windows (WinRE).

Sintaxis

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 Descripción

[<drive>:][<path>] Especifica la unidad y el directorio para los que desea ver una lista.

[<filename>] Especifica un archivo o grupo de archivos concretos para los que desea ver
una lista.

/p Muestra una pantalla de la lista cada vez. Para ver la siguiente pantalla,
presione cualquier tecla.

/q Muestra la información de propiedad del archivo.

/w Muestra la lista en formato ancho, con hasta cinco nombres de archivo o


nombres de directorio en cada línea.

/d Muestra la lista en el mismo formato que /w, pero los archivos se ordenan
por columna.
Parámetro Descripción

/a[[:] <attributes> ] Muestra solo los nombres de esos directorios y archivos con los atributos
especificados. Si no usa este parámetro, el comando muestra los nombres
de todos los archivos excepto los archivos ocultos y de sistema. Si usa este
parámetro sin especificar ningún atributo, el comando muestra los
nombres de todos los archivos, incluidos los archivos ocultos y de sistema.
La lista de posibles valores de atributos son:

d - Directorios
h - Archivos ocultos
s - Archivos de sistema
l - Puntos de repetición de análisis
r - Archivos de solo lectura
a - Archivos listos para archivar
i - Archivos no indexados por contenido

Puede combinar estos valores de cualquier manera, pero no separe los


valores mediante espacios. De manera opcional, puede usar dos puntos (:)
como separador, o un guion (-) como prefijo para indicar, "no". Por
ejemplo, el uso del atributo -s no mostrará los archivos de sistema.

/o/o[[:] <sortorder> ] Ordena la salida según sortorder, que puede ser la combinación de
cualquiera de los siguientes valores:

n - alfabéticamente por nombre


e - alfabéticamente por extensión
g - por directorios de grupo
s - por tamaño, de forma ascendente
d - Por fecha y hora, la más antigua primero
Usar el prefijo - para invertir el criterio de ordenación

Se procesan varios valores en el orden en que se enumeran. No separe


varios valores mediante espacios, pero puede usar los dos puntos (:) de
forma opcional.

Si no se especifica sortorder, dir /o enumera los directorios


alfabéticamente, seguidos de los archivos, que también se ordenan
alfabéticamente.

/t[[:] <timefield> ] Especifica el campo de hora que se va a mostrar o usar para la ordenación.
Los valores timefield disponibles son:

c - creación
a - último acceso
w - última escritura

/s Enumera todas las repeticiones del nombre de archivo especificado en el


directorio especificado y en todos los subdirectorios.
Parámetro Descripción

/b Muestra una lista de directorios y archivos, sin información adicional. El


parámetro /b invalida /w.

/l Muestra nombres de directorio y nombres de archivo sin ordenar, en


minúsculas.

/n Muestra un formato de lista larga con nombres de archivo en el extremo


derecho de la pantalla.

/x Muestra los nombres cortos generados para los nombres de archivo que
no son 8dot3. La presentación es la misma que la de /n, pero el nombre
corto se inserta antes del nombre largo.

/C Muestra el separador de miles en tamaños de archivo. Este es el


comportamiento predeterminado. Use /-c para ocultar separadores.

/4 Muestra años en formato de cuatro dígitos.

/r Muestra flujos de datos alternativos del archivo.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Para usar varios parámetros filename, separe cada nombre de archivo con un
espacio, coma o punto y coma.

Puede usar caracteres comodín (* o ?) para representar uno o varios caracteres de


un nombre de archivo y para mostrar un subconjunto de archivos o subdirectorios.

Puede usar el carácter comodín, *, para sustituir cualquier cadena de caracteres,


por ejemplo:

dir *.txt enumera todos los archivos del directorio actual con extensiones que

comienzan por .txt, como .txt, .txt1, .txt_old.

dir read *.txt enumera todos los archivos del directorio actual que empiezan

por read y con extensiones que comienzan por .txt, como .txt, .txt1, .txt_old.

dir read *.* enumera todos los archivos del directorio actual que comienzan

por read con cualquier extensión.

El carácter comodín de asterisco siempre usa una asignación de nombre de archivo


corto, por lo que es posible que obtenga resultados inesperados. Por ejemplo, el
siguiente directorio contiene dos archivos (t.txt2 y 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

Es posible que espere que escribir dir t97\* devuelva el archivo t97.txt. Sin
embargo, escribir dir t97\* devuelve ambos archivos, ya que el carácter comodín
de asterisco hace coincidir el archivo t.txt2 con t97.txt al usar la asignación de
nombre corto T97B4~1.TXT. De forma similar, escribir del t97\* eliminaría ambos
archivos.

Puede usar el signo de interrogación (?) como sustituto de un solo carácter en un


nombre. Por ejemplo, al escribir dir read???.txt se enumeran los archivos del
directorio actual con la extensión .txt que comienzan por read y que van seguidos
de hasta tres caracteres. Esto incluye Read.txt, Read1.txt, Read12.txt, Read123.txt y
Readme1.txt, pero no Readme12.txt.

Si usa /a con más de un valor en attributes, este comando muestra los nombres de
solo aquellos archivos con todos los atributos especificados. Por ejemplo, si usa /a
con r y -h como atributos (mediante /a:r-h o /ar-h ), este comando solo mostrará
los nombres de los archivos de solo lectura que no están ocultos.

Si especifica más de un valor sortorder, este comando ordena los nombres de


archivo por el primer criterio, después por el segundo criterio, etc. Por ejemplo, si
usa /o con los parámetros e y -s para sortorder (mediante /o:e-s o /oe-s ), este
comando ordena los nombres de directorios y archivos por extensión, empezando
por el más grande y, a continuación, muestra el resultado final. La ordenación
alfabética por extensión hace que los nombres de archivo sin extensiones
aparezcan primero, después los nombres de directorio y, a continuación, nombres
de archivo con extensiones.

Si usa el símbolo de redireccionamiento ( > ) para enviar la salida de este comando


a un archivo, o si usa una canalización ( | ) para enviar la salida de este comando a
otro comando, debe usar /a:-d y /b para enumerar solo los nombres de archivo.
Puede usar filename con /b y /s para especificar que este comando es para buscar
en el directorio actual y en los subdirectorios todos los nombres de archivo que
coincidan con filename. Este comando muestra solo la letra de unidad, el nombre
del directorio, el nombre de archivo y la extensión de nombre de archivo (una ruta
de acceso por línea) para cada nombre de archivo que encuentre. Antes de usar
una canalización para enviar la salida de este comando a otro comando, debe
establecer la variable de entorno TEMP en el archivo Autoexec.nt.

Ejemplos
Para mostrar todos los directorios uno después del otro, en orden alfabético, en formato
ancho y haciendo pausa después de cada pantalla, asegúrese de que el directorio raíz es
el directorio actual y, a continuación, escriba lo siguiente:

dir /s/w/o/p

La salida muestra el directorio raíz, los subdirectorios y los archivos del directorio raíz,
incluidas las extensiones. Este comando también enumera los nombres de subdirectorio
y los nombres de archivo de cada subdirectorio del árbol.

Para modificar el ejemplo anterior y que dir muestre los nombres y las extensiones de
archivo, pero omita los nombres de directorio, escriba lo siguiente:

dir /s/w/o/p/a:-d

Para imprimir una lista de directorios, escriba lo siguiente:

dir > prn

Al especificar prn, la lista de directorios se envía a la impresora que está conectada al


puerto LPT1. Si la impresora está conectada a un puerto diferente, debe reemplazar prn
por el nombre del puerto correcto.

También puede redirigir la salida del comando dir a un archivo reemplazando prn por
un nombre de archivo. También puede utilizar una ruta de acceso. Por ejemplo, para
dirigir una salida de dir al archivo dir.doc en el directorio Records, escriba lo siguiente:
dir > \records\dir.doc

Si dir.doc no existe, dir lo crea, a menos que el directorio Records no exista. En ese caso,
aparecerá el siguiente mensaje:

File creation error

Para mostrar una lista de todos los nombres de archivo con la extensión .txt en todos los
directorios de la unidad C, escriba lo siguiente:

dir c:\*.txt /w/o/s/p

El comando dir muestra, en formato ancho, una lista alfabética de los nombres de
archivo coincidentes en cada directorio y hace una pausa cada vez que se rellena la
pantalla hasta que se presiona cualquier tecla para continuar.

Vínculos relacionados
Clave de sintaxis de línea de comandos
diskcomp
Artículo • 14/04/2023

Compara el contenido de dos discos. Si se usa sin parámetros, diskcomp usa la unidad
actual para comparar ambos discos.

Sintaxis

diskcomp [<drive1>: [<drive2>:]]

Parámetros

Parámetro Descripción

<drive1> Especifica la unidad que contiene uno de los discos.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

El comando diskcomp solo funciona con discos. No se puede usar diskcopy con
un disco duro. Si especifica una unidad de disco duro para drive1 o drive2,
diskcopy muestra el mensaje de error siguiente:

Invalid drive specification


Specified drive does not exist
or is nonremovable

Si todas las pistas de los dos discos que se comparan son iguales (omite el número
de volumen de un disco), diskcomp muestra el mensaje siguiente:

Compare OK

Si las pistas no son las mismas, diskcomp muestra un mensaje similar al siguiente:
Compare error on
side 1, track 2

Cuando diskcomp completa la comparación, muestra este mensaje:

Compare another diskette (Y/N)?

Si presiona Y, diskcomp le pide que inserte el disco para realizar la comparación


siguiente. Si presiona N, diskcomp detiene la comparación.

Si omite el parámetro drive2, diskcomp usa la unidad actual para drive2. Si omite
ambos parámetros de unidad, diskcopy usa la unidad actual para ambos. Si la
unidad actual es la misma que drive1, diskcopy le pedirá que intercambie los
discos según sea necesario.

Si especifica la misma unidad de disco para drive1 y drive2, diskcomp las compara
usando una unidad y le pide que inserte los discos según sea necesario. Puede que
tenga que intercambiar los discos más de una vez, en función de la capacidad de
los discos y la cantidad de memoria disponible.

Diskcomp no puede comparar un disco de un solo lado con un disco de dos lados
ni un disco de alta densidad con un disco de densidad doble. Si el disco que se
encuentra en drive1 no es del mismo tipo que el disco de drive2, diskcomp
muestra este mensaje:

Drive types or diskette types not compatible

Diskcomp no funciona en una unidad de red ni en una unidad creada con el


comando subst. Si intenta usar diskcomp con una unidad de cualquiera de estos
tipos, diskcomp muestra el mensaje de error siguiente:

Invalid drive specification

Si usa diskcomp con un disco que creó con copy, diskcomp podría mostrar un
mensaje similar al siguiente:
Compare error on
side 0, track 0

Este tipo de error puede producirse incluso si los archivos de los discos son
idénticos. Si bien copy duplica la información, no necesariamente la coloca en la
misma ubicación en el disco de destino.

Códigos de salida de diskcomp:

Código de salida Descripción

0 Los discos son iguales

1 Diferencias que se encontraron

3 Se produjo un error grave

4 Se produjo un error de inicialización

Para procesar los códigos de salida devueltos por diskcomp, puede usar la variable
de entorno ERRORLEVEL en la línea de comandos if de un programa por lotes.

Ejemplos
Si el equipo solo tiene una unidad (por ejemplo, unidad A) y desea comparar dos discos,
escriba:

diskcomp a: a:

Diskcomp le pide que inserte cada disco según sea necesario.

Para ilustrar cómo procesar un código de salida de diskcomp en un programa por lotes
que usa la variable de entorno ERRORLEVEL en la línea de comandos 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

Vínculos relacionados
Clave de sintaxis de línea de comandos
diskcopy
Artículo • 12/04/2023

Copia el contenido del disquete de la unidad de origen en un disquete con formato o


sin formato de la unidad de destino. Si se usa sin parámetros, diskcopy usa la unidad
actual para el disco de origen y el disco de destino.

Sintaxis

diskcopy [<drive1>: [<drive2>:]] [/v]

Parámetros

Parámetro Descripción

<drive1> Especifica la unidad que contiene el disco de origen.

/v Comprueba que la información se copie correctamente. Esta opción ralentiza el


proceso de copia.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Diskcopy solo funciona con discos extraíbles, como disquetes, que deben ser del
mismo tipo. No se puede usar diskcopy con un disco duro. Si especifica una
unidad de disco duro para drive1 o drive2, diskcopy muestra el siguiente mensaje
de error:

Invalid drive specification


Specified drive does not exist or is nonremovable

El comando diskcopy le pide al usuario que inserte los discos de origen y destino y
espera a que presione cualquier tecla antes de continuar.

Después de copiar el disco, diskcopy muestra el mensaje siguiente:


Copy another diskette (Y/N)?

Si presiona Y, diskcopy le pide que inserte discos de origen y destino para la


siguiente operación de copia. Para detener el proceso de diskcopy, presione N.

Si va a copiar en un disquete sin formato en drive2, diskcopy da formato al disco


con el mismo número de lados y sectores por pista que hay en el disco en drive1.
Diskcopy muestra el siguiente mensaje mientras da formato al disco y copia los
archivos:

Formatting while copying

Si el disco de origen tiene un número de serie del volumen, diskcopy crea un


nuevo número de serie del volumen para el disco de destino y muestra el número
cuando se completa la operación de copia.

Si omite el parámetro drive2, diskcopy usa la unidad actual como unidad de


destino. Si omite ambos parámetros de unidad, diskcopy usa la unidad actual para
ambos. Si la unidad actual es la misma que drive1, diskcopy le pide que
intercambie los discos según sea necesario.

Ejecute diskcopy desde una unidad distinta de la unidad de disquete, por ejemplo,
la unidad C. Si la unidad de disquete drive1 y la unidad de disquete drive2 son las
mismas, diskcopy le pedirá que cambie los discos. Si los discos contienen más
información de la que puede contener la memoria disponible, diskcopy no puede
leer toda la información de una vez. Diskcopy lee desde el disco de origen, escribe
en el disco de destino y le pide que vuelva a insertar el disco de origen. Este
proceso se repite hasta que haya copiado todo el disco.

La fragmentación es la presencia de áreas pequeñas de espacio en disco sin usar


entre los archivos existentes de un disco. Un disco de origen fragmentado puede
ralentizar el proceso de búsqueda, lectura o escritura de archivos.

Dado que diskcopy realiza una copia exacta del disco de origen en el disco de
destino, cualquier fragmentación del disco de origen se transfiere al disco de
destino. Para evitar la transferencia de fragmentación de un disco a otro, use el
comando copy o el comando xcopy para copiar el disco. Dado que copy y xcopy
copian archivos secuencialmente, el nuevo disco no está fragmentado.
7 Nota

No puede usar xcopy para copiar un disco de inicio.

Códigos de salida de diskcopy:

Código de salida Descripción

0 La operación de copia se realizó correctamente

1 Se produjo un error de lectura o escritura no grave

3 Se produjo un error grave

4 Se produjo un error de inicialización

Para procesar los códigos de salida devueltos por diskcomp, puede usar la variable
de entorno ERRORLEVEL en la línea de comandos if de un programa por lotes.

Ejemplos
Para copiar el disco de la unidad B en el disco de la unidad A, escriba lo siguiente:

diskcopy b: a:

Para usar la unidad de disquete A para copiar un disquete a otro, primero cambie a la
unidad C y, a continuación, escriba lo siguiente:

diskcopy a: a:

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando xcopy

Comando copy
diskpart
Artículo • 14/04/2023

Se aplica 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 y Windows Server 2008 R2, Windows Server 2008

El intérprete de comandos diskpart le permite administrar las unidades del equipo


(discos, particiones, volúmenes o discos duros virtuales).

Para poder usar los comandos diskpart, primero debe enumerar y, luego, seleccionar un
objeto para transferirle el foco. Si un objeto tiene el foco, los comandos diskpart que se
escriban actuarán en ese objeto.

Determinación del foco


Al seleccionar un objeto, éste conserva el foco hasta que se selecciona otro objeto. Por
ejemplo, si el foco está establecido en el disco 0 y selecciona el volumen 8 en el disco 2,
el foco cambia del disco 0 al disco 2, volumen 8.

Algunos comandos cambian el foco automáticamente. Por ejemplo, al crear una


partición, el foco cambia automáticamente a esa partición nueva.

Solo se puede transferir el foco a una partición del disco seleccionado. Cuando una
partición tiene el foco, también lo tiene el volumen relacionado (si lo hay). Cuando un
volumen tiene el foco, también lo tienen el disco y la partición relacionados si el
volumen se asigna a una partición específica única. De no ser así, el disco y la partición
pierden el foco.

Sintaxis
Para iniciar el intérprete de comandos diskpart, escriba lo siguiente en el símbolo del
sistema:

Símbolo del sistema de Windows

diskpart <parameter>

) Importante
Para ejecutar diskpart, debe estar en el grupo Administradores local o en un grupo
con permisos similares.

Parámetros
Puede ejecutar los comandos siguientes desde el intérprete de comandos de Diskpart:

Comando Descripción

active Marca la partición del disco con el foco como activo.

add Refleja el volumen simple que tiene el foco en el disco especificado.

assign Asigna una letra de unidad o un punto de montaje al volumen que tiene el foco.

attach Adjunta (o bien "monta" o "muestra") un disco duro virtual (VHD) para que aparezca
vdisk en el equipo host como una unidad de disco duro local.

attributes Muestra, establece o borra los atributos de un disco o volumen.

automount Habilita o deshabilita la característica de montaje automático.

break Divide el volumen reflejado que tiene el foco en dos volúmenes simples.

clean Quita todo el formato de particiones o volúmenes del disco que tiene el foco.

compact Reduce el tamaño físico de un archivo de disco duro virtual (VHD) de expansión
vdisk dinámica.

convert Convierte los volúmenes de FAT y FAT32 (tabla de asignación de archivos) al sistema
de archivos NTFS, dejando intactos los archivos y directorios existentes.

crear Crea una partición en un disco, un volumen en uno o varios discos o un disco duro
virtual (VHD).

delete Elimina una partición o un volumen.

detach Impide que el disco duro virtual (VHD) seleccionado aparezca como una unidad de
vdisk disco duro local en el equipo host.

detail Muestra información sobre el disco, la partición, el volumen o el disco duro virtual
(VHD) que se seleccionó.

exit Sale del intérprete de comandos de diskpart.

expand Expande un disco duro virtual (VHD) al tamaño que especifique.


vdisk

extend Extiende el volumen o la partición que tiene el foco, junto con su sistema de
archivos, a espacio libre (sin asignar) de un disco.
Comando Descripción

filesystems Muestra información sobre el sistema de archivos actual del volumen que tiene el
foco y enumera los sistemas de archivos que tienen permitido dar formato al
volumen.

format Da formato a un disco para aceptar archivos.

gpt Asigna los atributos gpt a la partición con foco en los discos básicos de la tabla de
particiones GUID (gpt).

help Muestra una lista de los comandos disponibles o información detallada de ayuda
sobre un comando especificado.

import Importa un grupo de discos externos al grupo de discos del equipo local.

inactive Marca la partición del sistema o la partición de arranque con el foco como inactiva
en los discos del registro de arranque maestro (MBR) básico.

list Muestra una lista de discos, de particiones de un disco, de volúmenes de un disco o


de discos duros virtuales (VHD).

merge Combina un disco duro virtual (VHD) diferenciado con su VHD primario
vdisk correspondiente.

offline Lleva un disco o volumen en línea al estado sin conexión.

online Lleva un disco o volumen sin conexión al estado en línea.

recover Actualiza el estado de todos los discos de un grupo de discos, intenta recuperar
discos en un grupo de discos no válidos y vuelve a sincronizar volúmenes reflejados
y volúmenes RAID-5 que tienen datos obsoletos.

rem Proporciona una forma de agregar comentarios a un script.

remove Quita una letra de unidad o un punto de montaje de un volumen.

repair Repara el volumen RAID-5 con el foco sustituyendo la región del disco con errores
por el disco dinámico especificado.

rescan Ubica discos nuevos que se puedan haber agregado al equipo.

retain Prepara un volumen dinámico simple existente para utilizarlo como volumen de
arranque o de sistema.

san Muestra o establece la directiva de red de área de almacenamiento (SAN) para el


sistema operativo.

select Desplaza el foco a un disco, una partición, un volumen o un disco duro virtual
(VHD).

set id Cambia el campo de tipo de partición de la partición con el foco.


Comando Descripción

shrink Reduce el tamaño del volumen seleccionado en la cantidad que especifique.

uniqueid Muestra o establece el identificador de la tabla de particiones GUID (GPT) o la firma


del registro de arranque maestro (MBR) para el disco con el foco.

Enumeración de objetos disponibles


Para ver una lista de las opciones asociadas a cada comando, ejecute el comando
principal seguido de lo que está disponible para ese comando específico. La ejecución
del comando list solo mostrará estos cuatro parámetros:

7 Nota

Después de ejecutar el comando list, aparece un asterisco (*) junto al objeto del
foco.

Ejemplos
Para ver los discos disponibles, ejecute list disk:

Símbolo del sistema de Windows


list disk

Para seleccionar un disco, ejecute select disk seguido del número de disco. Por ejemplo:

Símbolo del sistema de Windows

select disk 1

Antes de que se pueda usar el disco 1, es necesario crear una partición mediante la
ejecución de create partition primary:

Símbolo del sistema de Windows

create partition primary

Por último, podemos dar formato rápidamente al disco 1 en formato NTFS con la
etiqueta "Backup" mediante la ejecución de format fs=ntfs label=Backup quick, tal
como se muestra a continuación:

Símbolo del sistema de Windows

format fs=ntfs label=Backup quick


Vínculos relacionados
Clave de sintaxis de línea de comandos

Introducción a la administración de discos

Cmdlets de almacenamiento en Windows PowerShell


diskperf
Artículo • 14/04/2023

El comando diskperf habilita o deshabilita de forma remota contadores de rendimiento


de disco físico o lógico en equipos que ejecutan Windows.

Sintaxis

diskperf [-y[d|v] | -n[d|v]] [\\computername]

Opciones
Opción Descripción

-y Inicia todos los contadores de rendimiento de disco cuando se reinicia el


equipo.

-yd Habilita los contadores de rendimiento de disco para las unidades físicas
cuando se reinicia el equipo.

-yv Habilita los contadores de rendimiento de disco para unidades lógicas o


volúmenes de almacenamiento cuando se reinicia el equipo.

-n Deshabilita todos los contadores de rendimiento de disco cuando se reinicia el


equipo.

-nd Deshabilita los contadores de rendimiento de disco para las unidades físicas
cuando se reinicia el equipo.

-nv Deshabilita los contadores de rendimiento de disco para unidades lógicas o


volúmenes de almacenamiento cuando se reinicia el equipo.

\\ Especifica el nombre del equipo en el que desea habilitar o deshabilitar los


<computername> contadores de rendimiento del disco.

-? Muestra ayuda contextual.

Vínculos relacionados
Clave de sintaxis de línea de comandos
Diskraid
Artículo • 14/04/2023

Diskraid es una herramienta de línea de comandos que permite configurar y administrar


una matriz redundante de subsistemas de almacenamiento de discos independientes (o
económicos) (RAID).

RAID se usa normalmente en servidores para estandarizar y clasificar los sistemas de


disco tolerantes a errores. Los niveles RAID ofrecen varias combinaciones de
rendimiento, confiabilidad y costo. Algunos servidores proporcionan tres de los niveles
RAID: Nivel 0 (fragmentación), Nivel 1 (reflejo) y Nivel 5 (fragmentación con paridad).

Un subsistema RAID de hardware distingue las unidades de almacenamiento


direccionables físicamente entre sí mediante un número de unidad lógica (LUN). Un
objeto LUN debe tener al menos un plex y puede tener cualquier número de plexes
adicionales. Cada plex contiene una copia de los datos en el objeto LUN. Los plexes se
pueden agregar y quitar de un objeto LUN.

La mayoría de los comandos Diskraid funcionan en un puerto específico del adaptador


de bus host (HBA), adaptador del iniciador, portal del iniciador, proveedor, subsistema,
controlador, puerto, unidad, LUN, portal de destino, destino o grupo del portal de
destino. Use el comando SELECT para seleccionar un objeto. Se dice que el objeto
seleccionado tiene el foco. El foco simplifica las tareas de configuración comunes, como
la creación de varios LUN en el mismo subsistema.

7 Nota

La herramienta de línea de comandos Diskraid solo funciona con subsistemas de


almacenamiento que admiten un servicio de disco virtual (VDS).

Comandos diskraid
Los siguientes comandos están disponibles desde la herramienta Diskraid.

add
Agrega un LUN existente al LUN seleccionado actualmente o agrega un portal de
destino iSCSI al grupo de portales de destino iSCSI seleccionado actualmente.
Sintaxis

add plex lun=n [noerr]


add tpgroup tportal=n [noerr]

Parámetros

Parámetro Descripción

plex lun= Especifica el número de LUN que se va a agregar como un plex al LUN
<n> seleccionado actualmente. PRECAUCIÓN: Se eliminarán todos los datos del LUN
que se van a agregar como un plex.

tpgroup Especifica el número del portal de destino iSCSI que se va a agregar al grupo de
tportal= <n> portales de destino iSCSI seleccionado actualmente.

noerr Sólo para scripting. Cuando se detecta un error, Diskraid sigue procesando los
comandos como si no hubiera ningún error.

associate
Establece la lista especificada de puertos de controlador como activos para el LUN
seleccionado actualmente (otros puertos de controlador están inactivos) o agrega los
puertos de controlador especificados a la lista de puertos de controlador activos
existentes para el LUN seleccionado actualmente o asocia el destino iSCSI especificado
para el LUN seleccionado actualmente.

Sintaxis

associate controllers [add] <n>[,<n> [,…]]


associate ports [add] <n-m>[,<n-m>[,…]]
associate targets [add] <n>[,<n> [,…]]

Parámetros

Parámetro Descripción

controlador Agrega o reemplaza la lista de controladores asociados al LUN seleccionado


actualmente. Usar solo con proveedores de VDS 1.0.
Parámetro Descripción

ports Agrega o reemplaza la lista de puertos de controlador asociados al LUN


seleccionado actualmente. Usar solo con proveedores de VDS 1.1.

destinos Agrega o reemplaza la lista de destinos iSCSI asociados al LUN seleccionado


actualmente. Usar solo con proveedores de VDS 1.1.

add Si usa proveedores de VDS 1.0: agrega los controladores especificados a la lista
existente de controladores asociados al LUN. Si no se especifica este parámetro, la
lista de controladores reemplaza la lista existente de controladores asociados a este
LUN.

Si usa proveedores de VDS 1.1: agrega los puertos de controlador especificados a


la lista existente de puertos de controlador asociados al LUN. Si no se especifica
este parámetro, la lista de puertos de controlador reemplaza la lista existente de
puertos de controlador asociados a este LUN.

<n>[,<n> Úselo con el parámetro controllers o targets. Especifica los números de los
[, ...]] controladores o destinos iSCSI que se van a establecer en activos o asociados.

<n-m>[,<n- Use con el parámetro ports. Especifica los puertos del controlador que se van a
m>[,…]] establecer como activos mediante un número de controlador (n) y un par de
número de puerto (m).

Ejemplo
Para asociar y agregar puertos a un LUN que usa un proveedor 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
Establece o borra marcas que proporcionan sugerencias a los proveedores sobre cómo
configurar un LUN. Si se usa sin parámetros, la operación automagic muestra una lista
de marcas.

Sintaxis

automagic {set | clear | apply} all <flag=value> [<flag=value> [...]]

Parámetros

Parámetro Descripción

set Establece las marcas especificadas en los valores especificados.

clear Borra las marcas especificadas. La palabra clave all borra todas las marcas
automagic.

apply Aplica las marcas actuales al LUN seleccionado.

<flag> Las marcas se identifican mediante acrónimos de tres letras, entre las que se
incluyen:
FCR: recuperación rápida tras bloqueo necesaria
FTL: tolerante a errores
MSR: principalmente lecturas
MXD: unidades máximas
MXS: tamaño máximo esperado
ORA: alineación óptima de lectura
ORS: tamaño de lectura óptimo
OSR: optimización para lecturas secuenciales
OSW: optimización para escrituras secuenciales
OWA: alineación óptima de escritura
OWS: tamaño de escritura óptimo
RBP: prioridad de reconstrucción
RBV: comprobación de lectura habilitada
RMP: reasignación habilitada
STS: tamaño de franja
WTC: almacenamiento en caché de escritura simultánea habilitado
YNK: extraíble

break
Quita el plex del LUN seleccionado actualmente. El plex y los datos que contiene no se
conservan y las extensiones de unidad se pueden reclamar.
U Precaución

Primero debe seleccionar un LUN reflejado antes de usar este comando. Se


eliminarán todos los datos del plex. No se garantiza que todos los datos
contenidos en el LUN original sean coherentes.

Sintaxis

break plex=<plex_number> [noerr]

Parámetros

Parámetro Descripción

plex Especifica el número del plex que se va a quitar. El plex y los datos contenidos no se
conservarán y se reclamarán los recursos utilizados por este plex. No se garantiza
que los datos contenidos en el LUN sean coherentes. Si desea conservar este plex,
use el Servicio de instantáneas de volumen (VSS).

noerr Sólo para scripting. Cuando se detecta un error, Diskraid sigue procesando los
comandos como si no hubiera ningún error.

chap
Establece el secreto compartido del Protocolo de autenticación por desafío mutuo
(CHAP) para que los iniciadores iSCSI y los destinos iSCSI puedan comunicarse entre sí.

Sintaxis

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 Descripción

initiator set Establece el secreto compartido en el servicio de iniciador iSCSI local que se usa
para la autenticación CHAP mutua cuando el iniciador autentica el destino.

initiator Comunica el secreto CHAP de un destino iSCSI al servicio del iniciador iSCSI local
remember para que el servicio de iniciador pueda usar el secreto para autenticarse en el
destino durante la autenticación CHAP.

target set Establece el secreto compartido en el destino iSCSI seleccionado actualmente que
se usa para la autenticación CHAP cuando el destino autentica al iniciador.

target Comunica el secreto CHAP de un iniciador iSCSI al destino iSCSI actual en foco
remember para que el destino pueda usar el secreto para autenticarse en el iniciador durante
la autenticación CHAP mutua.

secret Especifica el secreto que se va a usar. Si está vacío, se borrará el secreto.

Destino Especifica un destino en el subsistema seleccionado actualmente que se va a


asociar al secreto. Esto es opcional. Si se establece un secreto en el iniciador y se
deja fuera, esto indica que el secreto se usará para todos los destinos que aún no
tienen un secreto asociado.

initiatorname Especifica un nombre iSCSI del iniciador que se va a asociar al secreto. Esto es
opcional. Si se establece un secreto en el destino y se deja fuera, esto indica que
el secreto se usará para todos los iniciadores que aún no tienen un secreto
asociado.

create
Crea un nuevo destino LUN o iSCSI en el subsistema seleccionado actualmente o crea
un grupo de portal de destino en el destino seleccionado actualmente. Puede ver el
enlace real mediante el comando Diskraid list.

Sintaxis

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 Descripción

simple Crea un LUN simple.

franja Crea un LUN seccionado.

raid Crea un LUN seccionado con paridad.

mirror Crea un LUN reflejado.

automagic Crea un LUN mediante las sugerencias automagic actualmente en vigor. Para
obtener más información, consulte el subcomando automagic de este artículo.

size= Especifica el tamaño total de LUN en megabytes. Se debe especificar el parámetro


size= o drives=. También se pueden usar juntos. Si no se especifica el parámetro
size=, el LUN creado será el tamaño más grande posible permitido por todas las
unidades especificadas.

Normalmente, un proveedor crea un LUN al menos tan grande como el tamaño


solicitado, pero es posible que el proveedor tenga que redondear hasta el siguiente
tamaño más grande en algunos casos. Por ejemplo, si el tamaño se especifica como
0,99 GB y el proveedor solo puede asignar extensiones de disco GB, el LUN
resultante sería de 1 GB. Para especificar el tamaño mediante otras unidades, use
uno de los siguientes sufijos reconocidos inmediatamente después del tamaño:

B: byte
KB: kilobyte
MB: megabyte
GB: gigabyte
TB: terabyte
PB: petabyte.

drives= Especifica el drive_number de las unidades que se van a usar para crear un LUN. Se
debe especificar el parámetro size= o drives=. También se pueden usar juntos. Si no
se especifica el parámetro size=, el LUN creado es el tamaño más grande posible
permitido por todas las unidades especificadas. Si se especifica el parámetro size=,
los proveedores seleccionarán unidades de la lista de unidades especificadas para
crear el LUN. Los proveedores intentarán usar las unidades en el orden especificado
cuando sea posible.
Parámetro Descripción

stripesize= Especifica el tamaño en megabytes para un LUN stripe o raid. El stripesize no se


puede cambiar después de crear el LUN. Para especificar el tamaño mediante otras
unidades, use uno de los siguientes sufijos reconocidos inmediatamente después
del tamaño:

B: byte
KB: kilobyte
MB: megabyte
GB: gigabyte
TB: terabyte
PB: petabyte.

Destino Crea un nuevo destino iSCSI en el subsistema seleccionado actualmente.

name Proporciona el nombre descriptivo del destino.

iscsiname Proporciona el nombre iSCSI para el destino y se puede omitir para que el
proveedor genere un nombre.

tpgroup Crea un nuevo grupo de portal de destino iSCSI en el destino seleccionado


actualmente.

noerr Sólo para scripting. Cuando se detecta un error, Diskraid sigue procesando los
comandos como si no hubiera ningún error.

delete
Elimina el LUN seleccionado actualmente, el destino iSCSI (siempre que no haya ningún
LUN asociado con el destino iSCSI) o el grupo del portal de destino iSCSI.

Sintaxis

delete lun [uninstall] [noerr]


delete target [noerr]
delete tpgroup [noerr]

Parámetros

Parámetro Descripción

lun Elimina el LUN seleccionado actualmente y todos los datos que hay en él.
Parámetro Descripción

uninstall Especifica que el disco del sistema local asociado al LUN se limpiará antes de
eliminar el LUN.

Destino Elimina el destino iSCSI seleccionado actualmente si no hay ningún LUN asociado al
destino.

tpgroup Elimina el grupo de portal de destino iSCSI seleccionado actualmente.

noerr Sólo para scripting. Cuando se detecta un error, Diskraid sigue procesando los
comandos como si no hubiera ningún error.

detalles
Muestra información detallada sobre el objeto seleccionado actualmente del tipo
especificado.

Sintaxis

detail {hbaport | iadapter | iportal | provider | subsystem | controller |


port | drive | lun | tportal | target | tpgroup} [verbose]

Parámetros

Parámetro Descripción

hbaport Muestra información detallada sobre el puerto del adaptador de bus host (HBA)
seleccionado actualmente.

iadapter Muestra información detallada sobre el adaptador del iniciador iSCSI seleccionado
actualmente.

iportal Muestra información detallada sobre el portal del iniciador iSCSI seleccionado
actualmente.

provider Muestra información detallada sobre el proveedor seleccionado actualmente.

subsistema Muestra información detallada sobre el subsistema seleccionado actualmente.

controlador Muestra información detallada sobre el controlador seleccionado actualmente.

port Muestra información detallada sobre el puerto del controlador seleccionado


actualmente.
Parámetro Descripción

unidad Muestra información detallada sobre la unidad seleccionada actualmente, incluidos


los LUN que ocupan.

lun Muestra información detallada sobre el LUN seleccionado actualmente, incluidas las
unidades de contribución. La salida difiere ligeramente en función de si el LUN
forma parte de un subsistema iSCSI o canal de fibra. Si la lista Hosts sin máscara
contiene solo un asterisco, esto significa que el LUN no tiene máscara en ninguno
de los hosts.

tportal Muestra información detallada sobre el portal de destino iSCSI seleccionado


actualmente.

Destino Muestra información detallada sobre el destino iSCSI seleccionado actualmente.

tpgroup Muestra información detallada sobre el grupo de portal de destino iSCSI


seleccionado actualmente.

verbose Para uso exclusivo con el parámetro LUN. Enumera información adicional, incluidos
sus plexes.

dissociate
Establece la lista especificada de puertos de controlador como inactivos para el LUN
seleccionado actualmente (otros puertos de controlador no se ven afectados) o
desasocia la lista especificada de destinos iSCSI para el LUN seleccionado actualmente.

Syntax

dissociate controllers <n> [,<n> [,...]]


dissociate ports <n-m>[,<n-m>[,…]]
dissociate targets <n> [,<n> [,…]]

Parámetro

Parámetro Descripción

controllers Quita los controladores de la lista de controladores asociados al LUN seleccionado


actualmente. Usar solo con proveedores de VDS 1.0.

ports Quita los puertos del controlador de la lista de puertos de controlador que están
asociados al LUN seleccionado actualmente. Usar solo con proveedores de VDS 1.1.
Parámetro Descripción

destinos Quita los destinos de la lista de destinos iSCSI asociados al LUN seleccionado
actualmente. Usar solo con proveedores de VDS 1.1.

<n> [,<n> Para usar con el parámetro controllers o targets. Especifica los números de los
[,…]] controladores o destinos iSCSI que se van a establecer como inactivos o
desasociados.

<n-m>[,<n- Para su uso con el parámetro ports. Especifica los puertos del controlador que se
m>[,…]] van a establecer como inactivos mediante un número de controlador (n) y un par de
número de puerto (m).

Ejemplo

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
Sale de Diskraid.

Sintaxis

exit

extend
Extiende el LUN seleccionado actualmente agregando sectores al final del LUN. No
todos los proveedores admiten la extensión de LUN. No extiende ningún volumen ni
sistema de archivos contenido en el LUN. Después de extender el LUN, debe extender
las estructuras asociadas en disco mediante el comando DiskPart extend.

Sintaxis

extend lun [size=<LUN_size>] [drives=<drive_number>, [<drive_number>, ...]]


[noerr]

Parámetros

Parámetro Descripción

tamaño Especifica el tamaño en megabytes para extender el LUN. Se debe especificar el size
o el parámetro <drive> . También se pueden usar juntos. Si no se especifica el
parámetro size=, el LUN se extiende por el tamaño más grande posible permitido
por todas las unidades especificadas. Si se especifica el parámetro size=, los
proveedores seleccionan unidades de la lista especificadas por el parámetro drives=
para crear el LUN. Para especificar el tamaño mediante otras unidades, use uno de
los siguientes sufijos reconocidos inmediatamente después del tamaño:

B: byte
KB: kilobyte
MB: megabyte
GB: gigabyte
TB: terabyte
PB: petabyte.

drives= Especifica el <drive_number> que usarán las unidades al crear un LUN. Se debe
especificar el size o el parámetro <drive> . También se pueden usar juntos. Si no se
especifica el parámetro size=, el LUN creado es el tamaño más grande posible
permitido por todas las unidades especificadas. Los proveedores usan las unidades
en el orden especificado cuando sea posible.

noerr Sólo para scripting. Cuando se detecta un error, Diskraid sigue procesando los
comandos como si no hubiera ningún error.

flushcache
Borra la memoria caché en el controlador seleccionado actualmente.
Sintaxis

flushcache controller

help
Muestra una lista de los comandos Diskraid.

Sintaxis

help

importtarget
Recupera o establece el destino de importación actual del Servicio de instantáneas de
volumen (VSS) que se establece para el subsistema seleccionado actualmente.

Syntax

importtarget subsystem [set target]

Parámetro

Parámetro Descripción

set target Si se especifica, establece el destino seleccionado actualmente en el destino de


importación de VSS para el subsistema seleccionado actualmente. Si no se
especifica, el comando recupera el destino de importación de VSS actual que se
establece para el subsistema seleccionado actualmente.

initiator
Recupera información sobre el iniciador iSCSI local.
Sintaxis

initiator

invalidatecache
Invalida la memoria caché en el controlador seleccionado actualmente.

Sintaxis

invalidatecache controller

lbpolicy
Establece la directiva de equilibrio de carga en el LUN seleccionado actualmente.

Sintaxis

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 Descripción
Parámetro Descripción

type Especifica la directiva de equilibrio de carga. Si no se especifica el tipo, se debe


especificar el parámetro path. El elemento Type puede ser uno de los siguientes:

FAILOVER: usa una ruta de acceso principal con otras rutas de acceso de
copia de seguridad.
ROUNDROBIN: usa todas las rutas de acceso de forma round robin, que
intenta cada ruta secuencialmente.
SUBSETROUNDROBIN: usa todas las rutas de acceso principales de forma
round robin; las rutas de acceso de copia de seguridad solo se usan si se
produce un error en todas las rutas de acceso principales.
DYNLQD: usa la ruta de acceso con el menor número de solicitudes activas.

WEIGHTED: usa la ruta de acceso con el menor peso (cada ruta de acceso
debe tener asignado un peso).
LEASTBLOCKS: usa la ruta de acceso con los bloques mínimos.
VENDORSPECIFIC: usa una directiva específica del proveedor.

path Especifica si una ruta de acceso es principal o tiene un determinado <weight> . Las
rutas de acceso no especificadas se establecen implícitamente como copia de
seguridad. Las rutas de acceso enumeradas deben ser una de las rutas de acceso de
LUN seleccionadas actualmente.

list
Muestra una lista de objetos del tipo especificado.

Sintaxis

list {hbaports | iadapters | iportals | providers | subsystems | controllers


| ports | drives | LUNs | tportals | targets | tpgroups}

Parámetros

Parámetro Descripción

hbaports Muestra información de resumen sobre todos los puertos HBA conocidos para
VDS. El puerto HBA seleccionado actualmente está marcado por un asterisco (*).

iadapters Muestra información de resumen sobre todos los adaptadores de iniciador iSCSI
conocidos por VDS. El adaptador del iniciador seleccionado actualmente está
marcado por un asterisco (*).
Parámetro Descripción

iportals Muestra información de resumen sobre todos los portales del iniciador iSCSI en el
adaptador del iniciador seleccionado actualmente. El portal del iniciador
seleccionado actualmente está marcado por un asterisco (*).

providers Muestra información de resumen sobre cada proveedor conocido por VDS. El
proveedor seleccionado actualmente está marcado por un asterisco (*).

subsistemas Muestra información de resumen sobre cada subsistema del sistema. El subsistema
seleccionado actualmente está marcado por un asterisco (*).

controllers Muestra información de resumen sobre cada controlador del subsistema


seleccionado actualmente. El controlador seleccionado actualmente está marcado
por un asterisco (*).

ports Muestra información de resumen sobre cada puerto de controlador en el


controlador seleccionado actualmente. El puerto seleccionado actualmente está
marcado por un asterisco (*).

unidades Muestra información de resumen sobre cada unidad del subsistema seleccionado
actualmente. La unidad seleccionada actualmente está marcada por un asterisco
(*).

luns Muestra información de resumen sobre cada LUN en el subsistema seleccionado


actualmente. El LUN seleccionado actualmente está marcado por un asterisco (*).

tportals Muestra información de resumen sobre todos los portales de destino iSCSI del
subsistema seleccionado actualmente. El portal de destino seleccionado
actualmente está marcado por un asterisco (*).

destinos Muestra información de resumen sobre todos los destinos iSCSI del subsistema
seleccionado actualmente. El destino seleccionado actualmente está marcado por
un asterisco (*).

tpgroups Muestra información de resumen sobre todos los grupos del portal de destino
iSCSI en el destino seleccionado actualmente. El grupo del portal seleccionado
actualmente está marcado por un asterisco (*).

login
Registra el adaptador del iniciador iSCSI especificado en el destino iSCSI seleccionado
actualmente.

Sintaxis
login target iadapter=<iadapter> [type={manual | persistent | boot}] [chap=
{none | oneway | mutual}] [iportal=<iportal>] [tportal=<tportal>] [<flag>
[<flag> […]]]

Parámetros

Parámetro Descripción

type Especifica el tipo de inicio de sesión que se va a realizar: manual o persistent. Si no


se especifica, se realizará un inicio de sesión manual.

manual Inicie sesión manualmente. También hay una opción boot que está pensada para el
desarrollo futuro y no se usa actualmente.

persistent Use automáticamente el mismo inicio de sesión cuando se reinicie el equipo.

chap Especifica el tipo de autenticación CHAP que se va a usar: none, oneway CHAP o
mutual CHAP; si no se especifica, no se usará ninguna autenticación.

tportal Especifica un portal de destino opcional en el subsistema seleccionado actualmente


que se va a usar para el inicio de sesión.

iportal Especifica un portal de iniciador opcional en el adaptador del iniciador especificado


que se va a usar para el inicio de sesión.

<flag> Identificado por acrónimos de tres letras:


IPS: Requerir IPsec
EMP: Habilitar varias rutas
EHD: Habilitar resumen de encabezado
EDD: Habilitar resumen de datos

logout
Registra el adaptador del iniciador iSCSI especificado fuera del destino iSCSI
seleccionado actualmente.

Sintaxis

logout target iadapter= <iadapter>

Parámetros
Parámetro Descripción

iadapter Especifica el adaptador del iniciador con una sesión de inicio de sesión desde la que
cerrar sesión.

mantenimiento
Realiza operaciones de mantenimiento en el objeto seleccionado actualmente del tipo
especificado.

Sintaxis

maintenance <object operation> [count=<iteration>]

Parámetros

Parámetro Descripción

<object> Especifica el tipo de objeto en el que se va a realizar la operación. El tipo object


puede ser un subsystem, controller, port, drive o LUN.

<operation> Especifica la operación de mantenimiento que se va a realizar. El tipo operation


puede ser spinup, spindown, blink, beep o ping. Se debe especificar una
operation.

count= Especifica el número de veces que se repite la operación. Se usa normalmente con
blink, beep o ping.

name
Establece el nombre descriptivo del subsistema, LUN o destino iSCSI actualmente
seleccionado en el nombre especificado.

Syntax

name {subsystem | lun | target} [<name>]


Parámetro

Parámetro Descripción

<name> Especifica un nombre para el subsistema, LUN o destino. El nombre debe tener
menos de 64 caracteres de longitud. Si no se proporciona ningún nombre, se
elimina el nombre existente, si existe.

sin conexión
Establece el estado del objeto seleccionado actualmente del tipo especificado en
offline.

Syntax

offline <object>

Parámetro

Parámetro Descripción

<object> Especifica el tipo de objeto en el que se va a realizar esta operación. El tipo puede
ser: subsystem, controller, drive, LUN o tportal.

online (en línea)


Establece el estado del objeto seleccionado del tipo especificado en línea. Si el objeto
es hbaport, cambia el estado de las rutas de acceso al puerto HBA seleccionado
actualmente en online.

Syntax

online <object>

Parámetro
Parámetro Descripción

<object> Especifica el tipo de objeto en el que se va a realizar esta operación. El tipo puede
ser: hbaport, subsystem, controller, drive, LUN o tportal.

recover
Realiza las operaciones necesarias, como la resincronización o la moderación activa,
para reparar el LUN tolerante a errores seleccionado actualmente. Por ejemplo,
RECOVER puede hacer que una reserva activa esté enlazada a un conjunto RAID que
tenga un disco con errores u otra reasignación de extensión de disco.

Sintaxis

recover <lun>

reenumerate
Vuelve a enumerar los objetos del tipo especificado. Si usa el comando extend LUN,
debe usar el comando refresh para actualizar el tamaño del disco antes de usar el
comando reenumerate.

Sintaxis

reenumerate {subsystems | drives}

Parámetros

Parámetro Descripción

subsistemas Consulta al proveedor para detectar los nuevos subsistemas que se agregaron en
el proveedor seleccionado actualmente.

unidades Consulta los buses de E/S internos para detectar las nuevas unidades que se
agregaron en el subsistema seleccionado actualmente.
actualizar
Actualiza los datos internos del proveedor seleccionado actualmente.

Sintaxis

refresh provider

rem
Se usa para comentar scripts.

Sintaxis

Rem <comment>

remove
Quita el portal de destino iSCSI especificado del grupo de portales de destino
seleccionado actualmente.

Syntax

remove tpgroup tportal=<tportal> [noerr]

Parámetro

Parámetro Descripción

tpgroup tportal= Especifica el portal de destino iSCSI que se va a quitar.


<tportal>

noerr Sólo para scripting. Cuando se detecta un error, Diskraid sigue procesando
los comandos como si no hubiera ningún error.
replace
Reemplaza la unidad especificada por la unidad seleccionada actualmente. Es posible
que la unidad especificada no sea la unidad seleccionada actualmente.

Syntax

replace drive=<drive_number>

Parámetro

Parámetro Descripción

drive= Especifica el <drive_number> para que reemplace la unidad.

reset
Restablece el controlador o puerto seleccionado actualmente.

Sintaxis

reset {controller | port}

Parámetros

Parámetro Descripción

controlador Restablece el controlador.

port Restablece el puerto.

select
Muestra o cambia el objeto seleccionado actualmente.

Sintaxis
select {hbaport | iadapter | iportal | provider | subsystem | controller |
port | drive | lun | tportal | target | tpgroup } [<n>]

Parámetros

Parámetro Descripción

object Especifica el tipo de objeto que se va a seleccionar, incluido: provider, subsystem,


controller, drive o LUN.

hbaport Establece el foco en el puerto HBA local especificado. Si no se especifica ningún


[<n>] puerto HBA, el comando muestra el puerto HBA seleccionado actualmente (si
existe). Si se especifica un índice de puerto HBA no válido, no se pone ningún
puerto HBA en el foco. Al seleccionar un puerto HBA, se anula la selección de los
adaptadores de iniciador y los portales del iniciador seleccionados.

iadapter Establece el foco en el adaptador del iniciador iSCSI local especificado. Si no se


[<n>] especifica ningún adaptador de iniciador, el comando muestra el adaptador del
iniciador seleccionado (si existe). Si se especifica un índice de adaptador de iniciador
no válido, no se produce ningún adaptador de iniciador en foco. Al seleccionar un
adaptador de iniciador, se anula la selección de los puertos HBA y los portales del
iniciador seleccionados.

iportal Establece el foco en el portal del iniciador iSCSI local especificado dentro del
[<n>] adaptador del iniciador iSCSI seleccionado. Si no se especifica ningún portal del
iniciador, el comando muestra el portal del iniciador seleccionado actualmente (si
existe). Especificar un índice del portal del iniciador no válido no da como resultado
ningún portal de iniciador seleccionado.

provider Establece el foco del proveedor especificado. Si no se especifica ningún proveedor,


[<n>] el comando muestra el proveedor seleccionado actualmente (si existe). Si se
especifica un índice de proveedor no válido, no se pone el foco en ningún
proveedor.

subsystem Establece el foco del subsistema especificado. Si no se especifica ningún subsistema,


[<n>] el comando muestra el subsistema con foco (si existe). Si se especifica un índice de
subsistema no válido, no se pone el foco en ningún subsistema. Al seleccionar un
subsistema, se selecciona implícitamente su proveedor asociado.

controller Establece el foco en el controlador especificado dentro del subsistema seleccionado


[<n>] actualmente. Si no se especifica ningún controlador, el comando muestra el
controlador seleccionado actualmente (si existe). Si se especifica un índice de
controlador no válido, no se pone el foco en ningún controlador. Al seleccionar un
controlador, se anula la selección de los puertos de controlador seleccionados, las
unidades, los LUN, los portales de destino, los destinos y los grupos del portal de
destino.
Parámetro Descripción

port [<n>] Establece el foco en el puerto del controlador especificado dentro del controlador
seleccionado actualmente. Si no se especifica ningún puerto, el comando muestra el
puerto seleccionado actualmente (si existe). Si se especifica un índice de puerto no
válido, no se selecciona ningún puerto.

drive Establece el foco en la unidad especificada, o el eje físico, dentro del subsistema
[<n>] seleccionado actualmente. Si no se especifica ninguna unidad, el comando muestra
la unidad seleccionada actualmente (si existe). Especificar un índice de unidad no
válido conlleva que no se ponga el foco en ninguna unidad. Al seleccionar una
unidad, se anula la selección de los controladores seleccionados, los puertos de
controlador, los LUN, los portales de destino, los destinos y los grupos del portal de
destino.

lun [<n>] Establece el foco en el LUN especificado dentro del subsistema seleccionado
actualmente. Si no se especifica ningún LUN, el comando muestra el LUN
seleccionado actualmente (si existe). Si no se especifica un índice LUN válido, no se
selecciona ningún LUN. Al seleccionar un LUN, se anula la selección de los
controladores seleccionados, los puertos del controlador, las unidades, los portales
de destino, los destinos y los grupos del portal de destino.

tportal Establece el foco en el portal de destino iSCSI especificado dentro del subsistema
[<n>] seleccionado actualmente. Si no se especifica ningún portal de destino, el comando
muestra el portal de destino seleccionado actualmente (si existe). Si no se especifica
un índice de portal de destino válido, no se selecciona ningún portal de destino. Al
seleccionar un portal de destino, se anula la selección de los controladores, los
puertos del controlador, las unidades, los LUN, los destinos y los grupos del portal
de destino.

target Establece el foco en el destino iSCSI especificado dentro del subsistema


[<n>] seleccionado actualmente. Si no se especifica ningún destino, el comando muestra
el destino seleccionado actualmente (si existe). Si se especifica un índice de destino
no válido, no se selecciona ningún destino. Al seleccionar un destino, se anula la
selección de los controladores, los puertos del controlador, las unidades, los LUN,
los portales de destino y los grupos del portal de destino.

tpgroup Establece el foco en el grupo de portal de destino iSCSI especificado dentro del
[<n>] destino iSCSI seleccionado actualmente. Si no se especifica ningún grupo de portal
de destino, el comando muestra el grupo de portal de destino seleccionado
actualmente (si existe). Especificar un índice de grupo de portal de destino no válido
supone que no ponga el foco en el grupo de portal.

[<n>] Especifica el objeto <object number> que se va a seleccionar. Si el <object number>


especificado no es válido, se borran las selecciones existentes para los objetos del
tipo especificado. Si no se especifica ningún <object number> , se muestra el objeto
actual.

setflag
Establece la unidad seleccionada actualmente como reserva activa. Las reservas activas
no se pueden usar para las operaciones de enlace de LUN normales. Están reservadas
solo para el control de errores. La unidad no debe estar enlazada actualmente a ningún
LUN existente.

Sintaxis

setflag drive hotspare={true | false}

Parámetros

Parámetro Descripción

true Selecciona la unidad seleccionada actualmente como reserva activa.

false Anula la selección de la unidad seleccionada actualmente como reserva activa.

shrink
Reduce el tamaño del LUN seleccionado.

Sintaxis

shrink lun size=<n> [noerr]

Parámetros

Parámetro Descripción
Parámetro Descripción

tamaño Especifica el espacio en megabytes (MB) que se desea reducir en el volumen. Para
especificar el tamaño mediante otras unidades, use uno de los siguientes sufijos
reconocidos inmediatamente después del tamaño:
B: byte
KB: kilobyte
MB: megabyte
GB: gigabyte
TB: terabyte
PB: petabyte.

noerr Sólo para scripting. Cuando se detecta un error, Diskraid sigue procesando los
comandos como si no hubiera ningún error.

espera
Cambia el estado de las rutas de acceso al puerto del adaptador de bus host (HBA)
seleccionado actualmente a STANDBY.

Sintaxis

standby hbaport

Parámetros

Parámetro Descripción

hbaport Cambia el estado de las rutas de acceso al puerto del adaptador de bus host (HBA)
seleccionado actualmente a STANDBY.

unmask
Hace que los LUN seleccionados actualmente estén accesibles desde los hosts
especificados.

Sintaxis
unmask lun {all | none | [add] wwn=<hexadecimal_number> [;
<hexadecimal_number> [;…]] | [add] initiator=<initiator>[;<initiator>[;…]]}
[uninstall]

Parámetros

Parámetro Descripción

all Especifica que el LUN debe ser accesible desde todos los hosts. Sin embargo, no se
puede desenmascarar el LUN en todos los destinos de un subsistema iSCSI.
Debe cerrar sesión en el destino antes de ejecutar el comando unmask lun all .

ninguno Especifica que el LUN no debe ser accesible para ningún host.
Debe cerrar sesión en el destino antes de ejecutar el comando unmask lun none .

add Especifica que los hosts especificados deben agregarse a la lista existente de hosts
desde los que se puede acceder a este LUN. Si no se especifica este parámetro, la
lista de hosts suministrados reemplaza la lista existente de hosts desde los que se
puede acceder a este LUN.

wwn= Especifica una lista de números hexadecimales que representan nombres de todo el
mundo a partir de los cuales se debe hacer accesible el LUN o los hosts. Para
enmascarar o desenmascarar a un conjunto específico de hosts en un subsistema de
canal de fibra, puede escribir una lista separada por punto y coma de WWN para los
puertos de las máquinas host de interés.

initiator= Especifica una lista de iniciadores iSCSI a los que se debe hacer accesible el LUN
seleccionado actualmente. Para enmascarar o desenmascarar a un conjunto
específico de hosts en un subsistema iSCSI, puede escribir una lista separada por
punto y coma de nombres de iniciadores iSCSI para los iniciadores en los equipos
host de interés.

uninstall Si se especifica, desinstala el disco asociado al LUN en el sistema local antes de


enmascarar el LUN.

Scripting Diskraid
Se puede crear un script para Diskraid en cualquier equipo que ejecute una versión
compatible de Windows Server, con un proveedor de hardware de VDS asociado. Para
invocar un script Diskraid, escriba en el símbolo del sistema:

diskraid /s <script.txt>
De forma predeterminada, Diskraid detiene el procesamiento de comandos y devuelve
un código de error si hay un problema en el script. Para seguir ejecutando el script y
omitir los errores, incluya el parámetro noerr en el comando. Esto permite prácticas
útiles como el uso de un único script para eliminar todos los LUN de un subsistema,
independientemente del número total de LUN. No todos los comandos admiten el
parámetro noerr. Los errores siempre se devuelven en los errores de sintaxis de
comandos, independientemente de si incluyó el parámetro noerr.

Códigos de error diskraid


Código Descripción del error
de
error

0 No se ha producido ningún error. El script completo se ejecutó sin errores.

1 Excepción grave.

2 Los argumentos especificados en una línea de comandos Diskraid eran incorrectos.

3 DiskPart no ha podido abrir el script o el archivo de salida especificados.

4 Uno de los servicios que utiliza Diskraid ha devuelto un error.

5 Error de sintaxis de comando. El script produjo un error porque un objeto se


seleccionó incorrectamente o no era válido para su uso con dicho comando.

Ejemplo
Para ver el estado del subsistema 0 en el equipo, escriba:

diskraid

Pulse ENTRAR y se mostrará una salida similar a la siguiente:

Microsoft Diskraid version 5.2.xxxx


Copyright (©) 2003 Microsoft Corporation
On computer: COMPUTER_NAME

Para seleccionar el subsistema 0, escriba lo siguiente en el símbolo del sistema Diskraid:


select subsystem 0

Pulse ENTRAR y se mostrará una salida similar a la siguiente:

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 salir de Diskraid, escriba lo siguiente en el símbolo del sistema de Diskraid:

exit

Vínculos relacionados
Clave de sintaxis de línea de comandos
Diskshadow
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Diskshadow.exe es una herramienta que expone la funcionalidad que el Servicio de


instantáneas de volumen (VSS) proporciona. Diskshadow usa de forma predeterminada
un intérprete de comandos interactivo parecido al de Diskraid o Diskpart. Diskshadow
también incluye un modo que permite ejecutar scripts.

7 Nota

La pertenencia al grupo Administradores local, o equivalente, es el mínimo


requerido para usar Diskshadow.

Sintaxis
Para el modo interactivo, escriba lo siguiente en el símbolo del sistema para iniciar el
intérprete de comandos Diskshadow:

diskshadow

Para el modo de script, escriba lo siguiente, donde script.txt es un archivo de script que
contiene comandos Diskshadow:

diskshadow -s script.txt

Parámetros
Puede ejecutar los comandos siguientes en el intérprete de comandos Diskshadow o a
través de un archivo de script. Como mínimo, solo se necesitan agregar y crear para
crear una instantánea. Sin embargo, esto pierde la configuración de contexto y
opciones, será una copia de seguridad de copia y crea una instantánea sin script de
ejecución de copia de seguridad.
Comando Descripción

Comando Establece el contexto, las opciones, el modo detallado y el archivo de metadatos


set para la creación de instantáneas.

Comando Carga un archivo de metadatos .cab antes de importar una instantánea


load transportable o carga los metadatos del escritor en el caso de una restauración.
metadata

Comando Comprueba que se incluye un escritor o componente o excluye un escritor o


writer componente del procedimiento de copia de seguridad o restauración.

Comando Agrega volúmenes al conjunto de volúmenes que se van a copiar o agrega alias al
add entorno de alias.

Comando Inicia el proceso de creación de instantáneas mediante el contexto actual y la


create configuración de opciones.

Comando Ejecuta un archivo del equipo local.


exec

comando Inicia una sesión de copia de seguridad completa.


begin
backup

Comando Finaliza una sesión de copia de seguridad completa y emite un evento


end backup backupcomplete con el estado de escritor adecuado, si es necesario.

Comando Empieza una sesión de restauración y emite un evento prerestore a los escritores
begin implicados.
restore

Comando Finaliza una sesión de restauración y emite un evento postrestore a los escritores
end restore implicados.

Comando Restablece Diskshadow al estado predeterminado.


reset

Comando Enumera escritores, instantáneas o proveedores de instantáneas registrados


list actualmente que están en el sistema.

Comando Elimina instantáneas.


delete
shadows

Comando Importa una instantánea transportable desde un archivo de metadatos cargado en


import el sistema.

Comando Quita las instantáneas de hardware que se importaron mediante el comando


mask import.
Comando Descripción

Comando Expone una instantánea persistente como una letra de unidad, un recurso
expose compartido o un punto de montaje.

Comando Anula la exposición de una instantánea expuesta mediante el comando expose.


unexpose

Comando Desasocia un volumen de instantáneas de VSS.


break

Comando Revierte un volumen a una instantánea especificada.


revert

Comando Sale del intérprete o script del comando.


exit

Ejemplos
Se trata de una secuencia de comandos de ejemplo que creará una instantánea para la
copia de seguridad. Se puede guardar en el archivo como script.dsh y ejecutarse
mediante diskshadow /s script.dsh .

Supongamos lo siguiente:

Tiene un directorio existente denominado c:\diskshadowdata.

El volumen del sistema es C: y el volumen de datos es D:.

Tiene un archivo backupscript.cmd en c:\diskshadowdata.

El archivo backupscript.cmd realizará la copia de datos de instantánea p: y q: en la


unidad de copia de seguridad.

Puede escribir estos comandos manualmente o incluirlos en scripts:

#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

Vínculos relacionados
Clave de sintaxis de línea de comandos
dispdiag
Artículo • 12/04/2023

Los registros muestran información en un archivo.

Sintaxis

dispdiag [-testacpi] [-d] [-delay <seconds>] [-out <filepath>]

Parámetros

Parámetro Descripción

- testacpi Ejecuta la prueba de diagnóstico de teclas de acceso rápido. Muestra el nombre de


la clave, el código y el código de digitalización de cualquier tecla que se presiona
durante la prueba.

-d Genera un archivo de volcado con resultados de prueba.

-delay Retrasa la recopilación de datos por el tiempo especificado en segundos.


<seconds>

-out Especifica la ruta de acceso y el nombre de archivo donde guardar los datos
<filepath> recopilados. Debe ser el último parámetro.

-? Muestra los parámetros de comando disponibles y proporciona ayuda para su uso.

Vínculos relacionados
Clave de sintaxis de línea de comandos
Dnscmd
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Interfaz de línea de comandos para administrar servidores DNS. Esta utilidad resulta útil
en archivos por lotes de scripting para ayudar en la automatización de las tareas de
administración de DNS rutinarias o para realizar una instalación desatendida sencilla y
configurar nuevos servidores DNS en la red.

Sintaxis

dnscmd <servername> <command> [<command parameters>]

Parámetros

Parámetro Descripción

<servername> Dirección IP o nombre de host de un servidor DNS remoto o local.

Comando dnscmd /ageallrecords


Establece la hora actual en una marca de tiempo en los registros de recursos de una
zona o nodo especificados en un servidor DNS.

Sintaxis

dnscmd [<servername>] /ageallrecords <zonename>[<nodename>] | [/tree]|[/f]

Parámetros

Parámetro Descripción
Parámetro Descripción

<servername> Especifica el servidor DNS que el administrador planea administrar, representado


por la dirección IP, el nombre de dominio completo (FQDN) o el nombre de host.
Si se omite este parámetro, se utiliza el servidor local.

<zonename> Especifica el FQDN de la zona.

<nodename> Especifica un nodo o subárbol específico de la zona, con lo siguiente:


@ para la zona o el FQDN raíz
FQDN de un nodo (el nombre con un punto (.) al final)
Una sola etiqueta para el nombre en relación con la raíz de la zona.

/tree Especifica que todos los nodos secundarios también reciben la marca de tiempo.

/f Ejecuta el comando sin pedir confirmación.

Comentarios

El comando ageallrecords está por compatibilidad con versiones anteriores entre


la versión actual de DNS y las versiones anteriores de DNS en las que no se
admitían el establecimiento de antigüedad y la limpieza. Agrega una marca de
tiempo con la hora actual a los registros de recursos que no tienen una marca de
tiempo y establece la hora actual en los registros de recursos que tienen una
marca de tiempo.

La limpieza de registros no se produce a menos que los registros tengan una


marca de tiempo. Los registros de recursos del servidor de nombres (NS), los
registros de recursos de inicio de autoridad (SOA) y los registros de recursos del
Servicio de nombres de Internet de Windows (WINS) no se incluyen en el proceso
de limpieza y no reciben una marca de tiempo incluso cuando se ejecuta el
comando ageallrecords.

Este comando produce un error a menos que esté habilitada la limpieza para el
servidor DNS y la zona. Para obtener información sobre cómo habilitar la limpieza
en la zona, consulte el parámetro aging en la sintaxis del comando dnscmd /config
de este artículo.

La adición de una marca de tiempo a los registros de recursos DNS hace que sean
incompatibles con los servidores DNS que se ejecutan en sistemas operativos
distintos de Windows Server. No se puede revertir una marca de tiempo agregada
mediante el comando ageallrecords.
Si no se especifica ninguno de los parámetros opcionales, el comando devuelve
todos los registros de recursos del nodo especificado. Si se especifica un valor para
al menos uno de los parámetros opcionales, dnscmd enumera solo los registros de
recursos que corresponden al valor o los valores especificados en el parámetro o
parámetros opcionales.

Ejemplos
Ejemplo 1: establecer la hora actual en una marca de tiempo en los registros de recursos

Comando dnscmd /clearcache


Borra la memoria caché de DNS de los registros de recursos del servidor DNS
especificado.

Sintaxis

dnscmd [<servername>] /clearcache

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

Ejemplo

dnscmd dnssvr1.contoso.com /clearcache

Comando dnscmd /config


Cambia los valores del Registro del servidor DNS y las zonas individuales. Este comando
también modifica la configuración del servidor especificado. Acepta la configuración de
nivel de servidor y de nivel de zona.

U Precaución

No edite el registro directamente a menos que no tenga otra alternativa. El editor


del Registro omite las protecciones estándar, permitiendo valores que pueden
degradar el rendimiento, dañar el sistema o incluso obligarle a reinstalar Windows.
Puede modificar con seguridad la mayor parte de la configuración del Registro
mediante los programas del Panel de control o Microsoft Management Console
(MMC). Si debe editar el Registro directamente, haga una copia de seguridad
primero. Lea la ayuda del editor del Registro para obtener más información.

Sintaxis de nivel de servidor

dnscmd [<servername>] /config <parameter>

Parámetros

7 Nota

Este artículo contiene referencias al término esclavo, un término que Microsoft ya


no usa. Cuando se quite el término del software, se quitará también del artículo.

Parámetros Descripción

<servername> Especifica el servidor DNS que tiene previsto administrar,


representado por la sintaxis del equipo local, la dirección IP, el
FQDN o el nombre de host. Si se omite este parámetro, se
utiliza el servidor local.

<parameter> Especifique una configuración y, como opción, un valor. Los


valores de los parámetros usan esta sintaxis: parámetro [valor].

/addressanswerlimit [0|5-28] Especifica el número máximo de registros de host que puede


enviar un servidor DNS en respuesta a una consulta. El valor
puede ser cero (0) o puede estar en el intervalo de 5 a
28 registros. El valor predeterminado es cero (0).
Parámetros Descripción

/bindsecondaries [0|1] Cambia el formato de la transferencia de zona para que se


pueda lograr la máxima compresión y eficiencia. Acepta los
siguientes valores:
0: usa la compresión máxima y solo es compatible con
las versiones 4.9.4 y posteriores de BIND
1: envía solo un registro de recursos por mensaje a los
servidores DNS que no son de Microsoft y es
compatible con las versiones de BIND anteriores a la
versión 4.9.4. Esta es la configuración predeterminada.

/bootmethod [0|1|2|3] Determina el origen desde el que el servidor DNS obtiene su


información de configuración. Acepta los siguientes valores:
0: borra el origen de la información de configuración.
1: carga desde el archivo BIND que se encuentra en el
directorio de DNS, que es %systemroot%\System32\DNS de
manera predeterminada.
2: carga desde el Registro.
3: carga desde AD DS y el Registro. Esta es la
configuración predeterminada.

/defaultagingstate [0|1] Determina si la característica de limpieza de DNS está


habilitada de manera predeterminada en las zonas recién
creadas. Acepta los siguientes valores:
0: deshabilita la limpieza. Esta es la configuración
predeterminada.
1: habilita la limpieza.

/defaultnorefreshinterval [0x1- Establece un período de tiempo en el que no se aceptan


0xFFFFFFFF|0xA8] actualizaciones para los registros actualizados dinámicamente.
Las zonas del servidor heredan este valor automáticamente.
Para cambiar el valor predeterminado, escriba un valor del
intervalo 0x1-0xFFFFFFFF. El valor predeterminado del servidor
es 0xA8.

/defaultrefreshinterval [0x1- Establece el período de tiempo que se permite para las


0xFFFFFFFF|0xA8] actualizaciones dinámicas en los registros de DNS. Las zonas
del servidor heredan este valor automáticamente.
Para cambiar el valor predeterminado, escriba un valor del
intervalo 0x1-0xFFFFFFFF. El valor predeterminado del servidor
es 0xA8.
Parámetros Descripción

/disableautoreversezones [0|1] Habilita o deshabilita la creación automática de zonas de


búsqueda inversa. Las zonas de búsqueda inversa
proporcionan resolución de direcciones de Protocolo de
Internet (IP) a nombres de dominio de DNS. Acepta los
siguientes valores:
0: habilita la creación automática de zonas de búsqueda
inversa. Esta es la configuración predeterminada.
1: deshabilita la creación automática de zonas de
búsqueda inversa.

/disablensrecordsautocreation Especifica si el servidor DNS crea automáticamente registros


[0|1] de recursos del servidor de nombres (NS) para las zonas que
hospeda. Acepta los siguientes valores:
0: crea automáticamente registros de recursos del
servidor de nombres (NS) para las zonas que hospeda el
servidor DNS.
1: no crea automáticamente registros de recursos del
servidor de nombres (NS) para las zonas que hospeda el
servidor DNS.

/dspollinginterval [0-30] Especifica la frecuencia con la que el servidor DNS sondea


AD DS en busca de cambios en las zonas integradas de Active
Directory.

/dstombstoneinterval [1-30] Cantidad de tiempo en segundos que se van a conservar los


registros eliminados en AD DS.

/ednscachetimeout [3600- Especifica el número de segundos que se almacena en caché


15724800] la información de DNS extendido (EDNS). El valor mínimo es
3600 y el valor máximo es 15 724 800. El valor predeterminado
es 604 800 segundos (una semana).

/enableednsprobes [0|1] Habilita o deshabilita si el servidor va a sondear otros


servidores para determinar si admiten EDNS. Acepta los
siguientes valores:
0: deshabilita la compatibilidad activa con sondeos de
EDNS.
1: habilita la compatibilidad activa con sondeos de
EDNS.

/enablednssec [0|1] Habilita o deshabilita la compatibilidad con las extensiones de


seguridad de DNS (DNSSEC). Acepta los siguientes valores:
0: deshabilita DNSSEC.
1: habilita DNSSEC.
Parámetros Descripción

/enableglobalnamessupport Habilita o deshabilita la compatibilidad con la zona


[0|1] GlobalNames. La zona GlobalNames admite la resolución de
nombres DNS de etiqueta única en un bosque. Acepta los
siguientes valores:
0: deshabilita la compatibilidad con la zona
GlobalNames. Al establecer el valor de este comando en
0, el servicio del servidor DNS no resuelve los nombres
de etiqueta única en la zona GlobalNames.
1: habilita la compatibilidad con la zona GlobalNames. Al
establecer el valor de este comando en 1, el servicio del
servidor DNS resuelve los nombres de etiqueta única en
la zona GlobalNames.

/enableglobalqueryblocklist Habilita o deshabilita la compatibilidad con la lista global de


[0|1] bloqueos de consulta que bloquea la resolución de nombres
para los nombres de la lista. El servicio del servidor DNS crea y
habilita la lista global de bloqueos de consulta de manera
predeterminada cuando el servicio se inicia por primera vez.
Para ver la lista global de bloqueos de consulta actual, use el
comando dnscmd /info /globalqueryblocklist. Acepta los
siguientes valores:

0: deshabilita la compatibilidad con la lista global de


bloqueos de consulta. Al establecer el valor de este
comando en 0, el servicio del servidor DNS responde a
las consultas de nombres de la lista de bloqueos.
1: habilita la compatibilidad con la lista global de
bloqueos de consulta. Al establecer el valor de este
comando en 1, el servicio del servidor DNS no responde
a las consultas de nombres de la lista de bloqueos.

/eventloglevel [0|1|2|4] Determina qué eventos se registran en el registro del servidor


DNS en el Visor de eventos. Acepta los siguientes valores:
0: no registra ningún evento.
1: registra solo los errores.
2: registra solo los errores y las advertencias.
4: registra los errores, las advertencias y los eventos
informativos. Esta es la configuración predeterminada.
Parámetros Descripción

/forwarddelegations [0|1] Determina cómo controla el servidor DNS una consulta para
una subzona delegada. Estas consultas se pueden enviar a la
subzona a la que se hace referencia en la consulta o a la lista
de reenviadores nombrados del servidor DNS. Las entradas de
la configuración solo se usan cuando se habilita el reenvío.
Acepta los siguientes valores:
0: envía automáticamente las consultas que hacen
referencia a las subzonas delegadas a la subzona
adecuada. Esta es la configuración predeterminada.
1: reenvía las consultas que hacen referencia a la
subzona delegada a los reenviadores existentes.

/forwardingtimeout [<seconds>] Determina cuántos segundos (0x1-0xFFFFFFFF) espera un


servidor DNS a que responda un reenviador antes de intentar
otro reenviador. El valor predeterminado es 0x5, que son
5 segundos.

/globalneamesqueryorder [0|1] Especifica si el servicio del servidor DNS busca primero en la


zona GlobalNames o en las zonas locales cuando resuelve los
nombres. Acepta los siguientes valores:
0: el servicio del servidor DNS intenta resolver los
nombres consultando la zona GlobalNames antes de
consultar las zonas para las que es autoritativo.
1: el servicio del servidor DNS intenta resolver los
nombres consultando las zonas para las que es
autoritativo antes de consultar la zona GlobalNames.

/globalqueryblocklist [[<name> Reemplaza la lista global de bloqueos de consulta actual por


[<name>]...] una lista de los nombres que especifique. Si no especifica
ningún nombre, este comando borra la lista de bloqueos. De
manera predeterminada, la lista global de bloqueos de
consulta contiene los siguientes elementos:
isatap
wpad

El servicio del servidor DNS puede quitar uno o ambos


nombres cuando se inicia la primera vez si encuentra estos
nombres en una zona existente.
Parámetros Descripción

/isslave [0|1] Determina cómo responde el servidor DNS cuando las


consultas que reenvía no reciben respuesta. Acepta los
siguientes valores:
0: especifica que el servidor DNS no es un subordinado.
Si el reenviador no responde, el servidor DNS intenta
resolver la consulta él mismo. Esta es la configuración
predeterminada.
1: especifica que el servidor DNS es un subordinado. Si
el reenviador no responde, el servidor DNS finaliza la
búsqueda y envía un mensaje de error al solucionador.

/localnetpriority [0|1] Determina el orden en el que se devuelven los registros de


host cuando el servidor DNS tiene varios registros de host
para el mismo nombre. Acepta los siguientes valores:
0: devuelve los registros en el orden en que se
enumeran en la base de datos de DNS.
1: devuelve primero los registros que tienen direcciones
de red IP similares. Esta es la configuración
predeterminada.

/logfilemaxsize [<size>] Especifica el tamaño máximo en bytes (0x10000-0xFFFFFFFF)


del archivo Dns.log. Cuando el archivo alcanza su tamaño
máximo, DNS sobrescribe los eventos más antiguos. El tamaño
predeterminado es 0x400000, que son 4 megabytes (MB).

/logfilepath Especifica la ruta de acceso del archivo Dns.log. La ruta de


[<path+logfilename>] acceso predeterminada es
%systemroot%\System32\Dns\Dns.log . Puede especificar otra
ruta de acceso mediante el formato path+logfilename .

/logipfilterlist <IPaddress> [, Especifica qué paquetes se registran en el archivo de registro


<IPaddress>...] de depuración. Las entradas son una lista de direcciones IP.
Solo se registran los paquetes que van hacia y desde las
direcciones IP de la lista.
Parámetros Descripción

/loglevel [<eventtype>] Determina qué tipos de eventos se registran en el archivo


Dns.log. Cada tipo de evento se representa mediante un
número hexadecimal. Si desea más de un evento en el
registro, use la adición hexadecimal para sumar los valores y, a
continuación, escriba la suma. Acepta los siguientes valores:
0x0: el servidor DNS no crea un registro. Esta es la
entrada predeterminada.
0x10: registra las consultas y notificaciones.
0x20: registra las actualizaciones.
0xFE: registra las transacciones que no son de consulta.
0x100: registra las transacciones de preguntas.
0x200: registra las respuestas.
0x1000: registra los paquetes enviados.
0x2000: registra los paquetes recibidos.
0x4000: registra los paquetes del Protocolo de
datagramas de usuario (UDP).
0x8000: registra los paquetes del Protocolo de control
de transmisión (TCP).
0xFFFF: registra todos los paquetes.
0x10000: registra las transacciones de escritura de Active
Directory.
0x20000: registra las transacciones de actualización de
Active Directory.
0x1000000: registra paquetes completos.
0x80000000: registra las transacciones de escritura
diferida.

/maxcachesize Especifica el tamaño máximo, en kilobytes (KB), de la memoria


caché del servidor DNS.

/maxcachettl [<seconds>] Determina cuántos segundos (0x0-0xFFFFFFFF) se guarda un


registro en la memoria caché. Si se usa el valor 0x0, el servidor
DNS no almacena en caché los registros. El valor
predeterminado es 0x15180 (86 400 segundos o 1 día).

/maxnegativecachettl Especifica cuántos segundos (0x1-0xFFFFFFFF) permanece


[<seconds>] almacenada en la memoria caché de DNS una entrada que
registra una respuesta negativa a una consulta. El valor
predeterminado es 0x384 (900 segundos).
Parámetros Descripción

/namecheckflag [0|1|2|3] Especifica qué caracteres estándar se usan al comprobar los


nombres DNS. Acepta los siguientes valores:
0: usa caracteres ANSI que cumplen con la solicitud de
comentarios (RFC) del Grupo de tareas de ingeniería de
Internet (IETF).
1: usa caracteres ANSI que no cumplen necesariamente
con las RFC de IETF.
2: usa el formato de transformación UCS multibyte 8
(UTF-8). Esta es la configuración predeterminada.
3: usa todos los caracteres.

/norecursion [0|1] Determina si un servidor DNS realiza la resolución de nombres


recursiva. Acepta los siguientes valores:
0: el servidor DNS realiza la resolución de nombres
recursiva si se solicita en una consulta. Esta es la
configuración predeterminada.
1: el servidor DNS no realiza la resolución de nombres
recursiva.

/notcp Este parámetro está obsoleto y no tiene ningún efecto en las


versiones actuales de Windows Server.

/recursionretry [<seconds>] Determina el número de segundos (0x1-0xFFFFFFFF) que


espera un servidor DNS antes de volver a intentar ponerse en
contacto con un servidor remoto. El valor predeterminado es
0x3 (tres segundos). Este valor se debe aumentar cuando la
recursividad se produce mediante un vínculo de red de área
extensa (WAN) lento.

/recursiontimeout [<seconds>] Determina el número de segundos (0x1-0xFFFFFFFF) que


espera un servidor DNS antes de interrumpir los intentos de
ponerse en contacto con un servidor remoto. Los valores
varían entre 0x1 a 0xFFFFFFFF. El valor predeterminado es 0xF
(15 segundos). Este valor se debe aumentar cuando la
recursividad se produce mediante un vínculo WAN lento.

/roundrobin [0|1] Determina el orden en el que se devuelven los registros de


host cuando un servidor tiene varios registros de host para el
mismo nombre. Acepta los siguientes valores:
0: el servidor DNS no usa round robin. En su lugar,
devuelve el primer registro a cada consulta.
1: el servidor DNS rota entre los registros que devuelve
desde la parte superior a la parte inferior de la lista de
registros coincidentes. Esta es la configuración
predeterminada.
Parámetros Descripción

/rpcprotocol Especifica el protocolo que usa la llamada a procedimiento


[0x0|0x1|0x2|0x4|0xFFFFFFFF] remoto (RPC) cuando realiza una conexión desde el servidor
DNS. Acepta los siguientes valores:
0x0: deshabilita RPC para DNS.
0x01: usa TCP/IP
0x2: usa canalizaciones con nombre.
0x4: usa la llamada a procedimiento local (LPC).
0xFFFFFFFF: todos los protocolos. Esta es la
configuración predeterminada.

/scavenginginterval [<hours>] Determina si está habilitada la característica de limpieza para


el servidor DNS y establece el número de horas (0x0-
0xFFFFFFFF) entre ciclos de limpieza. La configuración
predeterminada es 0x0, lo que deshabilita la limpieza para el
servidor DNS. Un valor mayor que 0x0 habilita la limpieza para
el servidor y establece el número de horas entre los ciclos de
limpieza.

/secureresponses [0|1] Determina si DNS filtra los registros que se guardan en una
memoria caché. Acepta los siguientes valores:
0: guarda todas las respuestas a las consultas de
nombres en una memoria caché. Esta es la configuración
predeterminada.
1: guarda solo los registros que pertenecen al mismo
subárbol DNS en una memoria caché.

/sendport [<port>] Especifica el número de puerto (0x0-0xFFFFFFFF) que usa DNS


para enviar consultas recursivas a otros servidores DNS. El
valor predeterminado es 0x0, lo que significa que el número
de puerto se selecciona aleatoriamente.

/serverlevelplugindll [<dllpath>] Especifica la ruta de acceso de un complemento


personalizado. Cuando Dllpath especifica el nombre completo
de la ruta de acceso de un complemento del servidor DNS
válido, el servidor DNS llama a las funciones del complemento
para resolver las consultas de nombres que están fuera del
ámbito de todas las zonas hospedadas localmente. Si un
nombre consultado está fuera del ámbito del complemento, el
servidor DNS realiza la resolución de nombres mediante el
reenvío o la recursividad, tal como está configurado. Si no se
especifica Dllpath, el servidor DNS deja de usar un
complemento personalizado si se configuró previamente un
complemento personalizado.
Parámetros Descripción

/strictfileparsing [0|1] Determina el comportamiento de un servidor DNS cuando


encuentra un registro erróneo al cargar una zona. Acepta los
siguientes valores:
0: el servidor DNS sigue cargando la zona aunque el
servidor encuentre un registro erróneo. El error se
registra en el registro de DNS. Esta es la configuración
predeterminada.
1: el servidor DNS deja de cargar la zona y registra el
error en el registro de DNS.

/updateoptions <RecordValue> Prohíbe las actualizaciones dinámicas de los tipos de registros


especificados. Si desea prohibir más de un evento en el
registro, use la adición hexadecimal para sumar los valores y, a
continuación, escriba la suma. Acepta los siguientes valores:
0x0: no restringe ningún tipo de registro.
0x1: excluye los registros de recursos del inicio de
autoridad (SOA).
0x2: excluye los registros de recursos del servidor de
nombres (NS).
0x4: excluye los registros de recursos de delegación del
servidor de nombres (NS).
0x8: excluye los registros de host del servidor.
0x100: durante la actualización dinámica segura, excluye
los registros de recursos de inicio de autoridad (SOA).
0x200: durante la actualización dinámica segura, excluye
los registros de recursos del servidor de nombres (NS)
raíz.
0x30F: durante la actualización dinámica estándar,
excluye los registros de recursos del servidor de
nombres (NS), los registros de recursos de inicio de
autoridad (SOA) y los registros de host del servidor.
Durante la actualización dinámica segura, excluye los
registros de recursos del servidor de nombres (NS) raíz y
los registros de recursos de inicio de autoridad (SOA).
Permite las delegaciones y las actualizaciones del host
del servidor.
0x400: durante la actualización dinámica segura, excluye
los registros de recursos del servidor de nombres (NS)
de delegación.
0x800: durante la actualización dinámica segura, excluye
los registros de host del servidor.
0x1000000: excluye los registros del firmante de
delegación (DS).
0x80000000: deshabilita la actualización dinámica de
DNS.
Parámetros Descripción

/writeauthorityns [0|1] Determina cuándo escribe el servidor DNS los registros de


recursos del servidor de nombres (NS) en la sección Autoridad
de una respuesta. Acepta los siguientes valores:
0: escribe los registros de recursos del servidor de
nombres (NS) en la sección Autoridad de las referencias
únicamente. Esta configuración cumple con RFC 1034,
Conceptos e instalaciones de nombres de dominio, y
con RFC 2181, Aclaraciones de la especificación de DNS.
Esta es la configuración predeterminada.
1: escribe los registros de recursos del servidor de
nombres (NS) en la sección Autoridad de todas las
respuestas autoritativas correctas.

/xfrconnecttimeout [<seconds>] Determina el número de segundos (0x0-0xFFFFFFFF) que un


servidor DNS principal espera una respuesta de transferencia
desde su servidor secundario. El valor predeterminado es 0x1E
(30 segundos). Una vez expirado el valor del tiempo de espera,
se finaliza la conexión.

Sintaxis de nivel de zona


Modifica la configuración de la zona especificada. El nombre de zona solo se debe
especificar para los parámetros de nivel de zona.

dnscmd /config <parameters>

Parámetros

Parámetros Descripción

<parameter> Especifique una configuración, un nombre de zona y, como


opción, un valor. Los valores de los parámetros usan esta sintaxis:
zonename parameter [value] .

/aging <zonename> Habilita o deshabilita la limpieza en una zona específica.

/allownsrecordsautocreation Invalida la configuración de creación automática del registro de


<zonename> [value] recursos del servidor de nombres (NS) del servidor DNS. Los
registros de recursos del servidor de nombres (NS) que se
registraron anteriormente para esta zona no se ven afectados. Por
lo tanto, debe quitarlos manualmente si no los desea.
Parámetros Descripción

/allowupdate <zonename> Determina si la zona especificada acepta actualizaciones


dinámicas.

/forwarderslave <zonename> Invalida la configuración /isslave del servidor DNS.

/forwardertimeout Determina cuántos segundos espera una zona DNS a que


<zonename> responda un reenviador antes de intentar otro reenviador. Este
valor invalida el valor establecido en el nivel de servidor.

/norefreshinterval Establece un intervalo de tiempo para una zona durante el cual


<zonename> ninguna actualización puede actualizar dinámicamente los
registros DNS en una zona especificada.

/refreshinterval <zonename> Establece un intervalo de tiempo para una zona durante el cual las
actualizaciones pueden actualizar dinámicamente los registros
DNS en una zona especificada.

/securesecondaries Determina qué servidores secundarios pueden recibir


<zonename> actualizaciones de zona del servidor principal de esta zona.

Comando dnscmd
/createbuiltindirectorypartitions
Crea una partición del directorio de aplicaciones DNS. Cuando se instala DNS, se crea
una partición de directorio de aplicación para el servicio en los niveles de bosque y
dominio. Use este comando para crear particiones de directorio de aplicación de DNS
que se eliminaron o nunca se crearon. Sin ningún parámetro, este comando crea una
partición de directorio de DNS integrada para el dominio.

Sintaxis

dnscmd [<servername>] /createbuiltindirectorypartitions [/forest]


[/alldomains]

Parámetros

Parámetros Descripción
Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

/forest Crea una partición de directorio de DNS para el bosque.

/alldomains Crea particiones de DNS para todos los dominios del bosque.

Comando dnscmd /createdirectorypartition


Crea una partición del directorio de aplicaciones DNS. Cuando se instala DNS, se crea
una partición de directorio de aplicación para el servicio en los niveles de bosque y
dominio. Esta operación crea particiones adicionales de directorio de aplicación de DNS.

Sintaxis

dnscmd [<servername>] /createdirectorypartition <partitionFQDN>

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la


dirección IP, el FQDN o el nombre de host. Si se omite este parámetro, se
utiliza el servidor local.

<partitionFQDN> FQDN de la partición de directorio de aplicación de DNS que se va a crear.

Comando dnscmd /deletedirectorypartition


Quita una partición de directorio de aplicación de DNS existente.

Sintaxis

dnscmd [<servername>] /deletedirectorypartition <partitionFQDN>


Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la


dirección IP, el FQDN o el nombre de host. Si se omite este parámetro, se
utiliza el servidor local.

<partitionFQDN> FQDN de la partición de directorio de aplicación de DNS que se va a quitar.

Comando dnscmd /directorypartitioninfo


Enumera información sobre una partición de directorio de aplicación de DNS
especificada.

Sintaxis

dnscmd [<servername>] /directorypartitioninfo <partitionFQDN> [/detail]

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la


dirección IP, el FQDN o el nombre de host. Si se omite este parámetro, se
utiliza el servidor local.

<partitionFQDN> FQDN de la partición de directorio de aplicación de DNS.

/detail Enumera toda la información sobre la partición de directorio de aplicación


especificada.

Comando dnscmd /enlistdirectorypartition


Agrega el servidor DNS al conjunto de réplicas de la partición de directorio especificada.

Sintaxis
dnscmd [<servername>] /enlistdirectorypartition <partitionFQDN>

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la


dirección IP, el FQDN o el nombre de host. Si se omite este parámetro, se
utiliza el servidor local.

<partitionFQDN> FQDN de la partición de directorio de aplicación de DNS.

Comando dnscmd /enumdirectorypartitions


Enumera las particiones de directorio de aplicación de DNS del servidor especificado.

Sintaxis

dnscmd [<servername>] /enumdirectorypartitions [/custom]

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

/custom Enumera solo las particiones de directorio creadas por el usuario.

Comando dnscmd /enumrecords


Enumera los registros de recursos de un nodo especificado de una zona DNS.

Sintaxis
dnscmd [<servername>] /enumrecords <zonename> <nodename> [/type <rrtype>
<rrdata>] [/authority] [/glue] [/additional] [/node | /child |
/startchild<childname>] [/continue | /detail]

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la


dirección IP, el FQDN o el nombre de host. Si se omite este parámetro,
se utiliza el servidor local.

/enumrecords Enumera los registros de recursos de la zona especificada.

<zonename> Especifica el nombre de la zona a la que pertenecen los registros de


recursos.

<nodename> Especifica el nombre del nodo de los registros de recursos.

[/type <rrtype> Especifica el tipo de registros de recursos que se van a enumerar y el


<rrdata>] tipo de datos que se espera. Acepta los siguientes valores:
<rrtype> : especifica el tipo de registros de recursos que se van a
enumerar.
<rrdata> : especifica el tipo de datos que se espera registrar.

/authority Incluye datos autoritativos.

/glue Incluye datos de pegado.

/additional Incluye toda la información adicional sobre los registros de recursos


enumerados.

/node Enumera solo los registros de recursos del nodo especificado.

/child Enumera solo los registros de recursos del dominio secundario


especificado.

/startchild <childname> Comienza la lista en el dominio secundario especificado.

/continue Enumera solo los registros de recursos con su tipo y datos.

/detail Enumera toda la información sobre los registros de recursos.

Ejemplo
dnscmd /enumrecords test.contoso.com test /additional

Comando dnscmd /enumzones


Enumera las zonas que existen en el servidor DNS especificado. Los parámetros
enumzones actúan como filtros en la lista de zonas. Si no se especifica ningún filtro, se
devuelve una lista completa de zonas. Cuando se especifica un filtro, solo se incluyen en
la lista de zonas devuelta las zonas que cumplen los criterios del filtro.

Sintaxis

dnscmd [<servername>] /enumzones [/primary | /secondary | /forwarder | /stub


| /cache | /auto-created] [/forward | /reverse | /ds | /file]
[/domaindirectorypartition | /forestdirectorypartition |
/customdirectorypartition | /legacydirectorypartition | /directorypartition
<partitionFQDN>]

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por


la dirección IP, el FQDN o el nombre de host. Si se omite este
parámetro, se utiliza el servidor local.

/primary Enumera todas las zonas que son zonas principales estándar o zonas
integradas de Active Directory.

/secondary Enumera todas las zonas secundarias estándar.

/forwarder Enumera las zonas que reenvían las consultas sin resolver a otro
servidor DNS.

/stub Enumera todas las zonas auxiliares.

/cache Enumera solo las zonas que se cargan en la memoria caché.

/auto-created] Enumera las zonas que se crearon automáticamente durante la


instalación del servidor DNS.

/forward Enumera las zonas de búsqueda directa.

/reverse Enumera las zonas de búsqueda inversa.


Parámetros Descripción

/ds Enumera las zonas integradas de Active Directory.

/file Enumera las zonas respaldadas por archivos.

/domaindirectorypartition Enumera las zonas almacenadas en la partición de directorio de


dominio.

/forestdirectorypartition Enumera las zonas almacenadas en la partición de directorio de


aplicación de DNS del bosque.

/customdirectorypartition Enumera las zonas almacenadas en la partición de directorio de


aplicación definida por el usuario.

/legacydirectorypartition Enumera todas las zonas almacenadas en la partición de directorio de


dominio.

/directorypartition Enumera todas las zonas almacenadas en la partición de directorio


<partitionFQDN> especificada.

Ejemplos

Ejemplo 2: mostrar una lista completa de las zonas de un servidor DNS

Ejemplo 3: mostrar una lista de las zonas de creación automática de un servidor


DNS

Comando dnscmd /exportsettings


Crea un archivo de texto que enumera los detalles de configuración de un servidor DNS.
El archivo de texto se llama DnsSettings.txt. Se encuentra en el directorio
%systemroot%\system32\dns del servidor. Puede usar la información del archivo que crea

dnscmd /exportsettings para solucionar problemas de configuración o para asegurarse


de que ha configurado varios servidores de forma idéntica.

Sintaxis

dnscmd [<servername>] /exportsettings

Parámetros
Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

Comando dnscmd /info


Muestra la configuración de la sección de DNS del Registro del servidor especificado
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DNS\Parameters . Para mostrar la

configuración del Registro de nivel de zona, use el comando dnscmd zoneinfo .

Sintaxis

dnscmd [<servername>] /info [<settings>]

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

<settings> Cualquier configuración que devuelva el comando info se puede especificar


individualmente. Si no se especifica una configuración, se devuelve un informe de
la configuración común.

Ejemplo
Ejemplo 4: mostrar la configuración IsSlave de un servidor DNS

Ejemplo 5: mostrar la configuración RecursionTimeout de un servidor DNS

Comando dnscmd /ipvalidate


Comprueba si una dirección IP identifica un servidor DNS en funcionamiento o si el
servidor DNS puede actuar como reenviador, servidor de sugerencias raíz o servidor
principal de una zona específica.
Sintaxis

dnscmd [<servername>] /ipvalidate <context> [<zonename>] [[<IPaddress>]]

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

<context> Especifica el tipo de prueba que se va a realizar. Puede especificar cualquiera de


las siguientes pruebas:
/dnsservers: comprueba que los equipos con las direcciones que
especifique sean servidores DNS en funcionamiento.
/forwarders: comprueba que las direcciones que especifique identifican los
servidores DNS que pueden actuar como reenviadores.
/roothints: comprueba que las direcciones que especifique identifican los
servidores DNS que pueden actuar como servidores de nombres de
sugerencia raíz.
/zonemasters: comprueba que las direcciones que especifique identifican
los servidores DNS que son servidores principales para zonename.

<zonename> Identifica la zona. Utilice este parámetro con el parámetro /zonemasters.

<IPaddress> Especifica las direcciones IP que prueba el comando.

Ejemplos

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


Elimina todos los registros de un host especificado.

Sintaxis
dnscmd [<servername>] /nodedelete <zonename> <nodename> [/tree] [/f]

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

<zonename> Especifica el nombre de la zona.

<nodename> Especifica el nombre de host del nodo que se va a eliminar.

/tree Elimina todos los registros secundarios.

/f Ejecuta el comando sin pedir confirmación.

Ejemplo

Ejemplo 6: eliminar los registros de un nodo

Comando dnscmd /recordadd


Agrega un registro a una zona especificada de un servidor DNS.

Sintaxis

dnscmd [<servername>] /recordadd <zonename> <nodename> <rrtype> <rrdata>

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.
Parámetros Descripción

<zonename> Especifica la zona en la que reside el registro.

<nodename> Especifica un nodo específico de la zona.

<rrtype> Especifica el tipo de registro que se va a agregar.

<rrdata> Especifica el tipo de datos que se espera.

7 Nota

Después de agregar un registro, asegúrese de usar el tipo de datos y el formato de


datos correctos. Para obtener una lista de los tipos de registro de recursos y los
tipos de datos adecuados, consulte Ejemplos de dnscmd.

Ejemplos

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


Elimina un registro de recursos en una zona especificada.

Sintaxis

dnscmd [<servername>] /recorddelete <zonename> <nodename> <rrtype> <rrdata>


[/f]

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.
Parámetros Descripción

<zonename> Especifica la zona en la que reside el registro de recursos.

<nodename> Especifica un nombre del host.

<rrtype> Especifica el tipo de registro de recursos que se va a eliminar.

<rrdata> Especifica el tipo de datos que se espera.

/f Ejecuta el comando sin pedir confirmación. Dado que los nodos pueden tener
más de un registro de recursos, este comando requiere que sea muy específico
sobre el tipo de registro de recursos que desea eliminar. Si especifica un tipo de
datos y no especifica un tipo de datos de registro de recursos, se eliminan todos
los registros con ese tipo de datos específico para el nodo especificado.

Ejemplos

dnscmd /recorddelete test.contoso.com test MX 10 mailserver.test.contoso.com

Comando dnscmd /resetforwarders


Selecciona o restablece las direcciones IP a las que el servidor DNS reenvía las consultas
DNS cuando no las puede resolver localmente.

Sintaxis

dnscmd [<servername>] /resetforwarders <IPaddress> [,<IPaddress>]...]


[/timeout <timeout>] [/slave | /noslave]

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.
Parámetros Descripción

<IPaddress> Enumera las direcciones IP a las que el servidor DNS reenvía las consultas sin
resolver.

/timeout Establece el número de segundos que el servidor DNS espera una respuesta del
<timeout> reenviador. De manera predeterminada, este valor es de cinco segundos.

/slave Impide que el servidor DNS realice sus propias consultas iterativas si el reenviador
no puede resolver una consulta.

/noslave Permite que el servidor DNS realice sus propias consultas iterativas si el
reenviador no puede resolver una consulta. Esta es la configuración
predeterminada.

/f Ejecuta el comando sin pedir confirmación. Dado que los nodos pueden tener
más de un registro de recursos, este comando requiere que sea muy específico
sobre el tipo de registro de recursos que desea eliminar. Si especifica un tipo de
datos y no especifica un tipo de datos de registro de recursos, se eliminan todos
los registros con ese tipo de datos específico para el nodo especificado.

Comentarios

De manera predeterminada, un servidor DNS realiza consultas iterativas cuando no


puede resolver una consulta.

Establecer direcciones IP mediante el comando resetforwarders hace que el


servidor DNS realice consultas recursivas a los servidores DNS de las direcciones IP
especificadas. Si los reenviadores no resuelven la consulta, el servidor DNS puede
realizar sus propias consultas iterativas.

Si se usa el parámetro /slave, el servidor DNS no realiza sus propias consultas


iterativas. Esto significa que el servidor DNS reenvía las consultas sin resolver solo
a los servidores DNS de la lista y no intenta realizar consultas iterativas si los
reenviadores no las resuelven. Es más eficaz establecer una dirección IP como
reenviador para un servidor DNS. Puede usar el comando resetforwarders para los
servidores internos de una red para reenviar sus consultas sin resolver a un
servidor DNS que tenga una conexión externa.

Enumerar la dirección IP de un reenviador dos veces hace que el servidor DNS


intente reenviar a ese servidor dos veces.

Ejemplos
dnscmd dnssvr1.contoso.com /resetforwarders 10.0.0.1 /timeout 7 /slave
dnscmd dnssvr1.contoso.com /resetforwarders /noslave

Comando dnscmd /resetlistenaddresses


Especifica las direcciones IP de un servidor que escucha las solicitudes de cliente de
DNS. De manera predeterminada, todas las direcciones IP de un servidor DNS escuchan
las solicitudes DNS de cliente.

Sintaxis

dnscmd [<servername>] /resetlistenaddresses <listenaddress>

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la


dirección IP, el FQDN o el nombre de host. Si se omite este parámetro, se
utiliza el servidor local.

<listenaddress> Especifica una dirección IP del servidor DNS que escucha las solicitudes de
cliente de DNS. Si no se especifica ninguna dirección de escucha, todas las
direcciones IP del servidor escuchan las solicitudes de cliente.

Ejemplos

dnscmd dnssvr1.contoso.com /resetlistenaddresses 10.0.0.1

Comando dnscmd /startscavenging


Indica a un servidor DNS que intente buscar inmediatamente registros de recursos
obsoletos en un servidor DNS especificado.

Sintaxis
dnscmd [<servername>] /startscavenging

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

Comentarios

La finalización correcta de este comando inicia inmediatamente una limpieza. Si se


produce un error en la limpieza, no aparece ningún mensaje de advertencia.

Aunque el comando para iniciar la limpieza parece completarse correctamente, la


limpieza no se inicia a menos que se cumplan las condiciones previas siguientes:

La limpieza está habilitada tanto para el servidor como para la zona.

Se ha iniciado la zona.

Los registros de recursos tienen una marca de tiempo.

Para obtener información sobre cómo habilitar la limpieza para el servidor,


consulte el parámetro scavenginginterval en Sintaxis de nivel de servidor en la
sección /config.

Para obtener información sobre cómo habilitar la limpieza en la zona, consulte el


parámetro aging en Sintaxis de nivel de zona en la sección /config.

Para obtener información sobre cómo reiniciar una zona en pausa, consulte el
parámetro zoneresume en este artículo.

Para obtener información sobre cómo comprobar los registros de recursos en


busca de una marca de tiempo, consulte el parámetro ageallrecords de este
artículo.

Ejemplos
dnscmd dnssvr1.contoso.com /startscavenging

Comando dnscmd /statistics


Muestra o borra los datos de un servidor DNS especificado.

Sintaxis

dnscmd [<servername>] /statistics [<statid>] [/clear]

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.
Parámetros Descripción

<statid> Especifica qué estadística o combinación de estadísticas se van a mostrar. El


comando statistics muestra contadores que comienzan en el servidor DNS
cuando se inicia o reanuda. Se usa un número de identificación para identificar
una estadística. Si no se especifica ningún número de identificación de una
estadística, se muestran todas las estadísticas. Los números que se pueden
especificar, junto con la estadística correspondiente que se muestra, pueden
incluir:

00000001: Time
00000002: Query
00000004: Query2
00000008: Recurse
00000010: Master
00000020: Secondary
00000040: WINS
00000100: Update
00000200: SkwanSec
00000400: Ds
00010000: Memory
00100000: PacketMem
00040000: Dbase
00080000: Records
00200000: NbstatMem
/clear: restablece el contador de la estadística especificada en cero.

Ejemplos

Ejemplo 7:

Ejemplo 8: mostrar la estadística NbstatMem de un servidor DNS

Comando dnscmd /unenlistdirectorypartition


Quita el servidor DNS del conjunto de réplicas de la partición de directorio especificada.

Sintaxis

dnscmd [<servername>] /unenlistdirectorypartition <partitionFQDN>


Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la


dirección IP, el FQDN o el nombre de host. Si se omite este parámetro, se
utiliza el servidor local.

<partitionFQDN> FQDN de la partición de directorio de aplicación de DNS que se va a quitar.

Comando dnscmd /writebackfiles


Comprueba si hay cambios en la memoria del servidor DNS y los escribe en el
almacenamiento persistente. El comando writebackfiles actualiza todas las zonas
desfasadas o una zona especificada. Una zona está desfasada cuando hay cambios en la
memoria que aún no se han escrito en el almacenamiento persistente. Se trata de una
operación de nivel de servidor que comprueba todas las zonas. Puede especificar una
zona en esta operación o puede usar la operación zonewriteback.

Sintaxis

dnscmd [<servername>] /writebackfiles <zonename>

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

<zonename> Especifica el nombre de la zona que se va a actualizar.

Ejemplos

dnscmd dnssvr1.contoso.com /writebackfiles


Comando dnscmd /zoneadd
Agrega una zona al servidor DNS.

Sintaxis

dnscmd [<servername>] /zoneadd <zonename> <zonetype> [/dp <FQDN> | {/domain


| enterprise | legacy}]

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

<zonename> Especifica el nombre de la zona.

<zonetype> Especifica el tipo de zona que se va a crear. Al especificar una zona de tipo
/forwarder o /dsforwarder, se crea una zona que realiza el reenvío condicional.
Cada tipo de zona tiene diferentes parámetros necesarios:

/dsprimary: crea una zona integrada de Active Directory.


/primary /file <filename> : crea una zona principal estándar y especifica el
nombre del archivo que almacenará la información de zona.
/secondary <masterIPaddress> [<masterIPaddress>...] : crea una zona
secundaria estándar.
/stub <masterIPaddress> [<masterIPaddress>...] /file <filename> : crea una
zona auxiliar con respaldo de archivo.
/dsstub <masterIPaddress> [<masterIPaddress>...] : crea una zona auxiliar
integrada con Active Directory.
/forwarder <masterIPaddress> [<masterIPaddress>] ... /file <filename> :
especifica que la zona creada reenvía las consultas sin resolver a otro
servidor DNS.
/dsforwarder: especifica que la zona integrada de Active Directory creada
reenvía las consultas sin resolver a otro servidor DNS.

<FQDN> Especifica el FQDN de la partición de directorio.

/domain Almacena la zona en la partición de directorio de dominio.

/enterprise Almacena la zona en la partición de directorio de empresa.


Parámetros Descripción

/legacy Almacena la zona en la partición de directorio heredado.

Ejemplos

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
Cambia la partición de directorio en la que reside la zona especificada.

Sintaxis

dnscmd [<servername>] /zonechangedirectorypartition <zonename>


{[<newpartitionname>] | [<zonetype>]}

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la


dirección IP, el FQDN o el nombre de host. Si se omite este parámetro, se
utiliza el servidor local.

<zonename> FQDN de la partición de directorio actual en la que reside la zona.

<newpartitionname> FQDN de la partición de directorio a la que se va a mover la zona.

<zonetype> Especifica el tipo de partición de directorio a la que se va a mover la zona.

/domain Mueve la zona a la partición de directorio de dominio integrada.

/forest Mueve la zona a la partición de directorio de bosque integrada.


Parámetros Descripción

/legacy Mueve la zona a la partición de directorio que se crea para los


controladores de dominio de Active Directory previos. Estas particiones de
directorio no son necesarias para el modo nativo.

Comando dnscmd /zonedelete


Elimina una zona especificada.

Sintaxis

dnscmd [<servername>] /zonedelete <zonename> [/dsdel] [/f]

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

<zonename> Especifica el nombre de la zona que se va a eliminar.

/dsdel Elimina la zona de Azure Directory Domain Services (AD DS).

/f Ejecuta el comando sin pedir confirmación.

Ejemplos
Ejemplo 9: eliminar una zona de un servidor DNS

Comando dnscmd /zoneexport


Crea un archivo de texto que enumera los registros de recursos de una zona
especificada. La operación zoneexport crea un archivo de registros de recursos de una
zona integrada de Active Directory con fines de solución de problemas. De manera
predeterminada, el archivo que crea este comando se coloca en el directorio de DNS,
que es el directorio %systemroot%/System32/Dns de manera predeterminada.
Sintaxis

dnscmd [<servername>] /zoneexport <zonename> <zoneexportfile>

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la


dirección IP, el FQDN o el nombre de host. Si se omite este parámetro, se
utiliza el servidor local.

<zonename> Especifica el nombre de la zona.

<zoneexportfile> Especifica el nombre del archivo que se va a crear.

Ejemplos

Ejemplo 10: exportar la lista de registros de recursos de una zona a un archivo

dnscmd /zoneinfo
Muestra la configuración de la sección del Registro de la zona especificada:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DNS\Parameters\Zones\

<zonename>

Sintaxis

dnscmd [<servername>] /zoneinfo <zonename> [<setting>]

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.
Parámetros Descripción

<zonename> Especifica el nombre de la zona.

<setting> Puede especificar individualmente cualquier configuración que devuelva el


comando zoneinfo. Si no especifica una configuración, se devuelven todas las
opciones.

Comentarios

Para mostrar la configuración del Registro de nivel de servidor, use el comando


/info.

Para ver una lista de opciones de configuración que puede mostrar con este
comando, consulte el comando /config.

Ejemplos

Ejemplo 11: mostrar la configuración RefreshInterval del Registro

Ejemplo 12: mostrar la configuración de establecimiento de antigüedad del


Registro

Comando dnscmd /zonepause


Pone en pausa la zona especificada, la cual, a continuación, omite las solicitudes de
consulta.

Sintaxis

dnscmd [<servername>] /zonepause <zonename>

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.
Parámetros Descripción

<zonename> Especifica el nombre de la zona que se va a poner en pausa.

Comentarios

Para reanudar una zona y hacer que esté disponible una vez que haya estado en
pausa, utilice el comando /zoneresume.

Ejemplos

dnscmd dnssvr1.contoso.com /zonepause test.contoso.com

Comando dnscmd /zoneprint


Enumera los registros de una zona.

Sintaxis

dnscmd [<servername>] /zoneprint <zonename>

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

<zonename> Especifica el nombre de la zona que se va a enumerar.

Comando dnscmd /zonerefresh


Obliga a una zona DNS secundaria a actualizarse desde la zona maestra.
Sintaxis

dnscmd [<servername>] /zonerefresh <zonename>

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

<zonename> Especifica el nombre de la zona que se va a actualizar.

Comentarios

El comando zonerefresh fuerza una comprobación del número de versión en el


registro de recursos de inicio de autoridad (SOA) del servidor principal. Si el
número de versión del servidor principal es mayor que el número de versión del
servidor secundario, se inicia una transferencia de zona que actualiza el servidor
secundario. Si el número de versión es el mismo, no se produce una transferencia
de zona.

La comprobación forzada se produce de manera predeterminada cada 15 minutos.


Para cambiar el valor predeterminado, utilice el comando dnscmd config
refreshinterval .

Ejemplos

dnscmd dnssvr1.contoso.com /zonerefresh test.contoso.com

Comando dnscmd /zonereload


Copia la información de zona de su origen.

Sintaxis
dnscmd [<servername>] /zonereload <zonename>

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

<zonename> Especifica el nombre de la zona que se va a volver a cargar.

Comentarios

Si la zona está integrada en Active Directory, se vuelve a cargar desde Active


Directory Domain Services (AD DS).

Si la zona es una zona con respaldo de archivo estándar, se vuelve a cargar desde
un archivo.

Ejemplos

dnscmd dnssvr1.contoso.com /zonereload test.contoso.com

Comando dnscmd /zoneresetmasters


Restablece las direcciones IP del servidor principal que proporciona información de
transferencia de zona a una zona secundaria.

Sintaxis

dnscmd [<servername>] /zoneresetmasters <zonename> [/local] [<IPaddress>


[<IPaddress>]...]
Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

<zonename> Especifica el nombre de la zona que se va restablecer.

/local Establece una lista maestra local. Este parámetro se usa para zonas integradas de
Active Directory.

<IPaddress> Direcciones IP de los servidores principales de la zona secundaria.

Comentarios

Este valor se establece originalmente cuando se crea la zona secundaria. Use el


comando zoneresetmasters en el servidor secundario. Este valor no tiene ningún
efecto si se establece en el servidor DNS maestro.

Ejemplos

dnscmd dnssvr1.contoso.com /zoneresetmasters test.contoso.com 10.0.0.1


dnscmd dnssvr1.contoso.com /zoneresetmasters test.contoso.com /local

Comando dnscmd /zoneresetscavengeservers


Cambia las direcciones IP de los servidores que pueden hacer la limpieza de la zona
especificada.

Sintaxis

dnscmd [<servername>] /zoneresetscavengeservers <zonename> [/local]


[<IPaddress> [<IPaddress>]...]

Parámetros
Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

<zonename> Especifica la zona en la que se va a hacer la limpieza.

/local Establece una lista maestra local. Este parámetro se usa para zonas integradas de
Active Directory.

<IPaddress> Enumera las direcciones IP de los servidores que pueden realizar la limpieza. Si se
omite este parámetro, todos los servidores que hospedan esta zona pueden
realizar la limpieza.

Comentarios

De manera predeterminada, todos los servidores que hospedan una zona pueden
realizar la limpieza de esa zona.

Si una zona está hospedada en más de un servidor DNS, puede usar este comando
para reducir el número de veces que se realiza la limpieza de una zona.

La limpieza debe estar habilitada en el servidor DNS y en la zona afectada por este
comando.

Ejemplos

dnscmd dnssvr1.contoso.com /zoneresetscavengeservers test.contoso.com


10.0.0.1 10.0.0.2

Comando dnscmd /zoneresetsecondaries


Especifica una lista de direcciones IP de los servidores secundarios a los que responde
un servidor principal cuando se le solicita una transferencia de zona.

Sintaxis

dnscmd [<servername>] /zoneresetsecondaries <zonename> {/noxfr | /nonsecure


| /securens | /securelist <securityIPaddresses>} {/nonotify | /notify |
/notifylist <notifyIPaddresses>}

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la


dirección IP, el FQDN o el nombre de host. Si se omite este parámetro,
se utiliza el servidor local.

<zonename> Especifica el nombre de la zona cuyos servidores secundarios se van a


restablecer.

/local Establece una lista maestra local. Este parámetro se usa para zonas
integradas de Active Directory.

/noxfr Especifica que no se permiten transferencias de zona.

/nonsecure Especifica que se conceden todas las solicitudes de transferencia de


zona.

/securens Especifica que solo se concede una transferencia al servidor que aparece
en el registro de recursos del servidor de nombres (NS) de la zona.

/securelist Especifica que las transferencias de zona solo se conceden a la lista de


servidores. Este parámetro debe ir seguido de una o varias de las
direcciones IP que use el servidor principal.

<securityIPaddresses> Enumera las direcciones IP que reciben transferencias de zona desde el


servidor principal. Este parámetro solo se utiliza con el parámetro
/securelist.

/nonotify Especifica que no se envían notificaciones de cambios a los servidores


secundarios.

/notify Especifica que se envían notificaciones de cambios a todos los


servidores secundarios.

/notifylist Especifica que se envían notificaciones de cambios solo a la lista de


servidores. Este comando debe ir seguido de una o varias de las
direcciones IP que use el servidor principal.

<notifyIPaddresses> Especifica la dirección o direcciones IP del servidor o servidores


secundarios a los que se envían notificaciones de cambios. Esta lista
solo se usa con el parámetro /notifylist.

Comentarios
Use el comando zoneresetsecondaries en el servidor principal para especificar
cómo responde a las solicitudes de transferencia de zona desde servidores
secundarios.

Ejemplos

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


Cambia el tipo de la zona.

Sintaxis

dnscmd [<servername>] /zoneresettype <zonename> <zonetype> [/overwrite_mem |


/overwrite_ds]

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la


dirección IP, el FQDN o el nombre de host. Si se omite este parámetro, se
utiliza el servidor local.

<zonename> Identifica la zona en la que se va a cambiar el tipo.


Parámetros Descripción

<zonetype> Especifica el tipo de zona que se va a crear. Cada tipo tiene diferentes
parámetros necesarios, entre los que se incluyen:
/dsprimary: crea una zona integrada de Active Directory.
/primary /file <filename> : crea una zona primaria estándar.
/secondary <masterIPaddress> [,<masterIPaddress>...] : crea una zona
secundaria estándar.
/stub <masterIPaddress>[,<masterIPaddress>...] /file <filename> : crea
una zona auxiliar con respaldo de archivo.
/dsstub <masterIPaddress>[,<masterIPaddress>...] : crea una zona
auxiliar integrada con Active Directory.
/forwarder <masterIPaddress[,<masterIPaddress>] ... /file <filename> :
especifica que la zona creada reenvía las consultas sin resolver a otro
servidor DNS.
/dsforwarder: especifica que la zona integrada de Active Directory
creada reenvía las consultas sin resolver a otro servidor DNS.

/overwrite_mem Sobrescribe los datos de DNS a partir de los datos de AD DS.

/overwrite_ds Sobrescribe los datos existentes en AD DS.

Comentarios

Al establecer el tipo de zona como /dsforwarder, se crea una zona que realiza el
reenvío condicional.

Ejemplos

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 una zona especificada que se había puesto en pausa anteriormente.

Sintaxis
dnscmd [<servername>] /zoneresume <zonename>

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

<zonename> Especifica el nombre de la zona que se va a reanudar.

Comentarios

Puede usar esta operación para reiniciar desde la operación /zonepause.

Ejemplos

dnscmd dnssvr1.contoso.com /zoneresume test.contoso.com

Comando dnscmd /zoneupdatefromds


Actualiza la zona integrada de Active Directory especificada a partir de AD DS.

Sintaxis

dnscmd [<servername>] /zoneupdatefromds <zonename>

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.
Parámetros Descripción

<zonename> Especifica el nombre de la zona que se va a actualizar.

Comentarios

Las zonas integradas de Active Directory realizan esta actualización de manera


predeterminada cada cinco minutos. Para cambiar este parámetro, use el comando
dnscmd config dspollinginterval .

Ejemplos

dnscmd dnssvr1.contoso.com /zoneupdatefromds

Comando dnscmd /zonewriteback


Comprueba la memoria del servidor DNS para ver los cambios que son pertinentes para
una zona especificada y los escribe en el almacenamiento persistente.

Sintaxis

dnscmd [<servername>] /zonewriteback <zonename>

Parámetros

Parámetros Descripción

<servername> Especifica el servidor DNS que se va a administrar, representado por la dirección


IP, el FQDN o el nombre de host. Si se omite este parámetro, se utiliza el servidor
local.

<zonename> Especifica el nombre de la zona que se va a actualizar.

Comentarios
Se trata de una operación de nivel de zona. Puede actualizar todas las zonas de un
servidor DNS mediante la operación /writebackfiles.

Ejemplos

dnscmd dnssvr1.contoso.com /zonewriteback test.contoso.com

Vínculos relacionados
Clave de sintaxis de línea de comandos
doskey
Artículo • 12/04/2023

Llama a Doskey.exe, que recupera comandos de la línea de comandos que se


escribieron anteriormente, edita líneas de comandos y crea macros.

Sintaxis

doskey [/reinstall] [/listsize=<size>] [/macros:[all | <exename>] [/history]


[/insert | /overstrike] [/exename=<exename>] [/macrofile=<filename>]
[<macroname>=[<text>]]

Parámetros

Parámetro Descripción

/reinstall Instala una copia nueva de Doskey.exe y borra el búfer del historial de
comandos.

/listsize= <size> Especifica el número máximo de comandos en el búfer del historial.

/macros Muestra una lista de todas las macros doskey. Puede usar el símbolo de
redireccionamiento ( > ) con /macros para redirigir la lista a un archivo.
Puede abreviar /macros como /m.

/macros:all Muestra macros doskey para todos los ejecutables.

/macros: <exename> Muestra macros doskey para el ejecutable especificado por exename.

/history Muestra todos los comandos almacenados en memoria. Puede usar el


símbolo de redireccionamiento ( > ) con /history para redirigir la lista a
un archivo. Puede abreviar /history como /h.

/insert Especifica que el texto nuevo que escriba se inserta en texto antiguo.

/overstrike Especifica que el texto nuevo sobrescribe el texto antiguo.

/exename= <exename> Especifica el programa (es decir, el ejecutable) en el que se ejecuta la


macro doskey.

/macrofile= <filename> Especifica un archivo que contiene las macros que desea instalar.
Parámetro Descripción

<macroname> =[ <text> ] Crea una macro que lleva a cabo los comandos que Text especifica.
MacroName especifica el nombre que quiere asignar a la macro. Text
especifica los comandos que desea registrar. Si Text se deja en blanco,
se quitan de MacroName todos los comandos asignados.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Ciertos programas interactivos basados en caracteres, como depuradores de


programas o programas de transferencia de archivos (FTP), usan Doskey.exe de
manera automática. Para usar Doskey.exe, un programa debe ser un proceso de
consola y usar la entrada almacenada en búfer. Las asignaciones de claves de
programa invalidan las asignaciones de claves doskey. Por ejemplo, si el programa
usa la tecla F7 para una función, no se puede obtener un historial de comandos
doskey en una ventana emergente.

Puede usar Doskey.exe para editar la línea de comandos actual, pero no puede
usar las opciones de la línea de comandos desde el símbolo del sistema de un
programa. Debe ejecutar opciones de la línea de comandos doskey antes de iniciar
un programa. Si usa Doskey.exe dentro de un programa, es posible que las
asignaciones de claves de ese programa tengan prioridad y algunas claves de
edición de Doskey.exe no funcionen.

Con Doskey.exe, puede mantener un historial de comandos para cada programa


que inicie o repita. Puede editar comandos anteriores en el símbolo del sistema del
programa e iniciar macros doskey creadas para el programa. Si sale de un
programa y luego lo reinicia desde la misma ventana del símbolo del sistema, el
historial de comandos de la sesión de programa anterior está disponible.

Para recuperar un comando, puede usar cualquiera de las claves siguientes


después de iniciar Doskey.exe:

Clave Descripción

FLECHA ARRIBA Recupera el comando que usó antes del comando que se muestra.

FLECHA ABAJO Recupera el comando que usó después del comando que se muestra.

RE PÁG Recupera el primer comando que usó en la sesión actual.

AV PÁG Recupera el comando más reciente que usó en la sesión actual.


En la tabla siguiente, se enumeran las claves de edición doskey y sus funciones:

Teclas o Descripción
combinación
de teclas

FLECHA Mueve el punto de inserción un carácter hacia atrás.


IZQUIERDA

FLECHA Mueve el punto de inserción un carácter hacia delante.


DERECHA

CTRL+FLECHA Mueve el punto de inserción una palabra hacia atrás.


IZQUIERDA

CTRL+FLECHA Mueve el punto de inserción una palabra hacia delante.


DERECHA

INICIO Mueve el punto de inserción al comienzo de la línea.

FIN Mueve el punto de inserción al final de la línea.

ESC Borra el comando de la pantalla.

F1 Copia un carácter de una columna de la plantilla en la misma columna de


la ventana del símbolo del sistema. (La plantilla es un búfer de memoria
que contiene el último comando que escribió).

F2 Busca hacia delante en la plantilla la tecla siguiente que escribe después


de presionar F2. Doskey.exe inserta el texto de la plantilla, hasta el carácter
que especifique (sin incluirlo).

F3 Copia el resto de la plantilla en la línea de comandos. Doskey.exe


comienza a copiar caracteres desde la posición de la plantilla que
corresponde a la posición indicada por el punto de inserción en la línea de
comandos.

F4 Elimina todos los caracteres de la posición del punto de inserción actual


hasta la aparición siguiente del carácter que escriba después de presionar
F4 (sin incluirlo).

F5 Copia la plantilla en la línea de comandos actual.

F6 Coloca un carácter de final de archivo (CTRL+Z) en la posición del punto


de inserción actual.

F7 Muestra (en un cuadro de diálogo) todos los comandos de este programa


almacenados en memoria. Use las teclas FLECHA ARRIBA y FLECHA ABAJO
para seleccionar el comando que desea y presione ENTRAR para ejecutar
el comando. También puede anotar el número secuencial delante del
comando y usar este número junto con la tecla F9.
Teclas o Descripción
combinación
de teclas

ALT+F7 Elimina todos los comandos almacenados en memoria para el búfer del
historial actual.

F8 Muestra todos los comandos del búfer del historial que comienzan con los
caracteres del comando actual.

F9 Le pide un número de comando del búfer del historial y, a continuación,


muestra el comando asociado al número que se especifica. Presione
ENTRAR para ejecutar el comando. Para mostrar todos los números y sus
comandos asociados, presione F7.

ALT+F10 Elimina todas las definiciones de macros.

Si presiona la tecla INSERT, puede escribir texto en la línea de comandos doskey


en medio del texto existente sin reemplazar el texto. Sn embargo, después de
presionar ENTRAR, Doskey.exe devuelve el teclado al modo Reemplazar. Debe
volver a presionar INSERTAR para volver al modo Insertar.

El punto de inserción cambia de forma cuando se usa la tecla INSERTAR para


cambiar de un modo a otro.

Si desea personalizar el funcionamiento de Doskey.exe con un programa y crear


macros doskey para ese programa, puede crear un programa por lotes que
modifique Doskey.exe e inicie el programa.

Puede usar Doskey.exe para crear macros que ejecute uno o varios comandos. En
la tabla siguiente, se enumeran los caracteres especiales que puede usar para
controlar las operaciones de comando al definir una macro.

Carácter Descripción

$G o $g Redirige la salida. Use cualquiera de estos caracteres especiales para enviar la


salida a un dispositivo o a un archivo en lugar de a la pantalla. Este carácter es
equivalente al símbolo de redireccionamiento para la salida ( > ).

$G$G o Anexa la salida al final de un archivo. Use cualquiera de estos caracteres dobles
$g$g para anexar la salida a un archivo existente en lugar de reemplazar los datos del
archivo. Estos caracteres dobles son equivalentes al símbolo de
redireccionamiento de anexión para la salida ( >> ).

$L o $l Redirige la entrada. Use cualquiera de estos caracteres especiales para leer la


entrada de un dispositivo o un archivo en lugar de hacerlo desde el teclado.
Este carácter es equivalente al símbolo de redireccionamiento para la entrada
( < ).
Carácter Descripción

$B o $b Envía la salida de macro a un comando. Estos caracteres especiales son


equivalentes a usar la canalización ( y * .

$T o $t Separa los comandos. Use cualquiera de estos caracteres especiales para


separar los comandos al crear macros o escribir comandos en la línea de
comandos doskey. Estos caracteres especiales son equivalentes a usar la Y
comercial ( & ) en una línea de comandos.

$$ Especifica el carácter de signo de dólar ( $ ).

$1 Represente cualquier información de la línea de comandos que desee


mediante especificar al ejecutar la macro. Los caracteres especiales de $1 a $9 son
$9 parámetros por lotes que permiten usar datos diferentes en la línea de
comandos cada vez que se ejecuta la macro. El carácter $1 en un comando
doskey es similar al carácter %1 en un programa por lotes.

$* Representa toda la información de la línea de comandos que desea especificar


al escribir el nombre de la macro. El carácter especial $* es un parámetro
reemplazable que es similar a los parámetros por lotes de $1 a $9 , con una
diferencia importante: todo lo que escriba en la línea de comandos después del
nombre de la macro se sustituye por $* en la macro.

Para ejecutar una macro, escriba el nombre en el símbolo del sistema, empezando
en la primera posición. Si la macro se definió con $* o cualquiera de los
parámetros por lotes de $1 a $9 , separe los parámetros con un espacio. No se
puede ejecutar una macro doskey desde un programa por lotes.

Si siempre usa un comando determinado con opciones específicas de la línea de


comandos, puede crear una macro que tenga el mismo nombre que el comando.
Para especificar si desea ejecutar la macro o el comando, siga estas instrucciones:

Para ejecutar la macro, escriba el nombre en el símbolo del sistema. No agregue


ningún espacio antes del nombre de la macro.

Para ejecutar el comando, inserte uno o varios espacios en el símbolo del


sistema y escriba el nombre del comando.

Ejemplos
Las opciones de la línea de comandos /macros y /history son útiles para crear
programas por lotes para guardar macros y comandos. Por ejemplo, para almacenar
todas las macros doskey actuales, escriba:
doskey /macros > macinit

Para usar las macros almacenadas en Macinit, escriba:

doskey /macrofile=macinit

Para crear un programa por lotes denominado Tmp.bat que contiene los comandos
usados recientemente, escriba:

doskey /history> tmp.bat

Para definir una macro con varios comandos, use $t para separar los comandos, tal
como se indica a continuación:

doskey tx=cd temp$tdir/w $*

En el ejemplo anterior, la macro TX cambia el directorio actual a Temp y, a continuación,


muestra una lista de directorios en formato ancho. Puede usar $* al final de la macro
para anexar otras opciones de la línea de comandos a dir al ejecutar la opción tx.

La macro siguiente usa un parámetro por lotes para un nombre de directorio nuevo:

doskey mc=md $1$tcd $1

La macro crea un directorio y, luego, cambia a este directorio nuevo desde el actual.

Si desea usar la macro anterior para crear y cambiar a un directorio denominado Books,
escriba:

mc books

Si desea crear una macro doskey para un programa denominado Ftp.exe, incluya
/exename como se indica a continuación:
doskey /exename=ftp.exe go=open 172.27.1.100$tmget *.TXT c:\reports$tbye

Para usar la macro anterior, inicie FTP. En el símbolo del sistema de FTP, escriba:

go

FTP ejecuta los comandos open, mget y bye.

Para crear una macro que dé formato rápido e incondicional a un disco, escriba:

doskey qf=format $1 /q /u

Para dar formato rápido e incondicional a un disco en la unidad A, escriba:

qf a:

Para eliminar una macro denominada vlist, escriba:

doskey vlist =

Vínculos relacionados
Clave de sintaxis de línea de comandos
driverquery
Artículo • 12/04/2023

Permite a un administrador mostrar una lista de controladores de dispositivos instalados


y sus propiedades. Si se usa sin parámetros, driverquery se ejecuta en el equipo local.

Sintaxis

driverquery [/s <system> [/u [<domain>\]<username> [/p <password>]]] [/fo


{table | list | csv}] [/nh] [/v | /si]

Parámetros

Parámetro Descripción

/s <system> Especifica el nombre o la dirección IP de un equipo remoto. No use barras


diagonales inversas. La opción predeterminada es el equipo local.

/u Ejecuta el comando con las credenciales de la cuenta de usuario según lo


[<domain>] especificado por user o domain\user. De manera predeterminada, /s usa las
<username> credenciales del usuario que ha iniciado sesión en ese momento en el equipo que
emite el comando. /u no se puede usar a menos que se especifique /s.

/p Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u. /p


<password> no se puede usar a menos que se especifique /u.

/fo table Aplica al resultado un formato de tabla. Este es el valor predeterminado.

/fo list Formatea la salida como una lista.

/fo csv Formatea la salida con valores separados por comas.

/nh Omite la fila de encabezado de la información del controlador mostrada. No es


válido si el parámetro /fo está establecido en list.

/v Muestra la salida detallada. /v no es válido para los controladores firmados.

/si Proporciona información sobre los controladores firmados.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para mostrar una lista de controladores de dispositivo instalados en el equipo local,
escriba lo siguiente:

driverquery

Para mostrar la salida en un formato de valores separados por comas (CSV), escriba lo
siguiente:

driverquery /fo csv

Para ocultar la fila de encabezado en la salida, escriba lo siguiente:

driverquery /nh

Para usar el comando driverquery en un servidor remoto denominado server1 con las
credenciales actuales en el equipo local, escriba lo siguiente:

driverquery /s server1

Para usar el comando driverquery en un servidor remoto denominado server1 con las
credenciales para user1 en el dominio maindom, escriba lo siguiente:

driverquery /s server1 /u maindom\user1 /p p@ssw3d

Vínculos relacionados
Clave de sintaxis de línea de comandos
echo
Artículo • 06/10/2023

Muestra mensajes o activa o desactiva la característica de eco de comandos. Si se usa


sin parámetros, echo muestra la configuración de eco actual.

Sintaxis

echo [<message>]
echo [on | off]

Parámetros

Parámetro Descripción

[on | off] Activa o desactiva la característica de eco de comandos. El eco de comando se


encuentra habilitado de manera predeterminada.

<message> Especifica el texto que se va a mostrar en la pantalla.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

El comando echo <message> es más útil cuando el eco está desactivado. Para
mostrar un mensaje de varias líneas sin mostrar ningún comando, puede incluir
varios comandos echo <message> después del comando echo off en el programa
por lotes.

Después de desactivar echo, el símbolo del sistema no aparece en la ventana del


símbolo del sistema. Para mostrar el símbolo del sistema, escriba echo on.

Si se usa un archivo por lotes, echo on y echo off no afectan la configuración en el


símbolo del sistema.

Si hubiera una variable vacía en un archivo por lotes mientras se usa el eco, se
mostrará "El ECO está desactivado". Para evitar ver este mensaje y generar una
línea en blanco en su lugar, coloque dos puntos ( : ) entre el eco y la variable. Por
ejemplo, echo:%var% .
Para evitar la repetición de un comando determinado en un archivo por lotes,
inserte un signo ( @ ) antes del comando. Para evitar la repetición de todos los
comandos de un archivo por lotes, incluya el comando echo off al principio del
archivo.

Para mostrar un signo de exclamación ( ! ) en scripts por lotes, encapsule la palabra


o frase entre comillas dobles seguidas de un símbolo de intercalación antes del
signo de exclamación ( "Hello World^!" ). También se puede usar un símbolo de
intercalación doble ( ^^ ) sin necesidad de comillas dobles ( Hello World^^! ).

Para mostrar una barra vertical ( | ), una Y comercial ( & ) o un carácter de


redireccionamiento ( < o > ) cuando se usa eco, use un símbolo de intercalación
( ^ ) inmediatamente antes de ese carácter. Por ejemplo: ^| , ^& , ^> o ^< . Para
mostrar un símbolo de intercalación, escriba dos símbolos de intercalación
seguidos ( ^^ ).

Ejemplos
Para mostrar la configuración actual de echo, escriba:

echo

Para repetir una línea blanca en la pantalla, escriba:

echo.

7 Nota

No incluya un espacio antes del punto. De lo contrario, aparecerá el punto en lugar


de una línea blanca.

Para evitar los comandos de eco en el símbolo del sistema, escriba:

echo off
7 Nota

Una vez que se desactiva echo, el símbolo del sistema no aparece en la ventana del
símbolo del sistema. Para volver a mostrar el símbolo del sistema, escriba echo on.

Para evitar que todos los comandos de un archivo por lotes (incluido el comando echo
off) se muestren en la pantalla, en la primera línea del archivo por lotes, escriba:

@echo off

Puede usar el comando echo como parte de una instrucción if. Por ejemplo, para buscar
en el directorio actual cualquier archivo con la extensión de nombre de archivo .rpt y
para mostrar un mensaje si se encuentra este archivo, escriba:

if exist *.rpt echo The report has arrived.

El archivo por lotes siguiente busca en el directorio actual los archivos con la extensión
de nombre de archivo .txt y muestra un mensaje que indica los resultados de la
búsqueda:

@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
)

Si no se encuentra ningún archivo .txt cuando se ejecuta el archivo por lotes, se muestra
el mensaje siguiente:

This directory contains no text files.


Si se encuentran archivos .txt cuando se ejecuta el archivo por lotes, se muestra la salida
siguiente (por ejemplo, supongamos que los archivos File1.txt, File2.txt y File3.txt
existen):

This directory contains the following text files:


File1.txt
File2.txt
File3.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos
edición
Artículo • 12/04/2023

Inicia el Editor de MS-DOS, que crea y cambia los archivos de texto ASCII.

Sintaxis

edit [/b] [/h] [/r] [/s] [/<nnn>] [[<drive>:][<path>]<filename> [<filename2>


[...]]

Parámetros

Parámetro Descripción

[<drive>:] Especifica la ubicación y el nombre de uno o varios archivos de texto ASCII. Si el


[<path>] archivo no existe, el Editor de MS-DOS Editor lo crea. Si el archivo existe, el Editor
<filename> de MS-DOS lo abre y muestra su contenido en la pantalla. La opción filename
[<filename2> puede contener caracteres comodín (* y ?). Separe varios nombres de archivos con
[...]] espacios.

/b Fuerza el modo monocromo, para que el Editor de MS-DOS se muestre en blanco


y negro.

/h Muestra el número máximo de líneas posibles para el monitor actual.

/r Carga los archivos en modo de solo lectura.

/s Fuerza el uso de nombres de archivo cortos.

<nnn> Carga archivos binarios, encapsulando líneas a nnn caracteres de ancho.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Para obtener ayuda adicional, abra el Editor de MS-DOS y presione la tecla F1.

Algunos monitores no admiten la visualización de teclas de método abreviado de


forma predeterminada. Si el monitor no muestra las teclas de método abreviado,
use /b.
Ejemplos
Para abrir el Editor de MS-DOS, escriba lo siguiente:

edit

Para crear y editar un archivo denominado newtextfile.txt en el directorio actual, escriba


lo siguiente:

edit newtextfile.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos
endlocal
Artículo • 14/04/2023

Finaliza la localización de los cambios de entorno en un archivo por lotes y restaura las
variables de entorno a sus valores antes de que se ejecutara el comando setlocal
correspondiente.

Sintaxis

endlocal

Parámetros

Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
El comando endlocal no tiene ningún efecto fuera de un script o un archivo por
lotes.

Hay un comando endlocal implícito al final de un archivo por lotes.

Si las extensiones de comandos están habilitadas (las extensiones de comandos


están habilitadas de manera predeterminada), el comando endlocal restaura el
estado de las extensiones de comando (es decir, habilitadas o deshabilitadas) a lo
que estaba antes de que se ejecutara el comando setlocal correspondiente.

7 Nota

Para más información sobre cómo habilitar y deshabilitar extensiones de


comandos, consulte el comando Cmd.

Ejemplos
Puede localizar variables de entorno en un archivo por lotes. Por ejemplo, el programa
siguiente inicia el programa por lotes superapps en la red, dirige la salida a un archivo y
muestra el archivo en el Bloc de notas:

@echo off
setlocal
path=g:\programs\superapp;%path%
call superapp>c:\superapp.out
endlocal
start notepad c:\superapp.out

Vínculos relacionados
Clave de sintaxis de línea de comandos
end restore
Artículo • 12/04/2023

Finaliza una sesión de restauración y emite un evento PostRestore a los escritores


implicados.

Sintaxis

end restore

Vínculos relacionados
Clave de sintaxis de línea de comandos
erase
Artículo • 14/04/2023

Elimina uno o varios archivos. Si usa erase para eliminar un archivo del disco, no podrá
recuperarlo.

7 Nota

Este comando es el mismo que el comando del.

Sintaxis

erase [/p] [/f] [/s] [/q] [/a[:]<attributes>] <names>


del [/p] [/f] [/s] [/q] [/a[:]<attributes>] <names>

Parámetros

Parámetro Descripción

<names> Especifica una lista de uno o varios archivos o directorios. Los caracteres
comodín se pueden usar para eliminar varios archivos. Si especifica un
directorio, se eliminarán todos los archivos que contenga.

/p Solicita confirmación antes de eliminar el archivo especificado.

/f Fuerza la eliminación de archivos de solo lectura.

/s Elimina los archivos especificados del directorio actual y de todos los


subdirectorios. Muestra los nombres de los archivos a medida que se
eliminan.

/q Especifica el modo silencioso. No se le pedirá confirmación de eliminación.


Parámetro Descripción

/a[:] <attributes> Elimina los archivos en función de los siguientes atributos de archivo:
r Archivos de solo lectura
h Archivos ocultos
i Archivos no indexados por contenido
s Archivos de sistema
a Archivos listos para archivar
l Puntos de repetición de análisis
- Se usa como prefijo que significa “no”

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Si usa el comando erase /p , verá el siguiente mensaje:

FileName, Delete (Y/N)?

Para confirmar la eliminación, presione Y. Para cancelar la eliminación y mostrar el


siguiente nombre de archivo (si especificó un grupo de archivos), presione N. Para
detener el comando erase, presione CTRL+C.

Si deshabilita la extensión de comando, el parámetro /s mostrará los nombres de


los archivos que no se encontraron, en lugar de mostrar los nombres de los
archivos que se van a eliminar.

Si especifica carpetas concretas en el parámetro <names> , también se eliminarán


todos los archivos incluidos. Por ejemplo, si desea eliminar todos los archivos de la
carpeta \work, escriba lo siguiente:

erase \work

Puede usar caracteres comodín (* and ?) para eliminar más de un archivo a la vez.
Sin embargo, para evitar eliminar archivos involuntariamente, debe usar caracteres
comodín con precaución. Por ejemplo, si escribe el siguiente comando:

erase *.*

El comando erase muestra el siguiente símbolo del sistema:


Are you sure (Y/N)?

Para eliminar todos los archivos del directorio actual, presione Y y, a continuación,
presione ENTRAR. Para cancelar la eliminación, presione N y, a continuación,
presione ENTRAR.

7 Nota

Antes de usar caracteres comodín con el comando erase, use los mismos
caracteres comodín con el comando dir para enumerar todos los archivos que
se eliminarán.

Ejemplos
Para eliminar todos los archivos de una carpeta denominada Test en la unidad C, escriba
cualquiera de las siguientes opciones:

erase c:\test
erase c:\test\*.*

Para eliminar todos los archivos con la extensión de nombre de archivo .bat del
directorio actual, escriba lo siguiente:

erase *.bat

Para eliminar todos los archivos de solo lectura del directorio actual, escriba lo siguiente:

erase /a:r *.*

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando del
eventcreate
Artículo • 14/04/2023

Permite a un administrador crear un evento personalizado en un registro de eventos


especificado.

) Importante

Los eventos personalizados no se pueden escribir en el registro de seguridad.

Sintaxis

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 Descripción

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (no se pueden


usar barras diagonales inversas). La opción predeterminada es el equipo
local.

/u <domain\user> Ejecuta el comando con los permisos de cuenta del usuario especificado
por <user> o <domain\user> . El valor predeterminado son los permisos del
usuario que ha iniciado sesión actualmente en el equipo que emite el
comando.

/p <password> Especifica la contraseña de la cuenta de usuario especificada en el


parámetro /u.

/l {APPLICATION | Especifica el nombre del registro de eventos donde se creará el evento.


SYSTEM} Los nombres de registro válidos son APPLICATION o SYSTEM.

/so <srcname> Especifica el origen que se va a usar para el evento. Un origen válido
puede ser cualquier cadena y debe representar la aplicación o
componente que está generando el evento.
Parámetro Descripción

/t {ERROR | WARNING Especifica el tipo de evento que se va a crear. Los tipos válidos son ERROR,
| INFORMATION | WARNING, INFORMATION, SUCCESSAUDIT y FAILUREAUDIT.
SUCCESSAUDIT |
FAILUREAUDIT}

/id <eventID> Especifica el id. para el evento. Un id. válido es cualquier número
comprendido entre 1 y 1000.

/d <description> Especifica la descripción que se va a usar para el evento recién creado.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
En los ejemplos siguientes se muestra cómo puede usar el 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"

Vínculos relacionados
Clave de sintaxis de línea de comandos
evntcmd
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Configura la traducción de eventos en capturas, destinos de captura o ambos, en


función de la información de un archivo de configuración.

Sintaxis

evntcmd [/s <computername>] [/v <verbositylevel>] [/n] <filename>

Parámetros

Parámetro Descripción

/s <computername> Especifica, por nombre, el equipo en el que desea configurar la traducción de


eventos en capturas, destinos de captura o ambos. Si no especifica un
equipo, la configuración se produce en el equipo local.

/v Especifica qué tipos de mensajes de estado aparecen cuando se configuran


<verbositylevel> capturas y destinos de captura. Este parámetro debe ser un entero
comprendido entre 0 y 10. Si especifica 10, aparecen todo tipo de mensajes,
como mensajes de seguimiento y advertencias sobre si la configuración de
captura se realizó correctamente. Si especifica 0, no aparecerá ningún
mensaje.

/n Especifica que el servicio SNMP no se debe reiniciar si este equipo recibe


cambios de configuración de captura.

<filename> Especifica, por nombre, el archivo de configuración que contiene información


sobre la traducción de eventos en capturas y destinos de captura que desea
configurar.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si desea configurar capturas pero no destinos de captura, puede crear un archivo
de configuración válido mediante el Traductor de evento a captura, que es una
utilidad gráfica. Si tiene instalado el servicio SNMP, puede iniciar el Traductor de
evento a captura escribiendo evntwin en un símbolo del sistema. Después de
definir las capturas, haga clic en Exportar para crear un archivo adecuado para
usarlo con evntcmd. Puede usar el Traductor de evento a captura para crear
fácilmente un archivo de configuración y, a continuación, usar el archivo de
configuración con evntcmd en el símbolo del sistema para configurar rápidamente
capturas en varios equipos.

La sintaxis para configurar una captura es la siguiente:

#pragma add <eventlogfile> <eventsource> <eventID> [<count> [<period>]]

Donde el texto siguiente es true:

#pragma debe aparecer al principio de todas las entradas del archivo.

El parámetro add especifica que desea agregar una configuración de evento a


captura.

Se requieren los parámetros eventlogfile, eventsource y eventID. eventlogfile


especifica el archivo en el que se registra el evento, eventsource especifica la
aplicación que genera el evento y eventID especifica el número único que
identifica cada evento.

Para determinar qué valores corresponden a cada evento, inicie el Traductor de


evento a captura escribiendo evntwin en un símbolo del sistema. Haga clic en
Personalizar y, a continuación, haga clic en Editar. En Orígenes de eventos,
examine las carpetas hasta que localice el evento que desea configurar, haga clic
en él y, a continuación, haga clic en Agregar. La información sobre el origen del
evento, el archivo de registro de eventos y el identificador de evento aparecen en
Origen, Registro e Identificador específico de captura, respectivamente.

El parámetro count es opcional y especifica cuántas veces debe producirse el


evento antes de enviar un mensaje de captura. Si no usa este parámetro, el
mensaje de captura se envía después de que el evento se produzca una vez.

El parámetro period es opcional, pero requiere el uso del parámetro count. El


parámetro period especifica un período de tiempo (en segundos) durante el
cual el evento debe producirse el número de veces especificado con el
parámetro count antes de enviar un mensaje de captura. Si no usa este
parámetro, se envía un mensaje de captura después de que el evento se
produzca el número de veces especificado con el parámetro count,
independientemente del tiempo transcurrido entre repeticiones.

La sintaxis para quitar una captura es la siguiente:

#pragma delete <eventlogfile> <eventsource> <eventID>

Donde el texto siguiente es true:

#pragma debe aparecer al principio de todas las entradas del archivo.

El parámetro delete especifica que desea quitar una configuración de evento a


captura.

Se requieren los parámetros eventlogfile, eventsource y eventID. eventlogfile


especifica el archivo en el que se registra el evento, eventsource especifica la
aplicación que genera el evento y eventID especifica el número único que
identifica cada evento.

Para determinar qué valores corresponden a cada evento, inicie el Traductor de


evento a captura escribiendo evntwin en un símbolo del sistema. Haga clic en
Personalizar y, a continuación, haga clic en Editar. En Orígenes de eventos,
examine las carpetas hasta que localice el evento que desea configurar, haga clic
en él y, a continuación, haga clic en Agregar. La información sobre el origen del
evento, el archivo de registro de eventos y el identificador de evento aparecen en
Origen, Registro e Identificador específico de captura, respectivamente.

La sintaxis para configurar un destino de captura es la siguiente:

#pragma add_TRAP_DEST <communityname> <hostID>

Donde el texto siguiente es true:

#pragma debe aparecer al principio de todas las entradas del archivo.

El parámetro add_TRAP_DEST especifica que quiere que los mensajes de


captura se envíen a un host especificado dentro de una comunidad.

El parámetro communityname especifica, por nombre, la comunidad en la que


se envían los mensajes de captura.
El parámetro hostID especifica, por nombre o dirección IP, el host al que desea
enviar los mensajes de captura.

La sintaxis para eliminar un destino de captura es la siguiente:

#pragma delete_TRAP_DEST <communityname> <hostID>

Donde el texto siguiente es true:

#pragma debe aparecer al principio de todas las entradas del archivo.

El parámetro delete_TRAP_DEST especifica que no quiere que los mensajes de


captura se envíen a un host especificado dentro de una comunidad.

El parámetro communityname especifica, por nombre, la comunidad en la que


no deben enviarse los mensajes de captura.

El parámetro hostID especifica, por nombre o dirección IP, el host al que no


desea enviar los mensajes de captura.

Ejemplos
En los ejemplos siguientes se muestran entradas del archivo de configuración para el
comando evntcmd. No están diseñados para escribirse en un símbolo del sistema.

Para enviar un mensaje de captura si se reinicia el servicio de Registro de eventos,


escriba lo siguiente:

#pragma add System Eventlog 2147489653

Para enviar un mensaje de captura si el servicio de Registro de eventos se reinicia dos


veces en tres minutos, escriba lo siguiente:

#pragma add System Eventlog 2147489653 2 180

Para no enviar un mensaje de captura si se reinicia el servicio de Registro de eventos,


escriba lo siguiente:
#pragma delete System Eventlog 2147489653

Para enviar mensajes de captura dentro de la comunidad denominada Public al host con
la dirección IP 192.168.100.100, escriba lo siguiente:

#pragma add_TRAP_DEST public 192.168.100.100

Para enviar mensajes de captura dentro de la comunidad denominada Private al host


denominado Host1, escriba lo siguiente:

#pragma add_TRAP_DEST private Host1

Para dejar de enviar mensajes de captura dentro de la comunidad denominada Private


al mismo equipo en el que se configuran destinos de captura, escriba lo siguiente:

#pragma delete_TRAP_DEST private localhost

Vínculos relacionados
Clave de sintaxis de línea de comandos
exec
Artículo • 14/04/2023

Ejecuta un archivo de script en el equipo local. Este comando también duplica o restaura
datos como parte de una secuencia de copia de seguridad o restauración. Si se produce
un error en el script, se devuelve un error y DiskShadow se cierra.

El archivo puede ser un script cmd.

Sintaxis

exec <scriptfile.cmd>

Parámetros

Parámetro Descripción

<scriptfile.cmd> Especifica la ruta de acceso del archivo script.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando diskshadow
exit
Artículo • 12/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Sale del intérprete de comandos o del script por lotes actual.

Sintaxis

exit [/b] [<exitcode>]

Parámetros

Parámetro Descripción

/b Sale del script por lotes actual en lugar de salir de Cmd.exe. Si se ejecuta desde
fuera de un script por lotes, sale de Cmd.exe.

<exitcode> Especifica un número numérico. Si se especifica /b, la variable de entorno


ERRORLEVEL se establece en ese número. Si sale del intérprete de comandos, el
código de salida del proceso se establece en ese número.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para cerrar el intérprete de comandos, escriba:

exit

Vínculos relacionados
Clave de sintaxis de línea de comandos
expand
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Expande uno o más archivos comprimidos. También puede usar este comando para
recuperar archivos comprimidos de discos de distribución.

El comando expand también se puede ejecutar desde la Consola de recuperación de


Windows mediante parámetros diferentes. Para obtener más información, consulte
Entorno de recuperación de Windows (WinRE).

Sintaxis

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 Descripción

-r Cambia el nombre de los archivos expandidos.

source Especifica los archivos que se van a expandir. El valor de origen puede ser una letra
de unidad con dos puntos, un nombre de directorio, un nombre de archivo o una
combinación de varios de estos elementos. Puede usar caracteres comodín (* o ?).

destination Especifica la ubicación donde se van a expandir los archivos.


Si el valor de origen consta de varios archivos y no especifica -r, el valor de destino
debe ser un directorio que ya exista. El valor de destino puede ser una letra de
unidad con dos puntos, un nombre de directorio, un nombre de archivo o una
combinación de varios de estos elementos. Especificación de destino file \| path .

-i Cambia el nombre de los archivos expandidos, pero omite la estructura de


directorios.
Parámetro Descripción

-d Muestra una lista de los archivos que se encuentran en el origen. No expande ni


extrae los archivos.

-f: <files> Especifica los archivos de un archivo .cab que quiera expandir. Puede usar caracteres
comodín (* o ?).

/? Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
expand vdisk
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Expande un disco duro virtual (VHD) a un tamaño especificado.

Se debe seleccionar un VHD para que esta operación se realice correctamente. Use el
comando select vdisk para seleccionar un volumen y cambiar la concentración a él.

Sintaxis

expand vdisk maximum=<n>

Parámetros

Parámetro Descripción

maximum= <n> Especifica el nuevo tamaño del VHD en megabytes (MB).

Ejemplos
Para expandir el VHD seleccionado a 20 GB, escriba:

expand vdisk maximum=20000

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando select vdisk

Comando attach vdisk


comando compact vdisk

Comando detach vdisk

Comando detail vdisk

Comando merge vdisk

Comando list
expose
Artículo • 12/04/2023

Expone una instantánea persistente como una letra de unidad, un recurso compartido o
un punto de montaje.

Sintaxis

expose <shadowID> {<drive:> | <share> | <mountpoint>}

Parámetros

Parámetro Descripción

shadowID Especifica el id. de la instantánea que desea exponer. También puede usar un alias
existente o una variable de entorno en lugar de shadowID. Use add sin
parámetros para ver los alias existentes.

<drive:> Expone la instantánea especificada como una letra de unidad (por ejemplo, p: ).

<share> Expone la instantánea especificada en un recurso compartido (por ejemplo,


\\machinename ).

<mountpoint> Expone la instantánea especificada a un punto de montaje (por ejemplo,


C:\shadowcopy ).

Ejemplos
Para exponer la instantánea persistente asociada a la variable de entorno
VSS_SHADOW_1 como unidad X, escriba:

expose %vss_shadow_1% x:

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando diskshadow
extend
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Extiende el volumen o partición que recibe el enfoque y su sistema de archivos en


espacio disponible (sin asignar) en un disco.

Sintaxis

extend [size=<n>] [disk=<n>] [noerr]


extend filesystem [noerr]

Parámetros

Parámetro Descripción

size= <n> Especifica la cantidad de espacio, en megabytes (MB), que se van a agregar a la
partición o volumen actual. Si no se proporciona ningún tamaño, se usa todo el
espacio libre contiguo que está disponible en el disco.

disk= <n> Especifica el disco en el que se extiende el volumen o la partición. Si no se especifica


ningún disco, el volumen o la partición se extiende al disco actual.

fileSystem Extiende el sistema de archivos del volumen que recibe el enfoque. Para usar solo
en discos en los que el sistema de archivos no se extendió con el volumen.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Comentarios
En los discos básicos, el espacio disponible debe estar en el mismo disco que el
volumen o la partición que recibe el enfoque. También debe seguir
inmediatamente el volumen o la partición que recibe el enfoque (es decir, debe
comenzar en el siguiente desplazamiento del sector).
En discos dinámicos con volúmenes simples o distribuidos, un volumen puede
extenderse a cualquier espacio disponible de un disco dinámico. Con este
comando, puede convertir un volumen dinámico simple en un volumen dinámico
distribuido. No se pueden ampliar los volúmenes reflejados, RAID-5 y seccionados.

Si la partición se ha formateado previamente con el sistema de archivos NTFS, el


sistema de archivos se extiende automáticamente para rellenar la partición de
mayor tamaño y no se pierde ningún dato.

Si la partición se ha formateado anteriormente con cualquier sistema de archivos


que no sea NTFS, se producirá un error en el comando y no se realizarán cambios
en la partición.

Si la partición no se ha formateado previamente con un sistema de archivos, la


partición se seguirá ampliando.

La partición debe tener un volumen asociado antes de que se pueda extender.

Ejemplos
Para ampliar el volumen o la partición que recibe el enfoque en 500 megabytes, en el
disco 3, escriba lo siguiente:

extend size=500 disk=3

Para extender el sistema de archivos de un volumen después de extenderlo, escriba lo


siguiente:

extend filesystem

Vínculos relacionados
Clave de sintaxis de línea de comandos
extract / extrac32
Artículo • 12/04/2023

Extrae archivos de un contenedor u origen.

7 Nota

En Windows Server 2016 y versiones posteriores, y en Windows 10, el archivo de


programa Extract.exe no se proporciona ni se admite. Se reemplaza por
Extrac32.exe, originalmente parte de Internet Explorer, ahora parte del sistema
operativo.

Sintaxis

Extract.exe

extract [/y] [/a] [/d | /e] [/l dir] cabinet [filename ...]
extract [/y] source [newname]
extract [/y] /c source destination

Parámetros

Parámetro Descripción

cabinet Úselo si desea extraer dos o más archivos.

filename Nombre del archivo que se va a extraer del contenedor. Se pueden usar
caracteres comodín y varios nombres de archivo (separados por espacios en
blanco).

source Archivo comprimido (un contenedor con un solo archivo).

nuevoNombre Nuevo nombre de archivo para proporcionar al archivo extraído. Si no se


proporciona, se usa el nombre original.

/a Procesar TODOS los contenedores. Sigue la cadena de contenedores a partir del


primer contenedor mencionado.

/C Copie el archivo de origen en destino (para copiar desde discos DMF).


Parámetro Descripción

/d Mostrar el directorio del contenedor (use con el nombre de archivo para evitar la
extracción).

/e Extraer (úselo en lugar de . para extraer todos los archivos).

/l dir Ubicación para colocar los archivos extraídos (el valor predeterminado es el
directorio actual).

/y No pregunte antes de sobrescribir un archivo existente.

Extrac32.exe

7 Nota

Extrac32.exe se puede usar desde la línea de comandos, pero no muestra ninguna


salida en la consola. Redirija la salida de ayuda a través del comando more, de la
siguiente manera: 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 Descripción

cabinet Archivo archivador (contiene dos o más archivos).

filename Nombre del archivo que se va a extraer del contenedor. Se pueden usar
caracteres comodín y varios nombres de archivo (separados por espacios en
blanco).

source Archivo comprimido (un contenedor con un solo archivo).

nuevoNombre Nuevo nombre de archivo para proporcionar al archivo extraído. Si no se


proporciona, se usa el nombre original.

/A Procesar TODOS los contenedores. Sigue la cadena de contenedores a partir del


primer contenedor mencionado.

/C Copie el archivo de origen en destino (para copiar desde discos DMF).


Parámetro Descripción

/D Mostrar el directorio del contenedor (use con el nombre de archivo para evitar la
extracción).

/E Extraer (úselo en lugar de . para extraer todos los archivos).

/L dir Ubicación para colocar los archivos extraídos (el valor predeterminado es el
directorio actual).

/Y No pregunte antes de sobrescribir un archivo existente.

Vínculos relacionados
Clave de sintaxis de línea de comandos
fc
Artículo • 12/04/2023

Compara dos archivos o conjuntos de archivos y muestra las diferencias entre ellos.

Sintaxis

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 Descripción

/a Abrevia la salida de una comparación ASCII. En lugar de mostrar todas las líneas
que son diferentes, fc muestra solo la primera y la última línea para cada conjunto
de diferencias.

/b Compara los dos archivos en modo binario, byte por byte, y no intenta volver a
sincronizar los archivos después de encontrar un error de coincidencia. Este es el
modo predeterminado para comparar archivos que tienen las siguientes
extensiones de archivo: .exe, .com, .sys, .obj, .lib o .bin.

/C Omite si la letra está en mayúscula o minúscula.

/l Compara los archivos en modo ASCII, línea a línea e intenta volver a sincronizar los
archivos después de encontrar un error de coincidencia. Este es el modo
predeterminado para comparar archivos, excepto los que tienen las siguientes
extensiones de archivo: .exe, .com, .sys, .obj, .lib, o .bin.

/lb <n> Establece el número de líneas del búfer de línea interno en N. La longitud
predeterminada del búfer de líneas es de 100 líneas. Si los archivos que está
comparando tienen más de 100 líneas diferentes consecutivas, fc cancela la
comparación.

/n Muestra los números de línea durante una comparación ASCII.

/off[line] No omite los archivos que tienen establecido el atributo sin conexión.

/t Impide que fc convierta tabulaciones en espacios. El comportamiento


predeterminado es tratar las tabulaciones como espacios, con tabulaciones cada
ocho caracteres.
Parámetro Descripción

/U Compara archivos como archivos de texto Unicode.

/w Comprime el espacio en blanco (es decir, tabulaciones y espacios) durante la


comparación. Si una línea contiene varios espacios o tabulaciones consecutivos, /w
trata estos caracteres como un único espacio. Cuando se usa con /w, fc omite el
espacio en blanco al principio y al final de una línea.

/ <nnnn> Especifica el número de líneas consecutivas que deben coincidir después de un


error de coincidencia, antes de que fc considere que hay que volver a sincronizar
los archivos. Si el número de líneas coincidentes en los archivos es menor que
nnnn, fc muestra las líneas coincidentes como diferencias. El valor predeterminado
es 2.

[<drive1>:] Especifica la ubicación y el nombre del primer archivo o conjunto de archivos que
[<path1>] se va a comparar. filename1 es obligatorio.
<filename1>

[<drive2>:] Especifica la ubicación y el nombre del segundo archivo o conjunto de archivos


[<path2>] que se va a comparar. filename2 es obligatorio.
<filename2>

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Este comando se implementa mediante c:\WINDOWS\fc.exe. Puede usar este
comando en PowerShell, pero asegúrese de escribir el archivo ejecutable completo
(fc.exe), ya que "fc" también es un alias para Format-Custom.

Cuando se usa fc para una comparación ASCII, fc muestra las diferencias entre dos
archivos en el orden siguiente:

Nombre del primer archivo

Líneas de filename1 que difieren entre los archivos

Primera línea que debe coincidir en ambos archivos

Nombre del segundo archivo

Líneas de filename2 que difieren

Primera línea que debe coincidir

/b muestra errores de coincidencia que se encuentran durante una comparación


binaria en la sintaxis siguiente:
\<XXXXXXXX: YY ZZ>

El valor de XXXXXXXX especifica la dirección hexadecimal relativa para el par de


bytes, que se mide desde el principio del archivo. Las direcciones comienzan en
00000000. Los valores hexadecimales de YY y ZZ representan los bytes no
coincidentes de filename1 y filename2, respectivamente.

Puede usar caracteres comodín (* y ?) en filename1 y filename2. Si usa un carácter


comodín en filename1, fc compara todos los archivos especificados con el archivo
o conjunto de archivos especificados por filename2. Si usa un carácter comodín en
filename2, fc usa el valor correspondiente de filename1.

Al comparar archivos ASCII, fc usa un búfer interno (lo suficientemente grande


como para contener 100 líneas) como almacenamiento. Si los archivos son
mayores que el búfer, fc compara lo que puede cargar en el búfer. Si fc no
encuentra ninguna coincidencia en las partes cargadas de los archivos, se detiene y
muestra el mensaje siguiente:

Resynch failed. Files are too different.

Al comparar archivos binarios mayores que la memoria disponible, fc compara


ambos archivos por completo, superponiendo las partes en memoria con las
siguientes partes del disco. La salida es la misma que la de los archivos que caben
completamente en la memoria.

Ejemplos
Para realizar una comparación ASCII de dos archivos de texto, monthly.rpt y sales.rpt, y
mostrar los resultados en formato abreviado, escriba lo siguiente:

fc /a monthly.rpt sales.rpt

Para realizar una comparación binaria de dos archivos por lotes, profits.bat y
earnings.bat, escriba lo siguiente:

fc /b profits.bat earnings.bat

Aparecen resultados similares a los siguientes:


00000002: 72 43
00000004: 65 3A
0000000E: 56 92
000005E8: 00 6E
FC: earnings.bat longer than profits.bat

Si los archivos profits.bat y earnings.bat son idénticos, fc muestra el mensaje siguiente:

Comparing files profits.bat and earnings.bat


FC: no differences encountered

Para comparar cada archivo .bat en el directorio actual con el archivo new.bat, escriba lo
siguiente:

fc *.bat new.bat

Para comparar el archivo new.bat en la unidad C con el archivo new.bat en la unidad D,


escriba lo siguiente:

fc c:new.bat d:*.bat

Para comparar cada archivo por lotes en el directorio raíz de la unidad C con el mismo
nombre en el directorio raíz de la unidad D, escriba lo siguiente:

fc c:*.bat d:*.bat

Vínculos relacionados
Clave de sintaxis de línea de comandos
filesystems
Artículo • 12/04/2023

Muestra información sobre el sistema de archivos actual del volumen con foco y
enumera los sistemas de archivos que se admiten para dar formato al volumen.

Se debe seleccionar un volumen para que esta operación se realice correctamente. Use
el comando select volume para seleccionar un volumen y que reciba el enfoque.

Sintaxis

filesystems

Vínculos relacionados
Clave de sintaxis de línea de comandos
find
Artículo • 14/04/2023

Busca una cadena de texto en un archivo o archivos y muestra líneas de texto que
contienen la cadena especificada.

Sintaxis

find [/v] [/c] [/n] [/i] [/off[line]] <"string"> [[<drive>:][<path>]


<filename>[...]]

Parámetros

Parámetro Descripción

/v Muestra todas las líneas que no contienen el <string> especificado.

/C Cuenta las líneas que contienen el <string> especificado y muestra el


total.

/n Precede a cada línea con el número de línea del archivo.

/i Especifica que la búsqueda no distingue mayúsculas de minúsculas.

[/off[line]] No omite los archivos que tienen establecido el atributo sin conexión.

<"string"> Necesario. Especifica el grupo de caracteres (entre comillas) que desea


buscar.

[<drive>:][<path>] Especifica la ubicación y el nombre del archivo en el que se va a buscar


<filename> la cadena especificada.

/? Muestra la ayuda en el símbolo del sistema.

Códigos de salida

Código de Descripción
salida

0 Se encontró la cadena buscada.

1 Cadena buscada no encontrada


Código de Descripción
salida

2 No se encontró el archivo buscado o se ha especificado un modificador de línea


de comandos no válido

Comentarios

Si no usa /i, este comando busca exactamente lo que especifique para la cadena.
Por ejemplo, este comando trata los caracteres a y A de forma diferente. Sin
embargo, si usa /i, la búsqueda no distingue mayúsculas de minúsculas y trata a y
A como el mismo carácter.

Si la cadena que desea buscar contiene comillas, debe usar comillas dobles para
cada comilla contenida en la cadena (por ejemplo, """Esta cadena contiene
comillas""").

Si omite un nombre de archivo, este comando actúa como filtro, tomando la


entrada del origen de entrada estándar (normalmente el teclado, una pleca (|) o un
archivo redirigido) y, a continuación, muestra las líneas que contienen la cadena.

Para salir de la búsqueda de la consola, use CTRL-X o CTRL-z .

Puede escribir parámetros y opciones de línea de comandos para el comando find


en cualquier orden.

No puede usar caracteres comodín (* y ?) en la cadena buscada. Para buscar una


cadena con caracteres comodín y patrones regex, puede usar el comando
FINDSTR.

Si usa /c y /v en la misma línea de comandos, este comando muestra un recuento


de las líneas que no contienen la cadena especificada. Si especifica /c y /n en la
misma línea de comandos, find ignora /n.

Este comando no reconoce los retornos de carro. Cuando use este comando para
buscar texto en un archivo que incluya retornos de carro, debe limitar la cadena de
búsqueda al texto que se puede encontrar entre retornos de carro (es decir, una
cadena que no es probable que se interrumpa por un retorno de carro). Por
ejemplo, este comando no notifica una coincidencia para el archivo de impuesto
de cadena si se produce una devolución de carro entre las palabras impuesto y
archivo.
El comando acepta caracteres comodín para los nombres de archivo. Al buscar en
archivo (o archivos), imprimirá el archivo del archivo procesado precedido de diez
guiones.

El comando find no puede leer flujos de datos alternativos. Para buscar en flujos
de datos alternativos, use los comandos findstr, more o for /f.

Ejemplos
Para mostrar todas las líneas de pencil.md que contienen el tipo de cadena sacapuntas,
escriba:

find "pencil sharpener" pencil.md

Para encontrar el texto, “Los científicos etiquetaron su documento solo para la discusión.
No es un informe final.” (incluidas las comillas) en el archivo report.txt, escriba:

find """The scientists labeled their paper for discussion only. It is not a
final report.""" < report.txt

Para buscar un conjunto de archivos, puede usar caracteres comodín. Para buscar en el
directorio actual los archivos que tienen la extensión .bat y que contienen la cadena
PROMPT ignorando el caso, escriba:

find /i "PROMPT" *.bat

Para buscar nombres de archivos en un directorio que contenga la cadena CPU, use la
pleca (|) para dirigir la salida del comando dir al comando find de la siguiente manera:

dir c:\temp /s /b | find "CPU"

Busque todos los procesos en ejecución que NO contengan el agente:


tasklist | find /v /i "agent"

Compruebe si un servicio se está ejecutando:

sc query Winmgmt | find "RUNNING" >nul 2>&1 && (echo service is started) ||
(echo service is stopped)

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando findstr
findstr
Artículo • 14/04/2023

Busca patrones de texto en archivos.

Sintaxis

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 Descripción

/b Coincide con el patrón de texto si está al principio de una línea.

/e Coincide con el patrón de texto si está al final de una línea.

/l Procesa cadenas de búsqueda literalmente.

/r Procesa cadenas de búsqueda como expresiones regulares. Esta es la


configuración predeterminada.

/s Busca en el directorio actual y en todos los subdirectorios.

/i Omite el caso de los caracteres al buscar la cadena.

/x Imprime líneas que coinciden exactamente.

/v Imprime solo líneas que no contienen una coincidencia.

/n Imprime el número de línea de cada línea que coincida.

/m Imprime solo el nombre de archivo si un archivo contiene una


coincidencia.

/o Imprime el desplazamiento de caracteres antes de cada línea coincidente.

/p Omite los archivos con caracteres no imprimibles.

/off[line] No omite los archivos que tienen establecido el atributo sin conexión.

/f: <file> Obtiene una lista de archivos del archivo especificado.


Parámetro Descripción

/c: <string> Usa el texto especificado como una cadena de búsqueda literal.

/g: <file> Obtiene cadenas de búsqueda del archivo especificado.

/d: <dirlist> Busca en la lista especificada de directorios. Cada directorio debe estar
separado con un punto y coma (;), por ejemplo dir1;dir2;dir3 .

/a: <colorattribute> Especifica atributos de color con dos dígitos hexadecimales. Escriba color
/? para obtener información adicional.

<strings> Especifica el texto que se va a buscar en el nombre de archivo. Necesario.

[\<drive>:] Especifica la ubicación y los archivos que se van a buscar. Se requiere al


[<path>]<filename> menos un archivo.
[...]

/? Muestra la Ayuda en el símbolo del sistema.

Notas
Todas las opciones de línea de comandos findstr deben preceder a cadenas y
nombre de archivo en la cadena de comandos.

Las expresiones regulares usan caracteres literales y metacaracteres para buscar


patrones de texto, en lugar de cadenas exactas de caracteres.

Un carácter literal es un carácter que no tiene un significado especial en la


sintaxis de expresión regular; en su lugar, coincide con una aparición de ese
carácter. Por ejemplo, las letras y los números son caracteres literales.

Un metacarácter es un símbolo con significado especial (un operador o


delimitador) en la sintaxis de expresión regular.

Los metacaracteres aceptados son:

Metacarácter Valor

. Carácter comodín: cualquier carácter

* Repetir: cero o más repeticiones del carácter o clase anterior

^ Posición de línea inicial: principio de la línea

$ Posición final de la línea: final de la línea

[class] Clase de caracteres: cualquier carácter de un conjunto


Metacarácter Valor

[^class] Clase inversa: cualquier carácter que no esté en un conjunto

[x-y] Intervalo: cualquier carácter dentro del intervalo especificado

\x Escape: uso literal de un metacarácter

\<string Posición inicial de la palabra: principio de la palabra

string\> Posición final de la palabra: final de la palabra

Los caracteres especiales de la sintaxis de expresiones regulares tienen más


potencia al usarlos juntos. Por ejemplo, use la combinación del carácter
comodín ( . ) y repita ( * ) para que coincida con cualquier cadena de caracteres:
.* .

Use la siguiente expresión como parte de una expresión mayor para hacer
coincidir cualquier cadena que comienza por b y termina con ing: b.*ing

Para buscar varias cadenas en un conjunto de archivos, debe crear un archivo de


texto que contenga cada criterio de búsqueda en una línea independiente.

Use espacios para separar varias cadenas de búsqueda a menos que el argumento
tenga el prefijo /c.

Ejemplos
Para buscar hello o there el archivo x.y, escriba:

findstr hello there x.y

Para buscar hello there el archivo x.y, escriba:

findstr /c:"hello there" x.y

Para buscar todas las apariciones de la palabra Windows (con una letra mayúscula inicial
W) en el archivo proposal.txt, escriba:
findstr Windows proposal.txt

Para buscar en todos los archivos del directorio actual y todos los subdirectorios que
contenían la palabra Windows, independientemente de las mayúsculas y minúsculas,
escriba:

findstr /s /i Windows *.*

Para buscar todas las apariciones de líneas que comienzan por FOR y van precedidas
por cero o más espacios (como en un bucle de programa de equipo) y para mostrar el
número de línea donde se encuentra cada repetición, escriba:

findstr /b /n /r /c:^ *FOR *.bas

Para enumerar los archivos exactos que desea buscar en un archivo de texto, use los
criterios de búsqueda del archivo stringlist.txt, para buscar los archivos enumerados
filelist.txt, a continuación, para almacenar los resultados en el archivo results.out, escriba:

findstr /g:stringlist.txt /f:filelist.txt > results.out

Para enumerar todos los archivos que contienen la palabra computer dentro del
directorio actual y todos los subdirectorios, independientemente de las mayúsculas y
minúsculas, escriba:

findstr /s /i /m \<computer\> *.*

Para enumerar todos los archivos que contengan la palabra “computer“ y cualquier otra
palabra que comience por comp (por ejemplo, complementar y competir), escriba:

findstr /s /i /m \<comp.* *.*


Vínculos relacionados
Clave de sintaxis de línea de comandos
finger
Artículo • 05/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre los usuarios en un equipo remoto específico (normalmente


un equipo que ejecuta UNIX) que ejecuta el servicio finger o demonio. El equipo remoto
especifica el formato y la salida de la presentación de la información del usuario. Si se
usa sin parámetros, el finger muestra ayuda.

) Importante

Este comando solo está disponible si el Protocolo de Internet (TCP/IP) está


instalado como componente en las propiedades de un adaptador de red en
Conexiones de red.

Sintaxis

finger [-l] [<user>] [@<host>] [...]

Parámetros

Parámetro Descripción

-l Muestra la información del usuario en formato de lista larga.

<user> Especifica el usuario sobre el que desea obtener información. Si omite el parámetro
user, este comando muestra información sobre todos los usuarios del equipo
especificado.

@<host> Especifica el equipo remoto que ejecuta el servicio finger donde está buscando
información de usuario. Puede especificar un nombre de equipo o una dirección IP.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Debe prefijar los parámetros finger con un guion (-) en lugar de una barra ( / ).

Se pueden especificar varios user@host parámetros.

Ejemplos
Para mostrar información de usuario1 en el equipo users.microsoft.com, escriba:

finger user1@users.microsoft.com

Para mostrar información de todos los usuarios del equipo users.microsoft.com, escriba:

finger @users.microsoft.com

Vínculos relacionados
Clave de sintaxis de línea de comandos
flattemp
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Habilita o deshabilita carpetas temporales planas. Debe tener credenciales


administrativas para ejecutar este comando.

7 Nota

Este comando solo está disponible si instaló el servicio de rol Host de sesión de
Escritorio remoto.

Sintaxis

flattemp {/query | /enable | /disable}

Parámetros

Parámetro Descripción

/query Consulta la configuración actual.

/enable Habilita carpetas temporales planas. Los usuarios compartirán la carpeta temporal a
menos que esta resida en la carpeta principal del usuario.

/disable Deshabilita carpetas temporales planas. La carpeta temporal de cada usuario


residirá en una carpeta independiente (determinada por el identificador de sesión
del usuario).

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Después de que cada usuario tenga una carpeta temporal única, use flattemp
/enable para habilitar las carpetas temporales planas.
El método predeterminado para crear carpetas temporales para varios usuarios (a
las que habitualmente apuntan las variables de entorno TEMP y TMP) es crear
subcarpetas en la carpeta \Temp, con el logonID como el nombre de la
subcarpeta. Por ejemplo, si la variable de entorno TEMP apunta a C:\Temp, la
carpeta temporal asignada al logonID 4 del usuario es C:\Temp\4.

Con flattemp, puede apuntar directamente a la carpeta \Temp y evitar que se


formen subcarpetas. Esto resulta útil cuando desea que las carpetas temporales de
usuario estén contenidas en carpetas principales, ya sea en una unidad local del
servidor host de sesión de Escritorio remoto o en una unidad de red compartida.
Debe usar el comando flattemp /enable* solo cuando cada usuario tenga una
carpeta temporal independiente.

Es posible que encuentre errores de aplicación si la carpeta temporal del usuario


está en una unidad de red. Esto ocurre cuando la unidad de red compartida se
vuelve inaccesible en la red de manera momentánea. Dado que los archivos
temporales de la aplicación no son accesibles o no están sincronizados, responde
como si se hubiera tenido el disco. No se recomienda mover la carpeta temporal a
una unidad de red. El valor predeterminado es mantener las carpetas temporales
en el disco duro local. Si experimenta errores de comportamiento inesperado o
daños en el disco con determinadas aplicaciones, estabilice la red o vuelva a mover
las carpetas temporales al disco duro local.

Si deshabilita el uso de carpetas temporales independientes por sesión, se omite la


configuración flattemp. Esta opción se establece en la herramienta de
configuración de Servicios de Escritorio remoto.

Ejemplos
Para mostrar la configuración actual de las carpetas temporales planas, escriba:

flattemp /query

Para habilitar las carpetas temporales planas, escriba:

flattemp /enable

Para deshabilitar las carpetas temporales planas, escriba:


flattemp /disable

Vínculos relacionados
Clave de sintaxis de línea de comandos
fondue
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Habilita las características opcionales de Windows descargando los archivos necesarios


de Windows Update u otro origen especificado por la directiva de grupo. El archivo de
manifiesto de la característica ya debe estar instalado en la imagen de Windows.

Sintaxis

fondue.exe /enable-feature:<feature_name> [/caller-name:<program_name>]


[/hide-ux:{all | rebootrequest}]

Parámetros

Parámetro Descripción

/enable-feature: Especifica el nombre de la característica opcional de Windows que


<feature_name> desea habilitar. Solo puede habilitar una característica por línea de
comandos. Para habilitar varias características, use fondue.exe para cada
característica.

/caller-name: Especifica el nombre del programa o proceso cuando llama a


<program_name> fondue.exe desde un script o archivo por lotes. Puede usar esta opción
para agregar el nombre del programa al informe de SQM si se produce
un error.

/hide-ux: {all | Use all para ocultar todos los mensajes al usuario, incluidas las
rebootrequest} solicitudes de progreso y permisos para acceder a Windows Update. Si
se requiere permiso, se producirá un error en la operación.

Use rebootrequest para ocultar solo los mensajes de usuario que


solicitan permiso para reiniciar el equipo. Use esta opción si tiene un
script que controla las solicitudes de reinicio.

Ejemplos
Para habilitar Microsoft .NET Framework 4.8, escriba:
fondue.exe /enable-feature:NETFX4

Para habilitar Microsoft .NET Framework 4.8, agregar el nombre del programa al informe
SQM y no mostrar mensajes al usuario, escriba:

fondue.exe /enable-feature:NETFX4 /caller-name:Admin.bat /hide-ux:all

Vínculos relacionados
Clave de sintaxis de línea de comandos

Descarga de Microsoft .NET Framework 4.8


para
Artículo • 04/10/2023

Ejecuta un comando especificado para cada archivo, dentro de un conjunto de archivos.

Sintaxis

for {%% | %}<variable> in (<set>) do <command> [<commandlineoptions>]

Parámetros

Parámetro Descripción

{%% \| %}<variable> Necesario. Representa un parámetro reemplazable. Use un signo de un


solo porcentaje ( % ) para ejecutar el comando for en el símbolo del
sistema. Use signos de porcentaje doble ( %% ) para ejecutar el comando
for dentro de un archivo por lotes. Las variables distinguen entre
mayúsculas y minúsculas, y deben representarse con un valor alfabético,
como %a, %b o %c.

( <set> ) Necesario. Especifica uno o varios archivos, directorios o cadenas de


texto, o un intervalo de valores en los que se va a ejecutar el comando. Es
obligatorio utilizar paréntesis.

<command> Necesario. Especifica el comando que desea ejecutar en cada archivo,


directorio o cadena de texto, o en el intervalo de valores incluidos en el
conjunto.

<commandlineoptions> Especifica las opciones de línea de comandos que quiera usar con el
comando especificado.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Puede usar este comando en un archivo por lotes o directamente desde el símbolo
del sistema.

Los atributos siguientes se aplican al comando for:


Este comando reemplaza % variable o %% variable por cada cadena de texto
del conjunto especificado hasta que dicho comando procesa todos los archivos.

Los nombres de variable distinguen mayúsculas de minúsculas, son globales y


no puede haber más de 52 activos a la vez.

Para evitar confusiones con los parámetros de lote, %0 a %9 , puede usar


cualquier carácter para la variable, excepto los números del 0 al 9. En el caso de
los archivos por lotes simples, un solo carácter como %%f funcionará.

Puede usar varios valores para variable en archivos por lotes complejos para
distinguir distintas variables reemplazables.

El parámetro set puede representar un único grupo de archivos o varios grupos de


archivos. Puede usar caracteres comodín (* y ?) para especificar un conjunto de
archivos. A continuación, observe algunos conjuntos de archivos válidos:

(*.doc)
(*.doc *.txt *.me)
(jan*.doc jan*.rpt feb*.doc feb*.rpt)
(ar??1991.* ap??1991.*)

Cuando se usa este comando, el primer valor en set reemplaza % variable o %%


variable y, a continuación, el comando especificado procesa este valor. Este

proceso continúa hasta que se procesan todos los archivos (o grupos de archivos)
que corresponden al valor set.

In y do no son parámetros, pero debe usarlos con este comando. Si omite


cualquiera de estas palabras clave, aparecerá un mensaje de error.

Si las extensiones de comandos están habilitadas (es decir, el valor


predeterminado), se admiten las siguientes formas adicionales de for:

Solo directorios: si set contiene caracteres comodín (* o ?), el comando


especificado se ejecuta para cada directorio (en lugar de un conjunto de
archivos en un directorio especificado) que coincide con set. La sintaxis es:

for /d {%%|%}<Variable> in (<Set>) do <Command>


[<CommandLineOptions>]
Recursivo: recorre el árbol de directorios que se basa en drive:path y ejecuta la
instrucción for en cada directorio del árbol. Si no se especifica ningún directorio
después de /r, el directorio actual se usa como directorio raíz. Si set es solo un
punto (.), solo enumera el árbol de directorios. La sintaxis es:

for /r [[<drive>:]<path>] {%%|%}<variable> in (<set>) do <command>


[<commandlinepptions>]

Iteración de un intervalo de valores: use una variable iterativa para establecer


el valor inicial (start#) y, a continuación, recorra un intervalo de valores
establecido hasta que el valor supere el valor final establecido (end#). /l ejecuta
el iterativo comparando start# con end#. Si start# es menor que end# se
ejecutará el comando. Cuando la variable iterativa supera end#, el shell de
comandos sale del bucle. También puede usar un step# negativo para recorrer
un intervalo en valores decrecientes. Por ejemplo, (1,1,5) genera la secuencia 1 2
3 4 5 y (5,-1,1) genera la secuencia 5 4 3 2 1. La sintaxis es:

for /l {%%|%}<variable> in (<start#>,<step#>,<end#>) do <command>


[<commandlinepptions>]

Iteración y análisis de archivos: use el análisis de archivos para procesar la


salida de comandos, las cadenas y el contenido del archivo. Use variables
iterativas para definir el contenido o las cadenas que desea examinar y use las
distintas opciones parsingkeywords para seguir modificando el análisis. Use la
opción de token parsingkeywords para especificar qué tokens se deben pasar
como variables iterativas. Cuando se usa sin la opción de token, /f solo
examinará el primer token.

El análisis de archivos consiste en leer la salida, la cadena o el contenido del


archivo y, a continuación, dividirlo en líneas individuales de texto y analizar cada
línea en cero tokens o más. A continuación, se llama al bucle for con el valor de
variable iterativo establecido en el token. De forma predeterminada, /f pasa el
primer token separado por espacios de cada línea de cada archivo. Las líneas en
blanco se omiten.

Las sintaxis son las siguientes:


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>]

El argumento set especifica uno o varios nombres de archivo. Cada archivo se


abre, lee y procesa antes de pasar al siguiente archivo del conjunto. Para
invalidar el comportamiento de análisis predeterminado, especifique
parsingkeywords. Se trata de una cadena entre comillas que contiene una o
varias palabras clave para especificar diferentes opciones de análisis.

Si usa la opción usebackq, use una de las sintaxis siguientes:

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>]

En la tabla siguiente se enumeran las palabras clave de análisis que puede usar
para parsingkeywords.

Palabra Descripción
clave

eol= <c> Especifica un carácter de final de línea (solo un carácter).

skip= <n> Especifica el número de líneas que se omitirán al principio del archivo.

delims= Especifica un conjunto de delimitadores. Esto reemplaza el conjunto de


<xxx> delimitadores predeterminado de espacio y pestaña.

tokens= Especifica qué tokens de cada línea se van a pasar al bucle for en cada
<x,y,m–n> iteración. Como resultado, se asignan nombres de variable adicionales. m-
n especifica un intervalo, desde el m hasta el n. Si el último carácter de la
cadena tokens= es un asterisco (*), se asigna una variable adicional y
recibe el texto restante en la línea después del último token que se analiza.

usebackq Especifica que se ejecute una cadena entre comillas inversas como
comando, que se use una cadena entre comillas simples como cadena
literal, o bien, para nombres de archivo largos que contengan espacios,
Palabra Descripción
clave

que se permita que los nombres de archivo en <set> se incluyan entre


comillas dobles.

Sustitución de variables: en la tabla siguiente se muestra la sintaxis opcional


(para cualquier variable I):

Variable con Descripción


modificador

%~I Expande %I , que quita las comillas que haya alrededor.

%~fI Expande %I a un nombre de ruta de acceso completo.

%~dI Expande %I a una letra de unidad solamente.

%~pI Expande %I a una ruta de acceso solamente.

%~nI Expande %I a un nombre de archivo solamente.

%~xI Expande %I a una extensión de nombre de archivo solamente.

%~sI Expande la ruta de acceso para contener solo nombres cortos.

%~aI Expande %I a los atributos de archivo del archivo.

%~tI Expande %I a la fecha y hora del archivo.

%~zI Expande %I al tamaño del archivo.

%~$PATH:I Busca en los directorios enumerados en la variable de entorno PATH y


expande %I al nombre completo del primer directorio encontrado. Si
el nombre de la variable de entorno no está definido o la búsqueda
no encuentra el archivo, este modificador se expande a la cadena
vacía.

En la tabla siguiente se enumeran las combinaciones de modificadores que


puede usar para obtener resultados compuestos.

Variable con Descripción


modificadores
combinados

%~dpI Expande %I a una letra de unidad y una ruta de acceso


solamente.

%~nxI Expande %I a una extensión y nombre de archivo solamente.


Variable con Descripción
modificadores
combinados

%~fsI Expande %I a un nombre de ruta de acceso completo con


nombres cortos solamente.

%~dp$PATH:I Busca en los directorios que aparecen en la variable de


entorno PATH para %I y se expande a la letra de unidad y la
ruta de acceso de la primera que encuentra.

%~ftzaI Expande %I a una línea de salida similar a dir.

En los ejemplos anteriores, puede reemplazar %I y PATH por otros valores


válidos. Un nombre de variable for válido cierra la sintaxis %~.

Mediante el uso de nombres de variable en mayúsculas como %I , puede hacer


que el código sea más legible y evitar confusiones con los modificadores, que
no distinguen entre mayúsculas y minúsculas.

Análisis de una cadena: puede usar la lógica de análisis for /f en una cadena
inmediata encapsulando <literalstring> entre comillas dobles (sin usebackq) o
entre comillas simples (con usebackq), por ejemplo, (MyString) o ("MyString"). Se
trata a <literalstring> como una sola línea de entrada de un archivo. Al analizar
<literalstring> entre comillas dobles, los símbolos de comando como ( \ & | > <
^ ) se tratan como caracteres normales.

Análisis de salida: puede usar el comando for /f para analizar la salida de un


comando al colocar un <command> entrecomillado entre paréntesis. Se trata como
una línea de comandos, que se pasa a un Cmd.exe secundario. La salida se captura
en la memoria y se analiza como si fuera un archivo.

Ejemplos
Para usar for en un archivo por lotes, use la sintaxis siguiente:

for {%%|%}<variable> in (<set>) do <command> [<commandlineoptions>]

Para mostrar el contenido de todos los archivos del directorio actual que tienen la
extensión .doc o .txt mediante la variable reemplazable %f, escriba lo siguiente:
for %f in (*.doc *.txt) do type %f

En el ejemplo anterior, cada archivo que tiene la extensión .doc o .txt en el directorio
actual se sustituye por la variable %f hasta que se muestra el contenido de cada archivo.
Para usar este comando en un archivo por lotes, reemplace todas las repeticiones de %f
por %%f. De lo contrario, se omite la variable y se muestra un mensaje de error.

Para analizar un archivo, omitiendo líneas comentadas, escriba lo siguiente:

for /f eol=; tokens=2,3* delims=, %i in (myfile.txt) do @echo %i %j %k

Este comando analiza cada línea en myfile.txt. Omite aquellas líneas que comienzan por
un punto y coma y pasa el segundo y tercer token de cada línea al cuerpo de for (los
tokens se delimitan con comas o espacios). El cuerpo de la instrucción for hace
referencia a %i para obtener el segundo token, %j para obtener el tercer token y %k
para obtener todos los tokens restantes. Si los nombres de archivo que proporciona
contienen espacios, coloque el texto entre comillas (por ejemplo, Nombre del Archivo).
Para usar comillas, debe usar usebackq. De lo contrario, las comillas se interpretan como
la definición de una cadena literal que se va a analizar.

%i se declara explícitamente en la instrucción for. %j y %k se declaran implícitamente


mediante tokens=. Se puede usar tokens= para especificar hasta 26 tokens si no se
provoca un intento de declaración de una variable superior a la letra z o Z.

Para analizar la salida de un comando colocando set entre paréntesis, escriba lo


siguiente:

for /f "usebackq delims==" %i in (`set`) do @echo %i

Para realizar un bucle recursivo de todos los archivos de un directorio, incluyendo los
subdirectorios y el eco de su ruta de acceso completa, cuándo se modificaron por última
vez y su tamaño de archivo, escriba:

for /r "C:\My Dir\" %A in (*.*) do echo %~ftzA


Vínculos relacionados
Clave de sintaxis de línea de comandos
forfiles
Artículo • 14/04/2023

Selecciona y ejecuta un comando en un archivo o conjunto de archivos. Este comando


se usa con más frecuencia en archivos por lotes.

Sintaxis

forfiles [/P pathname] [/M searchmask] [/S] [/C command] [/D [+ | -]


[{<date> | <days>}]]

Parámetros

Parámetro Descripción

/P Especifica la ruta de acceso desde la que se va a iniciar la búsqueda. De forma


<pathname> predeterminada, la búsqueda comienza en el directorio de trabajo actual.

/M Busca archivos según la máscara de búsqueda especificada. La máscara de


<searchmask> búsqueda predeterminada es * .

/S Indica al comando forfiles que busque en subdirectorios de forma recursiva.

/C <command> Ejecuta el comando especificado en cada archivo. Las cadenas de comandos se


deben encapsular entre comillas dobles. El comando predeterminado es "cmd /c
echo @file" .

/D [{+\|-}] Selecciona los archivos con una fecha de última modificación dentro del período
[{<date> | de tiempo especificado:
<days>}] Selecciona los archivos con una fecha de última modificación posterior o
igual a (+) o anterior o igual a (-) la fecha especificada, donde la fecha está
en el formato MM/DD/AAAA.
Selecciona los archivos con una fecha de última modificación posterior o
igual a (+) la fecha actual más el número de días especificados, o anterior o
igual a (-) la fecha actual menos el número de días especificados.
Los valores válidos para días incluyen cualquier número en el intervalo de 0
a 32 768. Si no se especifica ningún signo, se utiliza por defecto +.

/? Muestra el texto de ayuda en la ventana cmd.

Comentarios
El comando forfiles /S es similar a dir /S .

Puede usar las siguientes variables en la cadena de comandos según lo


especificado por la opción de línea de comandos /C:

Variable Descripción

@FILE Nombre de archivo.

@FNAME Nombre de archivo sin extensión

@EXT Extensión de nombre de archivo

@PATH Ruta de acceso completa del archivo

@RELPATH Ruta de acceso relativa del archivo

@ISDIR Se evalúa como TRUE si un tipo de archivo es un directorio. De lo contrario,


esta variable se evalúa como FALSE.

@FSIZE Tamaño del archivo, en bytes.

@FDATE Marca de fecha de última modificación en el archivo.

@FTIME Marca de hora de la última modificación en el archivo.

El comando forfiles permite ejecutar un comando en varios archivos o pasar


argumentos. Por ejemplo, puede ejecutar el comando type en todos los archivos
de un árbol con la extensión de nombre de archivo .txt. O bien, puede ejecutar
todos los archivos por lotes (*.bat) en la unidad C, con el nombre de archivo
Myinput.txt como primer argumento.

Este comando puede hacer lo siguiente:

Seleccionar los archivos por una fecha absoluta o una fecha relativa mediante el
parámetro /d.

Compilar un árbol de archivos mediante variables como @FSIZE y @FDATE.

Diferenciar los archivos de los directorios mediante la variable @ISDIR.

Incluir caracteres especiales en la línea de comandos mediante el código


hexadecimal para el carácter, en formato 0xHH (por ejemplo, 0x09 para una
pestaña).

Este comando funciona mediante la implementación de la marca recurse


subdirectories en herramientas diseñadas para procesar solo un único archivo.
Ejemplos
Para enumerar todos los archivos por lotes de la unidad C, escriba:

forfiles /P c:\ /S /M *.bat /C "cmd /c echo @file is a batch file"

Para enumerar todos los directorios de la unidad C, escriba:

forfiles /P c:\ /S /M * /C "cmd /c if @isdir==TRUE echo @file is a


directory"

Para enumerar todos los archivos del directorio actual que tienen al menos un año de
antigüedad, escriba:

forfiles /S /M *.* /D -365 /C "cmd /c echo @file is at least one year old."

Para mostrar el archivo de texto que está obsoleto para cada uno de los archivos del
directorio actual que son anteriores al 1 de enero de 2007, escriba:

forfiles /S /M *.* /D -01/01/2007 /C "cmd /c echo @file is outdated."

Para enumerar las extensiones de nombre de archivo de todos los archivos del
directorio actual en formato de columna y agregar una pestaña antes de la extensión,
escriba:

forfiles /S /M *.* /C "cmd /c echo The extension of @file is 0x09@ext"

Vínculos relacionados
Clave de sintaxis de línea de comandos
Formato
Artículo • 07/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 11 y Windows 10

El comando format da formato a las unidades para que acepten archivos de Windows.
Para dar formato a un disco duro, debe ser miembro del grupo Administradores.

7 Nota

También puede usar el comando format, con otros parámetros, desde la Consola
de recuperación. Para más información sobre la Consola de recuperación, consulte
Entorno de recuperación de Windows (Windows RE).

Sintaxis

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 Descripción

<volume> Especifica el punto de montaje, el nombre del volumen o la letra de unidad


(seguido de dos puntos) de la unidad a la que desea dar formato. Si no se
especifica ninguna de las siguientes opciones de línea de comandos,
format utiliza el tipo de volumen para determinar el formato
predeterminado del disco.

/FS: <filesystem> Especifica el tipo de sistema de archivos (FAT, FAT32, NTFS, exFAT, ReFS o
UDF).

/V: <label> Especifica la etiqueta del volumen. Si se omite la opción de la línea de


comandos /V o la usa sin especificar una etiqueta de volumen, format le
pide la etiqueta del volumen una vez que termine de dar formato a la
unidad. Use la sintaxis /V: para evitar que se solicite una etiqueta de
Parámetro Descripción

volumen. Si utiliza un único comando format para dar formato a más de un


disco, todos los discos reciben la misma etiqueta de volumen.

/Q Realiza un formato rápido. Elimina la tabla de archivos y el directorio raíz


de un volumen formateado anteriormente, pero no realiza un examen
sector a sector para encontrar áreas defectuosas. Debe utilizar la opción de
la línea de comandos /Q para dar formato solo a los volúmenes
previamente formateados que estén en buenas condiciones. /Q invalida /P.

/C Solo NTFS : Los archivos creados en el nuevo volumen se comprimen de


forma predeterminada.

/X Hace que el volumen se desmonte, si es necesario, antes de darle formato.


Los controladores abiertos en el volumen dejan de ser válidos.

/R Solo NTFS : Los archivos creados en el nuevo volumen se comprimen de


forma predeterminada.

/D Solo UDF 2.50. Los metadatos están duplicados.

/L: <state> Solo NTFS. Invalida el tamaño predeterminado del registro de archivos. De
manera predeterminada, a los volúmenes sin niveles se les da formato con
registros de archivos pequeños, mientras que a los volúmenes con niveles
se les da formato con registros de archivos grandes. /L y /L:enable hacen
que format use registros de archivos de tamaño grande y /L:disable hace
que format use registros de archivos de tamaño pequeño.

/A: <size> Especifica el tamaño de la unidad de asignación que se va a usar en


volúmenes FAT, FAT32, NTFS, exFAT o ReFS. Si no se especifica el tamaño de
unidad, se elige en función del tamaño del volumen. Para un uso general,
se recomienda la configuración predeterminada. En la lista siguiente, se
muestran valores válidos para eltamaño de unidad de cada tipo de sistema
de archivos:

FAT y FAT32: 512 , 1024 , 2048 , 4096 , 8192 , 16K , 32K , 64K . También
128K y 256K para un tamaño de sector superior a los 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

/F: <size> Especifica el tamaño del disquete que se va a dar formato. Cuando sea
posible, use esta opción de la línea de comandos en lugar de las opciones
/T y /T de la línea de comandos. Windows acepta los siguientes valores
para el tamaño:

1440 , 1440k o 1440kb


Parámetro Descripción

1.44 , 1.44m o 1.44mb


1.44-MB , double-sided , quadruple-density , 3.5-inch disk

/T: <tracks> Especifica el número de pistas en el disco. Cuando sea posible, use en su
lugar la opción de la línea de comandos /F. Si utiliza la opción /T, también
debe utilizar la opción /N. En conjunto, estas opciones proporcionan un
método alternativo de especificar el tamaño del disco al que se da formato.
Esta opción no es válida con la opción /F.

/N: <sectors> Especifica el número de sectores por pista. Cuando sea posible, use la
opción de la línea de comandos /F en lugar de /N. Si usa /N, también debe
usar /T. Conjuntamente, estas dos opciones proporcionan un método
alternativo de especificar el tamaño del disco al que se da formato. Esta
opción no es válida con la opción /F.

/P: <count> Pone en cero cada sector del volumen. Después, el volumen se
sobrescribirá count veces con un número aleatorio cada vez. Si count es
cero, no se hace ninguna otra sobrescritura después de poner en cero cada
sector. Este modificador se omite cuando se especifica /Q.

/S: <state> Especifica la compatibilidad con nombres de archivo cortos. El estado es


habilitar o deshabilitar. Los nombres cortos están deshabilitados de
manera predeterminada.

/TXF: <state> Especifica que TxF está habilitado o deshabilitado. El estado es habilitar o
deshabilitar. TxF está habilitado de manera predeterminada.

/I: <state> Solo ReFS : especifica si la integridad debe estar habilitada en el nuevo
volumen. El estado es habilitar o deshabilitar. De manera predeterminada,
la integridad está habilitada en el almacenamiento que admite la
redundancia de datos.

/DAX: <state> Solo NTFS: habilite el modo de almacenamiento de acceso directo (DAX)
para este volumen. En el modo DAX, se accede al volumen a través del bus
de memoria, lo que aumenta el rendimiento de E/S. Solo se puede dar
formato a un volumen con el modo DAX si el hardware es compatible con
DAX. El estado es habilitar o deshabilitar. /DAX se considera que idéntico a
/DAX:enable.

/LogSize:: <size> Solo NTFS: especifica el tamaño del archivo de registro NTFS en kilobytes.
El tamaño mínimo admitido es de 2 MB, por lo que si se especifica un
tamaño inferior el resultado es un archivo de registro de 2 MB. Cero indica
el valor predeterminado. Por lo general, el valor predeterminado depende
del tamaño del volumen.

/NoRepairLogs Solo NTFS: deshabilita los registros de reparación de NTFS. Si se especifica


la marca spotfix para chkdsk, entonces el parámetro /NoReairLogs no
funciona.
Parámetro Descripción

/NoTrim Omite el envío de recorte (notificación de eliminación) durante un formato.

/DevDrv Solo ReFS : da formato al volumen como una unidad para desarrolladores.
Una unidad para desarrolladores o un volumen de desarrollador es un
volumen optimizado para el rendimiento de los escenarios de
desarrollador. Proporciona a los administradores controlar qué minifiltros
se adjuntan a este volumen.

/SHA256Checksums Solo ReFS: usa SHA-256 en todas las operaciones que implican sumas de
comprobación.

/Y No pide que se obligue a desmontar el volumen y asume una etiqueta


vacía cuando no se especifica ninguna.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
El comando format crea un sistema de archivos nuevo y un directorios raíz para el
disco. También puede comprobar si hay sectores defectuosos en el disco y eliminar
todos los datos del disco. Para que pueda usar un disco nuevo, primero debe usar
este comando para dar formato al disco.

Después de dar formato a un disco, format muestra el mensaje siguiente:

Volume label (11 characters, ENTER for none)?

Para agregar una etiqueta de volumen, escriba hasta 11 caracteres (incluidos los
espacios). Si no desea agregar una etiqueta de volumen al disco, presione ENTRAR.

Cuando se usa el comando format para dar formato a un disco duro, se muestra
un mensaje de advertencia similar al siguiente:

WARNING, ALL DATA ON NON-REMOVABLE DISK


DRIVE x: WILL BE LOST!
Proceed with Format (Y/N)? _

Para dar formato al disco duro, presione Y. Si no quiere hacerlo, presione N.

Los sistemas de archivos FAT restringen el número de clústeres a no más de


65 526. Los sistemas de archivos FAT32 restringen el número de clústeres a un
intervalo entre 65 527 y 4 177 917.
No se admite la compresión NTFS para tamaños de unidad de asignación
superiores a 4096.

7 Nota

El comando format detendrá el procesamiento de inmediato si determina que


no se pueden cumplir los requisitos anteriores con el tamaño de clúster
especificado.

Cuando se completa el formato, el formato muestra mensajes en los que se


muestra el espacio total en disco, los espacios marcados como defectuosos y el
espacio disponible para los archivos.

Puede acelerar el proceso de formato mediante el uso de la opción de la línea de


comandos /q. Utilice esta opción solo si no hay sectores defectuosos en el disco
duro.

No debe utilizar el comando format en una unidad que se preparó con el


comando subst. No se puede dar formato a discos a través de una red.

En la tabla siguiente se enumeran los códigos de salida y una breve descripción de


su significado.

Código de Descripción
salida

0 La operación de formato se realizó correctamente.

1 Se proporcionaron parámetros incorrectos.

4 Se produjo un error irrecuperable (que es cualquier error distinto de 0, 1 o


5).

5 El usuario presionó N como respuesta al aviso "¿Desea formatear S/N?"


para detener el proceso.

Puede comprobar estos códigos de salida mediante la variable de entorno


ERRORLEVEL con el comando por lotes if.

Ejemplos
Para dar formato a un disquete nuevo en la unidad A con el tamaño predeterminado,
escriba:
format a:

Para realizar una operación de formato rápido en un disquete previamente formateado


en la unidad A, escriba:

format a: /q

Para dar formato a un disco en la unidad A y asignarle la etiqueta de volumen DATA,


escriba:

format a: /v:DATA

Vínculos relacionados
Clave de sintaxis de línea de comandos
freedisk
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Comprueba si la cantidad especificada de espacio en disco está disponible antes de


continuar con un proceso de instalación.

Sintaxis

freedisk [/s <computer> [/u [<domain>\]<user> [/p [<password>]]]] [/d


<drive>] [<value>]

Parámetros

Parámetro Descripción

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (no se pueden


usar barras diagonales inversas). La opción predeterminada es el equipo
local. Este parámetro se aplica a todos los archivos y carpetas especificados
en el comando.

/u [ <domain> \] El script se ejecuta con los permisos de la cuenta de usuario especificada. El


<user> valor predeterminado es permisos del sistema.

/p [ <password> ] Especifica la contraseña de la cuenta de usuario especificada en /u.

/d <drive> Especifica la unidad para la que desea averiguar la disponibilidad del espacio
libre. Debe especificar <drive> para un equipo remoto.

<value> Comprueba si hay una cantidad específica de espacio disponible en disco.


Puede especificar <value> en bytes, KB, MB, GB, TB, PB, EB, ZB o YB.

Comentarios
El uso de las opciones de la línea de comandos /s, /u y /p, sólo están disponibles
al usar /s. Debe usar /p con /u para proporcionar la contraseña del usuario.
En el caso de las instalaciones desatendidas, puede usar freedisk en los archivos
por lotes de instalación para comprobar la cantidad de espacio disponible
necesario antes de continuar con la instalación.

Cuando se usa freedisk en un archivo por lotes, devuelve un 0 si hay suficiente


espacio y un 1 si no hay suficiente espacio.

Ejemplos
Para determinar si hay al menos 50 MB de espacio disponible en la unidad C, escriba lo
siguiente:

freedisk 50mb

La salida similar a la del ejemplo siguiente aparece en la pantalla:

INFO: The specified 52,428,800 byte(s) of free space is available on current


drive.

Vínculos relacionados
Clave de sintaxis de línea de comandos
fsutil
Artículo • 14/04/2023

Se aplica 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

Realiza tareas relacionadas con los sistemas de archivos NTFS y FAT (tabla de asignación
de archivos), como administrar puntos de reanálisis, administrar archivos dispersos o
desmontar un volumen. Si se usa sin parámetros, fsutil muestra una lista de los
subcomandos admitidos.

7 Nota

Para usar fsutil, debe haber iniciado sesión como administrador o como miembro
del grupo Administradores. Este comando es bastante eficaz y solo lo deben usar
los usuarios avanzados que tienen un conocimiento exhaustivo de los sistemas
operativos Windows.

Parámetros
Subcomando Descripción

fsutil Consulta o cambia la configuración del comportamiento de nombres cortos en el


8dot3name sistema; por ejemplo, genera nombres de archivo con una longitud de
8,3 caracteres. Quita los nombres cortos de todos los archivos de un directorio.
Examina un directorio e identifica las claves del Registro que podrían verse
afectadas si los nombres cortos se quitaran de los archivos del directorio.

fsutil dirty Consulta si está establecido el bit de integridad del volumen o lo establece.
Cuando se establece el bit de integridad de un volumen, autochk comprueba
automáticamente los errores del volumen la próxima vez que se reinicia el
equipo.

fsutil file Busca un archivo por nombre de usuario (si se habilitan cuotas de disco),
consulta los intervalos asignados para un archivo, establece el nombre corto de
un archivo, establece la longitud de datos válida de un archivo, establece cero
datos para un archivo, crea un archivo de un tamaño especificado, busca un
identificador de archivo si se le asigna el nombre o busca un nombre de vínculo
de archivo para un identificador de archivo especificado.
Subcomando Descripción

fsutil fsinfo Enumera todas las unidades y consulta el tipo de unidad, la información del
volumen, la información de volumen específica de NTFS o las estadísticas del
sistema de archivos.

fsutil hardlink Enumera los vínculos físicos de un archivo o crea un vínculo físico (una entrada
de directorio para un archivo). Cada archivo se puede considerar que tiene al
menos un vínculo físico. En volúmenes NTFS, cada archivo puede tener varios
vínculos físicos, por lo que un archivo único puede aparecer en muchos
directorios (o incluso en el mismo directorio con nombres diferentes). Dado que
todos los vínculos hacen referencia al mismo archivo, los programas pueden abrir
cualquiera de los vínculos y modificar el archivo. Un archivo se elimina del
sistema de archivos solo después de que se eliminan todos los vínculos a él.
Después de crear un vínculo físico, los programas pueden usarlo como cualquier
otro nombre de archivo.

fsutil objectid Administra los identificadores de objeto, que el sistema operativo Windows usa
para realizar un seguimiento de objetos como archivos y directorios.

fsutil quota Administra las cuotas de disco en volúmenes NTFS para proporcionar un control
más preciso del almacenamiento basado en red. Las cuotas de disco se
implementan por volumen y permiten implementar los límites de
almacenamiento permanentes y temporales por usuario.

fsutil repair Consulta o establece el estado de recuperación automática del volumen. La


recuperación automática de NTFS intenta corregir daños del sistema de archivos
NTFS en línea sin necesidad de ejecutar Chkdsk.exe. Incluye iniciar la
comprobación en disco y esperar que se complete la reparación.

fsutil Consulta o elimina puntos de reanálisis (objetos del sistema de archivos NTFS
reparsepoint que tienen un atributo definible que contiene datos controlados por el usuario).
Los puntos de reanálisis se usan para ampliar la funcionalidad en el subsistema
de entrada/salida (E/S). Se usan como puntos de unión de directorios y puntos
de montaje de volumen. También los controladores de filtro del sistema de
archivos los usan para marcar determinados archivos como especiales para ese
controlador.

fsutil resource Crea un administrador de recursos transaccionales secundario, inicia o detiene un


administrador de recursos transaccionales, muestra información sobre un
administrador de recursos transaccionales o modifica su comportamiento.
Subcomando Descripción

fsutil sparse Administra archivos dispersos. Un archivo disperso es un archivo con una o varias
regiones de datos no asignados en él. Un programa reconoce estas regiones sin
asignar como que contienen bytes con el valor cero, pero no se usa ningún
espacio en disco para representar estos ceros. Se asignan todos los datos
significativos o que no son ceros, mientras que no se asignan todos los datos no
significativos (cadenas grandes de datos que se componen de ceros). Cuando se
lee un archivo disperso, los datos asignados se devuelven como almacenados y
los datos sin asignar se devuelven como ceros (de manera predeterminada, de
acuerdo con la especificación de requisito de seguridad C2). La compatibilidad
con archivos dispersos permite desasignar los datos desde cualquier lugar del
archivo.

fsutil tiering Habilita la administración de funciones de nivel de almacenamiento, como la


configuración y deshabilitación de marcas y la lista de niveles.

fsutil Confirma una transacción especificada, revierte una transacción especificada o


transaction muestra información sobre la transacción.

fsutil usn Administra el diario de cambios del número de secuencias actualizadas (USN), el
que proporciona un registro persistente de todos los cambios realizados en los
archivos del volumen.

fsutil volume Administra un volumen. Desmonta un volumen, consulta para ver cuánto espacio
libre hay disponible en un disco o busca un archivo que usa un clúster
especificado.

fsutil wim Proporciona funciones para detectar y administrar archivos respaldados por
imágenes de Windows (WIM).

Vínculos relacionados
Clave de sintaxis de línea de comandos
fsutil 8dot3name
Artículo • 12/04/2023

Se aplica 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 o cambia la configuración del comportamiento de nombre corto (nombres 8dot3),


que incluye lo siguiente:

Consulta de la configuración actual para el comportamiento de nombre corto.

Examen de la ruta de acceso de directorio especificada para las claves del Registro que
podrían verse afectadas si se quitan nombres cortos de la ruta de acceso del directorio
especificada.

Cambio de la configuración que controla el comportamiento de nombre corto. Esta


configuración se puede aplicar a un volumen especificado o a la configuración
predeterminada del volumen.

Eliminación de los nombres cortos de todos los archivos de un directorio.

) Importante

Eliminar de forma permanente los nombres de archivo 8dot3 y no modificar las claves del
Registro que apuntan a los nombres de archivo 8dot3 puede provocar errores inesperados
en la aplicación, como la incapacidad de desinstalar una aplicación. Se recomienda realizar
primero una copia de seguridad del directorio o volumen antes de intentar quitar los
nombres de archivo 8dot3.

Sintaxis

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 Descripción
Parámetro Descripción

query Consulta el sistema de archivos para el estado del comportamiento de creación de nombres
[<volumepath>] cortos 8dot3.
Si no se especifica ningún volumepath como parámetro, se muestra la configuración
predeterminada del comportamiento de creación 8dot3name para todos los volúmenes.

scan Examina los archivos que se encuentran en directorypath especificado para las claves del
<directorypath> Registro que podrían verse afectadas si los nombres cortos de 8dot3 se eliminaran de los
nombres de archivo.

set { Cambia el comportamiento del sistema de archivos para la creación de nombres 8dot3 en las
<defaultvalue> instancias siguientes:
\| Cuando se especifica defaultvalue, la clave del Registro,
<volumepath>} HKLM\System\CurrentControlSet\Control\FileSystem\NtfsDisable8dot3NameCreation,
se establece en defaultvalue.

DefaultValue puede tener los siguientes valores:


0: Habilita la creación de nombres 8dot3 para todos los volúmenes del sistema.
1: Deshabilita la creación de nombres 8dot3 para todos los volúmenes del sistema.
2: Establece la creación de nombres 8dot3 por volumen.
3: Deshabilita la creación de nombres 8dot3 para todos los volúmenes excepto para
el volumen del sistema.
Cuando se especifica volumepath, los volúmenes especificados en las propiedades
8dot3name de la marca de disco se establecen para habilitar la creación de nombres
8dot3 para un volumen especificado (0) o para deshabilitar la creación de nombres
8dot3 en el volumen especificado (1).

Debe establecer el comportamiento predeterminado del sistema de archivos para la


creación de nombres 8dot3 en el valor 2 para poder habilitar o deshabilitar la creación
de nombres 8dot3 para un volumen especificado.

strip Quita los nombres de archivo 8dot3 de todos los archivos que se encuentran en directorypath
<directorypath> especificado. El nombre de archivo 8dot3 no se elimina para los archivos en los que
directorypath combinado con el nombre de archivo contiene más de 260 caracteres.

Este comando enumera pero no modifica las claves del Registro que apuntan a los archivos
que tenían nombres de archivo 8dot3 que se eliminaron.

<volumepath> Especifica el nombre de la unidad seguido de dos puntos o GUID en el formato volume{GUID} .

/f Especifica que todos los archivos que se encuentran en directorypath especificado se les ha
eliminado los nombres de archivo 8dot3 incluso si hay claves del Registro que apuntan a
archivos que usan el nombre de archivo 8dot3. En este caso, la operación elimina los nombres
de archivo 8dot3, pero no modifica ninguna clave del Registro que apunte a los archivos que
usan los nombres de archivo 8dot3. Advertencia: Se recomienda realizar una copia de
seguridad del directorio o volumen antes de usar el parámetro /f porque puede provocar
errores inesperados en la aplicación, como la incapacidad de desinstalar programas.

/l [<log file>] Especifica un archivo de registro donde se escribe información.


Si no se especifica el parámetro /l, toda la información se escribe en el archivo de registro
predeterminado: %temp%\8dot3_removal_log@(GMT YYYY-MM-DD HH-MM-SS) .log**

/s Especifica que la operación se debe aplicar a los subdirectorios de directorypath especificado.


Parámetro Descripción

/t Especifica que la eliminación de nombres de archivo 8dot3 debe ejecutarse en modo de


prueba. Se realizan todas las operaciones excepto la eliminación real de los nombres de
archivo 8dot3. Puede usar el modo de prueba para detectar qué claves del Registro apuntan a
los archivos que usan los nombres de archivo 8dot3.

/v Especifica que toda la información escrita en el archivo de registro también se muestra en la


línea de comandos.

Ejemplos
Para consultar el comportamiento del nombre 8dot3 de deshabilitación para un volumen de
disco especificado con el GUID, {928842df-5a01-11de-a85c-806e6f6e6963}, escriba lo siguiente:

fsutil 8dot3name query volume{928842df-5a01-11de-a85c-806e6f6e6963}

También puede consultar el comportamiento del nombre 8dot3 mediante el subcomando


behavior.

Para quitar los nombres de archivo 8dot3 en el directorio D:\MyData y todos los subdirectorios,
al escribir la información en el archivo de registro especificado como mylogfile.log, escriba lo
siguiente:

fsutil 8dot3name strip /l mylogfile.log /s d:\MyData

Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil

fsutil behavior
fsutil behavior
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y
Windows 8

Consulta o establece el comportamiento del volumen NTFS, que incluye:

Crear los nombres de archivo de longitud de caracteres de 8.3.

Extensión del uso de caracteres en nombres de archivo cortos de longitud de


caracteres de 8.3 en volúmenes NTFS.

Actualización de la marca Hora del último acceso cuando los directorios aparecen
en volúmenes NTFS.

Frecuencia con la que los eventos de cuota se escriben en el registro del sistema,
en el grupo paginado NTFS y en los niveles de caché de memoria del grupo no
paginado NTFS.

Tamaño de la zona de tabla de archivos maestros (zona MFT).

Eliminación silenciosa de datos cuando el sistema encuentra daños en un volumen


NTFS.

Notificación de eliminación de archivos (también conocida como recorte o


desasignación).

Sintaxis

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 Descripción

Query Consultas de los parámetros de comportamiento del sistema


de archivos.

set Cambios de los parámetros de comportamiento del sistema de


archivos.

allowextchar {1|0} Permite (1) o no permite (0) caracteres del juego de caracteres
extendidos (incluidos caracteres diacríticos) que se usarán en
nombres de archivo cortos de longitud de caracteres de 8.3 en
volúmenes NTFS.

Será preciso reiniciar el equipo para que este parámetro surta


efecto.

Bugcheckoncorrupt {1|0} Permite (1) o no permite (0) la generación de una


comprobación de errores cuando hay daños en un volumen
NTFS. Esta característica se puede usar para evitar que NTFS
elimine datos de forma silenciosa cuando se usa con la
característica NTFS de recuperación automática.

Será preciso reiniciar el equipo para que este parámetro surta


efecto.

disable8dot3 [ <volumepath> ] Deshabilita (1) o habilita (0) la creación de nombres de archivo


{1|0} de longitud de caracteres de 8.3 en volúmenes con formato
FAT y NTFS. Opcionalmente, el prefijo con la ruta de volumen
especificada como nombre de unidad seguido de dos puntos o
GUID.

disablecompression {1|0} Deshabilita (1) o habilita (0) la compresión NTFS.

Será preciso reiniciar el equipo para que este parámetro surta


efecto.
Parámetro Descripción

disablecompressionlimit {1|0} Deshabilita (1) o habilita (0) el límite de compresión NTFS en el


volumen NTFS. Cuando un archivo comprimido alcanza un
determinado nivel de fragmentación, en lugar de no extender
el archivo, NTFS deja de comprimir extensiones adicionales del
archivo. Esto se hizo para permitir que los archivos
comprimidos sean más grandes de lo que normalmente serían.
Establecer este valor en TRUE deshabilita esta característica
que limita el tamaño de los archivos comprimidos en el
sistema. No se recomienda deshabilitar esta característica.

Será preciso reiniciar el equipo para que este parámetro surta


efecto.

disableencryption {1|0} Deshabilita (1) o habilita (0) el cifrado de carpetas y archivos en


volúmenes NTFS.

Será preciso reiniciar el equipo para que este parámetro surta


efecto.

disablefilemetadataoptimization Deshabilita (1) o habilita (0) la optimización de metadatos de


{1|0} archivos. NTFS tiene un límite en cuántas extensiones puede
tener un archivo determinado. Los archivos comprimidos y
dispersos pueden ser muy fragmentados. De forma
predeterminada, NTFS compacta periódicamente sus
estructuras de metadatos internas para permitir más archivos
fragmentados. Establecer este valor en TRUE deshabilita esta
optimización interna. No se recomienda deshabilitar esta
característica.

Será preciso reiniciar el equipo para que este parámetro surta


efecto.

disablelastaccess {1|0} Deshabilita (1) o habilita (0) las actualizaciones de la marca de


hora del último acceso en cada directorio cuando los
directorios aparecen en un volumen NTFS.

Será preciso reiniciar el equipo para que este parámetro surta


efecto.

disablespotcorruptionhandling Deshabilita (1) o habilita (0) el control de daños puntuales.


{1|0} También permite a los administradores del sistema ejecutar
CHKDSK para analizar el estado de un volumen sin
desconectarlo. No se recomienda deshabilitar esta
característica.

Será preciso reiniciar el equipo para que este parámetro surta


efecto.
Parámetro Descripción

disabletxf {1|0} Deshabilita (1) o habilita (0) TxF en el volumen NTFS


especificado. TxF es una característica NTFS que proporciona
transacciones como semánticas a las operaciones del sistema
de archivos. TxF está actualmente en desuso, pero la
funcionalidad sigue estando disponible. No se recomienda
deshabilitar esta característica en el volumen C:.

Será preciso reiniciar el equipo para que este parámetro surta


efecto.

disablewriteautotiering {1|0} Deshabilita la lógica de creación de niveles automáticas de


ReFS v2 para los volúmenes en capas.
Será preciso reiniciar el equipo para que este parámetro surta
efecto.

encryptpagingfile {1|0} Cifra (1) o no cifra (0) el archivo de paginación de memoria en


el sistema operativo Windows.

Será preciso reiniciar el equipo para que este parámetro surta


efecto.

mftzone <value> Establece el tamaño de la zona MFT y se expresa como


múltiplo de 200 MB. Establezca el valor en un número de 1 (el
valor predeterminado es 200 MB) en 4 (el máximo es de
800 MB).

Será preciso reiniciar el equipo para que este parámetro surta


efecto.

memoryusage <value> Configura los niveles de caché interna de memoria de grupo


paginado NTFS y memoria de grupo no paginado NTFS. Se
establece en 1 o 2. Cuando se establece en 1 (valor
predeterminado), NTFS usa la cantidad predeterminada de
memoria del grupo paginado. Cuando se establece en 2, NTFS
aumenta el tamaño de sus listas de aspecto y umbrales de
memoria. (Una lista de aspecto es un grupo de búferes de
memoria de tamaño fijo que los controladores de dispositivo y
kernel crean como cachés de memoria privada para las
operaciones del sistema de archivos, como leer un archivo).

Será preciso reiniciar el equipo para que este parámetro surta


efecto.
Parámetro Descripción

quotanotify <frequency> Configura la frecuencia con la que se notifican las infracciones


de cuota NTFS en el registro del sistema. Los valores válidos
están en el intervalo 0: 4294967295. El valor predeterminado
es 3600 segundos (una hora).

Será preciso reiniciar el equipo para que este parámetro surta


efecto.

symlinkevaluation Controla el tipo de vínculos simbólicos que se pueden crear en


<symboliclinktype> un equipo. Las opciones válidas son:
1: vínculos simbólicos locales, L2L:{0|1}
2: vínculos simbólicos locales a remotos, L2R:{1|0}
3: remoto a vínculos simbólicos locales, R2L:{1|0}
4: remoto a vínculos simbólicos remotos, R2R:{1|0}

disabledeletenotify Deshabilita (1) o habilita (0) notificaciones de eliminación.


Eliminar notificaciones (también conocidas como recorte o
desasignación) es una característica que notifica al dispositivo
de almacenamiento subyacente de los clústeres que se han
liberado debido a una operación de eliminación de archivos.
Además:

En el caso de los sistemas que usan ReFS v2, el recorte


está deshabilitado de forma predeterminada.
En el caso de los sistemas que usan ReFS v1, el recorte
está habilitado de forma predeterminada.
En el caso de los sistemas que usan NTFS, el recorte está
habilitado de forma predeterminada a menos que un
administrador lo deshabilite.
Si la unidad de disco duro o SAN informa de que no
admite el recorte, la unidad de disco duro y los SAN no
reciben notificaciones de recorte.
La habilitación o deshabilitación no requiere un reinicio.
El recorte es efectivo cuando se emite el siguiente
comando de desasignación.
La E/S existente no se ve afectada por el cambio del
registro.
No requiere ningún reinicio del servicio al habilitar o
deshabilitar el recorte.

Comentarios
La zona MFT es un área reservada que permite que la tabla de archivos maestros
(MFT) se expanda según sea necesario para evitar la fragmentación de MFT. Si el
tamaño medio del archivo en el volumen es de 2 KB o menos, puede ser
beneficioso establecer el valor de mftzone en 2. Si el tamaño medio del archivo en
el volumen es de 1 KB o menos, puede ser beneficioso establecer el valor de
mftzone en 4.

Cuando disable8dot3 se establece en 0, cada vez que se crea un archivo con un


nombre de archivo largo, NTFS crea una segunda entrada de archivo que tiene un
nombre de archivo de longitud de caracteres de 8.3. Cuando NTFS crea archivos en
un directorio, debe buscar los nombres de archivo de longitud de caracteres de 8.3
asociados a los nombres de archivo largos. Este parámetro actualiza la clave del
Registro
HKLM\SYSTEM\CurrentControlSet\Control\FileSystem\NtfsDisable8dot3NameCr
eation.

El parámetro allowextchar actualiza la clave del Registro


HKLM\SYSTEM\CurrentControlSet\Control\FileSystem\NtfsAllowExtendedCharac
terIn8dot3Name .

El parámetro disablelastaccess reduce el impacto de las actualizaciones de registro


en la marca Hora del último acceso en archivos y directorios. Deshabilitar la
característica Hora del último acceso mejora la velocidad del acceso a archivos y
directorios. Este parámetro actualiza la clave del Registro
HKLM\SYSTEM\CurrentControlSet\Control\FileSystem\NtfsDisableLastAccessUp
date.

Notas:

Las consultas de la hora de último acceso basadas en archivos son precisas


incluso si todos los valores en disco no están actualizados. NTFS devuelve el
valor correcto en las consultas porque el valor preciso se almacena en la
memoria.

Una hora es la cantidad máxima de tiempo que NTFS puede aplazar la


actualización de la hora del último acceso en el disco. Si NTFS actualiza otros
atributos de archivo, como hora de última modificación, y está pendiente una
actualización de la hora de último acceso, NTFS actualiza la hora del último
acceso con las demás actualizaciones sin un impacto adicional en el
rendimiento.

El parámetro disablelastaccess puede afectar a programas como la copia de


seguridad y el almacenamiento remoto, que dependen de esta característica.

El aumento de la memoria física no siempre aumenta la cantidad de memoria del


grupo paginado disponible para NTFS. Si se establece memoryusage en 2, se
aumenta el límite de memoria del grupo paginado. Esto podría mejorar el
rendimiento si el sistema está abriendo y cerrando muchos archivos en el mismo
conjunto de archivos y aún no usa grandes cantidades de memoria del sistema
para otras aplicaciones o para la memoria caché. Si el equipo ya usa grandes
cantidades de memoria del sistema para otras aplicaciones o para la memoria
caché, aumentar el límite de memoria paginada NTFS y no paginada reduce la
memoria del grupo disponible para otros procesos. Esto podría reducir el
rendimiento general del sistema. Este parámetro actualiza la clave del Registro
HKLM\SYSTEM\CurrentControlSet\Control\FileSystem\NtfsMemoryUsage.

El valor especificado en el parámetro mftzone es una aproximación del tamaño


inicial del MFT más la zona MFT en un nuevo volumen y se establece en tiempo de
montaje para cada sistema de archivos. A medida que se usa espacio en el
volumen, NTFS ajusta el espacio reservado para el crecimiento futuro de MFT. Si la
zona MFT ya es grande, el tamaño completo de la zona MFT no se reserva de
nuevo. Dado que la zona MFT se basa en el intervalo contiguo más allá del final
del MFT, se reduce a medida que se usa el espacio.

El sistema de archivos no determina la nueva ubicación de la zona MFT hasta que


se use completamente la zona MFT actual. Tenga en cuenta que esto nunca se
produce en un sistema típico.

Algunos dispositivos pueden experimentar una degradación del rendimiento


cuando la característica de notificación de eliminación está activada. En este caso,
use la opción disabledeletenotify para desactivar la característica de notificación.

Ejemplos
Para consultar el comportamiento del nombre 8dot3 de deshabilitación para un
volumen de disco especificado con el GUID, {928842df-5a01-11de-a85c-806e6f6e6963},
escriba:

fsutil behavior query disable8dot3 volume{928842df-5a01-11de-a85c-


806e6f6e6963}

También puede consultar el comportamiento del nombre 8dot3 mediante el


subcomando 8dot3name.

Para consultar el sistema para ver si TRIM está habilitado o no, escriba:
fsutil behavior query DisableDeleteNotify

Esto produce una salida similar a la siguiente:

NTFS DisableDeleteNotify = 1
ReFS DisableDeleteNotify is not currently set

Para invalidar el comportamiento predeterminado de TRIM (disabledeletenotify) para


ReFS v2, escriba:

fsutil behavior set disabledeletenotify ReFS 0

Para invalidar el comportamiento predeterminado de TRIM (disabledeletenotify) para


NTFS y ReFS v1, escriba:

fsutil behavior set disabledeletenotify 1

Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil

fsutil 8dot3name
fsutil devdrv
Artículo • 07/10/2023

Válido para Windows 11

Una unidad (o volumen) para desarrolladores es un volumen que está optimizado para
mejorar el rendimiento en escenarios de desarrollo. El comando también permite a un
administrador del dispositivo controlar los minifiltros del sistema de archivos que están
conectados al volumen.

Comandos devdrv admitidos


Get-Help Descripción

Query Consulta información de las unidades para desarrolladores.

enable Habilita la compatibilidad con unidades para desarrolladores en este


sistema.

disable Deshabilita la compatibilidad con unidades para desarrolladores en este


sistema.

confiar Confía en la unidad para desarrolladores especificada.

untrust No confía en la unidad para desarrolladores especificada.

setFiltersAllowed Establece la lista de filtros permitidos para la unidad para desarrolladores.

clearFiltersAllowed Borra la lista de filtros permitidos para la unidad para desarrolladores.

Sintaxis

fsutil devdrv query [<volume path>]

fsutil devdrv enable [/allowAv|/disallowAv]

fsutil devdrv disable

fsutil devdrv trust [/f] <volume path>

fsutil devdrv untrust [/f] <volume path>

fsutil devdrv setFiltersAllowed [[/f] /volume <volume path>] "filter1,


filter 2, ..."

fsutil devdrv clearFiltersAllowed [[/f] <volume path>]

fsutil devdrv query


Consulta información sobre las unidades para desarrolladores o la unidad para
desarrolladores especificada. El comando muestra si el volumen especificado es una
unidad para desarrolladores y si es de confianza. El comando también enumera los
filtros que se pueden conectar y los que están conectados actualmente a la unidad para
desarrolladores.

Ejemplos de fsutil devdrv query


En el siguiente ejemplo se muestra la salida del comando query.

Ejemplo 1: Consultar información de unidades para desarrolladores


El comando consulta información sobre las unidades para desarrolladores de este
sistema.

fsutil devdrv query

Ejemplo 2: Consultar información de unidades para desarrolladores


de un volumen especificado

El siguiente comando consulta la información relacionada con la unidad para


desarrolladores D: . El comando enumera los filtros conectados actualmente a D: , si es
una unidad para desarrolladores.

fsutil devdrv query D:

fsutil devdrv enable


Habilita la compatibilidad con unidades para desarrolladores en este sistema.
Ejemplos de fsutil devdrv enable
En el ejemplo siguiente se muestra la salida del comando enable.

Ejemplo 1: Habilitar la compatibilidad con unidades para


desarrolladores
Este comando habilita la unidad para desarrolladores y permite al sistema decidir si
desea permitir que el filtro antivirus se conecte a una unidad para desarrolladores.

fsutil devdrv enable

Ejemplo 2: Habilitar la compatibilidad con unidades para


desarrolladores y conceder permiso para conectar el filtro antivirus

Con este comando, se habilita la unidad para desarrolladores a la vez que se permite
que el filtro antivirus se conecte a una unidad para desarrolladores.

fsutil devdrv enable /allowAv

Ejemplo 3: Habilitar la compatibilidad con unidades para


desarrolladores y denegar el permiso para conectar el filtro
antivirus
El siguiente comando habilita la unidad para desarrolladores sin permitir que el filtro
antivirus se conecte a una unidad para desarrolladores.

fsutil devdrv enable /disallowAv

fsutil devdrv disable


Deshabilita la compatibilidad con unidades para desarrolladores en este sistema.

7 Nota
Las unidades para desarrolladores actuales funcionarán como un volumen normal,
es decir, pueden conectarse todos los filtros.

fsutil devdrv trust


Confía en la unidad para desarrolladores especificada. La directiva de conexión de filtros
de unidad para desarrolladores se cumple únicamente con unidades para
desarrolladores de confianza.

Parámetros de fsutil devdrv trust

Parámetro Descripción

F/ Fuerza el desmontaje del volumen para que el cambio surta efecto inmediatamente
incluso si el volumen está en uso. De lo contrario, el volumen se desmonta solo si
no está en uso.

Ejemplos de fsutil devdrv trust


En los ejemplos siguientes se muestra la salida del comando trust.

Ejemplo 1: Confiar en una unidad para desarrolladores en un


volumen especificado

Este comando confía en el volumen D: . El volumen no se desmonta si está en uso, el


cambio surte efecto la próxima vez que se monte el volumen.

fsutil devdrv trust D:

Ejemplo 2: Confiar inmediatamente en una unidad para


desarrolladores en un volumen especificado

Con este comando, se confía en el volumen y se desmonta forzosamente para que el


cambio surta efecto inmediatamente.
fsutil devdrv trust /f D:

fsutil devdrv untrust


No confía en la unidad para desarrolladores especificada. No se cumple la directiva de
conexión de filtros de unidad para desarrolladores para una unidad que no es de
confianza.

Parámetros de fsutil devdrv untrust

Parámetro Descripción

F/ Fuerza el desmontaje del volumen para que el cambio surta efecto inmediatamente
incluso si el volumen está en uso. De lo contrario, el volumen se desmonta solo si
no está en uso.

Ejemplos de fsutil devdrv untrust


En los ejemplos siguientes se muestra la salida del comando untrust.

Ejemplo 1: No confiar en una unidad para desarrolladores en un


volumen especificado

Con el siguiente comando no se confía en el volumen D: . El volumen no se desmonta si


está en uso y el cambio surte efecto la próxima vez que se monte el volumen.

fsutil devdrv untrust D:

Ejemplo 2: No confiar inmediatamente en una unidad para


desarrolladores en un volumen especificado

Con este comando, no se confía en el volumen D: y se desmonta forzosamente para


que el cambio surta efecto inmediatamente.

fsutil devdrv untrust /f D:


fsutil devdrv setFiltersAllowed
Establece la lista de filtros permitidos en la unidad para desarrolladores especificada o
cualquier unidad para desarrolladores de este sistema.

Parámetros de fsutil devdrv setFiltersAllowed

Parámetro Descripción

F/ Fuerza el desmontaje del volumen para que el cambio surta efecto inmediatamente
incluso si el volumen está en uso. De lo contrario, el volumen, si se especifica, se
desmonta solamente si no está en uso.
Nota: el parámetro sólo está disponible cuando se proporciona <volume path> .

/Volume Si se especifica, la lista de filtros permitidos se establece solamente para este


volumen.

Ejemplos de fsutil devdrv setFiltersAllowed


En los ejemplos siguientes se muestra la salida del comando setFiltersAllowed.

Ejemplo 1: Establecer la lista de filtros permitidos para cualquier


unidad para desarrolladores del sistema

El comando permite conectar filter1 y filter2 a cualquier unidad para


desarrolladores del sistema. El cambio surte efecto la próxima vez que se monte una
unidad para desarrolladores.

fsutil devdrv setFiltersAllowed "filter1, filter 2"

Ejemplo 2: Establecer la lista de filtros permitidos para un volumen


especificado

Con este comando, se permite la conexión de filter1 y filter2 a la unidad para


desarrolladores D: . El volumen no se desmonta si está en uso y el cambio surte efecto
la próxima vez que se monte el volumen.
fsutil devdrv setFiltersAllowed /volume D: filter1,filter2

Ejemplo 3: Establecer la lista de filtros permitidos inmediatamente


para un volumen especificado

El comando siguiente permite conectar filter1 y filter2 a la unidad para


desarrolladores D: . El comando desmonta forzosamente el volumen para que el cambio
surta efecto inmediatamente.

fsutil devdrv setFiltersAllowed /f /volume D: filter1,filter2

fsutil devdrv clearFiltersAllowed


Borra la lista de filtros permitidos para la unidad para desarrolladores especificada o
cualquier unidad para desarrolladores de este sistema.

Parámetros de fsutil devdrv clearFiltersAllowed

Parámetro Descripción

F/ Fuerza el desmontaje del volumen para que el cambio surta efecto inmediatamente
incluso si el volumen está en uso. De lo contrario, el volumen, si se especifica, se
desmonta solamente si no está en uso.
Nota: el parámetro sólo está disponible cuando se proporciona <volume path> .

/Volume Si se especifica, la lista de filtros permitidos se establece solamente para este


volumen.

Ejemplos de fsutil devdrv clearFiltersAllowed


En los ejemplos siguientes se muestra la salida del comando clearFiltersAllowed.

Ejemplo 1: Borrar la lista de filtros permitidos para cualquier unidad


para desarrolladores de este sistema

Este comando borra la lista de filtros permitidos para cualquier unidad para
desarrolladores de este sistema. El cambio surte efecto la próxima vez que se monte una
unidad para desarrolladores en este sistema.
fsutil devdrv clearFiltersAllowed

Ejemplo 2: Borrar la lista de filtros permitidos para un volumen


especificado

El siguiente comando borra la lista de filtros permitidos para D: . El volumen no se


desmonta si está en uso, el cambio surte efecto la próxima vez que se monte el
volumen.

fsutil devdrv clearFiltersAllowed D:

7 Nota

D: debe ser una unidad para desarrolladores.

Ejemplo 3: Borrar inmediatamente la lista de filtros permitidos para


un volumen especificado

El siguiente comando borra la lista de filtros permitidos en D: . El comando desmonta


forzosamente el volumen para que el cambio surta efecto inmediatamente.

fsutil devdrv clearFiltersAllowed /f D:

7 Nota

D: debe ser una unidad para desarrolladores.

Vínculos relacionados
Clave de sintaxis de línea de comandos
fsutil
Unidad de desarrollo
fsutil dirty
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y
Windows 8

Consulta o establece el bit de integridad de un volumen. Cuando se establece el bit de


integridad de un volumen, autochk comprueba automáticamente los errores del
volumen la próxima vez que se reinicia el equipo.

Sintaxis

fsutil dirty {query | set} <volumepath>

Parámetros

Parámetro Descripción

Query Consulta el bit de integridad del volumen especificado.

set Establece el bit de integridad del volumen especificado.

<volumepath> Especifica el nombre de la unidad seguido de dos puntos o GUID en el formato


siguiente: volume{GUID} .

Comentarios
El bit de integridad de un volumen indica que el sistema de archivos puede estar
en un estado incoherente. El bit de integridad se puede establecer porque:

El volumen está en línea y tiene cambios pendientes.

Se realizaron cambios en el volumen y el equipo se cerró antes de confirmar los


cambios en el disco.

Se detectaron daños en el volumen.


Si el bit de integridad se establece cuando se reinicia el equipo, chkdsk se ejecuta
para comprobar la integridad del sistema de archivos e intentar corregir cualquier
problema relacionado con el volumen.

Ejemplos
Para consultar el bit de integridad en la unidad C, escriba lo siguiente:

fsutil dirty query c:

Si el volumen contiene errores, se muestra la siguiente salida: Volume C: is dirty

Si el volumen no contiene errores, se muestra la siguiente salida: Volume C: is not


dirty

Para establecer el bit de integridad en la unidad C, escriba lo siguiente:

fsutil dirty set C:

Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil
fsutil file
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y
Windows 8

Busca un archivo por nombre de usuario (si se habilitan cuotas de disco), consulta los
intervalos asignados para un archivo, establece el nombre corto de un archivo, establece
la longitud de datos válidos de un archivo, establece cero datos para un archivo o crea
un archivo.

Sintaxis

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 Descripción

createnew Crea un archivo con el nombre y el tamaño especificados y con


contenido que consta de ceros.

<length> Especifica la longitud de datos válidos del archivo.

findbysid Busca archivos que pertenecen a un usuario especificado en volúmenes


NTFS en los que están habilitadas las cuotas de disco.

<username> Especifica el nombre de usuario o el nombre de inicio de sesión del


usuario.
Parámetro Descripción

<directory> Especifica la ruta de acceso completa al directorio, por ejemplo,


C:\Usuarios.

optimizemetadata Esto realiza una compactación inmediata de los metadatos de un


archivo determinado.

/a Analiza los metadatos de archivo antes y después de la optimización.

queryallocranges Consulta los intervalos asignados para un archivo en un volumen NTFS.


Resulta útil para determinar si un archivo tiene regiones dispersas.

offset= <offset> Especifica el inicio del intervalo que se debe establecer en ceros.

length= <length> Especifica la longitud del intervalo (en bytes).

queryextents Consulta extensiones para un archivo.

/r Si <filename> es un punto de reanálisis, ábralo en lugar de su destino.

<startingvcn> Especifica el primer VCN que se va a consultar. Si se omite, comience


en VCN 0.

<numvcns> Número de VCN que se van a consultar. Si se omite o es 0, consulte


hasta EOF.

queryfileid Consulta el identificador de archivo de un archivo en un volumen NTFS.

<volume> Especifica el volumen como el nombre de la unidad seguido de dos


puntos.

queryfilenamebyid Muestra un nombre de vínculo aleatorio para un identificador de


archivo especificado en un volumen NTFS. Dado que un archivo puede
tener más de un nombre de vínculo que apunte a ese archivo, no se
garantiza qué vínculo de archivo se proporcionará como resultado de
la consulta del nombre de archivo.

<fileid> Especifica el identificador del archivo en un volumen NTFS.

queryoptimizemetadata Consulta el estado de los metadatos de un archivo.

queryvaliddata Consulta la longitud de datos válidos para un archivo.

/d Muestra información de datos válidos detallada.

seteof Establece el EOF del archivo especificado.

setshortname Establece el nombre corto (nombre de archivo de longitud de


8,3 caracteres) para un archivo en un volumen NTFS.

<shortname> Especifica el nombre corto del archivo.


Parámetro Descripción

setvaliddata Establece la longitud de datos válidos para un archivo en un volumen


NTFS.

<datalength> Especifica la longitud del archivo en bytes.

setzerodata Establece un intervalo (especificado por desplazamiento y longitud) del


archivo en ceros, lo que vacía el archivo. Si el archivo es un archivo
disperso, se anula la confirmación de las unidades de asignación
subyacentes.

Comentarios

En NTFS, hay dos conceptos importantes relacionados con la longitud de archivo:


el marcador de fin de archivo (EOF) y la longitud de datos válidos (VDL). El EOF
indica la longitud real del archivo. La VDL identifica la longitud de los datos válidos
en el disco. Las lecturas entre la VDL y el EOF devuelven automáticamente 0 para
conservar el requisito de reutilización de objetos de C2.

El parámetro setvaliddata solo está disponible para los administradores, porque


requiere el privilegio Realizar tareas de mantenimiento de volumen
(SeManageVolumePrivilege). Esta característica solo es necesaria para escenarios
avanzados de red multimedia y de área del sistema. El parámetro setvaliddata
debe ser un valor positivo mayor que la VDL actual, pero menor que el tamaño
actual del archivo.

Resulta útil para que los programas establezcan una VDL cuando:

Se escriben clústeres sin procesar directamente en el disco a través de un canal


de hardware. Esto permite que el programa informe al sistema de archivos de
que este intervalo contiene datos válidos que se pueden devolver al usuario.

Se crean archivos grandes cuando el rendimiento es un problema. Esto evita el


tiempo que se necesita para rellenar el archivo con ceros al crear o ampliar el
archivo.

Ejemplos
Para buscar archivos que son propiedad de scottb en la unidad C, escriba:

fsutil file findbysid scottb c:\users


Para consultar los intervalos asignados para un archivo en un volumen NTFS, escriba:

fsutil file queryallocranges offset=1024 length=64 c:\temp\sample.txt

Para optimizar los metadatos de un archivo, escriba:

fsutil file optimizemetadata C:\largefragmentedfile.txt

Para consultar las extensiones de un archivo, escriba:

fsutil file queryextents C:\Temp\sample.txt

Para establecer el EOF de un archivo, escriba:

fsutil file seteof C:\testfile.txt 1000

Para establecer el nombre corto del archivo, longfilename.txt, en la unidad C en


longfile.txt, escriba:

fsutil file setshortname c:\longfilename.txt longfile.txt

Para establecer la longitud de datos válidos en 4096 bytes para un archivo denominado
testfile.txt en un volumen NTFS, escriba:

fsutil file setvaliddata c:\testfile.txt 4096

Para establecer un intervalo de un archivo en un volumen NTFS en ceros para vaciarlo,


escriba:

fsutil file setzerodata offset=100 length=150 c:\temp\sample.txt


Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil
fsutil fsinfo
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y
Windows 8

Muestra todas las unidades, consulta el tipo de unidad, consulta la información de


volumen, consulta la información de volumen específica de NTFS o consulta estadísticas
del sistema de archivos.

Sintaxis

fsutil fsinfo [drives]


fsutil fsinfo [drivetype] <volumepath>
fsutil fsinfo [ntfsinfo] <rootpath>
fsutil fsinfo [statistics] <volumepath>
fsutil fsinfo [volumeinfo] <rootpath>

Parámetros

Parámetro Descripción

unidades Muestra todas las unidades del equipo.

drivetype Consulta una unidad y enumera su tipo, por ejemplo, una unidad de CD-ROM.

ntfsinfo Muestra la información de volumen específica de NTFS para el volumen


especificado, como el número de sectores, los clústeres totales, los clústeres
libres y el inicio y el final de la zona MFT.

sectorinfo Muestra información sobre la alineación y el tamaño del sector del hardware.

estadísticas Muestra las estadísticas del sistema de archivos para el volumen especificado,
como metadatos, archivo de registro y lecturas y escrituras de MFT.

volumeinfo Muestra información para el volumen especificado, como el sistema de archivos,


y si el volumen admite nombres de archivo que distinguen mayúsculas de
minúsculas, unicode en nombres de archivo, cuotas de disco o es un volumen de
DirectAccess (DAX).

<volumepath>: Especifica la letra de unidad (seguida de dos puntos).


Parámetro Descripción

<rootpath>: Especifica la letra de unidad (seguida de dos puntos) de la unidad raíz.

Ejemplos
Para mostrar todas las unidades del equipo, escriba:

fsutil fsinfo drives

Esto genera una salida similar a las visualizaciones siguientes:

Drives: A:\ C:\ D:\ E:\

Para consultar el tipo de unidad de la unidad C, escriba:

fsutil fsinfo drivetype c:

Los posibles resultados de la consulta incluyen:

Unknown Drive
No such Root Directory
Removable Drive, for example floppy
Fixed Drive
Remote/Network Drive
CD-ROM Drive
Ram Disk

Para consultar la información del volumen E, escriba:

fsutil fsinfo volumeinfo e:

Esto genera una salida similar a las visualizaciones siguientes:


Volume Name : Volume
Serial Number : 0xd0b634d9
Max Component Length : 255
File System Name : NTFS
Supports Named Streams
Is DAX Volume

Para consultar la unidad F para información de volumen específica de NTFS, escriba:

fsutil fsinfo ntfsinfo f:

Esto genera una salida similar a las visualizaciones siguientes:

NTFS Volume Serial Number : 0xe660d46a60d442cb


Number Sectors : 0x00000000010ea04f
Total Clusters : 0x000000000021d409
Mft Zone End : 0x0000000000004700

Para consultar el hardware subyacente del sistema de archivos para información del
sector, escriba:

fsutil fsinfo sectorinfo d:

Esto genera una salida similar a las visualizaciones siguientes:

D:\>fsutil fsinfo sectorinfo d:


LogicalBytesPerSector : 4096
PhysicalBytesPerSectorForAtomicity : 4096
Trim Not Supported
DAX capable

Para consultar las estadísticas del sistema de archivos de la unidad E, escriba:

fsutil fsinfo statistics e:


Esto genera una salida similar a las visualizaciones siguientes:

File System Type : NTFS


Version : 1
UserFileReads : 75021
UserFileReadBytes : 1305244512
LogFileWriteBytes : 180936704

Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil
fsutil hardlink
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y
Windows 8

Crea un vínculo físico entre un archivo existente y un archivo nuevo. Un vínculo físico es
una entrada de directorio para un archivo. Cada archivo se puede considerar que tiene
al menos un vínculo físico.

En volúmenes NTFS, cada archivo puede tener varios vínculos físicos, por lo que un
único archivo puede aparecer en muchos directorios (o incluso en el mismo directorio
con nombres diferentes). Dado que todos los vínculos hacen referencia al mismo
archivo, los programas pueden abrir cualquiera de los vínculos y modificar el archivo. Un
archivo se elimina del sistema de archivos solo después de que se hayan eliminado
todos los vínculos a él. Después de crear un vínculo físico, los programas pueden usarlo
como cualquier otro nombre de archivo.

Sintaxis

fsutil hardlink create <newfilename> <existingfilename>


fsutil hardlink list <filename>

Parámetros

Parámetro Descripción

create Establece un vínculo físico NTFS entre un archivo existente y otro nuevo.
(Un vínculo físico NTFS es similar a un vínculo físico POSIX).

<newfilename> Especifica el archivo al que desea crear un vínculo físico.

<existingfilename> Especifica el archivo desde el que desea crear un vínculo físico.

list Enumera los vínculos físicos al nombre de archivo.

Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil
fsutil objectid
Artículo • 12/04/2023

Se aplica a Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y
Windows 8

Administra identificadores de objeto (OID), que son objetos internos utilizados por el
servicio de cliente de Seguimiento de vínculos distribuidos (DLT) y el Servicio de
replicación de archivos (FRS), para realizar un seguimiento de otros objetos, como
archivos, directorios y vínculos. Los identificadores de objeto son invisibles para la
mayoría de los programas y nunca se deben modificar.

2 Advertencia

No elimine, establezca ni modifique un identificador de objeto. La eliminación o


establecimiento de un identificador de objeto puede provocar desde la pérdida de
datos de partes de un archivo hasta volúmenes completos de datos. Además,
puede provocar un comportamiento adverso en el Servicio de cliente de
Seguimiento de vínculos distribuidos (DLT) y en el Servicio de replicación de
archivos (FRS).

Sintaxis

fsutil objectid [create] <filename>


fsutil objectid [delete] <filename>
fsutil objectid [query] <filename>
fsutil objectid [set] <objectID> <birthvolumeID> <birthobjectID> <domainID>
<filename>

Parámetros

Parámetro Descripción

create Crea un identificador de objeto si el archivo especificado no dispone de uno.


Si el archivo ya tiene un identificador de objeto, este subcomando es
equivalente al subcomando de consulta.
Parámetro Descripción

delete Elimina un identificador de objeto.

Query Consulta un identificador de objeto.

set Establece un identificador de objeto.

<objectID> Establece un identificador hexadecimal de 16 bytes específico de un archivo


que se garantiza que es único dentro de un volumen. El Servicio de cliente de
Seguimiento de vínculos distribuidos (DLT) y el servicio de replicación de
archivos (FRS) usan el identificador de objeto para identificar archivos.

<birthvolumeID> Indica el volumen en el que se encontraba el archivo cuando obtuvo por


primera vez un identificador de objeto. Este valor es un identificador
hexadecimal de 16 bytes que usa el Servicio de cliente DLT.

<birthobjectID> Indica el identificador de objeto original del archivo (el objectID puede cambiar
cuando se mueve un archivo). Este valor es un identificador hexadecimal de 16
bytes que usa el Servicio de cliente DLT.

<domainID> Identificador de dominio hexadecimal de 16 bytes. Este valor no se usa


actualmente y debe establecerse en todos los ceros.

<filename> Especifica la ruta de acceso completa al archivo, incluido el nombre de archivo


y la extensión, por ejemplo C:\documents\filename.txt.

Comentarios

Cualquier archivo que tenga un identificador de objeto también tiene un


identificador de volumen de nacimiento, un identificador de objeto de nacimiento
y un identificador de dominio. Al mover un archivo, el identificador de objeto
puede cambiar, pero los identificadores de volumen de nacimiento y objeto de
nacimiento siguen siendo los mismos. Este comportamiento permite que el
sistema operativo Windows siempre encuentre un archivo, sin importar a dónde se
haya movido.

Ejemplos
Para crear un identificador de objeto, escriba lo siguiente:

fsutil objectid create c:\temp\sample.txt

Para eliminar un identificador de objeto, escriba lo siguiente:

fsutil objectid delete c:\temp\sample.txt


Para consultar un identificador de objeto, escriba lo siguiente:

fsutil objectid query c:\temp\sample.txt

Para establecer un identificador de objeto, escriba lo siguiente:

fsutil objectid set 40dff02fc9b4d4118f120090273fa9fc


f86ad6865fe8d21183910008c709d19e 40dff02fc9b4d4118f120090273fa9fc

00000000000000000000000000000000 c:\temp\sample.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil
fsutil quota
Artículo • 12/04/2023

Se aplica a Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y
Windows 8

Administra las cuotas de disco en volúmenes NTFS para proporcionar un control más
preciso del almacenamiento basado en red.

Sintaxis

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 Descripción

disable Deshabilita el seguimiento de cuotas y la aplicación en el volumen especificado.

aplicar Aplica el uso de cuota en el volumen especificado.

modify Modifica una cuota de disco existente o crea una nueva cuota.

Query Enumera las cuotas de disco existentes.

track Realiza un seguimiento del uso del disco en el volumen especificado.

infracciones Busca en los registros de aplicación y en el sistema y muestra un mensaje para


indicar que se han detectado infracciones de cuota o que un usuario ha
alcanzado un umbral de cuota o un límite de cuota.

<volumepath> Necesario. Especifica el nombre de la unidad seguido de dos puntos o GUID en el


formato volume{GUID} .

<threshold> Establece el límite (en bytes) en el que se emiten advertencias. Este parámetro es
necesario para el comando fsutil quota modify .
Parámetro Descripción

<limit> Establece el uso máximo permitido del disco (en bytes). Este parámetro es
necesario para el comando fsutil quota modify .

<username> Especifica el dominio o el nombre de usuario. Este parámetro es necesario para el


comando fsutil quota modify .

Comentarios

Las cuotas de disco se implementan por volumen y permiten implementar los


límites de almacenamiento permanentes y temporales por usuario.

Puede usar scripts de escritura que usen fsutil quota para establecer los límites de
cuota cada vez que agregue un nuevo usuario o realice un seguimiento
automático de los límites de cuota, compilarlos en un informe y enviarlos
automáticamente al administrador del sistema por correo electrónico.

Ejemplos
Para enumerar las cuotas de disco existentes para un volumen de disco especificado con
el GUID, {928842df-5a01-11de-a85c-806e6f6e6963}, escriba lo siguiente:

fsutil quota query volume{928842df-5a01-11de-a85c-806e6f6e6963}

Para enumerar las cuotas de disco existentes de un volumen de disco especificado con
la letra de unidad, C:, escriba lo siguiente:

fsutil quota query C:

Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil
fsutil repair
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y
Windows 8

Administra y supervisa las operaciones de reparación automática de NTFS. La


recuperación automática de NTFS intenta corregir daños del sistema de archivos NTFS
en línea, sin necesidad de que se ejecute Chkdsk.exe. Para obtener más información,
consulte NTFS de recuperación automática.

Sintaxis

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 Descripción

enumerar Enumera todo el registro de daños de un volumen.

<logname> Puede ser $corrupt , el conjunto de daños confirmados en el volumen, o


$verify , un conjunto de posibles daños no comprobados en el volumen.

iniciar Inicia la recuperación automática de NTFS.

<filereference> Especifica el identificador de archivo específico del volumen NTFS (número de


referencia de archivo). La referencia de archivo incluye el número de segmento
del archivo.

Query Consulta el estado de recuperación automática del volumen NTFS.

set Establece el estado de recuperación automática del volumen.


Parámetro Descripción

<flags> Especifica el método de reparación que se usará al establecer el estado de


recuperación automática del volumen.
Este parámetro se puede establecer en tres valores:

0x01: habilita la reparación general.


0x09: advierte sobre la posible pérdida de datos sin reparación.
0x00: deshabilita las operaciones de reparación automática de NTFS.

state Consulta el estado dañado del sistema o de un volumen determinado.

wait Espera a que se completen las reparaciones. Si NTFS ha detectado un


problema en un volumen en el que realiza reparaciones, esta opción permite al
sistema esperar hasta que se complete la reparación antes de ejecutar los
scripts pendientes.

[waittype Indica si se debe esperar a que se complete la reparación actual o a que se


{0|1}] completen todas las reparaciones. El parámetro waittype puede establecerse
en uno de los valores siguientes:

0: espera a que se completen todas las reparaciones. (valor


predeterminado)
1: espera a que se complete la reparación actual.

Ejemplos
Para enumerar los daños confirmados de un volumen, escriba:

fsutil repair enumerate C: $Corrupt

Para habilitar la reparación automática en la unidad C, escriba:

fsutil repair set c: 1

Para deshabilitar la reparación automática en la unidad C, escriba:

fsutil repair set c: 0


Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil

Recuperación automática de NTFS


fsutil reparsepoint
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y
Windows 8

Consulta o elimina puntos de repetición de análisis. Normalmente, los profesionales de


soporte técnico usan el comando fsutil reparsepoint.

Los puntos de repetición de análisis son objetos del sistema de archivos NTFS que
tienen un atributo definible, que contiene datos definidos por el usuario. Se usan para:

Ampliar la funcionalidad en el subsistema de entrada y salida (E/S)

Actuar como puntos de unión de directorios y puntos de montaje de volumen

Marcar determinados archivos como especiales para un controlador de filtro del


sistema de archivos

Sintaxis

fsutil reparsepoint [query] <filename>


fsutil reparsepoint [delete] <filename>

Parámetros

Parámetro Descripción

Query Recupera los datos de punto de repetición de análisis asociados al archivo o


directorio identificado por el identificador especificado.

delete Elimina un punto de repetición de análisis del archivo o directorio identificado por
el identificador especificado, pero no elimina el archivo o directorio.

<filename> Especifica la ruta de acceso completa al archivo, incluido el nombre de archivo y la


extensión, por ejemplo, C:\documents\filename.txt.

Comentarios
Cuando un programa establece un punto de repetición de análisis, almacena estos
datos, además de una etiqueta de repetición de análisis, que identifica de forma
única los datos que almacena. Cuando el sistema de archivos abre un archivo con
un punto de repetición de análisis, intenta buscar el filtro del sistema de archivos
asociado. Si se encuentra el filtro del sistema de archivos, el filtro procesa el
archivo según lo indicado por los datos de repetición de análisis. Si no se
encuentra ningún filtro del sistema de archivos, se produce un error en la
operación Abrir archivos.

Ejemplos
Para recuperar datos de punto de repetición de análisis asociados a c:\server, escriba:

fsutil reparsepoint query c:\server

Para eliminar un punto de repetición de análisis de un archivo o directorio especificados,


use el siguiente formato:

fsutil reparsepoint delete c:\server

Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil
fsutil resource
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y
Windows 8

Crea un administrador de recursos transaccionales secundario, inicia o detiene un


administrador de recursos transaccionales o muestra información sobre un
administrador de recursos transaccionales y modifica el comportamiento siguiente:

Si un administrador de recursos transaccionales predeterminado limpia sus


metadatos transaccionales en el siguiente montaje.

El administrador de recursos transaccionales especificado para preferir la


coherencia sobre la disponibilidad.

El administrador de recursos transaccionales especificado para preferir la


disponibilidad sobre la coherencia.

Características de un administrador de recursos transaccionales en ejecución.

Sintaxis

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 Descripción
Parámetro Descripción

create Crea un administrador de recursos transaccionales secundario.

<rmrootpathname> Especifica la ruta de acceso completa a un directorio raíz del


administrador de recursos transaccionales.

info Muestra la información del administrador de recursos transaccionales


especificado.

setautoreset Especifica si un administrador de recursos transaccionales


predeterminado limpiará los metadatos transaccionales en el
siguiente montaje.
true: especifica que el administrador de recursos
transaccionales limpiará los metadatos transaccionales en el
siguiente montaje de forma predeterminada.
false: especifica que el administrador de recursos
transaccionales no limpiará los metadatos transaccionales en el
siguiente montaje de forma predeterminada.

<defaultrmrootpathname> Especifica el nombre de la unidad seguido de dos puntos.

setavailable Especifica que un administrador de recursos transaccionales preferirá


la disponibilidad sobre la coherencia.

setconsistent Especifica que un administrador de recursos transaccionales preferirá


la coherencia sobre la disponibilidad.

setlog Cambia las características de un administrador de recursos


transaccionales que ya se está ejecutando.

growth Especifica la cantidad por la que puede crecer el registro de


administrador de recursos transaccionales.
El parámetro de crecimiento se puede especificar de la siguiente
manera:

Número de contenedores, con el formato: <containers>


containers
Porcentaje, con el formato: <percent> percent

<containers> Especifica los objetos de datos utilizados por el administrador de


recursos transaccionales.

maxextent Especifica el número máximo de contenedores para el administrador


de recursos transaccionales especificado.

minextent Especifica el número mínimo de contenedores para el administrador


de recursos transaccionales especificado.
Parámetro Descripción

mode {full|undo} Especifica si todas las transacciones se registran (completas) o solo se


registran los eventos de reversión (deshacer).

rename Cambia el GUID del administrador de recursos transaccionales.

shrink Especifica el porcentaje por el que el registro del administrador de


recursos transaccionales puede disminuir automáticamente.

tamaño Especifica el tamaño del administrador de recursos transaccionales


como un número especificado de contenedores.

start Inicia el administrador de recursos transaccionales especificado.

stop Detiene el administrador de recursos transaccionales especificado.

Ejemplos
Para establecer el registro del administrador de recursos transaccionales especificado
por c:\test, para tener un crecimiento automático de cinco contenedores, escriba:

fsutil resource setlog growth 5 containers c:test

Para establecer el registro del administrador de recursos transaccionales especificado


por c:\test, para tener un crecimiento automático del dos por ciento, escriba:

fsutil resource setlog growth 2 percent c:test

Para especificar que el administrador de recursos transaccionales predeterminado


limpiará los metadatos transaccionales en el siguiente montaje en la unidad C, escriba:

fsutil resource setautoreset true c:\

Vínculos relacionados
Clave de sintaxis de línea de comandos
fsutil

NTFS de transacciones
fsutil sparse
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y
Windows 8

Administra archivos dispersos. Un archivo disperso es un archivo con una o varias


regiones de datos no asignados en él.

Un programa ve estas regiones sin asignar como que contienen bytes con un valor cero
y que no hay espacio en disco que represente estos ceros. Cuando se lee un archivo
disperso, los datos asignados se devuelven como almacenados y los datos sin asignar se
devuelven, de forma predeterminada, como ceros, de acuerdo con la especificación de
requisito de seguridad C2. La compatibilidad con archivos dispersos permite desasignar
los datos desde cualquier lugar del archivo.

Sintaxis

fsutil sparse [queryflag] <filename>


fsutil sparse [queryrange] <filename>
fsutil sparse [setflag] <filename>
fsutil sparse [setrange] <filename> <beginningoffset> <length>

Parámetros

Parámetro Descripción

queryflag Consulta dispersa.

queryrange Examina un archivo y busca rangos que pueden contener datos distintos de
cero.

setflag Marca el archivo indicado como disperso.

setrange Rellena un intervalo especificado de un archivo con ceros.

<filename> Especifica la ruta de acceso completa al archivo, incluido el nombre de


archivo y la extensión, por ejemplo C:\documents\filename.txt.
Parámetro Descripción

<beginningoffset> Especifica el desplazamiento dentro del archivo que se va a marcar como


disperso.

<length> Especifica la longitud de la región del archivo que se va a marcar como


dispersa (en bytes).

Comentarios
Se asignan todos los datos significativos o no ceros, mientras que no se asignan
todos los datos no significativos (cadenas grandes de datos que se componen de
ceros).

En un archivo disperso, es posible que los intervalos grandes de ceros no requieran


asignación de disco. El espacio para los datos distintos de cero se asigna según sea
necesario cuando se escribe el archivo.

Solo los archivos comprimidos o dispersos pueden tener intervalos ceros


conocidos por el sistema operativo.

Si el archivo está disperso o comprimido, NTFS puede desasignar espacio en disco


dentro del archivo. Esto establece el intervalo de bytes en ceros sin extender el
tamaño del archivo.

Ejemplos
Para marcar un archivo denominado sample.txt en el directorio c:\temp como disperso,
escriba:

fsutil sparse setflag c:\temp\sample.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil
fsutil tiering
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10

Habilita la administración de funciones de nivel de almacenamiento, como la


configuración y deshabilitación de marcas y la lista de niveles.

Sintaxis

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 Descripción

clearflags Deshabilita las marcas de comportamiento por niveles de un volumen.

<volume> Especifica el volumen.

/trnh En el caso de los volúmenes con almacenamiento en capas, hace que la recopilación
de calor se deshabilite.
Solo se aplica a NTFS y ReFS.

queryflags Consulta las marcas de comportamiento por niveles de un volumen.

regionlist Enumera las regiones en capas de un volumen y sus respectivos niveles de


almacenamiento.

setflags Habilita las marcas de comportamiento por niveles de un volumen.

tierlist Enumera los niveles de almacenamiento asociados a un volumen.

Ejemplos
Para consultar las marcas en el volumen C, escriba:
fsutil tiering queryflags C:

Para establecer las marcas en el volumen C, escriba:

fsutil tiering setflags C: /trnh

Para borrar las marcas en el volumen C, escriba:

fsutil tiering clearflags C: /trnh

Para enumerar las regiones del volumen C y sus respectivos niveles de almacenamiento,
escriba:

fsutil tiering regionlist C:

Para enumerar los niveles del volumen C, escriba:

fsutil tiering tierlist C:

Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil
fsutil transaction
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y
Windows 8

Administra transacciones NTFS.

Sintaxis

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 Descripción

confirmación Marca el final de una transacción especificada correcta, ya sea implícita o explícita.

<GUID> Especifica el valor GUID que representa una transacción.

fileinfo Muestra información de transacción para el archivo especificado.

<filename> Especifica el nombre del archivo y la ruta de acceso completa.

list Muestra una lista de transacciones que actualmente están en ejecución.

Query Muestra información para la transacción especificada.


Si se especifica fsutil transaction query files , la información del archivo
solo se muestra para la transacción especificada.
Si se especifica fsutil transaction query all , se mostrará toda la
información de la transacción.

revertir Revierte una transacción especificada al principio.

Ejemplos
Para mostrar la información de transacción del archivo c:\test.txt, escriba:

fsutil transaction fileinfo c:\test.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil

NTFS de transacciones
fsutil usn
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y
Windows 8

Administra el diario de cambios del número de secuencias actualizadas (USN). Un diario


de cambios proporciona un registro persistente de todos los cambios realizados en los
archivos de un volumen. Cuando se agregan, eliminan y modifican archivos, directorios
y otros objetos del sistema de archivos NTFS, NTFS escribe registros en el diario de
cambios, uno para cada volumen del equipo. Cada registro indica el tipo de cambio y el
objeto cambiado. Los nuevos registros se anexan al final de la secuencia.

Sintaxis

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 Descripción

createjournal Crea un diario de cambios de USN.

m= <maxsize> Especifica el tamaño máximo, en bytes, que NTFS asigna para el diario de
cambios.

a= <allocationdelta> Especifica el tamaño, en bytes, de la asignación de memoria que se


agrega al final y se quita del principio del diario de cambios.

<volumepath> Especifica la letra de unidad (seguida de dos puntos).


Parámetro Descripción

deletejournal Elimina o deshabilita un diario de cambios de USN activo.


PRECAUCIÓN: La eliminación del diario de cambios afecta al servicio de
replicación de archivos (FRS) y al servicio de indexación, ya que requiere
que estos servicios realicen un examen completo (y lento) del volumen.
Esto, a su vez, afecta negativamente a la replicación y la replicación de
FRS SYSVOL entre las alternativas de vínculo DFS mientras se vuelve a
examinar el volumen.

/d Deshabilita un diario de cambios de USN activo y devuelve el control de


entrada/salida (E/S) mientras se deshabilita el diario de cambios.

/n Deshabilita un diario de cambios de USN activo y devuelve el control de


E/S solo después de deshabilitar el diario de cambios.

enablerangetracking Habilita el seguimiento del intervalo de escritura de USN para un


volumen.

c= <chunk-size> Especifica el tamaño del fragmento que se va a realizar en un volumen.

s= <file-size- Especifica el umbral de tamaño de archivo para el seguimiento de


threshold> intervalos.

enumdata Enumera y muestra las entradas del diario de cambios entre dos límites
especificados.

<fileref> Especifica la posición ordinal dentro de los archivos del volumen en el


que se va a comenzar la enumeración.

<lowUSN> Especifica el límite inferior del intervalo de valores USN utilizados para
filtrar los registros que se devuelven. Solo se devuelven los registros cuyo
último diario de cambios se encuentra entre o es igual que los valores de
miembro lowUSN y highUSN.

<highUSN> Especifica el límite superior del intervalo de valores USN usados para
filtrar los archivos que se devuelven.

queryjournal Consulta los datos de USN de un volumen para recopilar información


sobre el diario de cambios actual, sus registros y su capacidad.

readdata Lee los datos de USN de un archivo.

<filename> Especifica la ruta de acceso completa al archivo, incluido el nombre de


archivo y la extensión, por ejemplo: C:\documents\filename.txt.

readjournal Lee los registros de USN en el diario USN.

minver= <number> Versión principal mínima de USN_RECORD que se va a devolver. Valor


predeterminado = 2.
Parámetro Descripción

maxver= <number> Versión principal máxima de USN_RECORD que se va a devolver. Valor


predeterminado = 4.

startusn= <USN USN para empezar a leer el diario USN. Valor predeterminado = 0.
number>

Comentarios

Los programas pueden consultar el diario de cambios de USN para determinar


todas las modificaciones realizadas en un conjunto de archivos. El diario de
cambios de USN es mucho más eficaz que comprobar las marcas de tiempo o
registrar las notificaciones de archivos. El diario de cambios USN está habilitado y
lo usan el servicio de indexación, el servicio de replicación de archivos (FRS), los
servicios de instalación remota (RIS) y el almacenamiento remoto.

Si ya existe un diario de cambios en un volumen, el parámetro createjournal


actualiza los parámetros maxsize y allocationdelta del diario de cambios. Esto le
permite expandir el número de registros que mantiene un diario activo sin tener
que deshabilitarlo.

El diario de cambios puede aumentar más que este valor de destino, pero el diario
de cambios se trunca en el siguiente punto de control NTFS y pasa a ser menor
que este valor. NTFS examina el diario de cambios y lo recorta cuando su tamaño
supera el valor de maxsize más el valor de allocationdelta. En los puntos de
control NTFS, el sistema operativo escribe registros en el archivo de registro NTFS
que permiten a NTFS determinar qué procesamiento es necesario para recuperarse
de un error.

El diario de cambios puede crecer a más que la suma de los valores de maxsize y
allocationdelta antes de recortarse.

La eliminación o deshabilitación de un diario de cambios activo requiere mucho


tiempo, ya que el sistema debe tener acceso a todos los registros de la tabla de
archivos maestros (MFT) y establecer el último atributo USN en 0 (cero). Este
proceso puede tardar varios minutos y puede continuar después de reiniciar el
sistema, si es necesario reiniciarlo. Durante este proceso, el diario de cambios no
se considera activo ni está deshabilitado. Mientras el sistema deshabilita el diario,
no se puede acceder a él y todas las operaciones del diario devuelven errores.
Debe tener un cuidado extremo al deshabilitar un diario activo, ya que afecta
negativamente a otras aplicaciones que usan el diario.
Ejemplos
Para crear un diario de cambios de USN en la unidad C, escriba:

fsutil usn createjournal m=1000 a=100 c:

Para eliminar un diario de cambios de USN activo en la unidad C, escriba:

fsutil usn deletejournal /d c:

Para habilitar el seguimiento de intervalos con un tamaño de fragmento y un umbral de


tamaño de archivo especificados, escriba:

fsutil usn enablerangetracking c=16384 s=67108864 C:

Para enumerar y mostrar las entradas del diario de cambios entre dos límites
especificados en la unidad C, escriba:

fsutil usn enumdata 1 0 1 c:

Para consultar los datos de USN de un volumen en la unidad C, escriba:

fsutil usn queryjournal c:

Para leer los datos de USN de un archivo en la carpeta \Temp de la unidad C, escriba:

fsutil usn readdata c:\temp\sample.txt

Para leer el diario USN con un USN de inicio específico, escriba:


fsutil usn readjournal startusn=0xF00

Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil
fsutil volume
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012 y
Windows 8

Desmonta un volumen o consulta la unidad de disco duro para determinar qué cantidad
de espacio disponible hay actualmente en la unidad de disco duro o qué archivo usa un
clúster determinado.

Sintaxis

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 Descripción

allocationreport Muestra información sobre cómo se usa el almacenamiento en un volumen


determinado.

<volumepath> Especifica la letra de unidad (seguida de dos puntos).

diskfree Consulta la unidad de disco duro para determinar la cantidad de espacio libre
que contiene.

desmontar Desmonta un volumen.

filelayout Muestra los metadatos NTFS para el archivo especificado.

<fileID> Especifica el identificador de archivo.

list Enumera todos los volúmenes del sistema.

querycluster Identifica qué archivo usa un clúster especificado. Puede especificar varios
clústeres con el parámetro querycluster.
Parámetro Descripción

<cluster> Especifica el número de clúster lógico (LCN).

Ejemplos
Para mostrar un informe de clústeres asignados, escriba lo siguiente:

fsutil volume allocationreport C:

Para desmontar un volumen en la unidad C, escriba lo siguiente:

fsutil volume dismount c:

Para consultar la cantidad de espacio libre de un volumen en la unidad C, escriba lo


siguiente:

fsutil volume diskfree c:

Para mostrar toda la información sobre los archivos especificados, escriba lo siguiente:

fsutil volume C: *
fsutil volume C:\Windows
fsutil volume C: 0x00040000000001bf

Para enumerar los volúmenes en el disco, escriba lo siguiente:

fsutil volume list

Para identificar los archivos que usan los clústeres, especificados por los números de
clúster lógico 50 y 0x2000, en la unidad C, escriba lo siguiente:
fsutil volume querycluster C: 50 0x2000

Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil

Funcionamiento de NTFS
fsutil wim
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows 10

Proporciona funciones para detectar y administrar archivos respaldados por imágenes


de Windows (WIM).

Sintaxis

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 Descripción

enumfiles Enumera los archivos respaldados por WIM.

<drive Especifica el nombre de la unidad.


name>

<data Especifica el origen de datos.


source>

enumwims Enumera los archivos WIM de respaldo.

queryfile Consulta si el archivo está respaldado por WIM y, si es así, muestra detalles sobre
el archivo WIM.

<filename> Especifica el nombre de archivo.

removewim Quita un WIM de los archivos de respaldo.

Ejemplos
Para enumerar los archivos de la unidad C: del origen de datos 0, escriba:
fsutil wim enumfiles C: 0

Para enumerar los archivos WIM de respaldo para la unidad C:, escriba:

fsutil wim enumwims C:

Para ver si WIM respalda un archivo, escriba:

fsutil wim queryFile C:\Windows\Notepad.exe

Para quitar el WIM de los archivos de respaldo para el volumen C: y el origen de datos 2,
escriba:

fsutil wim removewims C: 2

Vínculos relacionados
Clave de sintaxis de línea de comandos

fsutil
ftp
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Transfiere archivos hacia y desde un equipo que ejecuta un servicio de servidor del
Protocolo de transferencia de archivos (ftp). Este comando se puede usar de forma
interactiva o en modo por lotes mediante el procesamiento de archivos de texto ASCII.

Sintaxis

ftp [-v] [-d] [-i] [-n] [-g] [-s:<filename>] [-a] [-A] [-x:<sendbuffer>] [-
r:<recvbuffer>] [-b:<asyncbuffers>][-w:<windowssize>][<host>] [-?]

Parámetros

Parámetro Descripción

-v Suprime la presentación de las respuestas del servidor remoto.

-d Habilita la depuración y muestra todos los comandos pasados entre el cliente


FTP y el servidor FTP.

-i Deshabilita la solicitud interactiva durante las transferencias de archivos


múltiples.

-n Suprime el inicio de sesión automático tras la conexión inicial.

-g Desactiva el uso de comodines en nombres de archivo. Glob permite el uso


del asterisco (*) y el signo de interrogación (?) como caracteres comodín en
los nombres de archivo y ruta de acceso locales.

-s: <filename> Especifica un archivo de texto que contiene comandos ftp. Estos comandos se
ejecutan automáticamente después de que se inicie ftp. Este parámetro no
permite espacios. Use este parámetro en lugar del redireccionamiento ( < ).
Nota: En Windows 8 y Windows Server 2012 o sistemas operativos
posteriores, el archivo de texto debe escribirse en UTF-8.

-a Especifica que se puede usar cualquier interfaz local al enlazar la conexión de


datos ftp.
Parámetro Descripción

-A Inicia sesión en el servidor ftp como anónimo.

-x: <sendbuffer> Invalida el tamaño de SO_SNDBUF predeterminado de 8192.

-r: <recvbuffer> Invalida el tamaño de SO_RCVBUF predeterminado de 8192.

-b: Invalida el recuento de búferes asincrónico predeterminado de 3.


<asyncbuffers>

-w: <windowssize> Especifica el tamaño del búfer de transferencia. El tamaño predeterminado de


las ventanas es de 4096 bytes.

<host> Especifica el nombre del equipo, la dirección IP o la dirección IPv6 del servidor
ftp al que se va a conectar. El nombre de host o la dirección, si se especifica,
deben ser el último parámetro de la línea.

-? Muestra la ayuda en el símbolo del sistema.

Comentarios

Los parámetros de la línea de comandos ftp distinguen las mayúsculas de las


minúsculas.

Este comando solo está disponible si el Protocolo de Internet (TCP/IP) está


instalado como componente en las propiedades de un adaptador de red en
Conexiones de red.

El comando ftp se puede usar de forma interactiva. Una vez iniciado, ftp crea un
entorno secundario en el que puede usar comandos ftp. Puede volver al símbolo
del sistema escribiendo el comando quit. Cuando se ejecuta el entorno secundario
ftp, se indica mediante el símbolo del sistema ftp > . Para más información,
consulte los comandos ftp.

El comando ftp admite el uso de IPv6 cuando el protocolo IPv6 está instalado.

Ejemplos
Para iniciar sesión en el servidor ftp denominado ftp.example.microsoft.com , escriba:

ftp ftp.example.microsoft.com
Para iniciar sesión en el servidor ftp denominado ftp.example.microsoft.com y ejecutar
los comandos ftp contenidos en un archivo denominado resync.txt, escriba:

ftp -s:resync.txt ftp.example.microsoft.com

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP

IP versión 6

Aplicaciones IPv6
ftp append
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Anexa un archivo local a un archivo en el equipo remoto mediante la configuración de


tipo de archivo actual.

Sintaxis

append <localfile> [remotefile]

Parámetros

Parámetro Descripción

<localfile> Especifica el archivo local que se va a agregar.

[remotefile] Especifica el archivo en el equipo remoto al que <localfile> se agrega. Si no usa


este parámetro, se usa el nombre <localfile> en lugar del nombre de archivo
remoto.

Ejemplos
Para anexar file1.txt a file2.txt en el equipo remoto, escriba:

append file1.txt file2.txt

Para anexar file1.txt local a un archivo denominado file1.txt en el equipo remoto.

append file1.txt
Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp ascii
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Establece el tipo de transferencia de archivos en ASCII. El comando ftp admite tipos de


transferencia de archivos ASCII (predeterminado) y binarios, pero se recomienda usar
ASCII al transferir archivos de texto. En el modo ASCII, se realizan conversiones de
caracteres hacia y desde el juego de caracteres estándar de red. Por ejemplo, los
caracteres de fin de línea se convierten según sea necesario, en función del sistema
operativo de destino.

Sintaxis

ascii

Ejemplos
Para establecer el tipo de transferencia de archivos en ASCII, escriba:

ascii

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ftp binary

Instrucciones adicionales de FTP


ftp bell
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Alterna un sonido audible para que se produzca después de que se complete cada
comando de transferencia de archivos. De forma predeterminada, este comando está
desactivado.

Sintaxis

bell

Ejemplos
Para alternar un sonido audible para que se produzca una vez completado cada
comando de transferencia de archivos, escriba:

bell

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp binary
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Establece el tipo de transferencia de archivos en binario. El comando ftp admite los


tipos de transferencia de archivos ASCII (predeterminado) y de imagen binaria, pero se
recomienda usar binarios al transferir archivos ejecutables. En modo binario, los archivos
se transfieren en unidades de un byte.

Sintaxis

binary

Ejemplos
Para establecer el tipo de transferencia de archivos en binario, escriba:

binary

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ftp ascii

Instrucciones adicionales de FTP


ftp bye
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Finaliza la sesión ftp en el equipo remoto y, a continuación, sale.

7 Nota

Este comando es el mismo que el comando ftp quit.

Sintaxis

bye

Ejemplos
Para finalizar la sesión ftp con el equipo remoto y salir, escriba:

bye

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ftp quit

Instrucciones adicionales de FTP


ftp cd
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el directorio de trabajo en el equipo remoto.

Sintaxis

cd <remotedirectory>

Parámetros

Parámetro Descripción

<remotedirectory> Especifica el directorio del equipo remoto al que desea cambiar.

Ejemplos
Para cambiar el directorio del equipo remoto a Docs, escriba:

cd Docs

Para cambiar el directorio del equipo remoto a Vídeos de mayo, escriba:

cd May Videos

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp close
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Finaliza la sesión ftp con el servidor remoto y permanece en el símbolo del sistema
ftp> .

Sintaxis

close

Ejemplos
Para finalizar la sesión ftp con el servidor remoto y permanecer en el símbolo del
sistema ftp> , escriba:

close

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp debug
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Alterna el modo de depuración. De forma predeterminada, la depuración está


desactivada. Si el modo de depuración está activado, verá cada comando enviado al
equipo remoto precedido por el carácter > .

Sintaxis

debug

Ejemplos
Para activar y desactivar el modo de depuración, escriba:

debug

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp delete
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Elimina archivos en equipos remotos.

Sintaxis

delete <remotefile>

Parámetros

Parámetro Descripción

<remotefile> Especifica el archivo que se va a eliminar.

Ejemplos
Para eliminar el archivo test.txt en el equipo remoto, escriba:

delete test.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp dir
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra una lista de archivos de directorios y subdirectorios en un equipo remoto.

Sintaxis

dir [<remotedirectory>] [<localfile>]

Parámetros

Parámetro Descripción

[<remotedirectory>] Especifica el directorio para el que desea ver una lista. Si no se especifica
ningún directorio, se usa el directorio de trabajo actual en el equipo
remoto.

[<localfile>] Especifica un archivo local en el que se va a almacenar la lista de


directorios. Si no se especifica un archivo local, los resultados se muestran
en la pantalla.

Ejemplos
Para mostrar una lista de directorios para dir1 en el equipo remoto, escriba:

dir dir1

Para guardar una lista del directorio actual en el equipo remoto en el archivo local
dirlist.txt, escriba:

dir . dirlist.txt
Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp disconnect
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Se desconecta del equipo remoto y permanece en el símbolo del sistema ftp> .

Sintaxis

disconnect

Ejemplos
Para desconectar del equipo remoto y permanece en el símbolo del sistema ftp> ,
escriba:

disconnect

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp get
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Copia un archivo remoto en el equipo local mediante el tipo de transferencia de


archivos actual.

7 Nota

Este comando es el mismo que el comando ftp recv.

Sintaxis

get <remotefile> [<localfile>]

Parámetros

Parámetro Descripción

<remotefile> Especifica el archivo remoto que se va a copiar.

[<localfile>] Especifica el nombre del archivo que se va a usar en el equipo local. Si no se


especifica localfile, el archivo recibe el nombre del remotefile.

Ejemplos
Para copiar test.txt en el equipo local mediante la transferencia de archivos actual,
escriba:

get test.txt

Para copiar test.txt en el equipo local como test1.txt mediante la transferencia de


archivos actual, escriba:
get test.txt test1.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ftp recv

Comando ftp ascii

Comando ftp binary

Instrucciones adicionales de FTP


ftp glob
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Alterna lo que permite la expansión de caracteres comodín para los nombres de archivo
locales. De forma predeterminada, la expansión global (expansión de caracteres
comodín) está activada. Si el globalizado está activado, podrá usar el asterisco (*) y el
signo de interrogación (?) como caracteres comodín en los nombres de archivo o ruta
de acceso locales.

Sintaxis

glob

Ejemplos
Para alternar si se permite la expansión de caracteres comodín de nombres de archivo
locales, escriba:

glob

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp hash
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Alterna la impresión de signo de número (#) para cada bloque de datos transferido. De
forma predeterminada, el comando hash está desactivado. El tamaño de un bloque de
datos es de 2048 bytes.

Sintaxis

hash

Ejemplos
Para alternar la impresión de signo de número (#) para cada bloque de datos
transferido, escriba:

hash

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp lcd
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el directorio de trabajo en el equipo local. De manera predeterminada, el


directorio de trabajo es el directorio en el que se inició el comando ftp.

Sintaxis

lcd [<directory>]

Parámetros

Parámetro Descripción

[<directory>] Especifica el directorio del equipo local que se va a cambiar. Si no se especifica


directory, el directorio de trabajo actual se cambia al directorio predeterminado.

Ejemplos
Para cambiar el directorio de trabajo del equipo local a c:\dir1, escriba:

lcd c:\dir1

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp literal
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Envía argumentos textuales al servidor ftp remoto. Se devuelve un único código de


respuesta ftp.

7 Nota

Este comando es el mismo que el comando ftp quote.

Sintaxis

literal <argument> [ ]

Parámetros

Parámetro Descripción

<argument> Especifica el argumento que se va a enviar al servidor ftp.

Ejemplos
Para enviar un comando quit al servidor ftp remoto, escriba:

literal quit

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ftp quote


Instrucciones adicionales de FTP
ftp ls
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra una lista abreviada de archivos y subdirectorios desde el equipo remoto.

Sintaxis

ls [<remotedirectory>] [<localfile>]

Parámetros

Parámetro Descripción

[<remotedirectory>] Especifica el directorio para el que desea ver una lista. Si no se especifica
ningún directorio, se usa el directorio de trabajo actual en el equipo
remoto.

[<localfile>] Especifica un archivo local en el que se va a almacenar la lista. Si no se


especifica un archivo local, los resultados se muestran en la pantalla.

Ejemplos
Para mostrar una lista abreviada de archivos y subdirectorios desde el equipo remoto,
escriba:

ls

Para obtener una lista abreviada de directorios de dir1 en el equipo remoto y guardarlo
en un archivo local denominado dirlist.txt, escriba:

ls dir1 dirlist.txt
Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp mget
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Copia archivos remotos en el equipo local mediante el tipo de transferencia de archivos


actual.

Sintaxis

mget <remotefile>[ ]

Parámetros

Parámetro Descripción

<remotefile> Especifica los archivos remotos que se van a copiar en el equipo local.

Ejemplos
Para copiar archivos remotos a.exe y b.exe en el equipo local mediante el tipo de
transferencia de archivos actual, escriba:

mget a.exe b.exe

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ftp ascii

Comando ftp binary

Instrucciones adicionales de FTP


ftp mkdir
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea un directorio en el equipo remoto.

Sintaxis

mkdir <directory>

Parámetros

Parámetro Descripción

<directory> Especifica el nombre del directorio remoto nuevo.

Ejemplos
Para crear un directorio denominado dir1 en el equipo remoto, escriba:

mkdir dir1

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp mls
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra una lista abreviada de directorios de archivos y subdirectorios en un directorio


remoto.

Sintaxis

mls <remotefile>[ ] <localfile>

Parámetros

Parámetro Descripción

<remotefile> Especifica el archivo para el que desea ver una lista. Al especificar remotefiles, use
un guion para representar el directorio de trabajo actual en el equipo remoto.

<localfile> Especifica un archivo local en el que se va a almacenar la lista. Al especificar


localfile, use un guion para mostrar la lista en la pantalla.

Ejemplos
Para mostrar una lista abreviada de archivos y subdirectorios para dir1 y dir2, escriba:

mls dir1 dir2 -

Para guardar una lista abreviada de archivos y subdirectorios para dir1 y dir2 en el
archivo local dirlist.txt, escriba:

mls dir1 dir2 dirlist.txt


Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp mput
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Copia los archivos locales en el equipo remoto mediante el tipo de transferencia de


archivos actual.

Sintaxis

mput <localfile>[ ]

Parámetros

Parámetro Descripción

<localfile> Especifica el archivo local que se va a copiar en el equipo remoto.

Ejemplos
Para copiar Program1.exe y Program2.exe en el equipo remoto mediante el tipo de
transferencia de archivos actual, escriba:

mput Program1.exe Program2.exe

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ftp ascii

Comando ftp binary

Instrucciones adicionales de FTP


ftp open
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Se conecta al servidor ftp especificado.

Sintaxis

open <computer> [<port>]

Parámetros

Parámetro Descripción

<computer> Especifica el equipo remoto al que está intentando conectarse. Puede usar una
dirección IP o un nombre de equipo (en cuyo caso debe haber disponible un
servidor DNS o un archivo hosts).

[<port>] Especifica un número de puerto TCP que se va a usar para conectarse a un servidor
ftp. De forma predeterminada, se usa el puerto TCP 21.

Ejemplos
Para conectarse al servidor ftp en ftp.microsoft.com, escriba:

open ftp.microsoft.com

Para conectarse al servidor ftp en ftp.microsoft.com que escucha en el puerto TCP 755,
escriba:

open ftp.microsoft.com 755


Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp prompt
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Activa y desactiva el modo de símbolo de sistema. De forma predeterminada, el modo


de símbolo de sistema está activado. Si el modo de símbolo del sistema está activado, el
comando ftp solicita varias transferencias de archivos para permitirle recuperar o
almacenar archivos de forma selectiva.

7 Nota

Puede usar los comandos ftp mget y ftp mput para transferir todos los archivos
cuando el modo de símbolo de sistema está desactivado.

Sintaxis

prompt

Ejemplos
Para activar y desactivar el modo de símbolo de sistema, escriba:

prompt

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp put
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Copia un archivo local en el equipo remoto mediante el tipo de transferencia de


archivos actual.

7 Nota

Este comando es el mismo que el comando ftp send.

Sintaxis

put <localfile> [<remotefile>]

Parámetros

Parámetro Descripción

<localfile> Especifica el archivo local que se va a copiar.

[<remotefile>] Especifica el nombre que se va a usar en el equipo remoto. Si no especifica un


archivo remoto , el archivo asigna el nombre de archivo local.

Ejemplos
Para copiar el archivo local test.txt y asignarle el nombre test1.txt en el equipo remoto,
escriba:

put test.txt test1.txt

Para copiar el archivo local program.exe en el equipo remoto, escriba:


put program.exe

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ftp ascii

Comando ftp binary

Instrucciones adicionales de FTP


ftp pwd
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra el directorio del equipo remoto actual.

Sintaxis

pwd

Ejemplos
Para mostrar el directorio del equipo remoto actual, escriba:

pwd

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp quit
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Finaliza la sesión ftp con el equipo remoto y, a continuación, sale.

7 Nota

Este comando es el mismo que el comando ftp bye.

Sintaxis

quit

Ejemplos
Para finalizar la sesión ftp con el equipo remoto y volver al símbolo de comando del
sistema operativo, escriba:

quit

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp quote
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Envía argumentos textuales al servidor ftp remoto. Se devuelve un único código de


respuesta ftp.

7 Nota

Este comando es el mismo que el comando ftp literal.

Sintaxis

quote <argument>[ ]

Parámetros

Parámetro Descripción

<argument> Especifica el argumento que se va a enviar al servidor ftp.

Ejemplos
Para enviar un comando quit al servidor ftp remoto, escriba:

quote quit

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ftp literal


Instrucciones adicionales de FTP
ftp recv
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Copia un archivo remoto en el equipo local mediante el tipo de transferencia de


archivos actual.

7 Nota

Este comando es el mismo que el comando ftp get.

Sintaxis

recv <remotefile> [<localfile>]

Parámetros

Parámetro Descripción

<remotefile> Especifica el archivo remoto que se va a copiar.

[<localfile>] Especifica el nombre del archivo que se va a usar en el equipo local. Si no se


especifica localfile, el archivo recibe el nombre del remotefile.

Ejemplos
Para copiar test.txt en el equipo local mediante la transferencia de archivos actual,
escriba:

recv test.txt

Para copiar test.txt en el equipo local como test1.txt mediante la transferencia de


archivos actual, escriba:
recv test.txt test1.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ftp get

Comando ftp ascii

Comando ftp binary

Instrucciones adicionales de FTP


ftp remotehelp
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra ayuda para comandos remotos.

Sintaxis

remotehelp [<command>]

Parámetros

Parámetro Descripción

[<command>] Especifica el nombre del comando sobre el que desea ayuda. Si no se especifica
<command> , este comando muestra una lista de todos los comandos remotos.
También puede ejecutar comandos remotos mediante ftp quote o ftp literal.

Ejemplos
Para mostrar una lista de comandos remotos, escriba:

remotehelp

Para mostrar la sintaxis del comando remoto feat, escriba:

remotehelp feat

Vínculos relacionados
Clave de sintaxis de línea de comandos
ftp quote

ftp literal

Instrucciones adicionales de FTP


ftp rename
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el nombre de los archivos remotos.

Sintaxis

rename <filename> <newfilename>

Parámetros

Parámetro Descripción

<filename> Especifica el archivo al que desea cambiar el nombre.

<newfilename> Especifica el nombre del nuevo archivo.

Ejemplos
Para cambiar el nombre del archivo remoto example.txt a example1.txt, escriba:

rename example.txt example1.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp rmdir
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Elimina un directorio remoto.

Sintaxis

rmdir <directory>

Parámetros

Parámetro Descripción

<directory> Especifica el nombre del directorio remoto que se va a eliminar.

Ejemplos
Para eliminar el directorio remoto pictures, escriba:

rmdir pictures

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp send
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Copia un archivo local en el equipo remoto mediante el tipo de transferencia de


archivos actual.

7 Nota

Este comando es el mismo que el comando ftp put.

Sintaxis

send <localfile> [<remotefile>]

Parámetros

Parámetro Descripción

<localfile> Especifica el archivo local que se va a copiar.

<remotefile> Especifica el nombre que se va a usar en el equipo remoto. Si no especifica un


archivo remoto , el archivo obtendrá el nombre localfile.

Ejemplos
Para copiar el archivo local test.txt y asignarle el nombre test1.txt en el equipo remoto,
escriba:

send test.txt test1.txt

Para copiar el archivo local program.exe en el equipo remoto, escriba:


send program.exe

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp status
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra el estado actual de las conexiones ftp.

Sintaxis

status

Ejemplos
Para mostrar el estado actual de las conexiones ftp, escriba:

status

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp trace
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Alterna el seguimiento de paquetes. Este comando también muestra la serie de


llamadas a funciones FTP internas al ejecutar un comando ftp.

Sintaxis

trace

Ejemplos
Para activar y desactivar el seguimiento, escriba:

trace

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp type
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Establece o muestra el tipo de transferencia de archivos. El comando ftp admite los


tipos de transferencia de archivos ASCII (predeterminado) y de imagen binaria:

Se recomienda usar ASCII al transferir archivos de texto. En el modo ASCII, se


realizan conversiones de caracteres a y desde el juego de caracteres estándar de
red. Por ejemplo, los caracteres de fin de línea se convierten según sea necesario,
en función del sistema operativo de destino.

Se recomienda usar el modo binario al transferir archivos ejecutables. En modo


binario, los archivos se transfieren en unidades de un byte.

Sintaxis

type [<typename>]

Parámetros

Parámetro Descripción

[<typename>] Especifica el tipo de transferencia de archivo. Si no especifica este parámetro, se


muestra el tipo actual.

Ejemplos
Para establecer el tipo de transferencia de archivos en ASCII, escriba:

type ascii

Para establecer el tipo de archivo de transferencia en binario, escriba:


type binary

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp user
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Especifica un usuario en el equipo remoto.

Sintaxis

user <username> [<password>] [<account>]

Parámetros

Parámetro Descripción

<username> Especifica un nombre de usuario con el que iniciar sesión en el equipo remoto.

[<password>] Especifica la contraseña del nombre de usuario. Si no se especifica una contraseña,


pero es necesaria, el comando ftp solicita la contraseña.

[<account>] Especifica una cuenta con la que iniciar sesión en el equipo remoto. Si no se
especifica una cuenta, pero es necesaria, el comando ftp solicita la cuenta.

Ejemplos
Para especificar User1 con la contraseña Password1, escriba:

user User1 Password1

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp verbose
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Habilita el modo detallado. De forma predeterminada, el modo detallado está activado.


Cuando el modo detallado está activado, se muestran todas las respuestas de
comandos ftp. Cuando se completa una transferencia de archivos, también se muestran
estadísticas sobre la eficiencia de la transferencia.

Sintaxis

verbose

Ejemplos
Para activar y desactivar el modo detallado, escriba:

verbose

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp mdelete
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Elimina archivos en el equipo remoto.

Sintaxis

mdelete <remotefile>[...]

Parámetros

Parámetro Descripción

<remotefile> Especifica el archivo remoto que se va a eliminar.

Ejemplos
Para eliminar archivos remotos a.exe y b.exe, escriba:

mdelete a.exe b.exe

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftp mdir
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra una lista de directorios de archivos y subdirectorios en un directorio remoto.

Sintaxis

mdir <remotefile>[...] <localfile>

Parámetros

Parámetro Descripción

<remotefile> Especifica el directorio o archivo para el que desea ver una lista. Puede especificar
varios archivos remotos. Escriba un guión (-) si va a utilizar el directorio de trabajo
actual en el equipo remoto.

<localfile> Especifica un archivo local para almacenar la lista. Este parámetro es obligatorio.
Escriba un guión (-) para mostrar la lista en la pantalla.

Ejemplos
Para mostrar una lista de directorios de dir1 y dir2 en la pantalla, escriba:

mdir dir1 dir2 -

Para guardar la lista de directorios combinados de dir1 y dir2 en un archivo local


denominado dirlist.txt, escriba:

mdir dir1 dir2 dirlist.txt


Vínculos relacionados
Clave de sintaxis de línea de comandos

Instrucciones adicionales de FTP


ftype
Artículo • 12/04/2023

Muestra o modifica los tipos de archivo que se usan en las asociaciones de extensión de
nombre de archivo. Si se usa sin un operador de asignación (=), este comando muestra
la cadena de comando de apertura actual para el tipo de archivo especificado. Si se usa
sin parámetros, este comando muestra los tipos de archivo que tienen definidas
cadenas de comandos de apertura.

7 Nota

Este comando solo se admite dentro de cmd.exe y no está disponible desde


PowerShell. Aunque puede usar cmd /c ftype como solución alternativa.

Sintaxis

ftype [<filetype>[=[<opencommandstring>]]]

Parámetros

Parámetro Descripción

<filetype> Especifica el tipo de archivo que se va a mostrar o cambiar.

<opencommandstring> Especifica la cadena de comando de apertura que se va a usar al abrir


archivos del tipo de archivo especificado.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
En la tabla siguiente, se describe cómo ftype sustituye las variables dentro de una
cadena de comandos de apertura:

Variable Valor de reemplazo

%0 o %1 Se sustituye con el nombre de archivo que se inicia a través de la asociación.


Variable Valor de reemplazo

%* Obtiene todos los parámetros.

%2 , %3 , Obtiene el primer parámetro ( %2 ), el segundo parámetro ( %3 ), etc.


...

%~<n> Obtiene todos los parámetros restantes a partir del parámetro n, donde n puede ser
cualquier número del 2 al 9.

Ejemplos
Para mostrar los tipos de archivo actuales que tienen definidas cadenas de comandos de
apertura, escriba lo siguiente:

ftype

Para mostrar la cadena de comando de apertura actual para el tipo de archivo txtfile,
escriba lo siguiente:

ftype txtfile

Este comando produce un resultado similar al siguiente:

txtfile=%SystemRoot%\system32\NOTEPAD.EXE %1

Para eliminar la cadena de comando de apertura de un tipo de archivo denominado


example, escriba lo siguiente:

ftype example=

Para asociar la extensión de nombre de archivo .pl con el tipo de archivo PerlScript y
habilitar el tipo de archivo PerlScript para ejecutar PERL.EXE, escriba los siguientes
comandos:

assoc .pl=PerlScript
ftype PerlScript=perl.exe %1 %*
Para eliminar la necesidad de escribir la extensión de nombre de archivo .pl al invocar un
script Perl, escriba lo siguiente:

set PATHEXT=.pl;%PATHEXT%

Vínculos relacionados
Clave de sintaxis de línea de comandos
fveupdate
Artículo • 14/04/2023

FveUpdate es una herramienta interna, utilizada por el programa de instalación cuando


se actualiza un equipo. Actualiza los metadatos asociados a BitLocker a la versión más
reciente. Esta herramienta no se puede ejecutar de forma independiente.

Vínculos relacionados
Clave de sintaxis de línea de comandos
getmac
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Devuelve la dirección del control de acceso multimedia (MAC) y la lista de protocolos de


red asociados a cada dirección para todas las tarjetas de red de cada equipo, ya sea
localmente o a través de una red. Este comando es especialmente útil cuando desea
escribir la dirección MAC en un analizador de red o cuando necesite saber qué
protocolos están actualmente en uso en cada adaptador de red de un equipo.

Sintaxis

getmac[.exe][/s <computer> [/u <domain\<user> [/p <password>]]][/fo {table |


list | csv}][/nh][/v]

Parámetros

Parámetro Descripción

/s Especifica el nombre o la dirección IP de un equipo remoto (no se pueden usar


<computer> barras diagonales inversas). La opción predeterminada es el equipo local.

/u Ejecuta el comando con los permisos de cuenta del usuario especificado por user o
<domain>\ domain\user. El valor predeterminado son los permisos del usuario que ha iniciado
<user> sesión actualmente en el equipo que emite el comando.

/p Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u.


<password>

/fo {table | Especifica el formato que se va a usar para la salida de la consulta. Los valores
list | csv} válidos son table, lista y csv. El formato predeterminado para la salida es table.

/nh Suprime el encabezado de columna en la salida. Válido cuando el parámetro /fo se


establece en table o csv.

/v Especifica que la salida muestra información detallada.

/? Muestra la ayuda en el símbolo del sistema.


Ejemplos
En los ejemplos siguientes se muestra cómo puede usar el 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

Vínculos relacionados
Clave de sintaxis de línea de comandos
gettype
Artículo • 30/05/2023

Se aplica a: Windows Server (todas las versiones compatibles)

El comando gettype está en desuso y es posible que no se admita en futuras versiones


de Windows.

gettype se incluye en Windows Server 2003. Para más información, consulte gettype.

Vínculos relacionados
Clave de sintaxis de línea de comandos
goto
Artículo • 12/04/2023

Dirige cmd.exe a una línea con etiqueta en un programa por lotes. Dentro de un
programa por lotes, este comando dirige el procesamiento de comandos a una línea
identificada por una etiqueta. Cuando se encuentra la etiqueta, el procesamiento
continúa y empieza por los comandos que comienzan en la línea siguiente.

Sintaxis

goto <label>

Parámetros

Parámetro Descripción

<label> Especifica una cadena de texto que se usa como etiqueta en el programa por lotes.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Si las extensiones de comandos están habilitadas (el valor predeterminado) y usa


el comando goto con una etiqueta de destino de :EOF, transfiere el control al final
del archivo de script por lotes actual y sale del archivo de script por lotes sin
definir una etiqueta. Cuando use este comando con la etiqueta :EOF, debe insertar
dos puntos antes de la etiqueta. Por ejemplo: goto:EOF .

Puede usar espacios en el parámetro label, pero no puede incluir otros


separadores (por ejemplo, punto y coma (;) o signos de igual (=)).

El valor label que especifique debe coincidir con una etiqueta del programa por
lotes. La etiqueta del programa por lotes debe comenzar con dos puntos (:). Si una
línea comienza con dos puntos, se trata como una etiqueta y se omiten los
comandos de esa línea. Si el programa por lotes no contiene la etiqueta que
especifique en el parámetro label, el programa por lotes se detiene y muestra el
siguiente mensaje: Label not found .
Puede usar goto con otros comandos para realizar operaciones condicionales. Para
obtener más información sobre el uso de goto para operaciones condicionales,
consulte el comando if.

Ejemplos
El siguiente programa por lotes formatea un disco en la unidad A como un disco de
sistema. Si la operación se realiza correctamente, el comando goto dirige el
procesamiento a la etiqueta :end:

echo off
format a: /s
if not errorlevel 1 goto end
echo An error occurred during formatting.
:end
echo End of batch program.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando cmd

Comando if
gpfixup
Artículo • 14/04/2023

Corrige las dependencias de nombres de dominio en los objetos de la directiva de


grupo y en los vínculos de la directiva de grupo después de una operación de cambio
de nombre de dominio. Para usar este comando, debe instalar la administración de la
directiva de grupo como función a través del Administrador del servidor.

Sintaxis

gpfixup [/v]
[/olddns:<olddnsname> /newdns:<newdnsname>]
[/oldnb:<oldflatname> /newnb:<newflatname>]
[/dc:<dcname>] [/sionly]
[/user:<username> [/pwd:{<password>|*}]] [/?]

Parámetros

Parámetro Descripción

/v Muestra mensajes de estado detallados. Si no se usa este parámetro,


solo aparecerán los mensajes de error o un mensaje de estado de
resumen que indica, SUCCESS o FAILURE.

/olddns: <olddnsname> Especifica el nombre DNS antiguo del dominio cuyo nombre ha
cambiado como <olddnsname> cuando la operación de cambio de
nombre del dominio cambia el nombre DNS de un dominio. Solo puede
usar este parámetro si también usa el parámetro /newdns para
especificar un nuevo nombre DNS de dominio.

/newdns: <newdnsname> Especifica el nuevo nombre DNS del dominio cuyo nombre ha cambiado
como <newdnsname> cuando la operación de cambio de nombre del
dominio cambia el nombre DNS de un dominio. Este parámetro solo se
puede usar si también usa el parámetro /olddns para especificar el
nombre DNS de dominio antiguo.

/oldnb: <oldflatname> Especifica el nombre NetBIOS antiguo del dominio cuyo nombre ha
cambiado como <oldflatname> cuando la operación de cambio de
nombre del dominio cambia el nombre NetBIOS de un dominio. Este
parámetro solo se puede usar si usa el parámetro /newnb para
especificar un nuevo nombre NetBIOS de dominio.
Parámetro Descripción

/newnb: <newflatname> Especifica el nuevo nombre NetBIOS del dominio cuyo nombre ha
cambiado como <newflatname> cuando la operación de cambio de
nombre del dominio cambia el nombre NetBIOS de un dominio. Este
parámetro solo se puede usar si usa el parámetro /oldnb para
especificar el nombre NetBIOS del dominio anterior.

/dc: <dcname> Conéctese al controlador de dominio denominado <dcname> (un nombre


DNS o un nombre NetBIOS). <dcname> debe hospedar una réplica
grabable de la partición de directorio de dominio, como se indica en
uno de los siguientes elementos:

Nombre DNS <newdnsname> mediante /newdns


El nombre <newflatname> de NetBIOS mediante /newnb
Si no se usa este parámetro, puede conectarse a cualquier
controlador de dominio del dominio renombrado indicado
mediante <newdnsname> o <newflatname> .

/sionly Realiza solo la corrección de directiva de grupo relacionada con la


instalación de software administrada (la extensión de instalación de
software para directiva de grupo). Omita las acciones que corrigen
vínculos de directiva de grupo y las rutas de acceso SYSVOL en GPO.

/user: <username> Ejecuta este comando en el contexto de seguridad del usuario


<username> , donde <username> está en el formato domain\user. Si no se
usa este parámetro, este comando se ejecuta como el usuario que ha
iniciado sesión.

/pwd: {<password> | Especifica la contraseña del usuario.


*}

/? Muestra la Ayuda en el símbolo del sistema.

Ejemplos
En este ejemplo se supone que ya ha realizado una operación de cambio de nombre de
dominio en la que ha cambiado el nombre DNS de MyOldDnsName a
MyNewDnsName y el nombre NetBIOS de MyOldNetBIOSName a
MyNewNetBIOSName.

En este ejemplo, se usa el comando gpfixup para conectarse al controlador de dominio


denominado MyDcDnsName y reparar los GPO y los vínculos de la directiva de grupo
actualizando el nombre de dominio antiguo incrustado en los GPO y vínculos. El estado
y la salida del error se guardan en un archivo denominado gpfixup.log.
gpfixup /olddns: MyOldDnsName /newdns:MyNewDnsName /oldnb:MyOldNetBIOSName
/newnb:MyNewNetBIOSName /dc:MyDcDnsName 2>&1 >gpfixup.log

Este ejemplo es el mismo que el anterior, salvo que supone que el nombre NetBIOS del
dominio no se cambió durante la operación de cambio de nombre de dominio.

gpfixup /olddns: MyOldDnsName /newdns:MyNewDnsName /dc:MyDcDnsName 2>&1


>gpfixup.log

Vínculos relacionados
Clave de sintaxis de línea de comandos

Administrar el cambio de nombre de Dominio de Active Directory


gpresult
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información del conjunto resultante de directivas (RSoP) de un usuario y un


equipo remotos. Para usar la generación de informes de RSoP para equipos dirigidos
remotamente a través del firewall, debe tener reglas de firewall que permitan tráfico de
red entrante en los puertos.

Sintaxis

gpresult [/s <system> [/u <username> [/p [<password>]]]] [/user


[<targetdomain>\]<targetuser>] [/scope {user | computer}] {/r | /v | /z |
[/x | /h] <filename> [/f] | /?}

7 Nota

Excepto cuando se usa /?, debe incluir una opción de salida, /r, /v, /z, /x o /h.

Parámetros

Parámetro Descripción

/s <system> Especifica el nombre o la dirección IP de un equipo remoto. No use


barras diagonales inversas. La opción predeterminada es el equipo
local.

/u <username> Usa las credenciales del usuario especificado para ejecutar el


comando. El usuario predeterminado es el usuario que ha iniciado
sesión en el equipo que emite el comando.

/p [<password>] Especifica la contraseña de la cuenta de usuario que se proporciona


en el parámetro /u. Si se omite /p, gpresult solicita la contraseña. El
parámetro /p no se puede usar con /x o /h.

/user [<targetdomain>\] Especifica el usuario remoto cuyos datos de RSoP se van a mostrar.
<targetuser>]
Parámetro Descripción

/scope {user | Muestra los datos de RSoP para el usuario o el equipo. Si se omite
computer} /scope, gpresult muestra los datos de RSoP para el usuario y el
equipo.

[/x | /h] <filename> Guarda el informe en formato XML (/x) o HTML (/h) en la ubicación y
con el nombre de archivo especificado por el parámetro filename. No
se puede usar con /u, /p, /r, /v o /z.

/f Obliga a gpresult a sobrescribir el nombre de archivo especificado en


la opción /x o /h.

/r Muestra los datos de resumen de RSoP.

/v Muestra la información de la directiva de detalle. Esto incluye la


configuración detallada que se aplicó con una prioridad de 1.

/z Muestra toda la información disponible sobre la directiva de grupo.


Esto incluye la configuración detallada que se aplicó con una prioridad
de 1 y superior.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
La directiva de grupo es la herramienta administrativa principal para definir y
controlar cómo funcionan los programas, los recursos de red y el sistema
operativo para usuarios y equipos de una organización. En un entorno de Active
Directory, la directiva de grupo se aplica a usuarios o equipos en función de su
pertenencia a sitios, dominios o unidades organizativas.

Dado que puede aplicar la configuración de directiva superpuesta a cualquier


equipo o usuario, la característica de directiva de grupo genera un conjunto
resultante de configuraciones de directiva cuando el usuario inicia sesión. El
comando gpresult muestra el conjunto resultante de configuraciones de directiva
que se aplicaron en el equipo para el usuario especificado cuando el usuario inició
sesión.

Dado que /v y /z generan mucha información, resulta útil redirigir la salida a un


archivo de texto (por ejemplo, gpresult/z >policy.txt ).

En las versiones ARM64 de Windows, solo el gpresult de SysWow64 funciona con


el parámetro /h .
Ejemplos
Para recuperar datos de RSoP solo para el usuario remoto maindom\targetuser, en el
equipo, escribasrvmain:

gpresult /s srvmain /user maindom\targetuser /scope user /r

Para guardar toda la información disponible sobre la directiva de grupo en un archivo


denominado policy.txt, solo para el usuario remoto maindom\targetuser, en el equipo
srvmain, escriba:

gpresult /s srvmain /user maindom\targetuser /z > policy.txt

Para mostrar los datos de RSoP para el usuario que ha iniciado sesión, maindom\hiropln
con la contraseña p@ssW23, para el equipo srvmain, escriba:

gpresult /s srvmain /u maindom\hiropln /p p@ssW23 /r

Vínculos relacionados
Clave de sintaxis de línea de comandos
gpt
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

En los discos básicos de la tabla de particiones GUID (gpt), este comando asigna los
atributos gpt a la partición con el foco. Los atributos de partición GPT ofrecen
información adicional acerca del uso de la partición. Algunos atributos son específicos
del GUID de tipo de partición.

Debe elegir una partición gpt básica para que esta operación se realice correctamente.
Use el comando select partition para seleccionar una partición gpt básica y cambiar el
foco a ella.

U Precaución

Cambiar los atributos gpt puede provocar que sus volúmenes de datos básicos no
puedan asignar letras de unidad o evitar que el sistema de archivos se monte. Le
recomendamos encarecidamente que no cambie los atributos gpt a menos que sea
un fabricante de equipos originales (OEM) o un profesional de TI que tenga
experiencia con discos gpt.

Sintaxis

gpt attributes=<n>

Parámetros

Parámetro Descripción
Parámetro Descripción

attributes= <n> Especifica el valor del atributo que desea aplicar a la partición con foco. El
campo de atributo gpt es un campo de 64 bits que contiene dos subcampos. El
campo superior sólo se interpreta en el contexto del Id. de partición, mientras
que el campo inferior es común a todos los Id. de partición. Entre los valores
aceptados se incluyen:
0x0000000000000001: especifica que el equipo necesita la partición para
que funcione correctamente.
0x8000000000000000: especifica que la partición no recibirá una letra de
unidad de forma predeterminada cuando el disco se mueve a otro equipo
o cuando un equipo detecta el disco por primera vez.
0x4000000000000000: oculta el volumen de una partición para que el
administrador de montaje no lo detecte.
0x2000000000000000: especifica que la partición es una instantánea de
otra partición.
0x1000000000000000: especifica que la partición es de solo lectura. Este
atributo impide que se escriba en el volumen.

Para obtener más información sobre estos atributos, consulte la sección de


atributos en create_PARTITION_PARAMETERS Structure.

Comentarios

La partición de sistema EFI contiene únicamente el código binario necesario para


iniciar el sistema operativo. Esto facilita la colocación de archivos binarios o
binarios OEM específicos de un sistema operativo en otras particiones.

Ejemplos
Para evitar que el equipo asigne automáticamente una letra de unidad a la partición con
foco mientras se mueve un disco gpt, escriba:

gpt attributes=0x8000000000000000

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando select partition

Estructura de create_PARTITION_PARAMETERS
gpupdate
Artículo • 14/04/2023

Actualiza la configuración de directiva de grupo.

Sintaxis

gpupdate [/target:{computer | user}] [/force] [/wait:<VALUE>] [/logoff]


[/boot] [/sync] [/?]

Parámetros

Parámetro Descripción

/target: {computer|user} Especifica que se actualizan la configuración de la directiva solo del


usuario o solo del equipo. De forma predeterminada, se actualizan la
configuración de directiva de usuario y equipo.

/force Vuelve a aplicar todas las configuraciones de directiva. De forma


predeterminada, solo se aplican las configuraciones de directiva que
han cambiado.

/wait: <VALUE> Establece el número de segundos que se esperarán a que finalice el


procesamiento de directivas antes de volver al símbolo del sistema.
Cuando se supera el límite de tiempo, aparece el símbolo del sistema,
pero el procesamiento de directivas continúa. El valor predeterminado
es 600 segundos. El valor 0 implica que no hay espera. El valor -1
implica que hay una espera indefinida.

En un script, mediante este comando con un límite de tiempo


especificado, puede ejecutar gpupdate y continuar con los comandos
que no dependen de la finalización de gpupdate. Como alternativa,
puede usar este comando sin límite de tiempo especificado para
permitir que gpupdate termine de ejecutarse antes de que se ejecuten
otros comandos que dependen de él.
Parámetro Descripción

/logoff Provoca un cierre de sesión después de actualizar la configuración de


la directiva de grupo. Esto es necesario para aquellas extensiones de
directiva de grupo del cliente que no procesan la directiva en un ciclo
de actualización en segundo plano, sino que procesan la directiva
cuando un usuario inicia sesión. Entre los ejemplos se incluyen la
instalación de software de destino del usuario y la redirección de
carpetas. Esta opción no tiene ningún efecto si no hay extensiones
llamadas que requieran un cierre de sesión.

/boot Provoca un reinicio del equipo después de aplicar la configuración de


directiva de grupo. Esto es necesario para aquellas extensiones de
directiva de grupo del cliente que no procesan la directiva en un ciclo
de actualización en segundo plano, sino que procesan la directiva en el
reinicio del equipo. Entre los ejemplos se incluyen la instalación de
software de destino del equipo. Esta opción no tiene ningún efecto si
no hay extensiones llamadas que requieran un reinicio.

/sync Hace que la siguiente aplicación de directiva en primer plano se realice


de forma sincrónica. La directiva en primer plano se aplica en el
arranque del equipo y el inicio de sesión del usuario. Puede especificar
esto para el usuario, el equipo o ambos, mediante el parámetro
/target. Los parámetros /force y /wait se omiten si los especifica.

/? Muestra la Ayuda en el símbolo del sistema.

Ejemplos
Para forzar una actualización en segundo plano de todas las configuraciones de
directiva de grupo, independientemente de si han cambiado, escriba:

gpupdate /force

Vínculos relacionados
Clave de sintaxis de línea de comandos
graftabl
Artículo • 12/04/2023

Permite a los sistemas operativos Windows mostrar un juego de caracteres extendido en


modo gráfico. Si se usa sin parámetros, graftabl muestra la página de códigos anterior y
actual.

) Importante

El comando graftabl es un comando heredado y, por tanto, obsoleto.


Normalmente no se instala en versiones modernas de Windows. Consulte la página
chcp para más información sobre la gestión de las páginas de código.

Sintaxis

graftabl <codepage>
graftabl /status

Parámetros

Parámetro Descripción

<codepage> Especifica una página de códigos para definir la apariencia de los caracteres
extendidos en modo gráfico. Los números de identificación de página de códigos
válidos son:
437 - Estados Unidos
850 - Multilingüe (latino I)
852 - Eslavo (latino II)
855 - Cirílico (ruso)
857 - Turco
860 - Portugués
861 - Islandés
863 - Francés canadiense
865 - Nórdico
866 - Ruso
869 - Griego moderno

/status Muestra la página de códigos actual que utiliza este comando.


Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

El comando graftabl solo afecta a la visualización del monitor de caracteres


extendidos de la página de códigos que especifique. No cambia la página de
códigos de entrada de la consola real. Para cambiar la página de códigos de
entrada de la consola, utilice el comando mode o chcp.

Cada código de salida y una breve descripción de él:

Código de Descripción
salida

0 El juego de caracteres se ha cargado correctamente. No se ha cargado


ninguna página de códigos anterior.

1 Se ha especificado un parámetro incorrecto. No se realizó ninguna acción.

2 Se ha producido un error de archivo.

Puede usar la variable de entorno ERRORLEVEL en un programa por lotes para


procesar los códigos de salida devueltos por graftabl.

Ejemplos
Para ver la página de códigos actual utilizada por graftabl, escriba:

graftabl /status

Para cargar el juego de caracteres gráficos de la página de códigos 437 (Estados Unidos)
en la memoria, escriba:

graftabl 437

Para cargar el juego de caracteres gráficos de la página de códigos 850 (multilingüe) en


la memoria, escriba:
graftabl 850

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando freedisk

Comando mode

Comando chcp
help
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra una lista de los comandos disponibles o información detallada de ayuda sobre
un comando especificado. Si se usa sin parámetros, help enumera y describe
brevemente todos los comandos del sistema.

Sintaxis

help [<command>]

Parámetros

Parámetro Descripción

<command> Especifica el comando para el que se va a mostrar información detallada de ayuda.

Ejemplos
Para ver información sobre el comando robocopy, escriba:

help robocopy

Para mostrar una lista de todos los comandos disponibles en DiskPart, escriba:

help

Para mostrar información detallada sobre cómo usar el comando create partition
primary en DiskPart, escriba:
help create partition primary

Vínculos relacionados
Clave de sintaxis de línea de comandos
helpctr
Artículo • 06/04/2023

El comando helpctr está en desuso y no se garantiza que se admita en Windows.

Esta herramienta está incluida en Windows Server 2003. Para más información, consulte
Helpctr.
hostname
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra la parte del nombre de host del nombre del equipo completo del equipo.

) Importante

Este comando solo está disponible si el Protocolo de Internet (TCP/IP) está


instalado como componente en las propiedades de un adaptador de red en Red.

Sintaxis

hostname

Parámetros

Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Cualquier parámetro distinto de /? genera un mensaje de error y establece el valor de


errorlevel en 1.

Notas
Normalmente, la variable de entorno %COMPUTERNAME% imprimirá la misma cadena
que hostname , pero en mayúsculas.
Si se define una variable de entorno _CLUSTER_NETWORK_NAME_ , hostname imprimirá
su valor.

Ejemplos
Para mostrar el nombre del equipo, escriba:
shell

hostname

Para mostrar el nombre del equipo en mayúsculas:

shell

echo %COMPUTERNAME%

Para modificar la salida del nombre de host:

shell

set "_CLUSTER_NETWORK_NAME_=Altered Computer Name"


hostname

Vínculos relacionados
Clave de sintaxis de línea de comandos
icacls
Artículo • 14/04/2023

Muestra o modifica las listas de control de acceso discrecional (DACL) en los archivos
especificados y aplica las DACL almacenadas a los archivos de los directorios
especificados.

7 Nota

Este comando reemplaza el comando cacls en desuso.

Sintaxis

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 Descripción

<filename> Especifica el archivo para el que se van a mostrar o modificar las DACL.

<directorio> Especifica el directorio para el que se van a mostrar o modificar las DACL.

/t Realiza la operación en todos los archivos especificados del directorio actual y


sus subdirectorios.

/C Continúa la operación a pesar de los errores de archivo. Los mensajes de error


se seguirán mostrando.

/l Realiza la operación en un vínculo simbólico en lugar de en su destino.

/q Elimina los mensajes de éxito.

[/save <ACLfile> Almacena las DACL para todos los archivos coincidentes en un archivo de lista
[/t] [/c] [/l] [/q]] de control de acceso (ACL) para su uso posterior con /restore.
Parámetro Descripción

[/setowner Cambia el propietario de todos los archivos coincidentes al usuario


<username> [/t] especificado.
[/c] [/l] [/q]]

[/findsid <sid> Busca todos los archivos coincidentes que contienen una DACL que mencione
[/t] [/c] [/l] [/q]] explícitamente el identificador de seguridad (SID) especificado.

[/verify [/t] [/c] Busca todos los archivos con ACL que no son canónicos o tienen longitudes
[/l] [/q]] incoherentes con recuentos de entrada de control de acceso (ACE).

[/reset [/t] [/c] [/l] Reemplaza las ACL por las ACL heredadas predeterminadas para todos los
[/q]] archivos coincidentes.

[/grant[:r] <sid>: Concede derechos de acceso de usuario especificados. Los permisos


<perm>[...]] reemplazan los permisos explícitos concedidos previamente.
No agregar :r significa que los permisos se agregan a los permisos explícitos
concedidos previamente.

[/deny <sid>: Deniega explícitamente los derechos de acceso de usuario especificados. Se


<perm>[...]] agrega una ACE de denegación explícita para los permisos indicados y se
quitan los mismos permisos en cualquier concesión explícita.

[/remove[:g | :d]] Quita todas las coincidencias del SID especificado de DACL. Este comando
<sid>[...] [/t] [/c] también puede usar:
[/l] [/q] :g: quita todas las coincidencias de derechos concedidos al SID
especificado.
:d: quita todas las coincidencias de derechos denegados en el SID
especificado.

[/setintegritylevel Agrega explícitamente una ACE de integridad a todos los archivos


[(CI)(OI)] coincidentes. El nivel se puede especificar como:
<Level>: l: bajo
<Policy>[...]] m: medio
h: alto

Las opciones de herencia para la ACE de integridad pueden preceder al nivel


y solo se aplican a los directorios.

[/substitute Reemplaza un SID existente (sidold) por un nuevo SID (sidnew). Requiere el
<sidold> uso con el parámetro <directory> .
<sidnew> [...]]

/restore Aplica las DACL almacenadas de <ACLfile> a los archivos del directorio
<ACLfile> [/c] [/l] especificado. Requiere el uso con el parámetro <directory> .
[/q]
Parámetro Descripción

/inheritancelevel: Establece el nivel de herencia, que puede ser:


[e | d | r] e: habilita la herencia
d: deshabilita la herencia y copia las ACE
r: deshabilita la herencia y quita solo las ACE heredadas

Comentarios
Los SID pueden estar en forma numérica o de nombre descriptivo. Si usa una
forma numérica, añada el carácter comodín * al principio del SID.

Este comando conserva el orden canónico de las entradas ACE como:

Denegaciones explícitas

Concesiones explícitas

Denegaciones heredadas

Concesiones heredadas

La opción <perm> es una máscara de permisos que se puede especificar en una de


las siguientes formas:

Secuencia de derechos simples (permisos básicos):

F: acceso total

M: modificar el acceso

RX: acceso de lectura y ejecución

R: acceso de solo lectura

W: acceso de solo escritura

Una lista separada por comas entre paréntesis de derechos específicos


(permisos avanzados):

D: eliminar

RC: control de lectura (permisos de lectura)

WDAC: escritura de DAC (cambiar permisos)


WO: propietario de escritura (tomar posesión)

S: sincronizar

AS: seguridad del sistema de acceso

MA: máximo permitido

GR: lectura genérica

GW: escritura genérica

GE: ejecución genérica

GA: todo genérico

RD: directorio de lectura de datos/lista

WD: escribir datos o agregar archivo

AD: anexar datos o agregar subdirectorios

REA: leer atributos extendidos

WEA: escribir atributos extendidos

X: ejecutar/atravesar

DC: eliminar elemento secundario

RA: lectura de atributos

WA: escritura de atributos

Los derechos de herencia pueden venir precedidos de cualquier forma <perm> :

(I): heredar. ACE heredada del contenedor primario.

(OI): herencia de objeto. Los objetos de este contenedor heredarán esta ACE.
Solo se aplica a los directorios.

(CI): herencia de contenedor. Los contenedores de este contenedor primario


heredarán esta ACE. Solo se aplica a los directorios.

(E/S): solo herencia. ACE heredada del contenedor primario, pero no se


aplica al propio objeto. Solo se aplica a los directorios.

(NP): no propaga la herencia. ACE heredada por contenedores y objetos del


contenedor primario, pero no se propaga a contenedores anidados. Solo se
aplica a los directorios.

Ejemplos
Para guardar las DACL para todos los archivos del directorio C:\Windows y sus
subdirectorios en el archivo ACLFile, escriba:

icacls c:\windows\* /save aclfile /t

Para restaurar las DACL de cada archivo dentro de ACLFile que exista en el directorio
C:\Windows y sus subdirectorios, escriba:

icacls c:\windows\ /restore aclfile

Para conceder al usuario los permisos DAC de borrado y escritura de User1 en un


archivo denominado Test1, escriba:

icacls test1 /grant User1:(d,wdac)

Para conceder al usuario definido por SID S-1-1-0 los permisos DAC de borrado y
escritura en un archivo denominado Test2, escriba:

icacls test2 /grant *S-1-1-0:(d,wdac)

Vínculos relacionados
Clave de sintaxis de línea de comandos
if
Artículo • 14/04/2023

Realiza el procesamiento condicional en programas por lotes.

Sintaxis

if [not] ERRORLEVEL <number> <command> [else <expression>]


if [not] <string1>==<string2> <command> [else <expression>]
if [not] exist <filename> <command> [else <expression>]

Si las extensiones de comandos están habilitadas, use la siguiente sintaxis:

if [/i] <string1> <compareop> <string2> <command> [else <expression>]


if cmdextversion <number> <command> [else <expression>]
if defined <variable> <command> [else <expression>]

Parámetros

Parámetro Descripción

not Especifica que el comando solo se debe llevar a cabo si la condición es falsa.

errorlevel Especifica una condición verdadera solo si el programa anterior ejecutado por
<number> Cmd.exe devolvió un código de salida igual o mayor que number.

<command> Especifica el comando que se debe llevar a cabo si se cumple la condición


anterior.

<string1>== Especifica una condición verdadera solo si string1 y string2 son iguales. Estos
<string2> valores pueden ser cadenas literales o variables por lotes (por ejemplo, %1 ). No
es necesario incluir cadenas literales entre comillas.

exist Especifica una condición verdadera si existe el nombre de archivo especificado.


<filename>
Parámetro Descripción

<compareop> Especifica un operador de comparación de tres letras, entre los que se incluyen:
EQU: igual a
NEQ: no es igual a
LSS: menor que
LEQ: menor o igual que
GTR: mayor que
GEQ: mayor o igual que

/i Obliga a las comparaciones de cadenas a omitir mayúsculas y minúsculas. Puede


usar /i en forma de string1==string2 de if. Estas comparaciones son genéricas,
de modo que si string1 y string2 están compuestas solo de dígitos numéricos, las
cadenas se convierten en números y se realiza una comparación numérica.

cmdextversion Especifica una condición verdadera solo si el número de versión interno


<number> asociado a la característica de extensiones de comandos de Cmd.exe es igual o
mayor que el número especificado. La primera versión es 1. Aumenta por
incrementos de uno cuando se agregan mejoras significativas a las extensiones
de comando. El condicional cmdextversion nunca es verdadero cuando las
extensiones de comando están deshabilitadas (de forma predeterminada, las
extensiones de comandos están habilitadas).

defined Especifica una condición verdadera si se define una variable.


<variable>

<expression> Especifica un comando de línea de comandos y los parámetros que se van a


pasar al comando en una cláusula else.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Si la condición especificada en una cláusula if es true, se lleva a cabo el comando


que sigue a la condición. Si la condición es falsa, el comando de la cláusula if se
omite y el comando ejecuta cualquier comando especificado en la cláusula else.

Cuando un programa se detiene, devuelve un código de salida. Para usar códigos


de salida como condiciones, use el parámetro errorlevel.

Si usa defined, se agregan las tres variables siguientes al entorno: %errorlevel%,


%cmdcmdline% y %cmdextversion%.

%errorlevel%: se expande en una representación de cadena del valor actual de


la variable de entorno ERRORLEVEL. Esta variable supone que aún no hay una
variable de entorno existente con el nombre ERRORLEVEL. Si la hay, obtendrá
ese valor ERRORLEVEL en su lugar.

%cmdcmdline%: se expande a la línea de comandos original que se pasó a


Cmd.exe antes de cualquier procesamiento por Cmd.exe. Se supone que aún no
hay una variable de entorno existente con el nombre CMDCMDLINE. Si la hay,
obtendrá ese valor CMDCMDLINE en su lugar.

%cmdextversion%: se expande en la representación de cadena del valor actual


de cmdextversion. Se supone que aún no hay una variable de entorno existente
con el nombre CMDEXTVERSION. Si la hay, obtendrá ese valor
CMDEXTVERSION en su lugar.

Debe usar la cláusula else en la misma línea que el comando después de if.

Ejemplos
Para mostrar el mensaje No se encuentra el archivo de datos si no se encuentra el
archivo Product.dat, escriba:

if not exist product.dat echo Cannot find data file

Para dar formato a un disco en la unidad A y mostrar un mensaje de error si se produce


un error durante el proceso de formato, escriba las siguientes líneas en un archivo por
lotes:

: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 eliminar el archivo Product.dat del directorio actual o mostrar un mensaje si no se


encuentra Product.dat, escriba las siguientes líneas en un archivo por lotes:

IF EXIST Product.dat (
del Product.dat
) ELSE (
echo The Product.dat file is missing.
)

7 Nota

Estas líneas se pueden combinar en una sola línea de la siguiente manera:

IF EXIST Product.dat (del Product.dat) ELSE (echo The Product.dat file


is missing.)

Para reproducir el valor de la variable de entorno ERRORLEVEL después de ejecutar un


archivo por lotes, escriba las siguientes líneas en el archivo por lotes:

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 a la etiqueta ok si el valor de la variable de entorno ERRORLEVEL es menor o


igual que 1, escriba:

if %errorlevel% LEQ 1 goto okay

Vínculos relacionados
Clave de sintaxis de línea de comandos

comando goto
import (diskshadow)
Artículo • 12/04/2023

Importa una instantánea transportable desde un archivo de metadatos cargado en el


sistema.

[IMPORTANTE] Para poder usar este comando, debe utilizar el comando load
metadata para cargar un archivo de metadatos DiskShadow.

Sintaxis

import

Comentarios
Las instantáneas transportables no se almacenan de inmediato en el sistema. Sus
detalles se almacenan en un archivo XML de documento de componentes de copia
de seguridad, que DiskShadow solicita y guarda automáticamente en un archivo
de metadatos .cab en el directorio de trabajo. Utilice el comando set metadata
para cambiar la ruta de acceso y el nombre de este archivo XML.

Ejemplos
A continuación aparece un ejemplo de script de DiskShadow que muestra el uso del
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.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando diskshadow
import (diskpart)
Artículo • 14/04/2023

Importa un grupo de discos externos en el grupo de discos del equipo local. El


comando import importa todos los discos que pertenecen al mismo grupo que el disco
que tiene el foco.

[IMPORTANTE] Para poder usar este comando, debe usar el comando select disk
para seleccionar un disco dinámico en un grupo de discos externos y cambiar el
foco a ese disco.

Sintaxis

import [noerr]

Parámetros

Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para importar todos los discos que están en el mismo grupo de discos que el disco con
foco en el grupo de discos del equipo local, escriba:

import

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando diskpart
inactivo
Artículo • 14/04/2023

Marca la partición del sistema o la partición de arranque con el foco como inactivo en
los discos de registro de arranque maestro básico (MBR).

Se debe seleccionar un sistema activo o una partición de arranque para que esta
operación se realice correctamente. Use el comando select partition para seleccionar la
partición activa y cambiar el foco a ella.

U Precaución

Si no existe una partición activa, puede que el equipo no se inicie. No marque una
partición de sistema o de arranque como inactiva a menos que sea un usuario con
experiencia que conozca en profundidad la familia Windows Server.

Si no puede iniciar el equipo después de marcar como inactiva la partición de


sistema o de arranque, inserte el CD de instalación de Windows en la unidad de
CD-ROM, reinicie el equipo y, después, repare la partición mediante los comandos
fixmbr y fixboot en la Consola de recuperación.

Después de marcar la partición del sistema o la partición de arranque como


inactiva, el equipo comienza desde la siguiente opción especificada en el BIOS,
como la unidad CD-ROM o un entorno de eXecution de arranque previo (PXE).

Sintaxis

inactive

Ejemplos

inactive

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando select partition

Solución avanzada de problemas de arranque de Windows


ipconfig
Artículo • 14/04/2023

Muestra todos los valores de configuración de red TCP/IP actuales y actualiza la


configuración del Protocolo de configuración dinámica de host (DHCP) y del Sistema de
nombres de dominio (DNS). Si se usa sin parámetros, ipconfig muestra la versión 4
(IPv4) del protocolo de Internet y las direcciones IPv6, la máscara de subred y la puerta
de enlace predeterminada para todos los adaptadores.

Sintaxis

ipconfig [/allcompartments] [/all] [/renew [<adapter>]] [/release


[<adapter>]] [/renew6[<adapter>]] [/release6 [<adapter>]] [/flushdns]
[/displaydns] [/registerdns] [/showclassid <adapter>] [/setclassid <adapter>
[<classID>]]

Parámetros

Parámetro Descripción

/all IpConfig.txt: muestra la configuración de TCP/IP completa de todos los


adaptadores. Los adaptadores pueden representar interfaces físicas,
como adaptadores de red instalados o interfaces lógicas como
conexiones de acceso telefónico.

/displaydns Muestra el contenido de la memoria caché de la resolución del cliente


DNS, que incluye las dos entradas cargadas previamente desde el archivo
de hosts local y los registros de recursos que se han obtenido
recientemente para las consultas de nombre resueltas por el equipo. El
servicio cliente DNS usa esta información para resolver rápidamente los
nombres consultados con frecuencia antes de consultar sus servidores
DNS configurados.

/flushdns Vacía y restablece el contenido de la caché del solucionador de cliente


DNS. Durante la solución de problemas de DNS, puede usar este
procedimiento para descartar entradas de caché negativas de la memoria
caché, así como cualquier otra entrada que se haya agregado
dinámicamente.
Parámetro Descripción

/registerdns Inicia el registro dinámico manual para los nombres DNS y las direcciones
IP que se han configurado en un equipo. Puede usar este parámetro para
solucionar un error en el registro de nombres DNS o resolver un
problema de actualización dinámica entre un cliente y el servidor DNS sin
reiniciar el equipo cliente. La configuración DNS de las propiedades
avanzadas del protocolo TCP/IP determina qué nombres están
registrados en DNS.

/release [<adapter>] Envía un mensaje DHCPRELEASE al servidor DHCP para liberar la


configuración DHCP actual y descartar la configuración de dirección IP
para todos los adaptadores (si no se especifica un adaptador) o para un
adaptador específico si se incluye el parámetro adapter. Este parámetro
deshabilita TCP/IP para los adaptadores configurados para obtener
automáticamente una dirección IP. Para especificar un nombre de
adaptador, escriba el nombre del adaptador que aparece cuando se usa
ipconfig sin parámetros.

/release6 [<adapter>] Envía un mensaje DHCPRELEASE al servidor DHCPv6 para liberar la


configuración DHCPv6 actual y descartar la configuración de dirección IP
para todos los adaptadores (si no se especifica un adaptador) o para un
adaptador específico si se incluye el parámetro adapter. Este parámetro
deshabilita TCP/IP para los adaptadores configurados para obtener
automáticamente una dirección IP. Para especificar un nombre de
adaptador, escriba el nombre del adaptador que aparece cuando se usa
ipconfig sin parámetros.

/renew [<adapter>] Renueva la configuración de DHCP para todos los adaptadores (si no se
especifica un adaptador) o para un adaptador específico si se incluye el
parámetro adapter. Este parámetro solo está disponible en equipos con
adaptadores configurados para obtener automáticamente una dirección
IP. Para especificar un nombre de adaptador, escriba el nombre del
adaptador que aparece cuando se usa ipconfig sin parámetros.

/renew6 [<adapter>] Renueva la configuración de DHCPv6 para todos los adaptadores (si no se
especifica un adaptador) o para un adaptador específico si se incluye el
parámetro adapter. Este parámetro solo está disponible en equipos con
adaptadores configurados para obtener automáticamente una dirección
IPv6. Para especificar un nombre de adaptador, escriba el nombre del
adaptador que aparece cuando se usa ipconfig sin parámetros.

/setclassid <adapter> Configura el identificador de clase DHCP para un adaptador especificado.


[<classID>] Para establecer el identificador de clase DHCP para todos los
adaptadores, use el carácter comodín asterisco (*) en lugar del adapter.
Este parámetro solo está disponible en equipos con adaptadores
configurados para obtener automáticamente una dirección IP. Si no se
especifica un identificador de clase DHCP, se quita el identificador de
clase actual.
Parámetro Descripción

/showclassid Muestra el identificador de clase DHCP para un adaptador especificado.


<adapter> Para ver el identificador de clase DHCP para todos los adaptadores, use el
carácter comodín asterisco (*) en lugar del adapter. Este parámetro solo
está disponible en equipos con adaptadores configurados para obtener
automáticamente una dirección IP.

/? Muestra la Ayuda en el símbolo del sistema.

Notas
Este comando es más útil en los equipos que están configurados para obtener
automáticamente una dirección IP. Esto permite a los usuarios determinar qué
valores de configuración de TCP/IP han sido configurados por DHCP, dirección IP
privada automática (APIPA) o una configuración alternativa.

Si el nombre que proporcione para adapter contiene espacios, use comillas


alrededor del nombre del adaptador (por ejemplo, “nombre del adaptador”).

En el caso de los nombres de adaptador, ipconfig admite el uso del carácter


comodín asterisco (*) para especificar adaptadores con nombres que comiencen
por una cadena o adaptadores especificados con nombres que contengan una
cadena especificada. Por ejemplo, Local* coincide con todos los adaptadores que
comienzan con la cadena Local y *Con* coincide con todos los adaptadores que
contienen la cadena Con.

Ejemplos
Para mostrar la configuración básica de TCP/IP para todos los adaptadores, escriba:

ipconfig

Para mostrar la configuración completa de TCP/IP para todos los adaptadores, escriba:

ipconfig /all

Para renovar una configuración de dirección IP asignada por DHCP solo para el
adaptador de conexión de área local, escriba:
ipconfig /renew Local Area Connection

Para purgar la memoria caché del resolver de DNS cuando se solucionen problemas en
la resolución del nombre DNS, escriba:

ipconfig /flushdns

Para mostrar el identificador de clase DHCP para todos los adaptadores con nombres
que comienzan por Local, escriba:

ipconfig /showclassid Local*

Para establecer el identificador de clase DHCP del adaptador de conexión de área local
en TEST, escriba:

ipconfig /setclassid Local Area Connection TEST

Vínculos relacionados
Clave de sintaxis de línea de comandos
ipxroute
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra y modifica información sobre las tablas de enrutamiento usadas por el


protocolo IPX. Si se utiliza sin parámetros, ipxroute muestra la configuración
predeterminada de los paquetes que se envían a direcciones desconocidas, de difusión
y de multidifusión.

Sintaxis

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 Descripción

servers [/type=x] Muestra la tabla Punto de acceso de servicio (SAP) para el tipo de
servidor especificado. x debe ser un entero. Por ejemplo, /type=4 muestra
todos los servidores de archivos. Si no especifica /type, ipxroute servers
muestra todos los tipos de servidores y los enumera por nombre del
servidor.

resolve {GUID | Resuelve el nombre del GUID en su nombre descriptivo o el nombre


name} {GUID | descriptivo en su GUID.
adaptername}

board= n Especifica el adaptador de red para el que se van a consultar o establecer


parámetros.

def Envía paquetes a la difusión ALL ROUTES. Si un paquete se transmite a


una dirección única de Tarjeta de acceso multimedia (MAC) que no está
en la tabla de enrutamiento de origen, ipxroute envía el paquete a la
difusión SINGLE ROUTES de forma predeterminada.
Parámetro Descripción

gbr Envía paquetes a la difusión ALL ROUTES. Si se transmite un paquete a la


dirección de difusión (FFFFFFFFFFFF), ipxroute envía el paquete a la
difusión SINGLE ROUTES de forma predeterminada.

mbr Envía paquetes a la difusión ALL ROUTES. Si se transmite un paquete a


una dirección de multidifusión (C000xxxxxxxx), ipxroute envía el paquete
a la difusión SINGLE ROUTES de forma predeterminada.

remove=xxxxxxxxxxxx quita la dirección de nodo especificada de la tabla de enrutamiento de


origen.

config Muestra información sobre todos los enlaces para los que se configura
IPX.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para mostrar los segmentos de red a los que está conectada la estación de trabajo, la
dirección de nodo de la estación de trabajo y el tipo de marco que se utiliza, escriba:

ipxroute config

Vínculos relacionados
Clave de sintaxis de línea de comandos
irftp
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Envía archivos a través de un vínculo infrarrojo.

) Importante

Asegúrese de que los dispositivos diseñados para comunicarse a través de un


vínculo infrarrojo tienen habilitada la funcionalidad de infrarrojos y funcionan
correctamente. Asegúrese también de que se establece un vínculo infrarrojo entre
los dispositivos.

Sintaxis

irftp [<drive>:\] [[<path>] <filename>] [/h][/s]

Parámetros

Parámetro Descripción

<drive>:\ Especifica la unidad que contiene los archivos que desea enviar a través de un
vínculo infrarrojo.

[path] Especifica la ubicación y el nombre del archivo o conjunto de archivos que desea
<filename> enviar a través de un vínculo infrarrojo. Si especifica un conjunto de archivos, debe
especificar la ruta de acceso completa para cada archivo.

/h Especifica el modo oculto. Cuando se usa el modo oculto, los archivos se envían sin
mostrar el cuadro de diálogo de vínculo inalámbrico.

/s Abre el cuadro de diálogo Vínculo inalámbrico para que pueda seleccionar el


archivo o el conjunto de archivos que desea enviar sin usar la línea de comandos
para especificar la unidad, la ruta de acceso y los nombres de archivo. El cuadro de
diálogo Vínculo inalámbrico también se abre si usa este comando sin parámetros.
Ejemplos
Para enviar c:\example.txt a través del vínculo infrarrojo, escriba:

irftp c:\example.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos
jetpack
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Compacta una base de datos del Servicio de nombres Internet de Windows (WINS) o del
Protocolo de configuración dinámica de host (DHCP). Se recomienda compactar la base
de datos WINS cada vez que se aproxime a los 30 MB.

Jetpack.exe compacta la base de datos haciendo lo siguiente:

1. Copia la información de la base de datos en un archivo de base de datos temporal.

2. Elimina el archivo de base de datos original, WINS o DHCP.

3. Cambia el nombre de los archivos de base de datos temporales por el nombre de


archivo original.

Sintaxis

jetpack.exe <database_name> <temp_database_name>

Parámetros

Parámetro Descripción

<database_name> Especifica el nombre del archivo de base de datos original.

<temp_database_name> Especifica el nombre del archivo de base de datos temporal que


jetpack.exe va a crear.
Nota: Este archivo temporal se elimina cuando se completa el proceso de
compactación. Para que este comando funcione correctamente, debe
asegurarse de que el nombre de archivo temporal sea único y que no
exista un archivo con ese nombre.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para compactar la base de datos WINS, donde Tmp.mdb es una base de datos temporal
y Wins.mdb es la base de datos WINS, escriba:

cd %SYSTEMROOT%\SYSTEM32\WINS
NET STOP WINS
jetpack Wins.mdb Tmp.mdb
NET start WINS

Para compactar la base de datos DHCP, donde Tmp.mdb es una base de datos temporal
y Dhcp.mdb es la base de datos DHCP, escriba:

cd %SYSTEMROOT%\SYSTEM32\DHCP
NET STOP DHCPSERVER
jetpack Dhcp.mdb Tmp.mdb
NET start DHCPSERVER

Vínculos relacionados
Clave de sintaxis de línea de comandos
klist
Artículo • 14/04/2023

Muestra una lista de los vales de Kerberos que actualmente están almacenados en
caché.

) Importante

Debe ser al menos un administrador de dominio, o equivalente, para ejecutar


todos los parámetros de este comando.

Sintaxis

klist [-lh <logonID.highpart>] [-li <logonID.lowpart>] tickets | tgt | purge


| sessions | kcd_cache | get | add_bind | query_bind | purge_bind

Parámetros

Parámetro Descripción

-lh Indica la parte alta del identificador local único (LUID) del usuario, expresado de
manera hexadecimal. Si ni –lh ni –li están presentes, el comando tiene como valor
predeterminado el LUID del usuario que inició sesión actualmente.

-li Indica la parte baja del identificador local único (LUID) del usuario, expresado de
manera hexadecimal. Si ni –lh ni –li están presentes, el comando tiene como valor
predeterminado el LUID del usuario que inició sesión actualmente.

vales Enumera los vales de concesión de vales (TGT) actualmente almacenados en caché y
los vales de servicio de la sesión de inicio de sesión especificada. Ésta es la opción
predeterminada.

tgt Muestra el TGT de Kerberos inicial.

purga Permite eliminar todos los vales de la sesión de inicio de sesión especificada.

sesiones Muestra una lista de las sesiones de inicio de sesión en este equipo.

kcd_cache Muestra la información de caché de delegación restringida de Kerberos.


Parámetro Descripción

get Permite solicitar un vale al equipo de destino especificado por el nombre de


entidad de seguridad de servicio (SPN).

add_bind Permite especificar un controlador de dominio preferido para la autenticación


Kerberos.

query_bind Muestra una lista de los controladores de dominio preferidos almacenados en


caché para cada dominio con el que se contactó Kerberos.

purge_bind Quita los controladores de dominio preferidos almacenados en caché de los


dominios especificados.

kdcoptions Muestra las opciones del Centro de distribución de claves (KDC) que se especifican
en RFC 4120.

/? Muestra ayuda para este comando.

Comentarios
Si no se proporciona ningún parámetro, klist recupera todos los vales del usuario
que ha iniciado sesión actualmente.

Los parámetros muestran la información siguiente:

tickets: muestra los vales de servicios que actualmente están almacenados en


caché en los que se ha autenticado desde el inicio de sesión. Muestra los
atributos siguientes para todos los vales almacenados en caché:

LogonID: el LUID.

Client: concatenación del nombre del cliente y el nombre de dominio del


cliente.

Server: concatenación del nombre del servicio y el nombre de dominio del


servicio.

KerbTicket Encryption Type: tipo de cifrado que se utiliza para cifrar el vale
de Kerberos.

Ticket Flags: marcas de vales de Kerberos.

Start Time: hora a partir de la cual es válido el vale.

End Time: hora a la que el vale deja de ser válido. Cuando un vale pasa esta
hora, ya no se puede usar para realizar la autenticación en un servicio ni para
la renovación.

Renew Time: hora a la que se requiere una autenticación inicial nueva.

Session Key Type: algoritmo de cifrado que se usa para la clave de sesión.

tgt: enumera el TGT de Kerberos inicial y los atributos siguientes del vale
actualmente almacenado en caché:

LogonID: se identifica en formato hexadecimal.

ServiceName: krbtgt

TargetName <SPN> : krbtgt

DomainName: nombre del dominio que emite el TGT.

TargetDomainName: dominio al que se emite el TGT.

AltTargetDomainName: dominio al que se emite el TGT.

Ticket Flags: acciones y tipo de dirección y destino.

Session Key: longitud de clave y algoritmo de cifrado.

StartTime: hora del equipo local a la que se solicitó el vale.

EndTime: hora a la que el vale deja de ser válido. Cuando un vale pasa esta
hora, ya no se puede usar para realizar la autenticación en un servicio.

RenewUntil: fecha límite para la renovación del vale.

TimeSkew: diferencia horaria con el Centro de distribución de claves (KDC).

EncodedTicket: vale codificado.

purge: permite eliminar un vale específico. Al purgar los vales, se destruyen


todos los que almacenó en caché; por lo tanto, use este atributo con
precaución. Puede impedirle que pueda autenticarse en los recursos. Si esto
sucede, tendrá que cerrar la sesión e iniciarla de nuevo.
LogonID: se identifica en formato hexadecimal.

sessions: le permite enumerar y mostrar la información de todas las sesiones de


inicio de sesión de este equipo.
LogonID: si se especifica, muestra la sesión de inicio de sesión solo en virtud
del valor especificado. Si no se especifica, muestra todas las sesiones de
inicio de sesión de este equipo.
kcd_cache: le permite mostrar la información de caché de delegación
restringida de Kerberos.
LogonID: si se especifica, muestra la información de caché para la sesión de
inicio de sesión en virtud del valor especificado. Si no se especifica, muestra
la información de caché de la sesión de inicio de sesión del usuario actual.

get: le permite solicitar un vale al destino especificado por el SPN.

LogonID: si se especifica, solicita un vale mediante la sesión de inicio de


sesión en virtud del valor especificado. Si no se especifica, solicita un vale
mediante la sesión de inicio de sesión del usuario actual.

kdcoptions: solicita un vale con las opciones de especificadas del KDC.

add_bind: permite especificar un controlador de dominio preferido para la


autenticación Kerberos.

query_bind: permite mostrar controladores de dominio preferidos y


almacenados en caché para los dominios.

purge_bind: permite quitar controladores de dominio preferidos y almacenados


en caché de los dominios.

kdcoptions: para obtener la lista actual de opciones y sus explicaciones,


consulte RFC 4120 .

Ejemplos
Si desea consultar la caché de vales de Kerberos para determinar si faltan vales, si la
cuenta o el servidor de destino presentan un error, o bien si el tipo de cifrado no se
admite debido a un error de identificador de evento 27, escriba:

klist

klist –li 0x3e7

Para información sobre los detalles específicos de cada vale de concesión de vales que
esté almacenado en caché en el equipo para una sesión de inicio de sesión, escriba:
klist tgt

Si desea purgar la caché de vales de Kerberos, cerrar la sesión y volver a iniciarla,


escriba:

klist purge

klist purge –li 0x3e7

Para diagnosticar una sesión de inicio de sesión y localizar un logonID para un usuario o
servicio, escriba:

klist sessions

Para diagnosticar errores de delegación restringida de Kerberos y buscar el último error


que se encontró, escriba:

klist kcd_cache

Para diagnosticar si un usuario o un servicio pueden obtener un vale en un servidor o


para solicitar un vale para un SPN específico, escriba:

klist get host/%computername%

Por lo general, para diagnosticar problemas de replicación entre los controladores de


dominio, necesita que el equipo cliente tenga como destino un controlador de dominio
específico. Para dirigir el equipo cliente al controlador de dominio específico, escriba:

klist add_bind CONTOSO KDC.CONTOSO.COM


klist add_bind CONTOSO.COM KDC.CONTOSO.COM

Para consultar con qué controladores de dominio se contactó recientemente este


equipo, escriba:

klist query_bind

Para volver a detectar controladores de dominio o para vaciar la caché antes de crear
enlaces de controlador de dominio con klist add_bind , escriba:

klist purge_bind

Vínculos relacionados
Clave de sintaxis de línea de comandos
ksetup
Artículo • 12/04/2023

Realiza tareas relacionadas con la configuración y el mantenimiento del protocolo


Kerberos y el Centro de distribución de claves (KDC) para admitir los dominios Kerberos.
En concreto, este comando se usa para:

Cambie la configuración del equipo para buscar dominios Kerberos. En


implementaciones basadas en Kerberos que no son de Microsoft, esta información
se mantiene normalmente en el archivo Krb5.conf. En los sistemas operativos
Windows Server, se mantiene en el Registro. Puede utilizar esta herramienta para
modificar estos valores. Estas configuraciones las usan las estaciones de trabajo
para localizar los dominios Kerberos y los controladores de dominio para localizar
los dominios Kerberos para las relaciones de confianza entre dominios.

Inicialice las claves del Registro que usa el proveedor de compatibilidad de


seguridad (SSP) de Kerberos para buscar un KDC para el dominio kerberos, si el
equipo no es miembro de un dominio de Windows. Después de la configuración,
el usuario de un equipo cliente que ejecuta el sistema operativo Windows puede
iniciar sesión en las cuentas del dominio kerberos.

Busque en el Registro el nombre de dominio del dominio kerberos del usuario y, a


continuación, resuelva el nombre en una dirección IP consultando un servidor
DNS. El protocolo Kerberos puede usar DNS para buscar KDC usando solo el
nombre de dominio kerberos, pero debe configurarse especialmente para ello.

Sintaxis

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 Descripción

ksetup setrealm Hace que este equipo sea miembro de un dominio kerberos.

ksetup addkdc Define una entrada de KDC para el dominio kerberos especificado.

ksetup delkdc Elimina una entrada de KDC para el dominio kerberos.

ksetup addkpasswd Agrega una dirección de servidor kpasswd para un dominio kerberos.

ksetup delkpasswd Elimina una dirección de servidor kpasswd para un dominio kerberos.

ksetup server Permite especificar el nombre de un equipo Windows en el que se


aplicarán los cambios.

ksetup Establece la contraseña de la cuenta de dominio del equipo (o entidad


setcomputerpassword de seguridad de host).

ksetup removerealm Elimina toda la información del dominio kerberos especificado del
registro.

ksetup domain Permite especificar un dominio (si <domainname> aún no lo ha establecido


el parámetro /domain).

ksetup Permite usar el kpasswd para cambiar la contraseña del usuario que ha
changepassword iniciado sesión.

ksetup listrealmflags Enumera las marcas de dominio kerberos disponibles que ksetup puede
detectar.

ksetup setrealmflags Establece marcas de dominio kerberos para un dominio kerberos


específico.

ksetup addrealmflags Agrega marcas de dominio kerberos adicionales a un dominio kerberos.


Parámetro Descripción

ksetup delrealmflags Elimina las marcas de dominio kerberos de un dominio kerberos.

ksetup dumpstate Analiza la configuración de Kerberos en el equipo especificado. Agrega


un host a la asignación de dominio kerberos al Registro.

ksetup Agrega un valor de Registro para asignar el host al dominio kerberos.


addhosttorealmmap

ksetup Elimina el valor de Registro que ha asignado el equipo host al dominio


delhosttorealmmap kerberos.

ksetup setenctypeattr Establece uno o varios atributos de confianza de tipos de cifrado para el
dominio.

ksetup getenctypeattr Obtiene el atributo de confianza de tipos de cifrado para el dominio.

ksetup Agrega tipos de cifrado al atributo de confianza de tipos de cifrado para


addenctypeattr el dominio.

ksetup delenctypeattr Elimina el atributo de confianza de tipos de cifrado para el dominio.

/? Muestra la Ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
ksetup addenctypeattr
Artículo • 12/04/2023

Agrega el atributo de tipo de cifrado a la lista de posibles tipos para el dominio. Se


muestra un mensaje de estado tras completarse correctamente o con errores.

Sintaxis

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 Descripción

<domainname> Nombre del dominio con el que desea establecer una conexión. Use el nombre
de dominio completo o una forma simple del nombre, como corp.contoso.com o
contoso.

Tipo de Debe ser uno de los siguientes tipos de cifrado admitidos:


cifrado DES-CBC-CRC
DES-CBC-MD5
RC4-HMAC-MD5
AES128-CTS-HMAC-SHA1-96
AES256-CTS-HMAC-SHA1-96

Comentarios

Puede establecer o agregar varios tipos de cifrado separando los tipos de cifrado
en el comando con un espacio. Sin embargo, solo puede hacerlo para un dominio
a la vez.

Ejemplos
Para ver el tipo de cifrado del vale de concesión de vales de Kerberos (TGT) y la clave de
sesión, escriba:
klist

Para establecer el dominio en corp.contoso.com, escriba:

ksetup /domain corp.contoso.com

Para agregar el tipo de cifrado AES-256-CTS-HMAC-SHA1-96 a la lista de tipos posibles


para el dominio corp.contoso.com, escriba:

ksetup /addenctypeattr corp.contoso.com AES-256-CTS-HMAC-SHA1-96

Para establecer el atributo de tipo de cifrado en AES-256-CTS-HMAC-SHA1-96 para el


dominio corp.contoso.com, escriba:

ksetup /setenctypeattr corp.contoso.com AES-256-CTS-HMAC-SHA1-96

Para comprobar que el atributo de tipo de cifrado se estableció según lo previsto para el
dominio, escriba:

ksetup /getenctypeattr corp.contoso.com

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando klist

Comando ksetup

Comando ksetup domain

COamdno ksetup setenctypeattr

Comando ksetup getenctypeattr


Comando ksetup delenctypeattr
ksetup addhosttorealmmap
Artículo • 12/04/2023

Agrega una asignación de nombre de entidad de seguridad de servicio (SPN) entre el


host indicado y el dominio kerberos. Este comando también permite asignar uno o
varios hosts que comparten el mismo sufijo DNS al dominio kerberos.

La asignación se almacena en el Registro, en


HKEY_LOCAL_MACHINE\SYSTEM\CurrentContolSet\Control\Lsa\Kerberos\HostToReal
m.

Sintaxis

ksetup /addhosttorealmmap <hostname> <realmname>

Parámetros

Parámetro Descripción

<hostname> El nombre de host es el nombre del equipo y se puede indicar como nombre de
dominio completo del equipo.

<realmname> El nombre de dominio kerberos se indica como nombre DNS en mayúsculas, como
CORP. CONTOSO.COM.

Ejemplos
Para asignar el equipo host IPops897 al dominio kerberos CONTOSO, escriba:

ksetup /addhosttorealmmap IPops897 CONTOSO

Compruebe el Registro para asegurarse de que la asignación se ha producido según lo


previsto.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ksetup

Comando ksetup delhosttorealmmap


ksetup addkdc
Artículo • 12/04/2023

Agrega una dirección del Centro de distribución de claves (KDC) para el dominio
kerberos especificado.

La asignación se almacena en el Registro, en


HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\Kerberos\Domains, y
el equipo se debe reiniciar antes de que se use la nueva configuración de dominio
kerberos.

7 Nota

Para implementar datos de configuración del dominio kerberos en varios equipos,


debe utilizar el complemento Plantilla de configuración de seguridad y la
distribución de directivas explícitamente en equipos individuales. No puede utilizar
este comando.

Sintaxis

ksetup /addkdc <realmname> [<KDCname>]

Parámetros

Parámetro Descripción

<realmname> Especifica el nombre DNS en mayúsculas, como CORP. CONTOSO.COM. Este valor
también aparece como dominio kerberos predeterminado cuando se ejecuta
ksetup y es el dominio kerberos al que desea agregar el otro KDC.

<KDCname> Especifica el nombre de dominio completo, sin distinción entre mayúsculas y


minúsculas, como mitkdc.contoso.com. Si se omite el nombre del KDC, DNS
buscará KDC.

Ejemplos
Para configurar un servidor KDC que no sea de Windows y el dominio kerberos que
debe utilizar la estación de trabajo, escriba:
ksetup /addkdc CORP.CONTOSO.COM mitkdc.contoso.com

Para establecer la contraseña de la cuenta de equipo local en p@sswrd1% en el mismo


equipo que en el ejemplo anterior y reiniciar luego el equipo, escriba:

ksetup /setcomputerpassword p@sswrd1%

Para comprobar el nombre de dominio kerberos predeterminado del equipo o verificar


si este comando ha funcionado según lo previsto, escriba:

ksetup

Compruebe el Registro para asegurarse de que la asignación se ha producido según lo


previsto.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ksetup

Comando ksetup setcomputerpassword


ksetup addkpasswd
Artículo • 05/10/2023

Agrega una dirección de servidor de contraseñas Kerberos (kpasswd) para un dominio.

Sintaxis

ksetup /addkpasswd <realmname> [<kpasswdname>]

Parámetros

Parámetro Descripción

<realmname> Especifica el nombre DNS en mayúsculas, como CORP.CONTOSO.COM, y


aparece como el dominio de kerberos predeterminado o Realm= cuando se
ejecuta ksetup.

<kpasswdname> Especifica el servidor de contraseñas Kerberos. Se enuncia como nombre de


dominio completo, sin distinción entre mayúsculas y minúsculas, como
mitkdc.contoso.com. Si se omite el nombre del KDC, es posible que se utilice
DNS para buscar los KDC.

Comentarios
Si el dominio de Kerberos al que se autenticará la estación de trabajo admite el
protocolo de cambio de contraseña de Kerberos, puede configurar un equipo
cliente que ejecute el sistema operativo Windows para usar un servidor de
contraseñas Kerberos.

Puede agregar nombres de KDC adicionales, de uno en uno.

Ejemplos
Para configurar el dominio CORP.CONTOSO.COM para que utilice el servidor KDC que
no es de Windows, mitkdc.contoso.com, como servidor de contraseñas, escriba:
ksetup /addkpasswd CORP.CONTOSO.COM mitkdc.contoso.com

Para comprobar que el nombre del KDC está establecido, escriba ksetup y, a
continuación, busque el texto kpasswd = en la salida. Si no ve el texto, significa que
todavía no se configurar la asignación.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ksetup

Comando ksetup delkpasswd


ksetup addrealmflags
Artículo • 10/05/2023

Se aplica a Windows Server (todas las versiones compatibles)

El comando ksetup addrealmflags agrega otras marcas de dominio kerberos adicionales


a un dominio especificado.

Sintaxis

ksetup /addrealmflags <realmname> [sendaddress] [tcpsupported] [delegate]


[ncsupported] [rc4]

Parámetros

Parámetro Descripción

<realmname> Especifica el nombre DNS en mayúsculas, como en CORP.CONTOSO.COM .

Observaciones
Las marcas de dominio Kerberos se almacenan en el registro en
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\Kerberos\Domains\
<realmname> . Esta entrada no existe en el registro de forma predeterminada. Puede

usar el comando ksetup addrealmflags para rellenar el registro.

Las marcas de dominio kerberos especifican otras características de un dominio


kerberos que no se basan en el sistema operativo Windows Server. Los equipos
que ejecutan Windows Server pueden usar un servidor Kerberos para administrar
la autenticación en el dominio Kerberos, en lugar de usar un dominio que ejecute
un sistema operativo Windows Server. Esta entrada de registro establece las
características del dominio kerberos y son las siguientes:

Value Marca de Descripción


dominio
Kerberos

0xF All Todas las marcas de dominio Kerberos están establecidas.


Value Marca de Descripción
dominio
Kerberos

0x00 None No se establecen marcas de dominio kerberos y no hay otras


características habilitadas.

0x01 sendaddress La dirección IP se incluye dentro de los vales de concesión de vales.

0x02 tcpsupported Tanto el Protocolo de control de transmisión (TCP) como el Protocolo


de datagramas de usuario (UDP) se admiten en este dominio.

0x04 delegate Todos los usuarios de este dominio son de confianza para la
delegación.

0x08 ncsupported Este dominio Kerberos admite la canonización de nombres, lo que


permite los estándares de nomenclatura DNS y Realm.

0x80 rc4 Este dominio Kerberos admite el cifrado RC4 para habilitar la confianza
entre dominios, lo que permite el uso de TLS.

Puede ver las marcas de dominio kerberos disponibles y establecerlas viendo la


salida de ksetup o ksetup /dumpstate .

Ejemplos
Para enumerar las marcas de dominio kerberos disponibles para el dominio de kerberos
de CONTOSO, escriba lo siguiente:

ksetup /listrealmflags

Para establecer dos marcas en el dominio kerberos de CONTOSO, escriba lo siguiente:

ksetup /setrealmflags CONTOSO ncsupported delegate

Para agregar una marca más que no está actualmente en el conjunto, escriba lo
siguiente:

ksetup /addrealmflags CONTOSO SendAddress


Para comprobar que la marca de dominio kerberos está establecida, escriba ksetup y, a
continuación, visualice la salida buscando el texto Marcas de dominio kerberos =. Si no
ve el texto, significa que no se ha establecido la marca.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ksetup

Comando ksetup listrealmflags

Comando ksetup setrealmflags

Comando ksetup delrealmflags

Comando ksetup dumpstate


ksetup changepassword
Artículo • 14/04/2023

Usa el valor de contraseña del Centro de distribución de claves (KDC) (kpasswd) para
cambiar la contraseña del usuario que ha iniciado sesión. La salida del comando le
informa si el proceso se completó con éxito o si se produjo algún error.

Puede comprobar si se estableció kpasswd; para ello, ejecute el comando ksetup


/dumpstate y vea la salida.

Sintaxis

ksetup /changepassword <oldpassword> <newpassword>

Parámetros

Parámetro Descripción

<oldpassword> Especifica la contraseña existente del usuario que ha iniciado sesión.

<newpassword> Especifica la contraseña nueva del usuario que ha iniciado sesión. Esta
contraseña debe cumplir con todos los requisitos de contraseña establecidos en
este equipo.

Comentarios
Si la cuenta de usuario no se encuentra en el dominio actual, el sistema le pedirá
que proporcione el nombre de dominio en el que residen las cuentas de usuario.

Si desea forzar un cambio de contraseña en el próximo inicio de sesión, este


comando permite el uso del asterisco (*) para que se le solicite al usuario una
contraseña nueva.

Ejemplos
Para cambiar la contraseña de un usuario que ha iniciado sesión actualmente en este
equipo en este dominio, escriba:
ksetup /changepassword Pas$w0rd Pa$$w0rd

Para cambiar la contraseña de un usuario que ha iniciado sesión en el dominio Contoso,


escriba:

ksetup /domain CONTOSO /changepassword Pas$w0rd Pa$$w0rd

Para forzar que el usuario que inició sesión actualmente cambie la contraseña en el
inicio de sesión siguiente, escriba:

ksetup /changepassword Pas$w0rd *

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ksetup

Comando ksetup dumpstate

Comando ksetup addkpasswd

Comando ksetup delkpasswd

Comando ksetup dumpstate


ksetup delenctypeattr
Artículo • 14/04/2023

Quita el atributo de tipo de cifrado para el dominio. Se muestra un mensaje de estado


tras completarse correctamente o con errores.

Puede ver el tipo de cifrado del vale de concesión de vales (TGT) de Kerberos y la clave
de sesión mediante la ejecución del comando klist y la visualización de la salida. Puede
establecer el dominio al que conectarse y usar mediante la ejecución del comando
ksetup /domain <domainname> .

Sintaxis

ksetup /delenctypeattr <domainname>

Parámetros

Parámetro Descripción

<domainname> Nombre del dominio con el que desea establecer una conexión. Use el nombre
de dominio completo o una forma simple del nombre, como corp.contoso.com o
contoso.

Ejemplos
Para determinar los tipos de cifrado actuales establecidos en este equipo, escriba:

klist

Para establecer el dominio en mit.contoso.com, escriba:

ksetup /domain mit.contoso.com

Para comprobar qué es el atributo de tipo de cifrado para el dominio, escriba:


ksetup /getenctypeattr mit.contoso.com

Para quitar el atributo de tipo de cifrado establecido para el dominio mit.contoso.com,


escriba:

ksetup /delenctypeattr mit.contoso.com

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando klist

Comando ksetup

Comando ksetup domain

Comando ksetup addenctypeattr

Comando ksetup setenctypeattr


ksetup delhosttorealmmap
Artículo • 12/04/2023

Quita una asignación de nombre de entidad de seguridad de servicio (SPN) entre el host
indicado y el dominio kerberos. Este comando también quita cualquier asignación entre
un host y un dominio kerberos (o varios hosts y un dominio kerberos).

La asignación se almacena en el registro, en


HKEY_LOCAL_MACHINE\SYSTEM\CurrentContolSet\Control\Lsa\Kerberos\HostToRealm .

Después de ejecutar este comando, se recomienda asegurarse de que la asignación


aparece en el registro.

Sintaxis

ksetup /delhosttorealmmap <hostname> <realmname>

Parámetros

Parámetro Descripción

<hostname> Especifica el nombre de dominio completo del equipo.

<realmname> Especifica el nombre DNS en mayúsculas, como CORP.CONTOSO.COM.

Ejemplos
Para cambiar la configuración del dominio kerberos de CONTOSO y eliminar la
asignación del equipo host IPops897 al dominio kerberos, escriba:

ksetup /delhosttorealmmap IPops897 CONTOSO

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando ksetup

Comando ksetup addhosttorealmmap


ksetup delkdc
Artículo • 14/04/2023

Elimina instancias de nombres del Centro de distribución de claves (KDC) para el


dominio Kerberos.

La asignación se almacena en el registro, en


HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\Kerberos\Domains . Después

de ejecutar este comando, se recomienda asegurarse de que el KDC se ha quitado y ya


no aparece en la lista.

7 Nota

Para quitar los datos de configuración del dominio Kerberos de varios equipos, use
el complemento Plantilla de configuración de seguridad con la distribución de
directivas, en lugar de usar el comando ksetup explícitamente en equipos
individuales.

Sintaxis

ksetup /delkdc <realmname> <KDCname>

Parámetros

Parámetro Descripción

<realmname> Especifica el nombre DNS en mayúsculas, como CORP.CONTOSO.COM. Este es el


dominio Kerberos predeterminado que aparece al ejecutar el comando ksetup y es
el dominio Kerberos del que desea eliminar el KDC.

<KDCname> Especifica el nombre de dominio completo y con distinción entre mayúsculas y


minúsculas, como mitkdc.contoso.com.

Ejemplos
Para ver todas las asociaciones entre el dominio Kerberos de Windows y el dominio
Kerberos que no son de Windows, y determinar cuáles se van a quitar, escriba:
ksetup

Para quitar la asociación, escriba:

ksetup /delkdc CORP.CONTOSO.COM mitkdc.contoso.com

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ksetup

Comando ksetup addkdc


ksetup delkpasswd
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Quita un servidor de contraseñas Kerberos (kpasswd) para un dominio kerberos.

Sintaxis

ksetup /delkpasswd <realmname> <kpasswdname>

Parámetros

Parámetro Descripción

<realmname> Especifica el nombre DNS en mayúsculas, como CORP.CONTOSO.COM, y


aparece como el dominio de kerberos predeterminado o Realm= cuando se
ejecuta ksetup.

<kpasswdname> Especifica el servidor de contraseñas Kerberos. Se enuncia como nombre de


dominio completo, sin distinción entre mayúsculas y minúsculas, como
mitkdc.contoso.com. Si se omite el nombre del KDC, es posible que se utilice
DNS para buscar los KDC.

Ejemplos
Para asegurarse de que el dominio kerberos CORP.CONTOSO.COM utiliza el servidor
KDC que no es de Windows mitkdc.contoso.com como servidor de contraseñas, escriba:

ksetup /delkpasswd CORP.CONTOSO.COM mitkdc.contoso.com

Para asegurarse de que el dominio kerberos CORP.CONTOSO.COM no está asignado a


un servidor de contraseñas Kerberos (el nombre del KDC), escriba ksetup en el equipo
Windows y, a continuación, vea la salida.
Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ksetup

Comando ksetup delkpasswd


ksetup delrealmflags
Artículo • 05/10/2023

Quita las marcas de dominio kerberos del dominio kerberos especificado.

Sintaxis

ksetup /delrealmflags <realmname> [sendaddress] [tcpsupported] [delegate]


[ncsupported] [rc4]

Parámetros

Parámetro Descripción

<realmname> Especifica el nombre DNS en mayúsculas, como CORP.CONTOSO.COM, y aparece


como el dominio de kerberos predeterminado o Realm= cuando se ejecuta
ksetup.

Comentarios
Las marcas de dominio Kerberos especifican características adicionales de un
dominio Kerberos que no se basan en el sistema operativo Windows Server. Los
equipos que ejecutan Windows Server pueden usar un servidor Kerberos para
administrar la autenticación en el dominio Kerberos, en lugar de usar un dominio
que ejecute un sistema operativo Windows Server. Esta entrada establece las
características del dominio Kerberos y son las siguientes:

Value Marca de dominio Descripción


Kerberos

0xF Todo Todas las marcas de dominio Kerberos están activadas.

0x00 None No se establecen marcas de dominio Kerberos y no hay


características adicionales habilitadas.

0x01 sendaddress La dirección IP se incluirá dentro de los vales de concesión de


vales.

0x02 tcpsupported Tanto el Protocolo de control de transmisión (TCP) como el


Protocolo de datagramas de usuario (UDP) se admiten en este
Value Marca de dominio Descripción
Kerberos

dominio Kerberos.

0x04 delegado Todos los usuarios de este dominio Kerberos son de confianza
para la delegación.

0x08 ncsupported Este dominio Kerberos admite la canonización de nombres, lo que


permite los estándares de nomenclatura de DNS y dominio
Kerberos.

0x80 rc4 Este dominio Kerberos admite el cifrado RC4 para habilitar la
confianza entre dominios Kerberos, lo que permite el uso de TLS.

Los valores almacenados en caché se guardan en el registro en


HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\Kerberos\Domains\
<realmname> . Esta entrada no existe en el registro de forma predeterminada. Puede

usar el comando ksetup addrealmflags para rellenar el registro.

Puede ver las marcas de dominio Kerberos disponibles y establecerlas viendo la


salida de ksetup o ksetup /dumpstate .

Ejemplos
Para enumerar las marcas de dominio kerberos disponibles para el dominio de kerberos
de CONTOSO, escriba lo siguiente:

ksetup /listrealmflags

Para quitar dos marcas que están actualmente en el conjunto, escriba lo siguiente:

ksetup /delrealmflags CONTOSO ncsupported delegate

Para comprobar que las marcas de dominio kerberos han sido eliminadas, escriba
ksetup y, a continuación, visualice la salida buscando el texto Marcas de dominio

kerberos =.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ksetup

Comando ksetup listrealmflags

Comando ksetup setrealmflags

Comando ksetup addrealmflags

Comando ksetup dumpstate


ksetup domain
Artículo • 12/04/2023

Establece el nombre de dominio para todas las operaciones Kerberos.

Sintaxis

ksetup /domain <domainname>

Parámetros

Parámetro Descripción

<domainname> Nombre del dominio con el que desea establecer una conexión. Use el nombre
de dominio completo o una forma simple del nombre, como contoso.com o
contoso.

Ejemplos
Para establecer una conexión con un dominio válido, como Microsoft, mediante el
subcomando ksetup /mapuser , escriba:

ksetup /mapuser principal@realm domain-user /domain domain-name

Después de una conexión correcta, recibirá un nuevo TGT o se actualizará un TGT


existente.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ksetup

Comando ksetup mapuser


ksetup dumpstate
Artículo • 14/04/2023

Muestra el estado actual de la configuración del dominio kerberos para todos los
dominios kerberos definidos en el equipo. Este comando muestra la misma salida que el
comando ksetup.

Sintaxis

ksetup /dumpstate

Comentarios
La salida de este comando incluye el dominio kerberos predeterminado (el
dominio del que el equipo es miembro) y todos los dominios que se definen en
este equipo. Se incluye lo siguiente para cada dominio kerberos:

Todos los centros de distribución de claves (KDC) asociados a este dominio.

Todas las marcas set realm para este dominio kerberos.

La contraseña de KDC.

Este comando no muestra el nombre de dominio especificado por la detección de


DNS ni por el comando ksetup /domain .

Este comando no muestra la contraseña del equipo establecida mediante el


comando ksetup /setcomputerpassword .

Ejemplos
Para buscar las configuraciones de dominio kerberos en un equipo, escriba:

ksetup /dumpstate
Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ksetup
ksetup getenctypeattr
Artículo • 14/04/2023

Recupera el atributo de tipo de cifrado para el dominio. Se muestra un mensaje de


estado tras completarse correctamente o con errores.

Puede ver el tipo de cifrado del vale de concesión de vales (TGT) de Kerberos y la clave
de sesión mediante la ejecución del comando klist y la visualización de la salida. Puede
establecer el dominio al que conectarse y usar mediante la ejecución del comando
ksetup /domain <domainname> .

Sintaxis

ksetup /getenctypeattr <domainname>

Parámetros

Parámetro Descripción

<domainname> Nombre del dominio con el que desea establecer una conexión. Use el nombre
de dominio completo o una forma simple del nombre, como corp.contoso.com o
contoso.

Ejemplos
Para comprobar el atributo de tipo de cifrado para el dominio, escriba:

ksetup /getenctypeattr mit.contoso.com

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando klist

Comando ksetup
Comando ksetup domain

Comando ksetup addenctypeattr

Comando ksetup setenctypeattr

Comando ksetup delenctypeattr


ksetup listrealmflags
Artículo • 05/10/2023

Enumera las marcas de dominio Kerberos disponibles que ksetup puede notificar.

Sintaxis

ksetup /listrealmflags

Comentarios
Las marcas de dominio Kerberos especifican características adicionales de un
dominio Kerberos que no se basan en el sistema operativo Windows Server. Los
equipos que ejecutan Windows Server pueden usar un servidor Kerberos para
administrar la autenticación en el dominio Kerberos, en lugar de usar un dominio
que ejecute un sistema operativo Windows Server. Esta entrada establece las
características del dominio Kerberos y son las siguientes:

Value Marca de dominio Descripción


Kerberos

0xF Todo Todas las marcas de dominio Kerberos están activadas.

0x00 None No se establecen marcas de dominio Kerberos y no hay


características adicionales habilitadas.

0x01 sendaddress La dirección IP se incluirá dentro de los vales de concesión de


vales.

0x02 tcpsupported Tanto el Protocolo de control de transmisión (TCP) como el


Protocolo de datagramas de usuario (UDP) se admiten en este
dominio Kerberos.

0x04 delegado Todos los usuarios de este dominio Kerberos son de confianza
para la delegación.

0x08 ncsupported Este dominio Kerberos admite la canonización de nombres, lo que


permite los estándares de nomenclatura de DNS y dominio
Kerberos.

0x80 rc4 Este dominio Kerberos admite el cifrado RC4 para habilitar la
confianza entre dominios Kerberos, lo que permite el uso de TLS.
Los valores almacenados en caché se guardan en el registro en
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\Kerberos\Domains\

<realmname> . Esta entrada no existe en el registro de forma predeterminada. Puede

usar el comando ksetup addrealmflags para rellenar el registro.

Ejemplos
Para enumerar las marcas de dominio Kerberos conocidas en este equipo, escriba:

ksetup /listrealmflags

Para establecer las marcas de dominio Kerberos disponibles que ksetup no conoce,
escriba:

ksetup /setrealmflags CORP.CONTOSO.COM sendaddress tcpsupported delete


ncsupported

ksetup /setrealmflags CORP.CONTOSO.COM 0xF

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ksetup

Comando ksetup addrealmflags

Comando ksetup setrealmflags

Comando ksetup delrealmflags


ksetup mapuser
Artículo • 14/04/2023

Asigna el nombre de una entidad de seguridad Kerberos a una cuenta.

Sintaxis

ksetup /mapuser <principal> <account>

Parámetros

Parámetro Descripción

<principal> Especifica el nombre de dominio completo de cualquier usuario principal. Por


ejemplo, mike@corp.CONTOSO.COM. Si no especifica un parámetro de cuenta, la
asignación se elimina para la entidad de seguridad especificada.

<account> Especifica cualquier nombre de cuenta o grupo de seguridad que exista en este
equipo, como Guest, Domain Users o Administrator. Si se omite este parámetro,
la asignación se elimina para la entidad de seguridad especificada.

Comentarios
Una cuenta se puede identificar específicamente, como Domain Guests, o puede
usar un carácter comodín (*) para incluir todas las cuentas.

El equipo solo autentica las entidades de seguridad del dominio especificado si


presentan vales Kerberos válidos.

Cada vez que se realizan cambios en el Centro de distribución de claves externo


(KDC) y la configuración del dominio, se requiere un reinicio del equipo en el que
se ha cambiado la configuración.

Ejemplos
Para ver la configuración asignada actual y el dominio predeterminado, escriba:
ksetup

Para asignar la cuenta de Mike Danseglio dentro del dominio Kerberos CONTOSO a la
cuenta de invitado en este equipo, y concederle todos los privilegios de un miembro de
la cuenta de invitado integrada sin tener que autenticarse en este equipo, escriba:

ksetup /mapuser mike@corp.CONTOSO.COM guest

Para quitar la asignación de la cuenta de Mike Danseglio a la cuenta de invitado en este


equipo para evitar que se autentique en este equipo con sus credenciales de CONTOSO,
escriba:

ksetup /mapuser mike@corp.CONTOSO.COM

Para asignar la cuenta de Mike Danseglio dentro del dominio Kerberos de CONTOSO a
cualquier cuenta existente en este equipo, escriba:

ksetup /mapuser mike@corp.CONTOSO.COM *

7 Nota

Si solo las cuentas de usuario estándar e invitado están activas en este equipo, los
privilegios de Mike se establecen en ellos.

Para asignar todas las cuentas dentro del dominio Kerberos de CONTOSO a cualquier
cuenta existente con el mismo nombre en este equipo, escriba:

ksetup /mapuser * *

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando ksetup
ksetup removerealm
Artículo • 14/04/2023

Elimina toda la información del dominio Kerberos especificado del registro.

El nombre del dominio se almacena en el registro en


HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\Kerberos y
HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\Lsa\Kerberos . Esta entrada no existe

en el registro de forma predeterminada. Puede usar el comando ksetup addrealmflags


para rellenar el registro.

) Importante

No puede quitar el nombre de dominio predeterminado del controlador de


dominio porque restablece su información de DNS y quitarlo podría hacer que el
controlador de dominio no se pueda usar.

Sintaxis

ksetup /removerealm <realmname>

Parámetros

Parámetro Descripción

<realmname> Especifica el nombre DNS en mayúsculas, como CORP.CONTOSO.COM, y aparece


como el dominio predeterminado o Realm= cuando se ejecuta ksetup.

Ejemplos
Para quitar un nombre de dominio Kerberos erróneo (. CON en lugar de .COM) del
equipo local, escriba:

ksetup /removerealm CORP.CONTOSO.CON


Para comprobar la eliminación, puede ejecutar el comando ksetup y revisar la
eliminación.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ksetup

Comando ksetup setrealm


ksetup server
Artículo • 08/04/2023

Permite especificar un nombre para un equipo que ejecuta el sistema operativo


Windows, de modo que los cambios realizados por el comando ksetup actualicen el
equipo de destino.

El nombre del servidor de destino se almacena en el registro en


HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\LSA\Kerberos . Esta entrada no se

notifica al ejecutar el comando ksetup.

) Importante

No hay ninguna manera de quitar el nombre del servidor de destino. En su lugar,


puede volver a cambiarlo al nombre del equipo local, que es el valor
predeterminado.

Sintaxis

ksetup /server <servername>

Parámetros

Parámetro Descripción

<servername> Especifica el nombre completo del equipo en el que se aplicará la configuración,


como IPops897.corp.contoso.com.

Si se especifica un nombre de equipo de dominio completo incompleto, se


producirá un error en el comando.

Ejemplos
Para que las configuraciones de ksetup sean efectivas en el equipo IPops897, que está
conectado en el dominio Contoso, escriba:
ksetup /server IPops897.corp.contoso.com

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ksetup
ksetup setcomputerpassword
Artículo • 14/04/2023

Establece la contraseña del equipo local. Este comando afecta solo a la cuenta de
equipo y requiere un reinicio para que el cambio de contraseña surta efecto.

) Importante

La contraseña de la cuenta de equipo no se muestra en el registro ni como salida


del comando ksetup.

Sintaxis

ksetup /setcomputerpassword <password>

Parámetros

Parámetro Descripción

<password> Especifica la contraseña proporcionada para establecer la cuenta de equipo en el


equipo local. La contraseña solo se puede establecer mediante una cuenta con
privilegios administrativos y la contraseña debe tener entre 1 y 156 caracteres
alfanuméricos o especiales.

Ejemplos
Para cambiar la contraseña de la cuenta de equipo en el equipo local de IPops897 a
IPop$897!, escriba:

ksetup /setcomputerpassword IPop$897!

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando ksetup
ksetup setenctypeattr
Artículo • 14/04/2023

Establece el atributo de tipo de cifrado para el dominio. Se muestra un mensaje de


estado tras completarse correctamente o con errores.

Puede ver el tipo de cifrado del vale de concesión de vales (TGT) de Kerberos y la clave
de sesión mediante la ejecución del comando klist y la visualización de la salida. Puede
establecer el dominio al que conectarse y usar mediante la ejecución del comando
ksetup /domain <domainname> .

Sintaxis

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 Descripción

<domainname> Nombre del dominio con el que desea establecer una conexión. Use el nombre
de dominio completo o una forma simple del nombre, como corp.contoso.com o
contoso.

encryption Debe ser uno de los siguientes tipos de cifrado admitidos:


type DES-CBC-CRC
DES-CBC-MD5
RC4-HMAC-MD5
AES128-CTS-HMAC-SHA1-96
AES256-CTS-HMAC-SHA1-96

Comentarios
Puede establecer o agregar varios tipos de cifrado separando los tipos de cifrado
en el comando con un espacio. Sin embargo, solo puede hacerlo para un dominio
a la vez.

Ejemplos
Para ver el tipo de cifrado del vale de concesión de vales de Kerberos (TGT) y la clave de
sesión, escriba:

klist

Para establecer el dominio en corp.contoso.com, escriba:

ksetup /domain corp.contoso.com

Para establecer el atributo de tipo de cifrado en AES-256-CTS-HMAC-SHA1-96 para el


corp.contoso.com de dominio, escriba:

ksetup /setenctypeattr corp.contoso.com AES-256-CTS-HMAC-SHA1-96

Para comprobar que el atributo de tipo de cifrado se estableció según lo previsto para el
dominio, escriba:

ksetup /getenctypeattr corp.contoso.com

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando klist

Comando ksetup

Comando ksetup domain

Comando ksetup addenctypeattr

Comando ksetup getenctypeattr

Comando ksetup delenctypeattr


ksetup setrealm
Artículo • 14/04/2023

Establece el nombre de un dominio Kerberos.

) Importante

No se admite la configuración del dominio Kerberos en un controlador de dominio.


Si intenta hacerlo, se produce una advertencia y un error de comando.

Sintaxis

ksetup /setrealm <DNSdomainname>

Parámetros

Parámetro Descripción

<DNSdomainname> Especifica el nombre DNS en mayúsculas, como CORP.CONTOSO.COM. Puede


usar el nombre de dominio completo o una forma simple del nombre. Si no
usa mayúsculas para el nombre DNS, se le pedirá que realice la comprobación.

Ejemplos
Para establecer el dominio Kerberos de este equipo en un nombre de dominio
específico y restringir el acceso por un controlador que no sea de dominio solo al
dominio Kerberos de CONTOSO, escriba:

ksetup /setrealm CONTOSO

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando ksetup

ksetup removerealm
ksetup setrealmflags
Artículo • 12/04/2023

Establece marcas de dominio Kerberos para el dominio Kerberos especificado.

Sintaxis

ksetup /setrealmflags <realmname> [sendaddress] [tcpsupported] [delegate]


[ncsupported] [rc4]

Parámetros

Parámetro Descripción

<realmname> Especifica el nombre DNS en mayúsculas, como CORP. CONTOSO.COM.

Comentarios
Las marcas de dominio Kerberos especifican características adicionales de un
dominio Kerberos que no se basan en el sistema operativo Windows Server. Los
equipos que ejecutan Windows Server pueden usar un servidor Kerberos para
administrar la autenticación en el dominio Kerberos, en lugar de usar un dominio
que ejecute un sistema operativo Windows Server. Esta entrada establece las
características del dominio Kerberos y son las siguientes:

Value Marca de Descripción


dominio
Kerberos

0xF Todo Todas las marcas de dominio Kerberos están activadas.

0x00 None No se establecen marcas de dominio Kerberos y no hay características


adicionales habilitadas.

0x01 sendaddress La dirección IP se incluirá dentro de los vales de concesión de vales.

0x02 tcpsupported Tanto el Protocolo de control de transmisión (TCP) como el Protocolo de


datagramas de usuario (UDP) se admiten en este dominio Kerberos.
Value Marca de Descripción
dominio
Kerberos

0x04 delegado Todos los usuarios de este dominio Kerberos son de confianza para la
delegación.

0x08 ncsupported Este dominio Kerberos admite la canonización de nombres, lo que


permite los estándares de nomenclatura de DNS y dominio Kerberos.

0x80 rc4 Este dominio Kerberos admite el cifrado RC4 para habilitar la confianza
entre dominios Kerberos, lo que permite el uso de TLS.

Los valores almacenados en caché se guardan en el registro en


HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\Kerberos\Domains\

<realmname> . Esta entrada no existe en el registro de forma predeterminada. Puede


usar el comando ksetup addrealmflags para rellenar el registro.

Puede ver las marcas de dominio Kerberos disponibles y establecerlas viendo la


salida de ksetup o ksetup /dumpstate .

Ejemplos
Para enumerar los valores disponibles y para establecer marcas de dominio Kerberos
para el dominio CONTOSO, escriba:

ksetup

Para establecer dos marcas que no estén ya establecidas, escriba:

ksetup /setrealmflags CONTOSO ncsupported delegate

Para comprobar que la marca de dominio Kerberos está activada, escriba ksetup y, a
continuación, visualice la salida buscando el texto Marcas de dominio =. Si no ve el
texto, significa que no se ha establecido la marca.

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando ksetup

Comando ksetup listrealmflags

Comando ksetup addrealmflags

Comando ksetup delrealmflags

Comando ksetup dumpstate


ktmutil
Artículo • 12/04/2023

Inicia la utilidad Administrador de transacciones de kernel. Si se usa sin parámetros,


ktmutil muestra los subcomandos disponibles.

Sintaxis

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

Ejemplos
Para forzar una transacción Indoubt con GUID 311a9209-03f4-11dc-918f-00188b8f707b
para confirmar, escriba:

ktmutil force commit {311a9209-03f4-11dc-918f-00188b8f707b}

Vínculos relacionados
Clave de sintaxis de línea de comandos
ktpass
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Configura el nombre de la entidad de seguridad del servidor para el host o servicio en


los Active Directory Domain Services (AD DS) y genera un archivo .keytab que contiene
la clave secreta compartida del servicio. El archivo .keytab se basa en la implementación
del Instituto Tecnológico de Massachusetts (MIT) del protocolo de autenticación
Kerberos. La herramienta de línea de comandos Ktpass permite a los servicios no
Windows que admiten la autenticación Kerberos usar las características de
interoperabilidad proporcionadas por el servicio Centro de distribución de claves (KDC)
de Kerberos.

Sintaxis

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 Descripción
Parámetro Descripción

/out <filename> Especifica el nombre del archivo .keytab de la


versión 5 de Kerberos que se va a generar.
Nota: Este es el archivo .keytab que se
transfiere a un equipo que no ejecuta el
sistema operativo Windows y, a continuación,
se reemplaza o combina con el archivo .keytab
existente, /Etc/Krb5.keytab.

/princ <principalname> Especifica el nombre principal en el formulario


host/computer.contoso.com@CONTOSO.COM.
Advertencia: Este parámetro distingue
mayúsculas de minúsculas.

/mapuser <useraccount> Asigna el nombre de la entidad de seguridad


Kerberos, especificada por el parámetro princ,
a la cuenta de dominio especificada.

/mapop {add|set} Especifica cómo se establece el atributo de


asignación.
Add: agrega el valor del nombre de
usuario local especificado. Este es el
valor predeterminado.
Set: establece el valor del cifrado
estándar de cifrado de datos (DES) solo
para el nombre de usuario local
especificado.

{-|+} desonly El cifrado de solo DES se establece de forma


predeterminada.
+ Establece una cuenta para el cifrado
de solo DES.
- Libera la restricción en una cuenta para
el cifrado de solo DES. Importante:
Windows no admite DES de forma
predeterminada.

/in <filename> Especifica el archivo .keytab que se va a leer


desde un equipo host que no ejecuta el
sistema operativo Windows.

/pass {password|*|{-|+}rndpass} Especifica una contraseña para el nombre de


usuario principal especificado por el
parámetro princ. Use * para solicitar una
contraseña.

/minpass Establece la longitud mínima de la contraseña


aleatoria en 15 caracteres.
Parámetro Descripción

/maxpass Establece la longitud máxima de la contraseña


aleatoria en 256 caracteres.

/crypto {DES-CBC-CRC|DES-CBC-MD5|RC4-HMAC-NT|AES256- Especifica las claves que se generan en el


SHA1|AES128-SHA1|All} archivo keytab:
DES-CBC-CRC: se usa para la
compatibilidad.
DES-CBC-MD5: se adhiere más
estrechamente a la implementación MIT
y se usa para la compatibilidad.
RC4-HMAC-NT: emplea cifrado de 128
bits.
AES256-SHA1: emplea el cifrado
AES256-CTS-HMAC-SHA1-96.
AES128-SHA1: emplea el cifrado
AES128-CTS-HMAC-SHA1-96.
All: indica que se pueden usar todos los
tipos criptográficos admitidos.

Nota: Dado que la configuración


predeterminada se basa en versiones
anteriores de MIT, siempre debe usar el
parámetro /crypto .

/itercount Especifica el recuento de iteraciones que se


usa para el cifrado AES. El valor
predeterminado omite itercount para el
cifrado que no es AES y establece el cifrado
AES en 4096.

/ptype Especifica los tipos principales.


{KRB5_NT_PRINCIPAL|KRB5_NT_SRV_INST|KRB5_NT_SRV_HST} KRB5_NT_PRINCIPAL: tipo de entidad
de seguridad general (recomendado).
KRB5_NT_SRV_INST: la instancia de
servicio de usuario
KRB5_NT_SRV_HST: la instancia del
servicio host

/kvno <keyversionnum> Especifica el número de versión de la clave. El


valor predeterminado es 1.
Parámetro Descripción

/answer {-|+} Establece el modo de respuesta en segundo


plano:
Las respuestas - restablecen
automáticamente las solicitudes de
contraseña con NO.
Las respuestas + restablecen
automáticamente las solicitudes de
contraseña con SÍ.

/target Establece qué controlador de dominio se va a


usar. El valor predeterminado es para que se
detecte el controlador de dominio, en función
del nombre principal. Si el nombre del
controlador de dominio no se resuelve, un
cuadro de diálogo solicitará un controlador de
dominio válido.

/rawsalt obliga a ktpass a usar el algoritmo rawsalt al


generar la clave. Este parámetro es opcional.

{-|+}dumpsalt La salida de este parámetro muestra el


algoritmo de sal mit que se usa para generar
la clave.

{-|+}setupn Establece el nombre principal de usuario


(UPN) además del nombre de entidad de
seguridad de servicio (SPN). El valor
predeterminado es establecer ambos en el
archivo .keytab.

{-|+}setpass <password> Establece la contraseña del usuario cuando se


proporciona. Si se usa rndpass, se genera una
contraseña aleatoria en su lugar.

/? Muestra ayuda para este comando.

Comentarios
Los servicios que se ejecutan en sistemas que no ejecutan el sistema operativo
Windows se pueden configurar con cuentas de instancia de servicio en AD DS. Esto
permite que cualquier cliente Kerberos se autentique en servicios que no ejecutan
el sistema operativo Windows mediante el KDC de Windows.

El parámetro /princ no se evalúa mediante ktpass y se usa como se proporciona.


No hay ninguna comprobación para ver si el parámetro coincide con el caso
exacto del valor del atributo userPrincipalName al generar el archivo Keytab. Las
distribuciones Kerbero que distinguen mayúsculas de minúsculas que usan este
archivo Keytab pueden tener problemas si no hay ninguna coincidencia exacta de
mayúsculas y minúsculas e incluso podría producir un error durante la
autenticación previa. Para comprobar y recuperar el valor de atributo
userPrincipalName correcto de un archivo de exportación LDifDE. Por ejemplo:

ldifde /f keytab_user.ldf /d CN=Keytab


User,OU=UserAccounts,DC=contoso,DC=corp,DC=microsoft,DC=com /p base /l
samaccountname,userprincipalname

Ejemplos
Para crear un archivo .keytab de Kerberos para un equipo host que no ejecuta el sistema
operativo Windows, debe asignar la entidad de seguridad a la cuenta y establecer la
contraseña de la entidad de seguridad de host.

1. Use el complemento Usuario y equipos de Active Directory para crear una cuenta
de usuario para un servicio en un equipo que no ejecute el sistema operativo
Windows. Por ejemplo, cree una cuenta con el nombre User1.

2. Use el comando ktpass para configurar una asignación de identidad para la cuenta
de usuario escribiendo:

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 Nota

No se pueden asignar varias instancias de servicio a la misma cuenta de


usuario.

3. Combine el archivo .keytab con el archivo /Etc/Krb5.keytab en un equipo host que


no ejecute el sistema operativo Windows.

Vínculos relacionados
Clave de sintaxis de línea de comandos
label
Artículo • 14/04/2023

Crea, cambia o elimina la etiqueta de volumen (es decir, el nombre) de un disco. Si se


usa sin parámetros, el comando label cambia la etiqueta de volumen actual o elimina la
etiqueta existente.

Sintaxis

label [/mp] [<volume>] [<label>]

Parámetros

Parámetro Descripción

/mp Especifica que el volumen debe tratarse como un punto de montaje o un nombre
de volumen.

<volume> Especifica una letra de unidad (seguida de dos puntos), un punto de montaje o un
nombre de volumen. Si se especifica un nombre de volumen, el parámetro /mp no
es necesario.

<label> Especifica la etiqueta que se va a utilizar para el volumen.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Windows muestra la etiqueta de volumen y el número de serie (si tiene uno) como
parte de la lista de directorios.

Una etiqueta de volumen NTFS puede tener hasta 32 caracteres de longitud,


incluidos los espacios. Las etiquetas de volumen NTFS conservan y muestran el
caso que se usó cuando se creó la etiqueta.

Ejemplos
Para etiquetar un disco en la unidad A que contiene información de ventas para julio,
escriba:

label a:sales-july

Para ver y eliminar la etiqueta actual de la unidad C, siga estos pasos:

1. En el símbolo del sistema, escriba:

label

Debe aparecer una salida similar a la siguiente:

Volume in drive C: is Main Disk


Volume Serial Number is 6789-ABCD
Volume label (32 characters, ENTER for none)?

2. Presione ENTRAR. Se debe mostrar el siguiente símbolo del sistema:

Delete current volume label (Y/N)?

3. Presione Y para eliminar la etiqueta actual o N si desea conservar la etiqueta


existente.

Vínculos relacionados
Clave de sintaxis de línea de comandos
list
Artículo • 12/04/2023

Muestra una lista de discos, de particiones en un disco, de volúmenes en un disco o de


discos duros virtuales (VHD).

Sintaxis

list { disk | partition | volume | vdisk }

Parámetros

Parámetro Descripción

disk Muestra una lista de discos e información acerca de ellos, como el tamaño, la
cantidad de espacio libre disponible, si se trata de un disco básico o dinámico y si el
disco usa el estilo de partición de registro de arranque maestro (MBR) o de tabla de
particiones GUID (GPT).

partición Muestra las particiones enumeradas en la tabla de particiones del disco actual.

volumen Muestra una lista de volúmenes básicos y dinámicos en todos los discos.

vdisk Muestra una lista de los VHD que están conectados o seleccionados. Este comando
muestra los VHD desasociados si están seleccionados en este momento; sin
embargo, el tipo de disco se establece en Desconocido hasta que se conecta el
disco duro virtual. El VHD marcado con un asterisco (*) tiene el foco.

Comentarios

Al enumerar particiones en un disco dinámico, es posible que las particiones no se


correspondan con los volúmenes dinámicos del disco. Esta discrepancia se
produce porque los discos dinámicos contienen entradas en la tabla de particiones
para el volumen de sistema o el volumen de arranque (si existen en el disco).
También contienen una partición que ocupa el resto del disco para reservar el
espacio para que lo utilicen los volúmenes dinámicos.

El objeto marcado con un asterisco (*) tiene el foco.


Al enumerar los discos, si falta un disco, el número de disco tiene el prefijo M. Por
ejemplo, el primer disco que falta es M0.

Ejemplos

list disk
list partition
list volume
list vdisk

Vínculos relacionados
Clave de sintaxis de línea de comandos
list providers
Artículo • 14/04/2023

Enumera los proveedores de instantáneas que están registrados actualmente en el


sistema.

Sintaxis

list providers

Ejemplos
Para enumerar los proveedores de instantáneas registrados actualmente, escriba:

list providers

Esto genera una salida similar a las siguientes visualizaciones:

* 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.

Vínculos relacionados
Clave de sintaxis de línea de comandos
list shadows
Artículo • 14/04/2023

Enumera las instantáneas persistentes y no persistentes existentes que están en el


sistema.

Sintaxis

list shadows {all | set <setID> | id <shadowID>}

Parámetros

Parámetro Descripción

all Enumera todas las instantáneas.

set <setID> Enumera las instantáneas que pertenecen al identificador de conjunto de


instantáneas especificado.

id Enumera cualquier instantánea con el identificador de instantánea especificado.


<shadowID>

Vínculos relacionados
Clave de sintaxis de línea de comandos
list writers
Artículo • 14/04/2023

Enumera los escritores que hay en el sistema. Si se usa sin parámetros, list muestra la
salida de los metadatos de lista de forma predeterminada.

Sintaxis

list writers [metadata | detailed | status]

Parámetros

Parámetro Descripción

metadata Enumera la identidad y el estado de los escritores, y muestra metadatos como


detalles del componente y archivos excluidos. Este es el parámetro predeterminado.

detallado Enumera la misma información que metadata, pero también incluye la lista de
archivos completa para todos los componentes.

status Muestra solo la identidad y el estado de los escritores registrados.

Ejemplos
Para mostrar solo la identidad y el estado de los escritores, escriba:

list writers status

Esto genera una salida similar a las siguientes visualizaciones:

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.

Vínculos relacionados
Clave de sintaxis de línea de comandos
Load metadata
Artículo • 12/04/2023

Carga un archivo de metadatos .cab antes de importar una instantánea transportable o


carga los metadatos del escritor en el caso de una restauración. Si se usa sin
parámetros, load metadata muestra ayuda en el símbolo del sistema.

Sintaxis

load metadata [<drive>:][<path>]<metadata.cab>

Parámetros

Parámetro Descripción

[<drive>:][<path>] Especifica la ubicación del archivo de metadatos.

metadata.cab Especifica el archivo .cab de metadatos que se va a cargar.

Comentarios
Puede usar el comando import para importar una instantánea transportable en
función de los metadatos especificados por load metadata.

Debe ejecutar este comando antes del comando begin restore para cargar los
escritores y componentes seleccionados para la restauración.

Ejemplos
Para cargar un archivo de metadatos denominado metafile.cab desde la ubicación
predeterminada, escriba lo siguiente:

load metadata metafile.cab


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando import diskshadow

Comando begin restore


lodctr
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Permite registrar o guardar la configuración del registro y el nombre del contador de


rendimiento en un archivo y designar servicios de confianza.

Sintaxis

lodctr <filename> [/s:<filename>] [/r:<filename>] [/t:<servicename>]

Parámetros

Parámetro Descripción

<filename> Especifica el nombre del archivo de inicialización que registra la configuración


del nombre del contador de rendimiento y el texto explicativo.

/s: <filename> Especifica el nombre del archivo en el que se guardan la configuración del
registro del contador de rendimiento y el texto explicativo.

/r Restaura la configuración del registro de contadores y el texto explicativo de la


configuración actual del registro y los archivos de rendimiento almacenados
en caché relacionados con el registro.

/r: <filename> Especifica el nombre del archivo que restaura la configuración del registro del
contador de rendimiento y el texto explicativo.
Advertencia: Si usa este comando, sobrescribirá toda la configuración del
registro de contadores de rendimiento y el texto explicativo, lo que los
sustituirá por la configuración definida en el archivo especificado.

/t: <servicename> Indica que el servicio <servicename> es de confianza.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si la información que proporciona contiene espacios, use comillas alrededor del
texto (por ejemplo, “nombre de archivo 1”).

Ejemplos
Para guardar la configuración actual del registro de rendimiento y el texto explicativo en
el archivo “perf backup1.txt”, escriba:

lodctr /s:"perf backup1.txt"

Vínculos relacionados
Clave de sintaxis de línea de comandos
logman
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea y administra registros de rendimiento y de sesión de seguimiento de eventos, y


admite muchas funciones del Monitor de rendimiento desde la línea de comandos.

Sintaxis

logman [create | query | start | stop | delete| update | import | export |


/?] [options]

Parámetros

Parámetro Descripción

logman Crea un contador, un seguimiento, un recopilador de datos de configuración o


create una API.

logman Consulta las propiedades del recopilador de datos.


query

logman start Inicia o detiene la recopilación de datos.


| stop

logman Elimina un recopilador de datos existente.


delete

logman Actualiza las propiedades de un recopilador de datos existente.


update

logman Importa un conjunto de recopiladores de datos desde un archivo XML o exporta


import | un conjunto de recopiladores de datos a un archivo XML.
export

Vínculos relacionados
Clave de sintaxis de línea de comandos
logman create
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea un contador, un seguimiento, un recopilador de datos de configuración o una API.

Sintaxis

logman create <counter | trace | alert | cfg | api> <[-n] <name>> [options]

Parámetros

Parámetro Descripción

logman create counter Crea un recopilador de datos de contador.

logman create trace Crea un recopilador de datos de seguimiento.

logman create alert Crea un recopilador de datos de alertas.

logman create cfg Crea un recopilador de datos de configuración.

logman create api Crea un recopilador de datos de seguimiento de API.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman
logman create alert
Artículo • 05/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea un recopilador de datos de alertas.

Sintaxis

logman create alert <[-n] <name>> [options]

Parámetros

Parámetro Descripción

-s <computer name> Ejecute el comando en el equipo remoto especificado.

-config <value> Especifica el archivo de configuración que contiene las opciones de


comando.

[-n] <name> Nombre del objeto de destino.

-[-]u <user [password]> Especifica el usuario para Ejecutar como. Si se escribe un * como
contraseña, se genera un mensaje para la contraseña. La contraseña
no se muestra cuando se escribe en la solicitud de contraseña.

-m <[start] [stop] Cambia a un inicio o parada manual en lugar de una hora de inicio o
[[start] [stop] [...]]> finalización programadas.

-rf <[[hh:]mm:]ss> Ejecuta el recopilador de datos durante el período de tiempo


especificado.

-b <M/d/yyyy Comienza a recopilar datos en el momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Finaliza la recopilación de datos en el momento especificado.


h:mm:ss[AM|PM]>

-si <[[hh:]mm:]ss> Especifica el intervalo de ejemplo para los recopiladores de datos


del contador de rendimiento.
Parámetro Descripción

-o <path|dsn!log> Especifica el archivo de registro de salida o el nombre del conjunto


de registros y DSN en una base de datos SQL.

-[-]r Repite el recopilador de datos diariamente en las horas de inicio y


finalización especificadas.

-[-]a Anexa un archivo de registro existente.

-[-]ow Sobrescribe un archivo de registro existente.

-[-]v <nnnnnn|mmddhhmm> Adjunta información de control de versiones de archivos al final del


nombre del archivo de registro.

-[-]rc <task> Ejecuta el comando especificado cada vez que se cierra el registro.

-[-]max <value> Tamaño máximo del archivo de registro en MB o número máximo de


registros para los registros de SQL.

-[-]cnf <[[hh:]mm:]ss> Cuando se especifica la hora, crea un nuevo archivo cuando ha


transcurrido el tiempo especificado. Cuando no se especifica la hora,
crea un nuevo archivo cuando se supera el tamaño máximo.

-y Responde sí a todas las preguntas sin preguntar.

-cf <filename> Especifica los contadores de rendimiento de la lista de archivos que


se van a recopilar. El archivo debe incluir un nombre de contador de
rendimiento por línea.

-[-]el Habilita o deshabilita los informes del registro de eventos.

-th <threshold [threshold Especifica los contadores y sus valores de umbral para una alerta.
[...]]>

-[-]rdcs <name> Especifica el conjunto de recopiladores de datos que se iniciará


cuando se active una alerta.

-[-]tn <task> Especifica la tarea que se ejecutará cuando se active una alerta.

-[-]targ <argument> Especifica los argumentos de tarea que se van a usar con la tarea
especificada mediante -tn.

/? Muestra ayuda contextual.

Comentarios

Cuando [-] aparece en la lista, al agregar un guion adicional (-) se niega la opción.

Ejemplos
Para crear una nueva alerta denominada new_alert, que se desencadena cuando el
contador de rendimiento % de tiempo de procesador en el grupo de contadores
Processor(_Total) supera el valor de contador de 50, escriba:

logman create alert new_alert -th \Processor(_Total)\% Processor time>50

7 Nota

El valor de umbral definido se basa en el valor recopilado por el contador, por lo


que, en este ejemplo, el valor de 50 equivale al 50 % del tiempo del procesador.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman update alert

Comando logman
logman create api
Artículo • 05/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea un recopilador de datos de seguimiento de API.

Sintaxis

logman create api <[-n] <name>> [options]

Parámetros

Parámetro Descripción

-s <computer name> Ejecuta el comando en el equipo remoto especificado.

-config <value> Especifica el archivo de configuración que contiene las opciones de


comando.

[-n] <name> Nombre del objeto de destino.

-f <bin|bincirc> Especifica el formato de registro para el recopilador de datos.

-[-]u <user [password]> Especifica el usuario para Ejecutar como. Si se escribe un * como
contraseña, se genera un mensaje para la contraseña. La contraseña
no se muestra cuando se escribe en la solicitud de contraseña.

-m <[start] [stop] Cambia a un inicio o parada manual en lugar de una hora de inicio o
[[start] [stop] [...]]> finalización programadas.

-rf <[[hh:]mm:]ss> Ejecuta el recopilador de datos durante el período de tiempo


especificado.

-b <M/d/yyyy Comienza a recopilar datos en el momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Finaliza la recopilación de datos en el momento especificado.


h:mm:ss[AM|PM]>
Parámetro Descripción

-si <[[hh:]mm:]ss> Especifica el intervalo de ejemplo para los recopiladores de datos


del contador de rendimiento.

-o <path|dsn!log> Especifica el archivo de registro de salida o el nombre del conjunto


de registros y DSN en una base de datos SQL.

-[-]r Repite el recopilador de datos diariamente en las horas de inicio y


finalización especificadas.

-[-]a Anexa un archivo de registro existente.

-[-]ow Sobrescribe un archivo de registro existente.

-[-]v <nnnnnn|mmddhhmm> Adjunta información de control de versiones de archivos al final del


nombre del archivo de registro.

-[-]rc <task> Ejecuta el comando especificado cada vez que se cierra el registro.

-[-]max <value> Tamaño máximo del archivo de registro en MB o número máximo de


registros para los registros de SQL.

-[-]cnf <[[hh:]mm:]ss> Cuando se especifica la hora, crea un nuevo archivo cuando ha


transcurrido el tiempo especificado. Cuando no se especifica la hora,
crea un nuevo archivo cuando se supera el tamaño máximo.

-y Responder sí a todas las preguntas sin preguntar.

-mods <path [path Especifica la lista de módulos desde los que se van a registrar las
[...]]> llamadas API.

-inapis <module!api Especifica la lista de llamadas API que se van a incluir en el registro.
[module!api [...]]>

-exapis <module!api Especifica la lista de llamadas API que se van a excluir del registro.
[module!api [...]]>

-[-]ano Registra (-ano) solo nombres de API o no registra (-ano) solo


nombres de API.

-[-]recursive Registra (-recursive) o no registra (-recursive) de forma recursiva


más allá de la primera capa.

-exe <value> Especifica la ruta de acceso completa a un archivo ejecutable para el


seguimiento de API.

/? Muestra ayuda contextual.

Comentarios
Cuando [-] aparece en la lista, al agregar un guion adicional (-) se niega la opción.

Ejemplos
Para crear un contador de seguimiento de API denominado trace_notepad para el
archivo ejecutable c:\windows\notepad.exe y colocar los resultados en el archivo
c:\notepad.etl, escriba:

logman create api trace_notepad -exe c:\windows\notepad.exe -o


c:\notepad.etl

Para crear un contador de seguimiento de API denominado trace_notepad para el


archivo ejecutable c:\windows\notepad.exe y recopilar valores generados por el módulo
en c:\windows\system32\advapi32.dll, escriba:

logman create api trace_notepad -exe c:\windows\notepad.exe -mods


c:\windows\system32\advapi32.dll

Para actualizar un contador de seguimiento de API existente denominado trace_notepad


para el archivo ejecutable c:\windows\notepad.exe y excluir la llamada API TlsGetValue
generada por el módulo kernel32.dll, escriba:

logman create api trace_notepad -exe c:\windows\notepad.exe -exapis


kernel32.dll!TlsGetValue

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman update api

Comando logman
logman create cfg
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea un recopilador de datos de configuración.

Sintaxis

logman create cfg <[-n] <name>> [options]

Parámetros

Parámetro Descripción

-s <computer name> Ejecuta el comando en el equipo remoto especificado.

-config <value> Especifica el archivo de configuración que contiene las opciones de


comando.

[-n] <name> Nombre del objeto de destino.

-[-]u <user Especifica el usuario para Ejecutar como. Si se escribe un * como contraseña,
[password]> se genera un mensaje para la contraseña. La contraseña no se muestra
cuando se escribe en la solicitud de contraseña.

-m <[start] Cambia a un inicio o parada manual en lugar de una hora de inicio o


[stop] [[start] finalización programadas.
[stop] [...]]>

-rf <[[hh:]mm:]ss> Ejecuta el recopilador de datos durante el período de tiempo especificado.

-b <M/d/yyyy Comienza a recopilar datos en el momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Finaliza la recopilación de datos en el momento especificado.


h:mm:ss[AM|PM]>

-si <[[hh:]mm:]ss> Especifica el intervalo de ejemplo para los recopiladores de datos del
contador de rendimiento.
Parámetro Descripción

-o <path|dsn!log> Especifica el archivo de registro de salida o el nombre del conjunto de


registros y DSN en una base de datos SQL.

-[-]r Repite el recopilador de datos diariamente en las horas de inicio y


finalización especificadas.

-[-]a Anexa un archivo de registro existente.

-[-]ow Sobrescribe un archivo de registro existente.

-[-]v Adjunta información de control de versiones de archivos al final del nombre


<nnnnnn|mmddhhmm> del archivo de registro.

-[-]rc <task> Ejecuta el comando especificado cada vez que se cierra el registro.

-[-]max <value> Tamaño máximo del archivo de registro en MB o número máximo de


registros para los registros de SQL.

-[-]cnf Cuando se especifica la hora, crea un nuevo archivo cuando ha transcurrido


<[[hh:]mm:]ss> el tiempo especificado. Cuando no se especifica la hora, crea un nuevo
archivo cuando se supera el tamaño máximo.

-y Responde sí a todas las preguntas sin preguntar.

-[-]ni Habilita (-ni) o deshabilita (-ni) la consulta de interfaz de red.

-reg <path [path Especifica los valores del registro que se van a recopilar.
[...]]>

-mgt <query Especifica el objeto o los objetos WMI que se van a recopilar mediante el
[query [...]]> lenguaje de consulta SQL.

-ftc <path [path Especifica la ruta de acceso completa a los archivos que se van a recopilar.
[...]]>

/? Muestra ayuda contextual.

Comentarios
Cuando [-] aparece en la lista, al agregar un guion adicional (-) se niega la opción.

Ejemplos
Para crear un recopilador de datos de configuración denominado cfg_log usando la
clave del registro HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\Currentverion\ ,
escriba:
logman create cfg cfg_log -reg HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
NT\Currentverion\\

Para crear un recopilador de datos de configuración denominado cfg_log, que registra


todos los objetos WMI de en la columna de root\wmi en la columna de base de datos
MSNdis_Vendordriverversion , escriba:

logman create cfg cfg_log -mgt root\wmi:select * FROM


MSNdis_Vendordriverversion

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman update cfg

Comando logman
logman create counter
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea un recopilador de datos de contador.

Sintaxis

logman create counter <[-n] <name>> [options]

Parámetros

Parámetro Descripción

-s <computer name> Ejecute el comando en el equipo remoto especificado.

-config <value> Especifica el archivo de configuración que contiene las opciones de


comando.

[-n] <name> Nombre del objeto de destino.

-f Especifica el formato de registro para el recopilador de datos. El


<bin|bincirc|csv|tsv|sql> tamaño máximo del archivo de registro se limitará a 2 GB si se
especifica csv

-[-]u <user [password]> Especifica el usuario para Ejecutar como. Si se escribe un * como
contraseña, se genera un mensaje para la contraseña. La contraseña
no se muestra cuando se escribe en la solicitud de contraseña.

-m <[start] [stop] Cambia a un inicio o parada manual en lugar de una hora de inicio
[[start] [stop] [...]]> o finalización programadas.

-rf <[[hh:]mm:]ss> Ejecuta el recopilador de datos durante el período de tiempo


especificado.

-b <M/d/yyyy Comienza a recopilar datos en el momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Finaliza la recopilación de datos en el momento especificado.


h:mm:ss[AM|PM]>
Parámetro Descripción

-si <[[hh:]mm:]ss> Especifica el intervalo de ejemplo para los recopiladores de datos


del contador de rendimiento.

-o <path|dsn!log> Especifica el archivo de registro de salida o el nombre del conjunto


de registros y DSN en una base de datos SQL.

-[-]r Repite el recopilador de datos diariamente en las horas de inicio y


finalización especificadas.

-[-]a Anexa un archivo de registro existente.

-[-]ow Sobrescribe un archivo de registro existente.

-[-]v <nnnnnn|mmddhhmm> Adjunta información de control de versiones de archivos al final del


nombre del archivo de registro.

-[-]rc <task> Ejecuta el comando especificado cada vez que se cierra el registro.

-[-]max <value> Tamaño máximo del archivo de registro en MB o número máximo


de registros para los registros de SQL.

-[-]cnf <[[hh:]mm:]ss> Cuando se especifica la hora, cree un nuevo archivo cuando haya
transcurrido el tiempo especificado. Cuando no se especifica la
hora, cree un nuevo archivo cuando se supere el tamaño máximo.

-y Responde sí a todas las preguntas sin preguntar.

-cf <filename> Especifica los contadores de rendimiento de la lista de archivos que


se van a recopilar. El archivo debe incluir un nombre de contador de
rendimiento por línea.

-c <path [path [ ]]> Especifica el contador o los contadores de rendimiento que se van a
recopilar.

-sc <value> Especifica el número máximo de muestras que se van a recopilar


con un recopilador de datos de contador de rendimiento.

/? Muestra ayuda contextual.

Comentarios
Cuando [-] aparece en la lista, al agregar un guion adicional (-) se niega la opción.

Ejemplos
Para crear un contador denominado perf_log mediante el contador del porcentaje de
tiempo de procesador de la categoría de contador Procesador(_Total), escriba:
logman create counter perf_log -c \Processor(_Total)\% Processor time

Para crear un contador denominado perf_log mediante el contador de porcentaje de


tiempo de procesador de la categoría de contador Processor(_Total), que cree un
archivo de registro con un tamaño máximo de 10 MB y recopile datos durante 1 minuto
y 0 segundos, escriba:

logman create counter perf_log -c \Processor(_Total)\% Processor time -max


10 -rf 01:00

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman update counter

Comando logman
logman create trace
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cree un recopilador de datos de seguimiento de eventos.

Sintaxis

logman create trace <[-n] <name>> [options]

Parámetros

Parámetro Descripción

-s <computer name> Ejecuta el comando en el equipo remoto


especificado.

-config <value> Especifica el archivo de configuración que


contiene las opciones de comando.

-ets Envía comandos a sesiones de seguimiento de


eventos directamente sin guardar o programar.

[-n] <name> Nombre del objeto de destino.

-f <bin|bincirc> Especifica el formato de registro para el


recopilador de datos.

-[-]u <user [password]> Especifica el usuario para Ejecutar como. Si se


escribe un * como contraseña, se genera un
mensaje para la contraseña. La contraseña no se
muestra cuando se escribe en la solicitud de
contraseña.

-m <[start] [stop] [[start] [stop] [...]]> Cambia a un inicio o parada manual en lugar de
una hora de inicio o finalización programadas.

-rf <[[hh:]mm:]ss> Ejecuta el recopilador de datos durante el período


de tiempo especificado.
Parámetro Descripción

-b <M/d/yyyy h:mm:ss[AM|PM]> Comienza a recopilar datos en el momento


especificado.

-e <M/d/yyyy h:mm:ss[AM|PM]> Finaliza la recopilación de datos en el momento


especificado.

-o <path|dsn!log> Especifica el archivo de registro de salida o el


nombre del conjunto de registros y DSN en una
base de datos SQL.

-[-]r Repite el recopilador de datos diariamente en las


horas de inicio y finalización especificadas.

-[-]a Anexa un archivo de registro existente.

-[-]ow Sobrescribe un archivo de registro existente.

-[-]v <nnnnnn|mmddhhmm> Adjunta información de control de versiones de


archivos al final del nombre del archivo de
registro.

-[-]rc <task> Ejecuta el comando especificado cada vez que se


cierra el registro.

-[-]max <value> Tamaño máximo del archivo de registro en MB o


número máximo de registros para los registros de
SQL.

-[-]cnf <[[hh:]mm:]ss> Cuando se especifica la hora, crea un nuevo


archivo cuando ha transcurrido el tiempo
especificado. Cuando no se especifica la hora,
crea un nuevo archivo cuando se supera el
tamaño máximo.

-y Responde sí a todas las preguntas sin preguntar.

-ct <perf|system|cycle> Especifica el tipo de reloj de sesión de


seguimiento de eventos.

-ln <logger_name> Especifica el nombre del registrador para sesiones


de seguimiento de eventos.

-ft <[[hh:]mm:]ss> Especifica el temporizador de vaciado para


sesiones de seguimiento de eventos.

-[-]p <provider [flags [level]]> Especifica un único proveedor de seguimiento de


eventos que se va a habilitar.
Parámetro Descripción

-pf <filename> Especifica un archivo que enumera varios


proveedores de seguimiento de eventos que se
van a habilitar. El archivo debe ser un archivo de
texto que contenga un proveedor por línea.

-[-]rt Ejecuta la sesión de seguimiento de eventos en


modo de tiempo real.

-[-]ul Ejecuta la sesión de seguimiento de eventos en el


usuario.

-bs <value> Especifica el tamaño de búfer de la sesión de


seguimiento de eventos en kb.

-nb <min max> Especifica el número de búferes de sesión de


seguimiento de eventos.

-mode Especifica el modo de registrador de sesión de


<globalsequence|localsequence|pagedmemory> seguimiento de eventos, entre los que se
incluyen:
Globalsequence: especifica que el
seguimiento de eventos agrega un número
de secuencia a cada evento que recibe
independientemente de la sesión de
seguimiento que recibió el evento.
Localsequence: especifica que el
seguimiento de eventos agrega números
de secuencia para los eventos recibidos en
una sesión de seguimiento específica.
Cuando se usa esta opción, los números de
secuencia duplicados pueden existir en
todas las sesiones, pero serán únicos dentro
de cada sesión de seguimiento.
Pagedmemory: especifica que el
seguimiento de eventos usa una memoria
paginada en lugar del grupo de memoria
no paginada predeterminado para sus
asignaciones de búfer internas.

/? Muestra ayuda contextual.

Comentarios
Cuando [-] aparece en la lista, al agregar un guion adicional (-) se niega la opción.
Ejemplos
Para crear un recopilador de datos de seguimiento de eventos denominado trace_log,
usando no menos de 16 y no más de 256 búferes, con cada búfer con un tamaño de 64
kb, colocando los resultados en c:\logfile, escriba:

logman create trace trace_log -nb 16 256 -bs 64 -o c:\logfile

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman update trace

Comando logman
logman delete
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Elimina un recopilador de datos existente.

Sintaxis

logman delete <[-n] <name>> [options]

Parámetros

Parámetro Descripción

-s Ejecuta el comando en el equipo remoto especificado.


<computer
name>

-config Especifica el archivo de configuración que contiene las opciones de comando.


<value>

[-n] <name> Nombre del objeto de destino.

-ets Envía comandos a sesiones de seguimiento de eventos directamente sin guardar o


programar.

-[-]u <user Especifica el usuario para Ejecutar como. Si se escribe un * como contraseña, se
[password]> genera un mensaje para la contraseña. La contraseña no se muestra cuando se
escribe en la solicitud de contraseña.

/? Muestra ayuda contextual.

Ejemplos
Para eliminar el perf_log del recopilador de datos, escriba:
logman delete perf_log

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman
logman import y logman export
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Importa un conjunto de recopiladores de datos desde un archivo XML o lo exporta a un


archivo XML.

Sintaxis

logman import <[-n] <name> <-xml <name> [options]


logman export <[-n] <name> <-xml <name> [options]

Parámetros

Parámetro Descripción

-s Ejecute el comando en el equipo remoto especificado.


<computer
name>

-config Especifica el archivo de configuración que contiene las opciones de comando.


<value>

[-n] <name> Nombre del objeto de destino.

-xml <name> Nombre del archivo XML que se va a importar o exportar.

-ets Envía comandos a sesiones de seguimiento de eventos directamente sin guardar o


programar.

-[-]u <user Especifica el usuario para Ejecutar como. Si se escribe un * como contraseña, se
[password]> genera un mensaje para la contraseña. La contraseña no se muestra cuando se
escribe en la solicitud de contraseña.

-y Responde sí a todas las preguntas sin preguntar.

/? Muestra ayuda contextual.

Ejemplos
Para importar el archivo XML c:\windows\perf_log.xml desde el equipo server_1 como un
conjunto de recopiladores de datos denominado perf_log, escriba:

logman import perf_log -s server_1 -xml c:\windows\perf_log.xml

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman
logman query
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Consulta las propiedades del recopilador de datos o del conjunto de recopiladores de


datos.

Sintaxis

logman query [providers|Data Collector Set name] [options]

Parámetros

Parámetro Descripción

-s <computer Ejecute el comando en el equipo remoto especificado.


name>

-config <value> Especifica el archivo de configuración que contiene las opciones de comando.

[-n] <name> Nombre del objeto de destino.

-ets Envía comandos a sesiones de seguimiento de eventos directamente sin


guardar o programar.

/? Muestra ayuda contextual.

Ejemplos
Para enumerar todos los conjuntos de recopiladores de datos configurados en el
sistema de destino, escriba:

logman query
Para enumerar los recopiladores de datos incluidos en el conjunto de recopiladores de
datos denominado perf_log, escriba:

logman query perf_log

Para enumerar todos los proveedores disponibles de recopiladores de datos en el


sistema de destino, escriba:

logman query providers

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman
logman start y logman stop
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

El comando logman start inicia un recopilador de datos y establece la hora de inicio en


manual. El comando logman stop detiene un conjunto de recopiladores de datos y
establece la hora de finalización en manual.

Sintaxis

logman start <[-n] <name>> [options]


logman stop <[-n] <name>> [options]

Parámetros

Parámetro Descripción

-s <computer Ejecute el comando en el equipo remoto especificado.


name>

-config <value> Especifica el archivo de configuración que contiene las opciones de comando.

[-n] <name> Especifica el nombre del objeto de destino.

-ets Envía comandos a sesiones de seguimiento de eventos directamente, sin


guardar ni programar.

-as Realiza la operación solicitada de forma asincrónica.

-? Muestra ayuda contextual.

Ejemplos
Para iniciar el perf_log del recopilador de datos, en el equipo remoto server_1, escriba:

logman start perf_log -s server_1


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman
logman update
Artículo • 12/04/2023

Actualiza un recopilador de datos existente.

Sintaxis

logman update <counter | trace | alert | cfg | api> <[-n] <name>> [options]

Parámetros

Parámetro Descripción

logman update counter Actualiza un recopilador de datos del contador.

logman update alert Actualiza un recopilador de datos de alertas.

logman update cfg Actualiza un recopilador de datos de configuración.

logman update api Actualiza un recopilador de datos de seguimiento de API.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman
logman update alert
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Actualiza las propiedades de un recopilador de datos de alertas existente.

Sintaxis

logman update alert <[-n] <name>> [options]

Parámetros

Parámetro Descripción

-s <computer name> Ejecute el comando en el equipo remoto especificado.

-config <value> Especifica el archivo de configuración que contiene las opciones de


comando.

[-n] <name> Nombre del objeto de destino.

-[-]u <user Especifica el usuario para Ejecutar como. Si se escribe un * como


[password]> contraseña, se genera un mensaje para la contraseña. La contraseña no se
muestra cuando se escribe en la solicitud de contraseña.

-m <[start] Cambia a un inicio o parada manual en lugar de una hora de inicio o


[stop] [[start] finalización programadas.
[stop] [...]]>

-rf <[[hh:]mm:]ss> Ejecuta el recopilador de datos durante el período de tiempo especificado.

-b <M/d/yyyy Comienza a recopilar datos en el momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Finaliza la recopilación de datos en el momento especificado.


h:mm:ss[AM|PM]>

-si <[[hh:]mm:]ss> Especifica el intervalo de ejemplo para los recopiladores de datos del
contador de rendimiento.
Parámetro Descripción

-o <path|dsn!log> Especifica el archivo de registro de salida o el nombre del conjunto de


registros y DSN en una base de datos SQL.

-[-]r Repite el recopilador de datos diariamente en las horas de inicio y


finalización especificadas.

-[-]a Anexa un archivo de registro existente.

-[-]ow Sobrescribe un archivo de registro existente.

-[-]v Adjunta información de control de versiones de archivos al final del nombre


<nnnnnn|mmddhhmm> del archivo de registro.

-[-]rc <task> Ejecuta el comando especificado cada vez que se cierra el registro.

-[-]max <value> Tamaño máximo del archivo de registro en MB o número máximo de


registros para los registros de SQL.

-[-]cnf Cuando se especifica la hora, crea un nuevo archivo cuando ha transcurrido


<[[hh:]mm:]ss> el tiempo especificado. Cuando no se especifica la hora, crea un nuevo
archivo cuando se supera el tamaño máximo.

-y Responde sí a todas las preguntas sin preguntar.

-cf <filename> Especifica los contadores de rendimiento de la lista de archivos que se van a
recopilar. El archivo debe incluir un nombre de contador de rendimiento por
línea.

-[-]el Habilita o deshabilita los informes del registro de eventos.

-th <threshold Especifica los contadores y sus valores de umbral para una alerta.
[threshold
[...]]>

-[-]rdcs <name> Especifica el conjunto de recopiladores de datos que se iniciará cuando se


active una alerta.

-[-]tn <task> Especifica la tarea que se ejecutará cuando se active una alerta.

-[-]targ Especifica los argumentos de tarea que se van a usar con la tarea
<argument> especificada mediante -tn.

/? Muestra ayuda contextual.

Comentarios
Cuando [-] aparece en la lista, al agregar un guion adicional (-) se niega la opción.
Ejemplos
Para actualizar la alerta existente denominada new_alert estableciendo el valor de
umbral para el contador de porcentaje del tiempo de procesador en el grupo de
contadores Processor(_Total) en 40 %, escriba:

logman update alert new_alert -th \Processor(_Total)\% Processor time>40

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman create alert

Comando logman
logman update api
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Actualiza las propiedades de un recopilador de datos de seguimiento de API existente.

Sintaxis

logman update api <[-n] <name>> [options]

Parámetros

Parámetro Descripción

-s <computer name> Ejecuta el comando en el equipo remoto especificado.

-config <value> Especifica el archivo de configuración que contiene las opciones de


comando.

[-n] <name> Nombre del objeto de destino.

-f <bin|bincirc> Especifica el formato de registro para el recopilador de datos.

-[-]u <user Especifica el usuario para Ejecutar como. Si se escribe un * como


[password]> contraseña, se genera un mensaje para la contraseña. La contraseña no se
muestra cuando se escribe en la solicitud de contraseña.

-m <[start] Cambia a un inicio o parada manual en lugar de una hora de inicio o


[stop] [[start] finalización programadas.
[stop] [...]]>

-rf <[[hh:]mm:]ss> Ejecuta el recopilador de datos durante el período de tiempo especificado.

-b <M/d/yyyy Comienza a recopilar datos en el momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Finaliza la recopilación de datos en el momento especificado.


h:mm:ss[AM|PM]>
Parámetro Descripción

-si <[[hh:]mm:]ss> Especifica el intervalo de ejemplo para los recopiladores de datos del
contador de rendimiento.

-o <path|dsn!log> Especifica el archivo de registro de salida o el nombre del conjunto de


registros y DSN en una base de datos SQL.

-[-]r Repite el recopilador de datos diariamente en las horas de inicio y


finalización especificadas.

-[-]a Anexa un archivo de registro existente.

-[-]ow Sobrescribe un archivo de registro existente.

-[-]v Adjunta información de control de versiones de archivos al final del nombre


<nnnnnn|mmddhhmm> del archivo de registro.

-[-]rc <task> Ejecuta el comando especificado cada vez que se cierra el registro.

-[-]max <value> Tamaño máximo del archivo de registro en MB o número máximo de


registros para los registros de SQL.

-[-]cnf Si se especifica la hora, crea un nuevo archivo cuando ha transcurrido el


<[[hh:]mm:]ss> tiempo especificado. Si no se especifica la hora, crea un nuevo archivo
cuando se supera el tamaño máximo.

-y Responder sí a todas las preguntas sin preguntar.

-mods <path Especifica la lista de módulos desde los que se van a registrar las llamadas
[path [...]]> API.

-inapis Especifica la lista de llamadas API que se van a incluir en el registro.


<module!api
[module!api
[...]]>

-exapis Especifica la lista de llamadas API que se van a excluir del registro.
<module!api
[module!api
[...]]>

-[-]ano Registra (-ano) solo nombres de API o no registra (-ano) solo nombres de
API.

-[-]recursive Registra (-recursive) o no registra (-recursive) de forma recursiva más allá de


la primera capa.

-exe <value> Especifica la ruta de acceso completa a un archivo ejecutable para el


seguimiento de API.
Parámetro Descripción

/? Muestra ayuda contextual.

Comentarios
Cuando [-] aparece en la lista, al agregar un guion adicional (-), se niega la opción.

Ejemplos
Para actualizar un contador de seguimiento de API existente denominado trace_notepad,
para el archivo ejecutable c:\windows\notepad.exe, y excluir la llamada API TlsGetValue
generada por el módulo kernel32.dll, escriba:

logman update api trace_notepad -exe c:\windows\notepad.exe -exapis


kernel32.dll!TlsGetValue

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman create api

Comando logman
logman update cfg
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Actualiza las propiedades de un recopilador de datos de configuración existente.

Sintaxis

logman update cfg <[-n] <name>> [options]

Parámetros

Parámetro Descripción

-s <computer name> Ejecuta el comando en el equipo remoto especificado.

-config <value> Especifica el archivo de configuración que contiene las opciones de


comando.

[-n] <name> Nombre del objeto de destino.

-[-]u <user Especifica el usuario para Ejecutar como. Si se escribe un * como contraseña,
[password]> se genera un mensaje para la contraseña. La contraseña no se muestra
cuando se escribe en la solicitud de contraseña.

-m <[start] Cambia a un inicio o parada manual en lugar de una hora de inicio o


[stop] [[start] finalización programadas.
[stop] [...]]>

-rf <[[hh:]mm:]ss> Ejecuta el recopilador de datos durante el período de tiempo especificado.

-b <M/d/yyyy Comienza a recopilar datos en el momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Finaliza la recopilación de datos en el momento especificado.


h:mm:ss[AM|PM]>

-si <[[hh:]mm:]ss> Especifica el intervalo de ejemplo para los recopiladores de datos del
contador de rendimiento.
Parámetro Descripción

-o <path|dsn!log> Especifica el archivo de registro de salida o el nombre del conjunto de


registros y DSN en una base de datos SQL.

-[-]r Repite el recopilador de datos diariamente en las horas de inicio y


finalización especificadas.

-[-]a Anexa un archivo de registro existente.

-[-]ow Sobrescribe un archivo de registro existente.

-[-]v Adjunta información de control de versiones de archivos al final del nombre


<nnnnnn|mmddhhmm> del archivo de registro.

-[-]rc <task> Ejecuta el comando especificado cada vez que se cierra el registro.

-[-]max <value> Tamaño máximo del archivo de registro en MB o número máximo de


registros para los registros de SQL.

-[-]cnf Si se especifica la hora, crea un nuevo archivo cuando ha transcurrido el


<[[hh:]mm:]ss> tiempo especificado. Si no se especifica la hora, crea un nuevo archivo
cuando se supera el tamaño máximo.

-y Responde sí a todas las preguntas sin preguntar.

-[-]ni Habilita (-ni) o deshabilita (-ni) la consulta de interfaz de red.

-reg <path [path Especifica los valores del Registro que se van a recopilar.
[...]]>

-mgt <query Especifica los objetos WMI que se van a recopilar mediante el lenguaje de
[query [...]]> consulta SQL.

-ftc <path [path Especifica la ruta de acceso completa a los archivos que se van a recopilar.
[...]]>

/? Muestra ayuda contextual.

Comentarios
Cuando [-] aparece en la lista, al agregar un guion adicional (-), se niega la opción.

Ejemplos
Para actualizar un recopilador de datos de configuración denominado cfg_log, para
recopilar la clave del Registro HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
NT\Currentverion\ , escriba:
logman update cfg cfg_log -reg HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
NT\Currentverion\

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman create cfg

Comando logman
logman update counter
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Actualiza las propiedades de un recopilador de datos de contador existente.

Sintaxis

logman update counter <[-n] <name>> [options]

Parámetros

Parámetro Descripción

-s <computer name> Ejecute el comando en el equipo remoto especificado.

-config <value> Especifica el archivo de configuración que contiene las opciones de


comando.

[-n] <name> Nombre del objeto de destino.

-f <bin|bincirc> Especifica el formato de registro para el recopilador de datos.

-[-]u <user Especifica el usuario para Ejecutar como. Si se escribe un * como


[password]> contraseña, se genera un mensaje para la contraseña. La contraseña no se
muestra cuando se escribe en la solicitud de contraseña.

-m <[start] Cambia a un inicio o parada manual en lugar de una hora de inicio o


[stop] [[start] finalización programadas.
[stop] [...]]>

-rf <[[hh:]mm:]ss> Ejecuta el recopilador de datos durante el período de tiempo especificado.

-b <M/d/yyyy Comienza a recopilar datos en el momento especificado.


h:mm:ss[AM|PM]>

-e <M/d/yyyy Finaliza la recopilación de datos en el momento especificado.


h:mm:ss[AM|PM]>
Parámetro Descripción

-si <[[hh:]mm:]ss> Especifica el intervalo de ejemplo para los recopiladores de datos del
contador de rendimiento.

-o <path|dsn!log> Especifica el archivo de registro de salida o el nombre del conjunto de


registros y DSN en una base de datos SQL.

-[-]r Repite el recopilador de datos diariamente en las horas de inicio y


finalización especificadas.

-[-]a Anexa un archivo de registro existente.

-[-]ow Sobrescribe un archivo de registro existente.

-[-]v Adjunta información de control de versiones de archivos al final del nombre


<nnnnnn|mmddhhmm> del archivo de registro.

-[-]rc <task> Ejecuta el comando especificado cada vez que se cierra el registro.

-[-]max <value> Tamaño máximo del archivo de registro en MB o número máximo de


registros para los registros de SQL.

-[-]cnf Cuando se especifica la hora, cree un nuevo archivo cuando haya


<[[hh:]mm:]ss> transcurrido el tiempo especificado. Cuando no se especifica la hora, cree un
nuevo archivo cuando se supere el tamaño máximo.

-y Responde sí a todas las preguntas sin preguntar.

-cf <filename> Especifica los contadores de rendimiento de la lista de archivos que se van a
recopilar. El archivo debe incluir un nombre de contador de rendimiento por
línea.

-c <path [path [ Especifica el contador o los contadores de rendimiento que se van a


]]> recopilar.

-sc <value> Especifica el número máximo de muestras que se van a recopilar con un
recopilador de datos de contador de rendimiento.

/? Muestra ayuda contextual.

Comentarios
Cuando [-] aparece en la lista, al agregar un guion adicional (-) se niega la opción.

Ejemplos
Para crear un contador denominado perf_log mediante el contador del porcentaje de
tiempo de procesador de la categoría de contador Procesador(_Total), escriba:
logman create counter perf_log -c \Processor(_Total)\% Processor time

Para actualizar un contador existente denominado perf_log, cambiar el intervalo de


ejemplo a 10, el formato de registro a CSV y agregar el control de versiones al nombre
del archivo de registro con el formato mmddhhmm, escriba:

logman update counter perf_log -si 10 -f csv -v mmddhhmm

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman create counter

Comando logman
logman update trace
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Actualiza las propiedades de un recopilador de datos de seguimiento de eventos


existente.

Sintaxis

logman update trace <[-n] <name>> [options]

Parámetros

Parámetro Descripción

-s <computer name> Ejecuta el comando en el equipo remoto


especificado.

-config <value> Especifica el archivo de configuración que


contiene las opciones de comando.

-ets Envía comandos a sesiones de seguimiento de


eventos directamente sin guardar o programar.

[-n] <name> Nombre del objeto de destino.

-f <bin|bincirc> Especifica el formato de registro para el


recopilador de datos.

-[-]u <user [password]> Especifica el usuario para Ejecutar como. Si se


escribe un * como contraseña, se genera un
mensaje para la contraseña. La contraseña no se
muestra cuando se escribe en la solicitud de
contraseña.

-m <[start] [stop] [[start] [stop] [...]]> Cambia a un inicio o parada manual en lugar de
una hora de inicio o finalización programadas.

-rf <[[hh:]mm:]ss> Ejecuta el recopilador de datos durante el período


de tiempo especificado.
Parámetro Descripción

-b <M/d/yyyy h:mm:ss[AM|PM]> Comienza a recopilar datos en el momento


especificado.

-e <M/d/yyyy h:mm:ss[AM|PM]> Finaliza la recopilación de datos en el momento


especificado.

-o <path|dsn!log> Especifica el archivo de registro de salida o el


nombre del conjunto de registros y DSN en una
base de datos SQL.

-[-]r Repite el recopilador de datos diariamente en las


horas de inicio y finalización especificadas.

-[-]a Anexa un archivo de registro existente.

-[-]ow Sobrescribe un archivo de registro existente.

-[-]v <nnnnnn|mmddhhmm> Adjunta información de control de versiones de


archivos al final del nombre del archivo de
registro.

-[-]rc <task> Ejecuta el comando especificado cada vez que se


cierra el registro.

-[-]max <value> Tamaño máximo del archivo de registro en MB o


número máximo de registros para los registros de
SQL.

-[-]cnf <[[hh:]mm:]ss> Cuando se especifica la hora, crea un nuevo


archivo cuando ha transcurrido el tiempo
especificado. Cuando no se especifica la hora,
crea un nuevo archivo cuando se supera el
tamaño máximo.

-y Responde sí a todas las preguntas sin preguntar.

-ct <perf|system|cycle> Especifica el tipo de reloj de sesión de


seguimiento de eventos.

-ln <logger_name> Especifica el nombre del registrador para sesiones


de seguimiento de eventos.

-ft <[[hh:]mm:]ss> Especifica el temporizador de vaciado para


sesiones de seguimiento de eventos.

-[-]p <provider [flags [level]]> Especifica un único proveedor de seguimiento de


eventos que se va a habilitar.
Parámetro Descripción

-pf <filename> Especifica un archivo que enumera varios


proveedores de seguimiento de eventos que se
van a habilitar. El archivo debe ser un archivo de
texto que contenga un proveedor por línea.

-[-]rt Ejecuta la sesión de seguimiento de eventos en


modo de tiempo real.

-[-]ul Ejecuta la sesión de seguimiento de eventos en el


usuario.

-bs <value> Especifica el tamaño de búfer de la sesión de


seguimiento de eventos en kb.

-nb <min max> Especifica el número de búferes de sesión de


seguimiento de eventos.

-mode Especifica el modo de registrador de sesión de


<globalsequence|localsequence|pagedmemory> seguimiento de eventos, entre los que se
incluyen:
Globalsequence: especifica que el
seguimiento de eventos agrega un número
de secuencia a cada evento que recibe
independientemente de la sesión de
seguimiento que recibió el evento.
Localsequence: especifica que el
seguimiento de eventos agrega números
de secuencia para los eventos recibidos en
una sesión de seguimiento específica.
Cuando se usa esta opción, los números de
secuencia duplicados pueden existir en
todas las sesiones, pero serán únicos dentro
de cada sesión de seguimiento.
Pagedmemory: especifica que el
seguimiento de eventos usa una memoria
paginada en lugar del grupo de memoria
no paginada predeterminado para sus
asignaciones de búfer internas.

/? Muestra ayuda contextual.

Comentarios
Cuando [-] aparece en la lista, al agregar un guion adicional (-) se niega la opción.
Ejemplos
Para actualizar un recopilador de datos de seguimiento de eventos existente
denominado trace_log, cambiando el tamaño máximo del registro a 10 MB, actualizando
el formato de archivo de registro a CSV y anexando versiones de archivo con el formato
mmddhhmm, escriba:

logman update trace trace_log -max 10 -f csv -v mmddhhmm

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando logman create trace

Comando logman
cerrar sesión
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cierra la sesión de un usuario de una sesión en un servidor host de sesión de Escritorio


remoto y elimina la sesión.

Sintaxis

logoff [<sessionname> | <sessionID>] [/server:<servername>] [/v]

Parámetros

Parámetro Descripción

<sessionname> Especifica el nombre de la sesión. Debe ser una sesión activa.

<sessionID> Especifica el id. numérico que identifica la sesión en el servidor.

/server: <servername> Especifica el servidor host de sesión de Escritorio remoto que contiene la
sesión del usuario a quien desea cerrársela. Si no se especifica, se usa el
servidor en el que usted está activo actualmente.

/v Muestra información sobre las acciones que se realizan.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Siempre puede cerrar sesión desde la sesión que tiene iniciada actualmente. Sin
embargo, debe tener permiso Control total para cerrar la sesión de los usuarios de
otras sesiones.

El cierre de la sesión de usuario sin avisar puede provocar la pérdida de los datos
de la sesión de dicho usuario. Debe enviar un mensaje al usuario mediante el
comando msg para advertirle antes de realizar esta acción.
Si <sessionID> o <sessionname> no se especifica, logoff cierra la sesión actual del
usuario.

Después de cerrar la sesión de un usuario, finalizan todos los procesos y la sesión


se elimina del servidor.

No se puede cerrar la sesión de un usuario desde la sesión de consola.

Ejemplos
Para cerrar la sesión actual de un usuario, escriba:

logoff

Para cerrar la sesión de un usuario mediante el id. de la sesión, por ejemplo, la sesión 12,
escriba:

logoff 12

Para cerrar la sesión de un usuario mediante el nombre de la sesión y el servidor, por


ejemplo sesión TERM04 en Server1, escriba:

logoff TERM04 /server:Server1

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


lpq
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra el estado de una cola de impresión en un equipo que ejecuta Line printer
Daemon (LPD).

Sintaxis

lpq -S <servername> -P <printername> [-l]

Parámetros

Parámetro Descripción

-S Especifica (por nombre o dirección IP) el equipo o dispositivo de uso compartido


<servername> de impresoras que hospeda la cola de impresión LPD con un estado que desea
mostrar. Este parámetro es necesario y debe incluirse en mayúsculas.

-P Especifica (por nombre) la impresora de la cola de impresión con un estado que


<Printername> desea mostrar. Este parámetro es necesario y debe incluirse en mayúsculas.

-l Especifica que desea mostrar detalles sobre el estado de la cola de impresión.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para mostrar el estado de la cola de impresora Laserprinter1 en un host LPD en
10.0.0.45, escriba:

lpq -S 10.0.0.45 -P Laserprinter1

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos de impresión


lpr
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Envía un archivo a un equipo o dispositivo de uso compartido de impresoras que


ejecute el servicio Line printer Daemon (LPD) como preparación para la impresión.

Sintaxis

lpr [-S <servername>] -P <printername> [-C <bannercontent>] [-J <jobname>]


[-o | -o l] [-x] [-d] <filename>

Parámetros

Parámetro Descripción

-S <servername> Especifica (por nombre o dirección IP) el equipo o dispositivo de uso


compartido de impresoras que hospeda la cola de impresión LPD con un
estado que desea mostrar. Este parámetro es necesario y debe incluirse en
mayúsculas.

-P Especifica (por nombre) la impresora de la cola de impresión con un estado


<printername> que desea mostrar. Para buscar el nombre de la impresora, abra la carpeta
Impresoras. Este parámetro es necesario y debe incluirse en mayúsculas.

-C Especifica el contenido que se va a imprimir en la página de banner del trabajo


<bannercontent> de impresión. Si no incluye este parámetro, el nombre del equipo desde el que
se envió el trabajo de impresión aparece en la página de banner. Este
parámetro debe escribirse en mayúsculas.

-J <jobname> Especifica el nombre del trabajo de impresión que se imprimirá en la página


de banner. Si no incluye este parámetro, el nombre del archivo que se va a
imprimir aparece en la página de banner. Este parámetro debe escribirse en
mayúsculas.

[-o | -o l] Especifica el tipo de archivo que desea imprimir. El parámetro -o especifica


que desea imprimir un archivo de texto. El parámetro -o l especifica que desea
imprimir un archivo binario (por ejemplo, un archivo PostScript).
Parámetro Descripción

-d Especifica que el archivo de datos debe enviarse antes del archivo de control.
Use este parámetro si la impresora requiere que el archivo de datos se envíe
primero. Para obtener más información, vea la documentación de la impresora.

-X Especifica que el comando lpr debe ser compatible con el sistema operativo
Sun Microsystems (denominado SunOS) para las versiones hasta la 4.1.4_u1.

<filename> Especifica (por nombre) el archivo que se va a imprimir. Este parámetro es


obligatorio.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para imprimir el archivo de texto Document.txt en la cola de impresora Laserprinter1 en
un host LPD en 10.0.0.45, escriba:

lpr -S 10.0.0.45 -P Laserprinter1 -o Document.txt

Para imprimir el archivo PostScript_file.ps de Adobe PostScript en la cola de impresora


Laserprinter1 en un host LPD en 10.0.0.45, escriba:

lpr -S 10.0.0.45 -P Laserprinter1 -o l PostScript_file.ps

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos de impresión


macfile
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Administra servidores, volúmenes, directorios y archivos de File Server para Macintosh.


Puede automatizar las tareas administrativas incluyendo una serie de comandos en
archivos por lotes e iniciándolos manualmente o en momentos predeterminados.

Modificación de directorios en volúmenes


accesibles para Macintosh
Para cambiar el nombre del directorio, la ubicación, el propietario, el grupo y los
permisos de los volúmenes accesibles para Macintosh.

Sintaxis

macfile directory[/server:\\<computername>] /path:<directory> [/owner:


<ownername>] [/group:<groupname>] [/permissions:<permissions>]

Parámetros

Parámetro Descripción

/server: \\<computername> Especifica el servidor en el que se va a cambiar un directorio. Si se


omite, la operación se realiza en el equipo local.

/path: <directory> Especifica la ruta de acceso al directorio que quiere cambiar. Este
parámetro es obligatorio. Nota: El directorio debe existir, el uso de
macfile directory no creará directorios.

/owner: <ownername> Cambia el propietario del directorio. Si se omite, el nombre del


propietario no cambiará.

/group: <groupname> Especifica o cambia el grupo principal de Macintosh asociado al


directorio. Si se omite, el grupo principal permanece sin cambios.
Parámetro Descripción

/permissions: <permissions> Establece permisos en el directorio para el propietario, el grupo


principal y el mundo (todos). Debe ser un número de 11 dígitos,
donde el número 1 concede permiso y 0 revoca el permiso (por
ejemplo, 11111011000). Si se omite este parámetro, los permisos
permanecen sin cambios.

/? Muestra la ayuda en el símbolo del sistema.

Posición del dígito de permisos

La posición del dígito de permisos determina qué permiso se establece, entre los que se
incluyen:

Position Establece el permiso

Primero OwnerSeeFiles

Segundo OwnerSeeFolders

Tercero OwnerMakechanges

Cuarto GroupSeeFiles

Quinto GroupSeeFolders

Sexto GroupMakechanges

Seventh WorldSeeFiles

Eighth WorldSeeFolders

Ninth WorldMakechanges

Tenth El directorio no se puede renombrar, mover ni eliminar.

Eleventh Los cambios se aplican al directorio actual y a todos los subdirectorios.

Comentarios

Si la información que proporciona contiene espacios o caracteres especiales, use


comillas alrededor del texto (por ejemplo, " <computer name> ").

Use macfile directory para poner a disposición de los usuarios de Macintosh un


directorio existente en un volumen accesible desde Macintosh. El comando macfile
directory no crea directorios.
Use el Administrador de archivos, el símbolo del sistema o el comando macintosh
new folder para crear un directorio en un volumen accesible desde Macintosh
antes de usar el comando macfile directory.

Ejemplos
Para asignar los permisos Ver archivos, Ver carpetas y Hacer cambios al propietario,
establecer los permisos Ver carpeta para el resto de usuarios y evitar que se renombre,
mueva o elimine el directorio, escriba:

macfile directory /path:e:\statistics\may sales /permissions:11111011000

Donde el subdirectorio es May sales, ubicado en el volumen accesible por Macintosh


Statistics, en la unidad E:\ del servidor local.

Unión de bifurcaciones de recursos y datos de


un archivo Macintosh
Para especificar el servidor en el que se unirán los archivos, quién creó el archivo, el tipo
de archivo, dónde se encuentra la bifurcación de datos, dónde se encuentra la
bifurcación de recursos y dónde debería estar ubicado el archivo de salida.

Sintaxis

macfile forkize[/server:\\<computername>] [/creator:<creatorname>] [/type:


<typename>] [/datafork:<filepath>] [/resourcefork:<filepath>] /targetfile:
<filepath>

Parámetros

Parámetro Descripción

/server: \\<computername> Especifica el servidor en el que se unirán los archivos. Si se omite, la


operación se realiza en el equipo local.
Parámetro Descripción

/creator: <creatorname> Especifica el creador del archivo. El buscador de Macintosh usa la


opción de línea de comandos /creator para determinar la aplicación
que creó el archivo.

/type: <typename> Especifica el tipo de archivo. El buscador de Macintosh usa la opción


de línea de comandos /type para determinar el tipo de archivo dentro
de la aplicación que lo creó.

/datafork: <filepath> Especifica la ubicación de la bifurcación de datos que se va a unir.


Puede especificar una ruta de acceso remota.

/resourcefork: <filepath> Especifica la ubicación de la bifurcación de recursos que se va a unir.


Puede especificar una ruta de acceso remota.

/targetfile: <filepath> Especifica la ubicación del archivo que se crea al unir una bifurcación
de datos y una bifurcación de recursos, o especifica la ubicación del
archivo cuyo tipo o creador está cambiando. El archivo debe estar en
el servidor especificado. Este parámetro es obligatorio.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Si la información que proporciona contiene espacios o caracteres especiales, use


comillas alrededor del texto (por ejemplo, " <computer name> ").

Ejemplos
Para crear el archivo tree_app en el volumen accesible para Macintosh D:\Release, con la
bifurcación de recursos C:\Cross\Mac\Appcode, y para que este nuevo archivo aparezca
en los clientes de Macintosh como una aplicación (las aplicaciones Macintosh usan el
tipo APPL) con el creador (firma) establecido en MAGNOLIA, escriba:

macfile forkize /resourcefork:c:\cross\mac\appcode /type:APPL


/creator:MAGNOLIA /targetfile:D:\Release\tree_app

Para cambiar el creador del archivo a Microsoft Word 5.1}, para el archivo Word.txt del
directorio D:\Word documents\Group files, en el servidor ServerA, escriba:
macfile forkize /server:\\ServerA /creator:MSWD /type:TEXT
/targetfile:d:\Word documents\Group files\Word.txt

Cambiar el mensaje de inicio de sesión y limitar


las sesiones
Para cambiar el mensaje de inicio de sesión que aparece cuando un usuario inicia sesión
en el servidor de archivos para Macintosh y para limitar el número de usuarios que
pueden usar simultáneamente servidores de archivos e impresión para Macintosh.

Sintaxis

macfile server [/server:\\<computername>] [/maxsessions:{number |


unlimited}] [/loginmessage:<message>]

Parámetros

Parámetro Descripción

/server: \\<computername> Especifica el servidor en el que se van a cambiar los parámetros. Si se


omite, la operación se realiza en el equipo local.

/maxsessions: {number | Especifica el número máximo de usuarios que pueden usar


unlimited} simultáneamente servidores de archivos e impresión para Macintosh.
Si se omite, la configuración maxsessions del servidor permanece sin
cambios.

/loginmessage: <message> Cambia el mensaje que ven los usuarios de Macintosh al iniciar sesión
en el servidor de archivos para Macintosh. El número máximo de
caracteres para el mensaje de inicio de sesión es 199. Si se omite, el
mensaje loginmessage del servidor permanece sin cambios. Para
quitar un mensaje de inicio de sesión existente, incluya el parámetro
/loginmessage, pero deje en blanco la variable message.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Si la información que proporciona contiene espacios o caracteres especiales, use


comillas alrededor del texto (por ejemplo, " <computer name> ").
Ejemplos
Para cambiar el número de sesiones permitidas del servidor de archivos e impresión
para Macintosh en el servidor local a cinco sesiones, y agregar el mensaje de inicio de
sesión "Sign off from Server for Macintosh when you are finished" (Cerrar sesión del
servidor para Macintosh cuando haya terminado), escriba:

macfile server /maxsessions:5 /loginmessage:Sign off from Server for


Macintosh when you are finished

Agregar, cambiar o quitar volúmenes accesibles


para Macintosh
Para agregar, cambiar o quitar un volumen accesible para Macintosh.

Sintaxis

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 Descripción

{/add | /set} Necesario al agregar o cambiar un volumen accesible para Macintosh.


Agrega o cambia el volumen especificado.

/server: \\ Especifica el servidor en el que se va a agregar, cambiar o quitar un


<computername> volumen. Si se omite, la operación se realiza en el equipo local.

/name: <volumename> Necesario. Especifica el nombre del volumen que se va a agregar,


cambiar o quitar.

/path: <directory> Obligatorio y válido solo cuando se agrega un volumen. Especifica la ruta
de acceso al directorio raíz del volumen que se va a agregar.
Parámetro Descripción

/readonly: {true | Especifica si los usuarios pueden cambiar archivos en el volumen. Use
false} True para especificar que los usuarios no pueden cambiar archivos en el
volumen. Use False para especificar que los usuarios pueden cambiar
archivos en el volumen. Si se omite al agregar un volumen, se permiten
cambios en los archivos. Si se omite al cambiar un volumen, la
configuración readonly del volumen permanece sin cambios.

/guestsallowed: {true Especifica si los usuarios que inician sesión como invitados pueden usar
| false} el volumen. Use True para especificar que los invitados pueden usar el
volumen. Use False para especificar que los invitados no pueden usar el
volumen. Si se omite al agregar un volumen, los invitados pueden usar el
volumen. Si se omite al cambiar un volumen, la configuración
guestsallowed del volumen permanece sin cambios.

/password: <password> Especifica una contraseña que se necesitará para acceder al volumen. Si
se omite al agregar un volumen, no se crea ninguna contraseña. Si se
omite al cambiar un volumen, la contraseña permanece sin cambios.

/maxusers: {<number>> Especifica el número máximo de usuarios que pueden usar


| unlimited} simultáneamente los archivos en el volumen. Si se omite al agregar un
volumen, un número ilimitado de usuarios puede usar el volumen. Si se
omite al cambiar un volumen, el valor maxusers permanece sin cambios.

/remove Necesario cuando se quita un volumen accesible para Macintosh. quita el


volumen especificado.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Si la información que proporciona contiene espacios o caracteres especiales, use


comillas alrededor del texto (por ejemplo, " <computer name> ").

Ejemplos
Para crear un volumen denominado US Marketing Statistics (Estadísticas de marketing de
EE. UU.) en el servidor local, mediante el directorio Stats de la unidad E y para especificar
que los invitados no pueden tener acceso al volumen, escriba:

macfile volume /add /name:US Marketing Statistics /guestsallowed:false


/path:e:\Stats
Para cambiar el volumen creado anteriormente para que sea de solo lectura, para
requerir una contraseña y establecer el número de usuarios máximos en cinco, escriba:

macfile volume /set /name:US Marketing Statistics /readonly:true


/password:saturn /maxusers:5

Para agregar un volumen llamado Landscape Design (Diseño de paisaje), en el servidor


\Magnolia, usando el directorio trees (árboles) en la unidad E, y para especificar que los
invitados pueden acceder al volumen, escriba:

macfile volume /add /server:\\Magnolia /name:Landscape Design /path:e:\trees

Para quitar el volumen denominado Sales Reports (Informes de ventas) en el servidor


local, escriba:

macfile volume /remove /name:Sales Reports

Vínculos relacionados
Clave de sintaxis de línea de comandos
makecab
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Empaquete los archivos existentes en un archivo .cab.

7 Nota

Este comando es el mismo que el comando diantz.

Sintaxis

makecab [/v[n]] [/d var=<value> ...] [/l <dir>] <source> [<destination>]


makecab [/v[<n>]] [/d var=<value> ...] /f <directives_file> [...]

Parámetros

Parámetro Descripción

<source> Archivo que se va a comprimir.

<destination> Nombre de archivo que se va a asignar al archivo comprimido. Si se omite,


el último carácter del nombre de archivo de origen se reemplaza por un
guion bajo (_) y se usa como destino.

/f Un archivo con directivas makecab (puede repetirse).


<directives_file>

/d var= <value> Define la variable con el valor especificado.

/l <dir> Ubicación para colocar el destino (el valor predeterminado es el directorio


actual).

/v[ <n> ] Establezca el nivel de detalle de depuración (0=ninguno,...,3=total).

/? Muestra la ayuda en el símbolo del sistema.


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando diantz

Formato .cab de Microsoft


manage-bde
Artículo • 14/04/2023

Activa o desactiva BitLocker, especifica mecanismos de desbloqueo, métodos de


recuperación de actualizaciones y desbloquea unidades de datos protegidas con
BitLocker.

7 Nota

Esta herramienta de línea de comandos se puede utilizar en lugar del elemento del
panel de control Cifrado de unidad BitLocker.

Sintaxis

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 Descripción

manage-bde Proporciona información sobre todas las unidades del equipo, estén o no
status protegidas por BitLocker.

manage-bde on Cifra la unidad y activa BitLocker.

manage-bde off Descifra la unidad y desactiva BitLocker. Todos los protectores de clave se
quitan cuando se completa el descifrado.

manage-bde Pausa el cifrado o el descifrado.


pause

manage-bde Reanuda el cifrado o el descifrado.


resume

manage-bde Impide el acceso a los datos protegidos por BitLocker.


lock
Parámetro Descripción

manage-bde Permite el acceso a datos protegidos por BitLocker con una contraseña de
unlock recuperación o una clave de recuperación.

manage-bde Administra el desbloqueo automático de unidades de datos.


autounlock

manage-bde Administra métodos de protección para la clave de cifrado.


protectors

manage-bde Configura el módulo de plataforma segura (TPM) del equipo. Este comando
tpm no se admite en equipos que ejecutan Windows 8 o win8_server_2. Para
administrar el TPM en estos equipos, use el complemento MMC de
administración de TPM o los cmdlets de administración de TPM para Windows
PowerShell.

manage-bde Establece el campo identificador de unidad de la unidad en el valor


setidentifier especificado en la configuración de directiva de grupo Proporcionar los
identificadores únicos de su organización.

manage-bde Fuerza una unidad protegida con BitLocker al modo de recuperación al


ForceRecovery reiniciar. Este comando elimina todos los protectores de clave relacionados
con TPM de la unidad. Cuando se reinicia el equipo, solo se puede usar una
contraseña de recuperación o una clave de recuperación para desbloquear la
unidad.

manage-bde Modifica la contraseña de una unidad de datos.


changepassword

manage-bde Modifica el PIN de una unidad del sistema operativo.


changepin

manage-bde Modifica la clave de inicio de una unidad de sistema operativo.


changekey

manage-bde Genera un paquete de claves para una unidad.


KeyPackage

manage-bde Actualiza la versión de BitLocker.


upgrade

manage-bde Borra el espacio libre en una unidad.


WipeFreeSpace

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Habilitación de BitLocker mediante la línea de comandos


manage-bde status
Artículo • 06/04/2023

Proporciona información sobre todas las unidades del equipo, estén o no protegidas
por BitLocker, incluyendo:

Size

Versión de BitLocker

Estado de conversión

Porcentaje cifrado

Encryption method

Estado de protección

Estado de bloqueo

Campo de identificación

Protectores de clave

Sintaxis

manage-bde -status [<drive>] [-protectionaserrorlevel] [-computername


<name>] [{-?|/?}] [{-help|-h}]

Parámetros

Parámetro Descripción

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

- Hace que la herramienta de línea de comandos manage-bde envíe el


protectionaserrorlevel código de devolución 0 si el volumen está protegido y 1 si el volumen
está desprotegido; se usa más comúnmente para scripts por lotes para
determinar si una unidad está protegida por BitLocker. También puede
usar -p como una versión abreviada de este comando.
Parámetro Descripción

-computername Especifica que manage-bde.exe se usará para modificar la protección de


BitLocker en un equipo diferente. También puede usar -cn como una
versión abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la


protección de BitLocker. Los valores aceptados incluyen el nombre de
NetBIOS del equipo y la dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para mostrar el estado de la unidad C, escriba:

manage-bde –status C:

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando manage-bde
manage-bde on
Artículo • 06/04/2023

Cifra la unidad y activa BitLocker.

Sintaxis

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 Descripción

<drive> Representa la letra de una unidad seguida del signo de dos


puntos.

-recoverypassword Agrega un protector de contraseña numérico. También puede


usar -rp como una versión abreviada de este comando.

<numericalpassword> Representa la contraseña de recuperación.

-recoverykey Agrega un protector de clave externa para la recuperación.


También puede usar -rk como una versión abreviada de este
comando.

<pathtoexternaldirectory> Representa la ruta de acceso del directorio a la clave de


recuperación.

-startupkey Agrega un protector de clave externa para el inicio. También


puede usar -sk como una versión abreviada de este comando.

<pathtoexternalkeydirectory> Representa la ruta de acceso del directorio a la clave de inicio.


Parámetro Descripción

-certificate Agrega un protector de clave pública para una unidad de datos.


También puede usar -cert como una versión abreviada de este
comando.

-tpmandpin Agrega un Módulo de plataforma segura (TPM) y un protector


de número de identificación personal (PIN) para la unidad del
sistema operativo. También puede usar -tp como una versión
abreviada de este comando.

-tpmandstartupkey Agrega un protector de clave de inicio y TPM para la unidad del


sistema operativo. También puede usar -tsk como una versión
abreviada de este comando.

-tpmandpinandstartupkey Agrega un protector TPM, PIN y clave de inicio para la unidad


del sistema operativo. También puede usar -tpsk como una
versión abreviada de este comando.

-password Agrega un protector de clave de contraseña para la unidad de


datos. También puede usar -pw como una versión abreviada de
este comando.

-ADaccountorgroup Agrega un protector de identidad basado en SID para el


volumen. El volumen se desbloqueará automáticamente si el
usuario o el equipo tiene las credenciales adecuadas. Cuando
especifique una cuenta de equipo, añada un $ al nombre del
equipo y especifique -service para indicar que el desbloqueo
debe producirse en el contenido del servidor BitLocker en lugar
del usuario. También puede usar -sid como una versión
abreviada de este comando.

-usedspaceonly Establece el modo de encriptación en el cifrado de Solo espacio


usado. Las secciones del volumen que contiene espacio usado se
cifrarán, pero el espacio libre no. Si no se especifica esta opción,
se cifrará todo el espacio usado y el espacio libre del volumen.
También puede usar -used como una versión abreviada de este
comando.

-encryptionMethod Configura el algoritmo de cifrado y el tamaño de la clave.


También puede usar -em como una versión abreviada de este
comando.

-skiphardwaretest Comienza el cifrado sin una prueba de hardware. También puede


usar -s como una versión abreviada de este comando.

-discoveryvolumetype Especifica el sistema de archivos que se va a usar para la unidad


de datos de detección. La unidad de datos de detección es una
unidad oculta agregada a una unidad de datos extraíble con
formato FAT protegida por BitLocker que contiene el Lector de
BitLocker To Go.
Parámetro Descripción

-forceencryptiontype Obliga a BitLocker a usar el cifrado de software o hardware.


Puede especificar hardware o software como tipo de cifrado. Si
se selecciona el parámetro hardware, pero la unidad no admite
el cifrado de hardware, manage-bde devuelve un error. Si la
configuración de la directiva de grupo prohíbe el tipo de cifrado
especificado, manage-bde devuelve un error. También puede
usar -fet como una versión abreviada de este comando.

-removevolumeshadowcopies Forzar la eliminación de instantáneas de volumen para el


volumen. No podrá restaurar este volumen mediante puntos de
restauración del sistema anteriores después de ejecutar este
comando. También puede usar -rvsc como una versión
abreviada de este comando.

<filesystemtype> Especifica qué sistemas de archivos se pueden usar con unidades


de datos de detección: FAT32, default o none.

-computername Especifica que manage-bde.exe se usa para modificar la


protección de BitLocker en un equipo diferente. También puede
usar -cn como una versión abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la


protección de BitLocker. Los valores aceptados incluyen el
nombre de NetBIOS del equipo y la dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para activar BitLocker para la unidad C y agregar una contraseña de recuperación a la
unidad, escriba:

manage-bde –on C: -recoverypassword

Para activar BitLocker para la unidad C, agregar una contraseña de recuperación a la


unidad y guardar una clave de recuperación en la unidad E, escriba:

manage-bde –on C: -recoverykey E:\ -recoverypassword


Para activar BitLocker para la unidad C, usando un protector de clave externa (como una
llave USB) para desbloquear la unidad del sistema operativo, escriba:

manage-bde -on C: -startupkey E:\

) Importante

Este método es necesario si usa BitLocker con equipos que no tienen un TPM.

Para activar BitLocker para la unidad de datos E y agregar un protector de clave de


contraseña, escriba:

manage-bde –on E: -pw

Para activar BitLocker para la unidad del sistema operativo C y usar el cifrado basado en
hardware, escriba:

manage-bde –on C: -fet hardware

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando manage-bde off

Comando manage-bde pause

Comando manage-bde resume

Comando manage-bde
manage-bde off
Artículo • 05/10/2023

Descifra la unidad y desactiva BitLocker. Todos los protectores de clave se quitan


cuando se completa el descifrado.

Sintaxis

manage-bde -off [<volume>] [-computername <name>] [{-?|/?}] [{-help|-h}]

Parámetros

Parámetro Descripción

<volume> Especifica una letra de unidad seguida de dos puntos, una ruta de acceso al
GUID de volumen o un volumen montado.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para desactivar BitLocker en la unidad C, escriba:

manage-bde –off C:

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando manage-bde on

Comando manage-bde pause

Comando manage-bde resume

Comando manage-bde
manage-bde -pause
Artículo • 14/04/2023

Detiene el cifrado o el descifrado de BitLocker.

Sintaxis

manage-bde -pause [<volume>] [-computername <name>] [{-?|/?}] [{-help|-h}]

Parámetros

Parámetro Descripción

<volume> Especifica una letra de unidad seguida de dos puntos, una ruta de acceso al
GUID de volumen o un volumen montado.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para pausar el cifrado de BitLocker en la unidad C, escriba:

Output

manage-bde -pause C:

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando manage-bde on

Comando manage-bde off

Comando manage-bde resume

Comando manage-bde
manage-bde resume
Artículo • 14/04/2023

Reanuda el cifrado o descifrado de BitLocker tras haberlo pausado.

Sintaxis

manage-bde -resume [<drive>] [-computername <name>] [{-?|/?}] [{-help|-h}]

Parámetros

Parámetro Descripción

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para reanudar el cifrado de BitLocker en la unidad C, escriba:

manage-bde –resume C:

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando manage-bde on

Comando manage-bde off

Comando manage-bde pause

Comando manage-bde
manage-bde lock
Artículo • 12/04/2023

Bloquea una unidad protegida con BitLocker para impedir el acceso a ella a menos que
se proporcione la clave de desbloqueo.

Sintaxis

manage-bde -lock [<drive>] [-computername <name>] [{-?|/?}] [{-help|-h}]

Parámetros

Parámetro Descripción

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para bloquear la unidad de datos D, escriba:

manage-bde -lock D:

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando manage-bde
manage-bde unlock
Artículo • 14/04/2023

Desbloquea una unidad protegida con BitLocker mediante una contraseña de


recuperación o una clave de recuperación.

Sintaxis

manage-bde -unlock {-recoverypassword -password | -recoverykey


<pathtoexternalkeyfile>} <drive> [-certificate {-cf pathtocertificatefile |
-ct certificatethumbprint} {-pin}] [-password] [-computername <name>] [{-?
|/?}] [{-help|-h}]

Parámetros

Parámetro Descripción

-recoverypassword Especifica que se usará una contraseña de recuperación para


desbloquear la unidad. También puede usar -rp como una versión
abreviada de este comando. Esta es la clave de recuperación que se
guarda en un archivo de texto y debe escribirse exactamente como se
muestra, guiones incluidos.

-password Representa la contraseña de recuperación que se puede usar para


desbloquear la unidad que usted o el administrador ha establecido.

-recoverykey Especifica que se usará un archivo de clave de recuperación externo


para desbloquear la unidad. También puede usar -rk como una
versión abreviada de este comando. Este método busca el archivo de
clave de recuperación .bek que se guarda en una unidad USB.

<pathtoexternalkeyfile> Representa el archivo de clave de recuperación externo que se puede


usar para desbloquear la unidad.

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

-certificate El certificado de usuario local de un certificado de BitLocker para


desbloquear el volumen se encuentra en el almacén de certificados de
usuario local. También puede usar -cert como una versión abreviada
de este comando.

-cf Ruta de acceso al archivo de certificado.


<pathtocertificatefile>
Parámetro Descripción

-ct Huella digital del certificado que puede incluir opcionalmente el PIN
<certificatethumbprint> (-pin).

-password Presenta un mensaje para que la contraseña desbloquee el volumen.


También puede usar -pw como una versión abreviada de este
comando.

-computername Especifica que manage-bde.exe se usará para modificar la protección


de BitLocker en un equipo diferente. También puede usar -cn como
una versión abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la


protección de BitLocker. Los valores aceptados incluyen el nombre de
NetBIOS del equipo y la dirección IP de este.

-? o /? Muestra la Ayuda abreviada en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para desbloquear la unidad E con una contraseña, escriba:

Símbolo del sistema de Windows

manage-bde -unlock E: -password

Para desbloquear la unidad E con una contraseña de recuperación, escriba:

Símbolo del sistema de Windows

manage-bde -unlock E: -recoverypassword xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-


xxxxxx-xxxxxx-xxxxxx

Para desbloquear la unidad E con un archivo de clave de recuperación que se ha


guardado en una carpeta de copia de seguridad en otra unidad, escriba:

Símbolo del sistema de Windows

manage-bde -unlock E: -recoverykey F:\Backupkeys\recoverykey.bek

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando manage-bde
manage-bde autounlock
Artículo • 06/04/2023

Administra el desbloqueo automático de unidades de datos protegidas con BitLocker.

Sintaxis

manage-bde -autounlock [{-enable|-disable|-clearallkeys}] <drive> [-


computername <name>] [{-?|/?}] [{-help|-h}]

Parámetros

Parámetro Descripción

-enable Habilita el desbloqueo automático para una unidad de datos.

-disable Deshabilita el desbloqueo automático para una unidad de datos.

-clearallkeys Quita todas las claves externas almacenadas en la unidad del sistema operativo.

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para habilitar el desbloqueo automático de la unidad de datos E, escriba:

manage-bde –autounlock -enable E:


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando manage-bde
manage-bde protectors
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016

Administra los métodos de protección usados para la clave de cifrado de BitLocker.

Sintaxis

manage-bde -protectors [{-get|-add|-delete|-disable|-enable|-adbackup|-


aadbackup}] <drive> [-computername <name>] [{-?|/?}] [{-help|-h}]

Parámetros

Parámetro Descripción

-get Muestra todos los métodos de protección de claves habilitados en la unidad y


proporciona su tipo e identificador (ID).

-add Agrega métodos de protección de claves tal como se especifican mediante


parámetros -add adicionales.

-delete Elimina los métodos de protección de claves utilizados por BitLocker. Todos los
protectores de clave se quitarán de una unidad a menos que se usen los
parámetros opcionales -delete para especificar qué protectores eliminar.
Cuando se elimina el último protector de una unidad, se deshabilita la
protección de BitLocker de la unidad para asegurarse de que el acceso a los
datos no se pierde accidentalmente.

-disable Deshabilita la protección, lo que permitirá a cualquier persona acceder a los


datos cifrados haciendo que la clave de cifrado esté disponible sin proteger en
la unidad. No se quita ningún protector de clave. La protección se reanudará la
próxima vez que se inicie Windows a menos que se usen los parámetros
opcionales -disable para especificar el recuento de reinicios.

-enable Habilita la protección quitando la clave de cifrado no seguro de la unidad. Se


aplicarán todos los protectores de clave configurados en la unidad.

-adbackup Realiza una copia de seguridad de la información de recuperación de la unidad


especificada en Active Directory Domain Services (AD DS). Anexe el parámetro -
id y especifique el identificador de una clave de recuperación específica para
realizar una copia de seguridad. Se requiere el parámetro -id.
Parámetro Descripción

-aadbackup Realiza una copia de seguridad de toda la información de recuperación de la


unidad especificada en Azure Active Directory (Azure AD). Anexe el parámetro -
id y especifique el identificador de una clave de recuperación específica para
realizar una copia de seguridad. Se requiere el parámetro -id.

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Parámetros -add adicionales

El parámetro -add también puede usar estos parámetros adicionales 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 Descripción

<drive> Representa la letra de una unidad seguida del signo de dos


puntos.

-recoverypassword Agrega un protector de contraseña numérico. También puede


usar -rp como una versión abreviada de este comando.

<numericalpassword> Representa la contraseña de recuperación.

-recoverykey Agrega un protector de clave externa para la recuperación.


También puede usar -rk como una versión abreviada de este
comando.
Parámetro Descripción

<pathtoexternalkeydirectory> Representa la ruta de acceso del directorio a la clave de


recuperación.

-startupkey Agrega un protector de clave externa para el inicio. También


puede usar -sk como una versión abreviada de este comando.

<pathtoexternalkeydirectory> Representa la ruta de acceso del directorio a la clave de inicio.

-certificate Agrega un protector de clave pública para una unidad de datos.


También puede usar -cert como una versión abreviada de este
comando.

-cf Especifica que se usará un archivo de certificado para


proporcionar el certificado de clave pública.

<pathtocertificatefile> Representa la ruta de acceso del directorio al archivo de


certificado.

-ct Especifica que se usará una huella digital de certificado para


identificar el certificado de clave pública

<certificatethumbprint> Especifica el valor de la propiedad de huella digital del


certificado que desea usar. Por ejemplo, un valor de huella digital
de certificado de a9 09 50 2d d8 2a e4 14 33 e6 f8 38 86 b0 0d
42 77 a3 2a 7b debería especificarse como
a909502dd82ae41433e6f83886b00d4277a32a7b.

-tpmandpin Agrega un Módulo de plataforma segura (TPM) y un protector


de número de identificación personal (PIN) para la unidad del
sistema operativo. También puede usar -tp como una versión
abreviada de este comando.

-tpmandstartupkey Agrega un protector de clave de inicio y TPM para la unidad del


sistema operativo. También puede usar -tsk como una versión
abreviada de este comando.

-tpmandpinandstartupkey Agrega un protector TPM, PIN y clave de inicio para la unidad


del sistema operativo. También puede usar -tpsk como una
versión abreviada de este comando.

-password Agrega un protector de clave de contraseña para la unidad de


datos. También puede usar -pw como una versión abreviada de
este comando.
Parámetro Descripción

-adaccountorgroup Agrega un protector de identidad basado en identificadores de


seguridad (SID) para el volumen. También puede usar -sid como
una versión abreviada de este comando. IMPORTANTE: De
manera predeterminada, no puede agregar un protector
ADaccountorgroup de forma remota usando WMI o manage-
bde. Si la implementación requiere la capacidad de agregar este
protector de forma remota, debe habilitar la delegación
restringida.

-computername Especifica que manage-bde.exe se usa para modificar la


protección de BitLocker en un equipo diferente. También puede
usar -cn como una versión abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la


protección de BitLocker. Los valores aceptados incluyen el
nombre de NetBIOS del equipo y la dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Parámetros -delete adicionales

manage-bde -protectors -delete <drive> [-type


{recoverypassword|externalkey|certificate|tpm|tpmandstartupkey|tpmandpin|tpm
andpinandstartupkey|Password|Identity}]
[-id <keyprotectorID>] [-computername <name>] [{-?|/?}] [{-help|-h}]

Parámetro Descripción

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

-type Identifica el protector de clave que se va a eliminar. También puede


usar -t como una versión abreviada de este comando.

recoverypassword Especifica que se deben eliminar los protectores de clave de


contraseña de recuperación.

externalkey Especifica que se deben eliminar los protectores de clave externos


asociados a la unidad.

certificado Especifica que se deben eliminar los protectores de clave de


certificado asociados a la unidad.
Parámetro Descripción

tpm Especifica que se deben eliminar los protectores de clave solo TPM
asociados a la unidad.

tpmandstartupkey Especifica que se deben eliminar los protectores de clave basados en


clave de inicio y TPM asociados a la unidad.

tpmandpin Especifica que se deben eliminar los protectores de clave basados en


TPM y PIN asociados a la unidad.

tpmandpinandstartupkey Especifica que se deben eliminar los protectores de clave basados en


TPM, PIN y clave de inicio asociados a la unidad.

password Especifica que se deben eliminar los protectores de clave de


contraseña asociados a la unidad.

identity Especifica que se deben eliminar los protectores de clave de identidad


asociados a la unidad.

-ID Identifica el protector de clave que se va a eliminar mediante el


identificador de clave. Este parámetro es una opción alternativa al
parámetro -type.

<keyprotectorID> Identifica un protector de clave individual en la unidad que se va a


eliminar. Los identificadores de protector de clave se pueden mostrar
mediante el comando manage-bde -protectors -get.

-computername Especifica que manage-bde.exe se usará para modificar la protección


de BitLocker en un equipo diferente. También puede usar -cn como
una versión abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la


protección de BitLocker. Los valores aceptados incluyen el nombre de
NetBIOS del equipo y la dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Parámetros -disable adicionales

manage-bde -protectors -disable <drive> [-rebootcount <integer 0 - 15>] [-


computername <name>] [{-?|/?}] [{-help|-h}]

Parámetro Descripción
Parámetro Descripción

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

rebootcount Especifica que se ha suspendido la protección del volumen del sistema


operativo y se reanudará después de reiniciar Windows el número de veces
especificadas en el parámetro rebootcount. Especifique 0 para suspender la
protección indefinidamente. Si no se especifica este parámetro, la protección de
BitLocker se reanuda automáticamente después de reiniciar Windows. También
puede usar -rc como una versión abreviada de este comando.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para agregar un protector de clave de certificado, identificado por un archivo de
certificado, a la unidad E, escriba:

manage-bde -protectors -add E: -certificate -cf c:\File Folder\Filename.cer

Para agregar un protector de clave adaccountorgroup, identificado por dominio y


nombre de usuario, a la unidad E, escriba:

manage-bde -protectors -add E: -sid DOMAIN\user

Para deshabilitar la protección hasta que el equipo se haya reiniciado 3 veces, escriba:

manage-bde -protectors -disable C: -rc 3


Para eliminar todos los protectores de clave basados en claves de inicio y TPM en la
unidad C, escriba:

manage-bde -protectors -delete C: -type tpmandstartupkey

Para enumerar todos los protectores de clave de la unidad C, escriba:

manage-bde -protectors -get C:

Para realizar una copia de seguridad de toda la información de recuperación de la


unidad C en AD DS, escriba (donde -id es el identificador del protector de clave
específico para realizar una copia de seguridad):

manage-bde -protectors -adbackup C: -id '{00000000-0000-0000-0000-


000000000000}'

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando manage-bde
manage-bde tpm
Artículo • 29/08/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Configura el módulo de plataforma segura (TPM) del equipo.

Sintaxis

manage-bde -tpm [-turnon] [-takeownership <ownerpassword>] [-computername


<name>] [{-?|/?}] [{-help|-h}]

Parámetros

Parámetro Descripción

-turnon Habilita y activa el TPM, lo que permite establecer la contraseña del


propietario del TPM. También puede usar -t como una versión abreviada de
este comando.

-takeownership Toma posesión del TPM estableciendo una contraseña de propietario. También
puede usar -t como una versión abreviada de este comando.

<ownerpassword> Representa la contraseña de propietario que especifique para el TPM.

-computername Especifica que manage-bde.exe se usa para modificar la protección de


BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y
la dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para activar el TPM, escriba:
manage-bde -tpm -turnon

Para tomar posesión del TPM y establecer la contraseña de propietario en 0wnerP@ss,


escriba:

manage-bde -tpm -takeownership 0wnerP@ss

Vínculos relacionados
Clave de sintaxis de línea de comandos

Cmdlets de administración de TPM para Windows PowerShell

Comando manage-bde
manage-bde setidentifier
Artículo • 14/04/2023

Establece el campo identificador de unidad de la unidad en el valor especificado en la


configuración de directiva de grupo Proporcionar los identificadores únicos de su
organización.

Sintaxis

manage-bde –setidentifier <drive> [-computername <name>] [{-?|/?}] [{-help|-


h}]

Parámetros

Parámetro Descripción

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para establecer el campo de identificador de unidad BitLocker para C, escriba:

manage-bde –setidentifier C:

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando manage-bde

Guía de recuperación de BitLocker


manage-bde forcerecovery
Artículo • 14/04/2023

Fuerza una unidad protegida con BitLocker al modo de recuperación al reiniciar. Este
comando elimina todos los protectores de clave relacionados con el módulo de
plataforma segura (TPM) de la unidad. Cuando se reinicia el equipo, solo se puede usar
una contraseña de recuperación o una clave de recuperación para desbloquear la
unidad.

Sintaxis

manage-bde –forcerecovery <drive> [-computername <name>] [{-?|/?}] [{-help|-


h}]

Parámetros

Parámetro Descripción

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para que BitLocker se inicie en modo de recuperación en la unidad C, escriba:

manage-bde –forcerecovery C:
Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando manage-bde
manage-bde changepassword
Artículo • 14/04/2023

Modifica la contraseña de una unidad de datos. Al usuario se le solicitará una


contraseña.

Sintaxis

manage-bde -changepassword [<drive>] [-computername <name>] [{-?|/?}] [{-


help|-h}]

Parámetros

Parámetro Descripción

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para cambiar la contraseña usada para desbloquear BitLocker en la unidad de datos D,
escriba:

manage-bde –changepassword D:

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando manage-bde
manage-bde changepin
Artículo • 06/04/2023

Modifica el PIN de una unidad del sistema operativo. Se pide al usuario que escriba un
nuevo PIN.

Sintaxis

manage-bde -changepin [<drive>] [-computername <name>] [{-?|/?}] [{-help|-


h}]

Parámetros

Parámetro Descripción

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para cambiar el PIN usado con BitLocker en la unidad C, escriba:

manage-bde –changepin C:

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando manage-bde
manage-bde changekey
Artículo • 06/04/2023

Modifica la clave de inicio de una unidad de sistema operativo.

Sintaxis

manage-bde -changekey [<drive>] [<pathtoexternalkeydirectory>] [-


computername <name>] [{-?|/?}] [{-help|-h}]

Parámetros

Parámetro Descripción

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para crear una nueva clave de inicio en la unidad E, para usarla con el cifrado de
BitLocker en la unidad C, escriba:

manage-bde -changekey C: E:\

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando manage-bde
manage-bde keypackage
Artículo • 05/10/2023

Genera un paquete de claves para una unidad. El paquete de claves se puede usar junto
con la herramienta de reparación para reparar unidades dañadas.

Sintaxis

manage-bde -keypackage [<drive>] [-ID <keyprotectoryID>] [-path


<pathtoexternalkeydirectory>] [-computername <name>] [{-?|/?}] [{-help|-h}]

Parámetros

Parámetro Descripción

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

-ID Crea un paquete de claves mediante el protector de claves con el identificador


especificado por este valor de identificador. Sugerencia: Use el comando
manage-bde –protectors –get (junto con la letra de unidad para la que quiere
crear un paquete de claves) para obtener una lista de los GUID disponibles para
usar como valor de identificador.

-path Especifica la ubicación en la que se va a guardar el paquete de claves creado.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para crear un paquete de claves para la unidad C, basado en el protector de claves
identificado por el GUID y para guardar el paquete de claves en F:\Folder, escriba:
manage-bde -keypackage C: -id {84E151C1...7A62067A512} -path f:\Folder

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando manage-bde
manage-bde upgrade
Artículo • 14/04/2023

Actualiza la versión de BitLocker.

Sintaxis

manage-bde -upgrade [<drive>] [-computername <name>] [{-?|/?}] [{-help|-h}]

Parámetros

Parámetro Descripción

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para actualizar el cifrado de BitLocker en la unidad C, escriba:

manage-bde –upgrade C:

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando manage-bde
manage-bde wipefreespace
Artículo • 14/04/2023

Borra el espacio disponible en el volumen, quitando los fragmentos de datos que


puedan haber existido en el espacio. La ejecución de este comando en un volumen
cifrado mediante el método de cifrado Solo en espacio usado proporciona el mismo
nivel de protección que el método de Cifrado de volumen completo.

Sintaxis

manage-bde -wipefreespace|-w [<drive>] [-cancel] [-computername <name>] [{-?


|/?}] [{-help|-h}]

Parámetros

Parámetro Descripción

<drive> Representa la letra de una unidad seguida del signo de dos puntos.

-cancel Cancela un borrado del espacio libre que está en proceso.

- Especifica que manage-bde.exe se usará para modificar la protección de


computername BitLocker en un equipo diferente. También puede usar -cn como una versión
abreviada de este comando.

<name> Representa el nombre del equipo en el que se va a modificar la protección de


BitLocker. Los valores aceptados incluyen el nombre de NetBIOS del equipo y la
dirección IP del mismo.

-? o /? Muestra una breve Ayuda en el símbolo del sistema.

-help o -h Muestra la Ayuda completa en el símbolo del sistema.

Ejemplos
Para borrar el espacio libre en la unidad C, escriba:

manage-bde -w C:
manage-bde -wipefreespace C:

Para cancelar el borrado del espacio disponible en la unidad C, escriba:

manage-bde -w -cancel C:

manage-bde -wipefreespace -cancel C:

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando manage-bde
mapadmin
Artículo • 14/04/2023

La utilidad de línea de comandos mapadmin administra la asignación de nombres de


usuario en el equipo local o remoto que ejecuta los servicios de Microsoft para el
sistema de archivos de red. Si inicia sesión con una cuenta que no tenga credenciales
administrativas, puede especificar un nombre de usuario y una contraseña de una
cuenta que sí los tenga.

Sintaxis

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 Descripción

<computer> Especifica el equipo remoto que ejecuta el servicio de asignación de


nombres de usuario que desea administrar. Puede especificar el equipo
mediante un nombre del Servicio de nombres Internet de Windows (WINS),
un nombre del servicio de nombres de dominio (DNS) o una dirección del
protocolo de Internet (IP).
Parámetro Descripción

-u <user> Especifica el nombre del usuario cuyas credenciales se van a usar. Es posible
que sea necesario agregar el nombre de dominio al nombre de usuario, con
el formato dominio\nombreDeUsuario.

-p <password> Especifica la contraseña del usuario. Si se especifica la opción -u, pero se


omite la opción -p, se solicita la contraseña del usuario.

start | stop Inicia o detiene el servicio de asignación de nombres de usuario.

config Especifica la configuración general para la asignación de nombres de


usuario. Las siguientes opciones están disponibles con este parámetro:
-r <dddd>:<hh>:<mm> : especifica el intervalo de actualización para
actualizar desde las bases de datos de Windows y NIS en días, horas y
minutos. El intervalo mínimo es de 5 minutos.
-i {yes | no} : activa la asignación simple (sí) o la desactiva (no). De
forma predeterminada, la asignación está activada.

add Crea una nueva asignación para un usuario o grupo. Las siguientes
opciones están disponibles con este parámetro:
-wu <name> : especifica el nombre del usuario de Windows para el
que se va a crear una nueva asignación.
-uu <name> : especifica el nombre del usuario UNIX para el que se va a
crear una nueva asignación.
-wg <group> : especifica el nombre del grupo de Windows para el que
se va a crear una nueva asignación.
-ug <group> : especifica el nombre del grupo UNIX para el que se va a
crear una nueva asignación.
-setprimary: especifica que la nueva asignación es la asignación
principal.

setprimary Especifica qué asignación es la asignación principal para un usuario o grupo


de UNIX con varias asignaciones. Las siguientes opciones están disponibles
con este parámetro:
-wu <name> : especifica el usuario de Windows de la asignación
principal. Si existe más de una asignación para el usuario, use la
opción -uu para especificar la asignación principal.
-uu <name> : especifica el usuario UNIX de la asignación principal.
-wg <group> : especifica el grupo de Windows de la asignación
principal. Si existe más de una asignación para el grupo, use la opción
-ug para especificar la asignación principal.
-ug <group> : especifica el grupo UNIX de la asignación principal.
Parámetro Descripción

delete Quita la asignación de un usuario o grupo. Las siguientes opciones están


disponibles para este parámetro:
-wu <user> : especifica el usuario de Windows para el que se
eliminará la asignación, especificada como <windowsdomain>\
<username> .

Debe especificar la opción -wu o -uu, o ambas. Si especifica ambas


opciones, se eliminará la asignación concreta identificada por las dos
opciones. Si especifica solo la opción -wu, se eliminarán todas las
asignaciones del usuario especificado.
-uu <user> : especifica el usuario UNIX para el que se eliminará la
asignación, especificada como <username> .

Debe especificar la opción -wu o -uu, o ambas. Si especifica ambas


opciones, se eliminará la asignación concreta identificada por las dos
opciones. Si especifica solo la opción -uu, se eliminarán todas las
asignaciones del usuario especificado.
-wg <group> : especifica el grupo de Windows para el que se
eliminará la asignación, especificada como <windowsdomain>\
<username> .

Debe especificar la opción -wg o -ug , o ambas. Si especifica ambas


opciones, se eliminará la asignación concreta identificada por las dos
opciones. Si especifica solo la opción -wg, se eliminarán todas las
asignaciones del grupo especificado.
-ug <group> : especifica el grupo UNIX para el que se eliminará la
asignación, especificada como <groupname> .

Debe especificar la opción -wg o -ug , o ambas. Si especifica ambas


opciones, se eliminará la asignación concreta identificada por las dos
opciones. Si especifica solo la opción -ug, se eliminarán todas las
asignaciones del grupo especificado.
Parámetro Descripción

list Muestra información sobre las asignaciones de usuarios y grupos. Las


siguientes opciones están disponibles con este parámetro:
-all: enumera las asignaciones tanto simples como avanzadas para
usuarios y grupos.
-simple: enumera todos los usuarios y grupos asignados simples.
-advanced: enumera todos los usuarios y grupos asignados
avanzados. Los mapas se muestran en el orden en que se evalúan.
Los mapas principales, marcados con un asterisco (*), se enumeran
primero, seguidos de los mapas secundarios, que se marcan con un
acento circunflejo (^) .
-wu <name> : enumera la asignación de un usuario de Windows
especificado.
-wg <group> : enumera la asignación de un grupo de Windows.
-uu <name> : enumera la asignación de un usuario UNIX.
-ug <group> : enumera la asignación de un grupo UNIX.

copia de seguridad Guarda la configuración de asignación de nombres de usuario y los datos


de asignación en el archivo especificado por <filename> .

Restauración Reemplaza los datos de configuración y asignación con los datos del
archivo (especificado por <filename> ) que se crearon mediante el
parámetro de copia de seguridad.

adddomainmap Agrega un mapa simple entre un dominio de Windows y un dominio NIS o


archivos de grupo o de contraseña. Las siguientes opciones están
disponibles para este parámetro:
-d <windowsdomain> : especifica el dominio de Windows que se va a
asignar.
-y <NISdomain> : especifica el dominio NIS que se va a asignar. Debe
usar el parámetro -n <NISserver> para especificar el servidor NIS
para el dominio NIS especificado por la opción -y.
-f <path> : especifica la ruta de acceso completa del directorio que
contiene la contraseña y los archivos de grupo que se van a asignar.
Los archivos deben encontrarse en el equipo que se administra y no
se puede usar mapadmin para administrar un equipo remoto con el
objetivo de configurar mapas basados en archivos de grupo y
contraseña.
Parámetro Descripción

removedomainmap Quita un mapa simple entre un dominio de Windows y un dominio NIS. Las
siguientes opciones y argumentos están disponibles para este parámetro:
-d <windowsdomain> : especifica el dominio de Windows del mapa que
se va a quitar.
-y <NISdomain> : especifica el dominio NIS del mapa que se va a
quitar.
-all: especifica que se van a quitar todas las asignaciones simples
entre dominios de Windows y NIS. Esto también quitará cualquier
mapa simple entre un dominio de Windows y archivos de grupo y
contraseña.

listdomainmaps Enumera los dominios de Windows que se asignan a los dominios NIS o a
los archivos de contraseña y grupo.

Comentarios
Si no especifica ningún parámetro, el comando mapadmin muestra la
configuración actual de asignación de nombres de usuario.

Para todas las opciones que especifican un nombre de usuario o grupo, se pueden
usar los siguientes formatos:

Para los usuarios de Windows, use los formatos: <domain>\<username> , \\


<computer>\<username> , \<computer>\<username> o <computer>\<username>

En el caso de los grupos de Windows, use los formatos: <domain>\<groupname> ,


\\<computer>\<groupname> , \<computer>\<groupname> o <computer>\<groupname>

Para los usuarios de UNIX, use los formatos: <NISdomain>\<username> ,


<username>@<NISdomain> , <username>@PCNFS o PCNFS\<username>

En el caso de los grupos UNIX, use los formatos: <NISdomain>\<groupname> ,


<groupname>@<NISdomain> , <groupname>@PCNFS o PCNFS\<groupname>

Vínculos relacionados
Clave de sintaxis de línea de comandos
md
Artículo • 14/04/2023

Crea un directorio o subdirectorio. Las extensiones de comandos, que están habilitadas


de forma predeterminada, permiten usar un único comando md para crear directorios
intermedios en una ruta de acceso especificada.

7 Nota

Este comando es el mismo que el comando mkdir.

Sintaxis

md [<drive>:]<path>

Parámetros

Parámetro Descripción

<drive> : Especifica la unidad en la que desea crear el nuevo directorio.

<path> Especifica el nombre y la ubicación del nuevo directorio. El sistema de archivos


determina la longitud máxima de cualquier ruta de acceso única. Es un parámetro
obligatorio.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para crear un directorio denominado Directory1 dentro del directorio actual, escriba:

md Directory1

Para crear el árbol de directorio Taxes\Property\Current dentro del directorio raíz, con las
extensiones de comando habilitadas, escriba:
md \Taxes\Property\Current

Para crear el árbol de directorios Taxes\Property\Current dentro del directorio raíz como
en el ejemplo anterior, pero con las extensiones de comando deshabilitadas, escriba la
siguiente secuencia de comandos:

md \Taxes
md \Taxes\Property
md \Taxes\Property\Current

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando mkdir
merge vdisk
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Combina un disco duro virtual (VHD) diferenciado con su VHD primario


correspondiente. El VHD primario se modificará para incluir las modificaciones del VHD
diferenciado. Este comando modifica el VHD primario. Como resultado, otros VHD
diferenciados que dependan del primario dejarán de ser válidos.

) Importante

Debe elegir y desasociar un VHD para que esta operación se realice correctamente.
Use el comando select vdisk para seleccionar un VHD y desplazar el foco a él.

Sintaxis

merge vdisk depth=<n>

Parámetros

Parámetro Descripción

depth= <n> Indica el número de archivos de VHD primarios que hay que fusionar. Por ejemplo,
depth=1 indica que el VHD diferenciado se fusionará con un nivel de la cadena de
diferenciado.

Ejemplos
Para fusionar un VHD diferenciado con su VHD primario, escriba:

merge vdisk depth=1


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando attach vdisk

Comando compact vdisk

Comando detail vdisk

Comando detach vdisk

Comando expand vdisk

Comando select vdisk

Comando list
mkdir
Artículo • 14/04/2023

Crea un directorio o subdirectorio. Las extensiones de comandos, que están habilitadas


de manera predeterminada, permiten usar un comando mkdir para crear directorios
intermedios en una ruta de acceso especificada.

7 Nota

Este comando es el mismo que el comando md.

Sintaxis

mkdir [<drive>:]<path>

Parámetros

Parámetro Descripción

<drive> : Especifica la unidad en la que desea crear el directorio.

<path> Especifica el nombre y la ubicación del directorio nuevo. El sistema de archivos


determina la longitud máxima de cualquier ruta de acceso única. Es un parámetro
obligatorio.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para crear un directorio denominado Directory1 dentro del directorio actual, escriba:

mkdir Directory1

Para crear el árbol de directorio Taxes\Property\Current dentro del directorio raíz, con las
extensiones de comando habilitadas, escriba:
mkdir \Taxes\Property\Current

Para crear el árbol de directorios Taxes\Property\Current dentro del directorio raíz como
en el ejemplo anterior, pero con las extensiones de comando deshabilitadas, escriba la
siguiente secuencia de comandos:

mkdir \Taxes
mkdir \Taxes\Property
mkdir \Taxes\Property\Current

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando md
mklink
Artículo • 14/04/2023

Crea un vínculo, simbólico o físico, de directorio o archivo.

Sintaxis

mklink [[/d] | [/h] | [/j]] <link> <target>

Parámetros

Parámetro Descripción

/d Crea un vínculo simbólico de directorio. De forma predeterminada, este comando


crea un vínculo simbólico de archivo.

/h Crea un vínculo físico en lugar de un vínculo simbólico.

/j Crea una unión de directorios.

<link> Especifica el nombre del vínculo simbólico que se va a crear.

<target> Especifica la ruta de acceso (relativa o absoluta) a la que hace referencia el nuevo
vínculo simbólico.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para crear y quitar un vínculo simbólico denominado MyFolder del directorio raíz al
directorio \Users\User1\Documents y un vínculo físico denominado Myfile.file al archivo
example.file ubicado dentro del directorio, escriba:

mklink /d \MyFolder \Users\User1\Documents


mklink /h \MyFile.file \User1\Documents\example.file
rd \MyFolder
del \MyFile.file
Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando del

Comando rd

New-Item en Windows PowerShell


mmc
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Usando las opciones de la línea de comandos de mmc, puede abrir una consola mmc
específica, abrir mmc en modo autor o especificar que se abra la versión de 32 o 64 bits
de mmc.

Sintaxis

mmc <path>\<filename>.msc [/a] [/64] [/32]

Parámetros

Parámetro Descripción

<path>\ inicia mmc y abre una consola guardada. Debe especificar la ruta de acceso
<filename>.msc completa y el nombre del archivo de consola guardado. Si no especifica un
archivo de consola, mmc abre una nueva consola.

/a Abre una consola guardada en modo autor. Se usa para hacer cambios en las
consolas guardadas.

/64 Abre la versión de 64 bits de mmc (mmc64). Utilice esta opción sólo si ejecuta
un sistema operativo de Microsoft de 64 bits y desea utilizar un complemento
de 64 bits.

/32 Abre la versión de 32 bits de mmc (mmc32). Cuando se ejecuta un sistema


operativo de Microsoft de 64 bits, puede ejecutar complementos de 32 bits si
abre mmc con esta opción en la línea de comandos cuando tiene solo
complementos de 32 bits.

Comentarios
Puede utilizar variables de entorno para crear líneas de comandos o accesos
directos que no dependan de la ubicación explícita de los archivos de consola. Por
ejemplo, si la ruta a un archivo de consola se encuentra en la carpeta del sistema
(por ejemplo, mmc c:\winnt\system32\console_name.msc), puede usar la cadena
de datos expandible %systemroot% para especificar la ubicación
(mmc%systemroot%\system32\console_name.msc). Esto puede resultar útil si
delega tareas en usuarios de la organización que trabajan en equipos distintos.

Cuando las consolas se abren usando la opción /a, se abren en modo autor,
independientemente de su modo predeterminado. Esto no cambia
permanentemente la configuración predeterminada del modo para los archivos;
cuando omite esta opción, mmc abre los archivos de la consola según su
configuración predeterminada de modo.

Después de abrir mmc o un archivo de consola en modo autor, puede abrir


cualquier consola existente haciendo clic en Abrir en el menú Consola.

Puede usar la línea de comandos para crear métodos abreviados para abrir mmc y
las consolas guardadas. Un comando de la línea de comandos funciona con el
comando Ejecutar del menú Inicio, en cualquier ventana del símbolo del sistema,
en accesos directos o en cualquier archivo por lotes o programa que llame al
comando.

Vínculos relacionados
Clave de sintaxis de línea de comandos
mode
Artículo • 14/04/2023

Muestra el estado del sistema, cambia la configuración del sistema o vuelve a configurar
puertos o dispositivos. Si se usa sin parámetros, mode muestra todos los atributos
controlables de la consola y los dispositivos COM disponibles.

Puerto serie
Configura un puerto de comunicaciones serie y establece el protocolo de enlace de
salida.

Sintaxis

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 Descripción

com<m>[:] Especifica el número del puerto de comunicaciones asincrónico Prncnfg.vbshronous.

baud=<b> Especifica la velocidad de transmisión en bits por segundo. Los valores válidos
incluyen:
11 - 110 baudios
15 - 150 baudios
30 - 300 baudios
60 - 600 baudios
12 - 1200 baudios
24 - 2400 baudios
48 - 4800 baudios
96 - 9600 baudios
19 - 19 200 baudios
Parámetro Descripción

parity= Especifica cómo usa el sistema el bit de paridad para comprobar si hay errores de
<p> transmisión. Los valores válidos incluyen:
n: ninguno
e: par (valor predeterminado)
o: impar
m: marca
s: espacio

No todos los dispositivos admiten el uso de los parámetros m o s.

data=<d> Especifica el número de bits de datos en un carácter. El rango de valores válidos


está comprendido entre 5 y 8. El valor predeterminado es 7. No todos los
dispositivos admiten los valores 5 y 6.

stop=<s> Especifica el número de bits de detención que definen el final de un carácter: 1, 1,5 o
2. Si la velocidad en baudios es 110, el valor predeterminado es 2. De lo contrario, el
valor predeterminado es 1. No todos los dispositivos admiten el valor 1.5.

to={on | Especifica si el dispositivo usa el procesamiento de tiempo de espera infinito. El


off} valor predeterminado es off. Si se activa esta opción, el dispositivo nunca dejará de
esperar a recibir una respuesta de un equipo host o cliente.

xon={on | Especifica si el sistema permite el protocolo XON/XOFF. Este protocolo proporciona


off} control de flujo para las comunicaciones en serie, lo que mejora la confiabilidad,
pero reduce el rendimiento.

odsr={on | Especifica si el sistema activa el protocolo de enlace de salida listo para conjuntos
off} de datos preparados (DSR).

octs={on | Especifica si el sistema activa el protocolo de enlace de salida Listo para enviar (CTS).
off}

dtr={on | Especifica si el sistema activa el protocolo de enlace de salida de terminal de datos


off | hs} preparado (DTR). Al establecer este valor en el modo on, se proporciona una señal
constante para mostrar que el terminal está listo para enviar datos. Al establecer
este valor en el modo hs, se proporciona una señal de protocolo de enlace entre los
dos terminales.

rts={on | Especifica si el sistema activa el protocolo de enlace de salida de solicitud de envío


off | hs | (RTS). Al establecer este valor en el modo on, se proporciona una señal constante
tg} para mostrar que el terminal está listo para enviar datos. Al establecer este valor en
el modo hs, se proporciona una señal de protocolo de enlace entre los dos
terminales. Establecer este valor en modo tg proporciona una manera de alternar
entre estados listos y no listos.

idsr={on | Especifica si el sistema activa la sensibilidad de DSR. Debe activar esta opción para
off} usar el protocolo de enlace DSR.

/? Muestra la ayuda en el símbolo del sistema.


Estado del dispositivo
Muestra el estado de los dispositivos especificados. Si se usa sin parámetros, mode
muestra el estado de todos los dispositivos instalados en el sistema.

Sintaxis

mode [<device>] [/status]

Parámetros

Parámetro Descripción

<device> Especifica el nombre del dispositivo para el que desea mostrar el estado. Los
nombres estándar incluyen LPT1: a LPT3:, COM1: a COM9: y CON.

/status Solicita el estado de las impresoras paralelas redirigidas. También puede usar /sta
como una versión abreviada de este comando.

/? Muestra la ayuda en el símbolo del sistema.

Impresión de redireccionamiento
Redirige la salida de la impresora. Para desviar la impresión, debe ser miembro del
grupo de administradores.

7 Nota

Para configurar el sistema para que envíe la salida paralela de la impresora a una
impresora en serie, debe usar el comando mode dos veces. La primera vez, debe usar
mode para configurar el puerto serie. La segunda vez, debe usar mode para redirigir la
salida de la impresora paralela al puerto serie que especificó en el primer comando
mode.

Sintaxis

mode LPT<n>[:]=COM<m>[:]
Parámetros

Parámetro Descripción

LPT <n> [:] Especifica el número del LPT que se va a configurar. Normalmente, esto significa
proporcionar un valor de LTP1: a LTP3:, a menos que el sistema incluya
compatibilidad especial con puertos paralelos. Este parámetro es obligatorio.

COM <m> [:] Especifica el puerto COM que se va a configurar. Normalmente, esto significa
proporcionar un valor de COM1: a COM9:, a menos que el sistema tenga hardware
especial para puertos COM adicionales. Este parámetro es obligatorio.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para redirigir una impresora en serie que funciona a 4800 baudios con paridad uniforme
y está conectada al puerto COM1 (la primera conexión en serie del equipo), escriba:

mode com1 48,e,,,b


mode lpt1=com1

Para redirigir la salida de la impresora paralela de LPT1 a COM1 y, a continuación,


imprimir un archivo mediante LPT1, escriba el siguiente comando antes de imprimir el
archivo:

mode lpt1

Este comando impide el redireccionamiento del archivo de LPT1 a COM1.

Seleccionar página de códigos


Configura o consulta la información de la página de códigos de un dispositivo
seleccionado.

Sintaxis
mode <device> codepage select=<yyy>
mode <device> codepage [/status]

Parámetros

Parámetro Descripción

<device> Especifica el dispositivo para el que desea seleccionar una página de códigos.
CON es el único nombre válido para un dispositivo. Este parámetro es obligatorio.

codepage Especifica la página de códigos que se va a usar con el dispositivo especificado.


También puede usar cp como una versión abreviada de este comando. Este
parámetro es obligatorio.

select= <yyy> Especifica el número de la página de códigos que se va a usar con el dispositivo.
Las páginas de códigos admitidas, por país o región o idioma, incluyen:
437: Estados Unidos
850: Multilingüe (latino I)
852: Eslavo (latino II)
855: Cirílico (ruso)
857: Turco
860: Portugués
861: Islandés
863: Francés canadiense
865: Nórdico
866: Ruso
869: Griego moderno

Este parámetro es obligatorio.

/status Muestra los números de las páginas de códigos actuales seleccionadas para el
dispositivo especificado. También puede usar /sta como una versión abreviada de
este comando. Independientemente de si especifica /status, el comando mode
codepage mostrará los números de las páginas de códigos seleccionadas para el
dispositivo especificado.

/? Muestra la ayuda en el símbolo del sistema.

Modo de pantalla
Cambia el tamaño del búfer de pantalla del símbolo del sistema

Sintaxis
mode con[:] [cols=<c>] [lines=<n>]

Parámetros

Parámetro Descripción

con[:] Indica que el cambio se aplica a la ventana del símbolo del sistema. Este parámetro
es obligatorio.

cols= <c> Especifica el número de columnas en el búfer de pantalla del símbolo del sistema. El
valor predeterminado es 80 columnas, pero puede establecerlo en cualquier valor. Si
no usa el valor predeterminado, los valores típicos son 40 y 135 columnas. El uso de
valores no estándar puede dar lugar a problemas de la aplicación del símbolo del
sistema.

lines= <n> Especifica el número de líneas en el búfer de pantalla del símbolo del sistema. El
valor predeterminado es 25, pero puede establecerlo en cualquier valor. Si no usa el
valor predeterminado, el otro valor típico es 50 líneas.

/? Muestra la ayuda en el símbolo del sistema.

Velocidad de tipo
Establece la velocidad de tipo de teclado. La velocidad de tipo es la velocidad a la que
Windows puede repetir un carácter al presionar la tecla en un teclado.

7 Nota

Algunos teclados no reconocen este comando.

Sintaxis

mode con[:] [rate=<r> delay=<d>]

Parámetros

Parámetro Descripción
Parámetro Descripción

con[:] Especifica el teclado. Este parámetro es obligatorio.

rate= <r> Especifica la velocidad a la que se repite un carácter en la pantalla cuando se


mantiene presionada una tecla. El valor predeterminado es de 20 caracteres por
segundo para teclados compatibles con IBM AT y 21 para teclados compatibles con
IBM PS/2, pero puede usar cualquier valor de 1 a 32. Si establece este parámetro,
también debe establecer el parámetro delay.

delay= <d> Especifica la cantidad de tiempo que transcurrirá después de presionar y mantener
presionada una tecla antes de que se repita la salida del carácter. El valor
predeterminado es 2 (0,50 segundos), pero también puede usar 1 (0,25 segundos), 3
(0,75 segundos) o 4 (1 segundo). Si establece este parámetro, también debe
establecer el parámetro rate.

/? Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
más
Artículo • 17/04/2023

Muestra una pantalla de salida a la vez.

7 Nota

El comando more, con diferentes parámetros, también está disponible en la


Consola de recuperación.

Sintaxis

<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 Descripción

<command> Especifica un comando para el que desea mostrar la salida.

/C Borra la pantalla antes de mostrar una página.

/p Expande los caracteres de avance de página.

/s Muestra varias líneas en blanco como una sola línea en blanco.

/t <n> Muestra las pestañas como el número de espacios especificados por n.

+ <n> Muestra el primer archivo, comenzando en la línea especificada por n.

[<drive>:][<path>] Especifica la ubicación y el nombre de un archivo que se va a mostrar.


<filename>

<files> Especifica una lista de archivos que se van a mostrar. Los archivos se
deben separar mediante espacios.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Se aceptan los siguientes subcomandos en el símbolo del sistema more ( -- More -
- ):

Clave Acción

BARRA Presione la BARRA ESPACIADORA para mostrar la pantalla siguiente.


ESPACIADORA

ENTRAR Presione ENTRAR para mostrar el archivo una línea a la vez.

f Presione F para mostrar el siguiente archivo que aparece en la línea de


comandos.

q Presione Q para salir del comando more.

= Muestra el número de línea.

p <n> Presione P para mostrar las n líneas siguientes.

s <n> Presione S para omitir las siguientes n líneas.

? Presione ? para mostrar los comandos que están disponibles en el


símbolo del sistema more.

Si usa el carácter de redireccionamiento ( < ), también debe especificar un nombre


de archivo como origen.

Si usa la canalización ( | ), puede usar comandos como dir, sort y type.

Ejemplos
Para ver la primera pantalla de información de un archivo denominado Clients.new,
escriba uno de los siguientes comandos:

more < clients.new


type clients.new | more

El comando more muestra la primera pantalla de información de Clients.new y puede


presionar la BARRA ESPACIADORA para ver la siguiente pantalla de información.

Para borrar la pantalla y quitar todas las líneas en blanco adicionales antes de mostrar el
archivo Clients.new, escriba uno de los siguientes comandos:
more /c /s < clients.new
type clients.new | more /c /s

Para mostrar el número de línea actual en el símbolo del sistema, more, escriba:

more =

El número de línea actual se agrega al símbolo del sistema more, como -- More [Line:
24] -- .

Para mostrar un número específico de líneas en el símbolo del sistema more, escriba:

more p

El símbolo del sistema more le pide el número de líneas que se van a mostrar, como se
indica a continuación: -- More -- Lines: . Escriba el número de líneas que se van a
mostrar y presione ENTRAR. La pantalla cambia para mostrar solo ese número de líneas.

Para omitir un número específico de líneas en el símbolo del sistema more, escriba:

more s

El símbolo del sistema more le pide el número de líneas que se van a omitir, como se
indica a continuación: -- More -- Lines: . Escriba el número de líneas que se van a
omitir y presione ENTRAR. La pantalla cambia para mostrar que esas líneas se omiten.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Entorno de recuperación de Windows (WinRE)


montar
Artículo • 07/10/2023

Una utilidad de línea de comandos que monta recursos compartidos de red del Sistema
de archivos de red (NFS). Si se usa sin opciones ni argumentos, mount muestra
información sobre todos los sistemas de archivos NFS montados.

7 Nota

Esta utilidad solo está disponible si Cliente para NFS está instalado.

Sintaxis

mount [-o <option>[...]] [-u:<username>] [-p:{<password> | *}] {\\


<computername>\<sharename> | <computername>:/<sharename>} {<devicename> | *}

Parámetros

Parámetro Descripción

-o rsize= <buffersize> Establece el tamaño en kilobytes del búfer de lectura. Los


valores aceptables son 1, 2, 4, 8, 16 y 32. El valor
predeterminado es 32 KB.

-o wsize= <buffersize> Establece el tamaño en kilobytes del búfer de escritura. Los


valores aceptables son 1, 2, 4, 8, 16 y 32. El valor
predeterminado es 32 KB.

-o timeout= <seconds> Establece el valor de tiempo de espera en segundos para una


llamada a procedimiento remoto (RPC). Los valores aceptables
son 0,8, 0,9 y cualquier entero que oscile entre 1 y 60. El valor
predeterminado es 0,8.

-o retry= <number> Establece el número de reintentos para un montaje suave. Los


valores aceptables son enteros que oscilan entre 1 y 10. El valor
predeterminado es 1.

-o mtype= {soft|hard} Establece el tipo de montaje del recurso compartido NFS. De


forma predeterminada, Windows usa un montaje flexible. Los
montajes flexibles agotan el tiempo de espera más fácilmente
cuando hay problemas de conexión; sin embargo, para reducir
Parámetro Descripción

las interrupciones de E/S durante los reinicios del servidor NFS,


recomendamos usar un montaje flexible.

-o lang= {euc-jp|euc-tw|euc- Especifica la codificación de idioma a configurar en un recurso


kr|shift- compartido de NFS. Solo puede usar un idioma en el recurso
jis|Big5|Ksc5601|Gb2312- compartido. Este valor puede incluir cualquiera de los siguientes
80|Ansi} valores:
euc-jp: japonés
euc-tw: chino
euc-kr: coreano
shift-jis: japonés
Big5: chino
Ksc5601: coreano
Gb2312-80: chino simplificado
Ansi: codificado en ANSI

-o fileaccess= <mode> Especifica el modo de permiso predeterminado de los nuevos


archivos creados en el recurso compartido de NFS. Especifique
el modo como un número de tres dígitos de la forma ogw,
donde o, g y w son cada uno un dígito que representa el acceso
concedido al propietario del archivo, al grupo y al mundo,
respectivamente. Los dígitos deben estar en el intervalo entre 0
y 7, incluyendo:

0: Sin acceso
1: x (acceso de ejecución)
2: w (acceso de escritura)
3: wx (acceso de escritura y ejecución)
4: r (acceso de lectura)
5: rx (acceso de lectura y ejecución)
6: rw (acceso de lectura y escritura)
7: rwx (acceso de lectura, escritura y ejecución)

-o anon Monta como usuario anónimo.

-o nolock Deshabilita el bloqueo (el valor predeterminado es enabled


(habilitado)).

-o casesensitive Obliga a que las búsquedas de archivos en el servidor distingan


entre mayúsculas y minúsculas.

-o sec= Especifica el mecanismo de seguridad para montar un recurso


{sys|krb5|krb5i|krb5p} compartido de NFS. Este valor puede incluir cualquiera de los
siguientes valores:
sec=sys: no se realizan comprobaciones de autenticación
o seguridad. Las transferencias de datos no se cifran.
Parámetro Descripción

sec=krb5: especifica la autenticación Kerberos para


montar el recurso compartido de NFS.
sec=krb5i: amplía la seguridad de Kerberos agregando
comprobaciones de integridad de datos entre el cliente y
el servidor no se ha alterado.
sec=krb5p: mejora la seguridad de Kerberos al habilitar la
privacidad de los datos, que cifra los datos
intercambiados entre el cliente y el servidor.

-u: <username> Especifica el nombre de usuario que se usará para montar el


recurso compartido. Si el nombre de usuario no va precedido de
una barra invertida ( \ ), se trata como un nombre de usuario
UNIX.

-p: <password> Contraseña que se va a usar para montar el recurso compartido.


Si usa un asterisco (*), se le pedirá la contraseña.

<computername> Especifica el nombre del servidor NFS.

<sharename> Especifica el nombre del sistema de archivos.

<devicename> Especifica la letra de unidad y el nombre del dispositivo. Si usa


un asterisco (*) este valor representa la primera letra de
controlador disponible.

Ejemplos
Para montar el recurso compartido de NFS de forma anónima en la unidad de red Z,
escriba:

Símbolo del sistema de Windows

mount -o anon \\ServerIP\ShareName Z:

7 Nota

Para que este parámetro funcione según lo previsto, el servidor NFS debe permitir
el acceso anónimo.

Para montar el recurso compartido NFS y deshabilitar el bloqueo de archivos para la


unidad de red Z, escriba:

Símbolo del sistema de Windows


mount -o nolock \\ServerIP\ShareName Z:

Para montar el recurso compartido NFS con permisos para el conjunto de ogw como
rwx, rw, r y volver a conectarse continuamente al servidor NFS si la conexión se pierde
para la unidad de red Z, escriba:

Símbolo del sistema de Windows

mount -o fileaccess=764 mtype=hard \\ServerIP\ShareName Z:

Vínculos relacionados
Clave de sintaxis de línea de comandos
mountvol
Artículo • 12/04/2023

Crea, elimina o enumera un punto de montaje del volumen. También puede vincular
volúmenes sin necesidad de una letra de unidad.

Sintaxis

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 Descripción

[<drive>:] Especifica el directorio NTFS existente donde residirá el punto de montaje.


<path>

<volumename> Especifica el nombre del volumen que es el destino del punto de montaje. El
nombre del volumen usa la siguiente sintaxis, donde GUID es un identificador
único global: \\?\volume\{GUID}\ . Los corchetes { } son obligatorios.

/d Quita el punto de montaje del volumen de la carpeta especificada.

/l Enumera el nombre del volumen montado para la carpeta especificada.

/p Quita el punto de montaje del volumen del directorio especificado, desmonta y


desconecta el volumen básico, por lo que es imposible montarlo. Si hay otros
procesos utilizando el volumen, mountvol cerrará los identificadores abiertos
antes de desmontar el volumen.

/r Quita los directorios de puntos de montaje del volumen y la configuración de


registro de los volúmenes que ya no están en el sistema, lo que impide que se
monten automáticamente y que se les asigne sus puntos de montaje de volumen
anteriores cuando se agreguen de nuevo al sistema.

/n Deshabilita el montaje automático de nuevos volúmenes básicos. Los nuevos


volúmenes no se montan automáticamente cuando se agregan al sistema.
Parámetro Descripción

/e Vuelve a habilitar el montaje automático de nuevos volúmenes básicos.

/s Monta la partición del sistema EFI en la unidad especificada.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si desmonta el volumen mientras usa el parámetro /p, la lista de volúmenes
mostrará el volumen como no montado hasta que se cree un punto de montaje de
volumen.

Si el volumen tiene más de un punto de montaje, use /d para quitar los puntos de
montaje adicionales antes de usar /p. Puede volver a hacer que el volumen básico
se pueda montar mediante la asignación de un punto de montaje de volumen.

Si necesita expandir el espacio del volumen sin volver a formatear o reemplazar un


disco duro, puede agregar una ruta de acceso de montaje a otro volumen. La
ventaja de usar un volumen con varias rutas de acceso de montaje es que puede
acceder a todos los volúmenes locales mediante una sola letra de unidad (como
C: ). No es necesario recordar qué volumen corresponde a qué letra de unidad,
aunque todavía puede montar volúmenes locales y asignarles letras de unidad.

Ejemplos
Para crear un punto de montaje, escriba:

mountvol \sysmount \\?\volume\{2eca078d-5cbc-43d3-aff8-7e8511f60d0e}\

Vínculos relacionados
Clave de sintaxis de línea de comandos
mover
Artículo • 14/04/2023

Mueve uno o varios archivos de un directorio a otro.

) Importante

Si se mueven archivos cifrados a un volumen que no admite los resultados del


Sistema de cifrado de archivos (EFS), se producirá un error. En primer lugar, debe
descifrar los archivos o moverlos a un volumen que admita el EFS.

Sintaxis

move [{/y|-y}] [<source>] [<target>]

Parámetros

Parámetro Descripción

/y Deja de solicitar confirmación de que desea sobrescribir un archivo de destino


existente. Este parámetro se puede preestablecer en la variable de entorno
COPYCMD. Puede invalidar este valor preestablecido mediante el parámetro -y. El
valor predeterminado es solicitar confirmación antes de sobrescribir archivos, a
menos que el comando se ejecute desde un script por lotes.

-y Comienza a solicitar confirmación de que desea sobrescribir un archivo de destino


existente.

<source> Especifica la ruta de acceso y el nombre del archivo o de los archivos que se van a
mover. Para mover o cambiar el nombre de un directorio, el origen debe ser la ruta
de acceso y el nombre del directorio actual.

<target> Especifica la ruta de acceso y el nombre a los que se van a mover los archivos. Para
mover o cambiar el nombre de un directorio, el destino debe ser la ruta de acceso y
el nombre del directorio deseados.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para mover todos los archivos con la extensión .xls del directorio \Data al directorio
\Second_Q\Reports, escriba:

move \data\*.xls \second_q\reports\

Vínculos relacionados
Clave de sintaxis de línea de comandos
mqbkup
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Realiza una copia de seguridad de los archivos de mensajes MSMQ y la configuración


del registro en un dispositivo de almacenamiento y restaura los mensajes y la
configuración previamente almacenados.

Tanto la copia de seguridad como las operaciones de restauración detienen el servicio


MSMQ local. Si el servicio MSMQ se inició de antemano, la utilidad intentará reiniciar el
servicio MSMQ al final de la copia de seguridad o la operación de restauración. Si el
servicio ya se ha detenido antes de ejecutar la utilidad, no se realiza ningún intento de
reiniciar el servicio.

Antes de usar la utilidad de Copia de seguridad/Restauración de mensajes MSMQ debe


cerrar todas las aplicaciones locales que estén usando MSMQ.

Sintaxis

mqbkup {/b | /r} <folder path_to_storage_device>

Parámetros

Parámetro Descripción

/b Especifica la operación de copia de seguridad.

/r Especifica la operación de restauración.

<folder Especifica la ruta de acceso donde se almacenan los archivos de


path_to_storage_device> mensajes de MSMQ y la configuración del registro.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si no existe una carpeta especificada mientras se realiza la operación de copia de
seguridad o restauración, la utilidad crea automáticamente la carpeta.

Si decide especificar una carpeta existente, debe estar vacía. Si especifica una
carpeta no vacía, la utilidad elimina todos los archivos y subcarpetas que contiene.
En este caso, se le pedirá que dé permiso para eliminar los archivos y subcarpetas
existentes. Puede usar el parámetro /y para indicar que acepta de antemano la
eliminación de todos los archivos y subcarpetas existentes en la carpeta
especificada.

Las ubicaciones de las carpetas usadas para almacenar los archivos de mensajes
MSMQ se almacenan en el registro. Por lo tanto, la utilidad restaura los archivos de
mensaje MSMQ a las carpetas especificadas en el registro y no a las carpetas de
almacenamiento usadas antes de la operación de restauración.

Ejemplos
Para realizar una copia de seguridad de todos los archivos de mensajes MSMQ y la
configuración del registro, y almacenarlos en la carpeta msmqbkup de la unidad C:,
escriba:

mqbkup /b c:\msmqbkup

Para eliminar todos los archivos y subcarpetas existentes en la carpeta oldbkup de la


unidad C: y, a continuación, almacenar los archivos de mensaje MSMQ y la
configuración del registro en la carpeta, escriba:

mqbkup /b /y c:\oldbkup

Para restaurar los mensajes MSMQ y la configuración del registro, escriba:

mqbkup /r c:\msmqbkup

Vínculos relacionados
Clave de sintaxis de línea de comandos
Referencia de PowerShell de MSMQ
mqsvc
Artículo • 06/04/2023

La tecnología Message Queuing permite que las aplicaciones que se ejecutan en


distintos momentos se comuniquen a través de redes y sistemas heterogéneos que
pueden estar sin conexión temporalmente. Message Queue Server proporciona garantía
de entrega de mensajes, enrutamiento eficaz, seguridad y mensajería por prioridades. Se
puede usar para implementar soluciones para escenarios de mensajería asincrónicos y
sincrónicos. Para más información acerca de Message Queuing, vea Message Queuing
(MSMQ).

Sintaxis

mqsvc.exe

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de PowerShell de MSMQ


mqtgsvc
Artículo • 06/04/2023

Supervisa una cola de mensajes entrantes y realiza una acción, en forma de archivo
ejecutable o componente COM, cuando las reglas de un desencadenador se evalúan
como verdaderas. Para ver ejemplos de cómo puede usarse el servicio de
desencadenadores de colas de mensajes, consulte Desencadenadores de colas de
mensajes.

Sintaxis

mqtgsvc.exe

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de PowerShell de MSMQ


msdt
Artículo • 12/04/2023

Invoca un paquete de solución de problemas en la línea de comandos o como parte de


una secuencia de comandos automatizada, y habilita opciones adicionales sin entrada
del usuario.

7 Nota

La herramienta de diagnóstico para soporte técnico de Microsoft (MSDT) está en


desuso. Para más información, consulte Características de Windows en desuso.

Sintaxis

msdt </id <name> | /path <name> | /cab < name>> <</parameter> [options] …
<parameter> [options]>>

Parámetros

Parámetro Descripción

/id <packagename> Especifica qué paquete de diagnóstico debe ejecutarse. Para obtener una
lista de los paquetes disponibles, consulte Paquetes de solución de
problemas disponibles.

/path Especifica la ruta de acceso completa a un paquete de diagnóstico. Si


<directory|.diagpkg especifica un directorio, este debe contener un paquete de diagnóstico.
file|.diagcfg file> No se puede usar el parámetro /path junto con los parámetros** /id**,
/dci o /cab.

/dci <passkey> Rellena previamente el campo de clave de paso. Este parámetro solo se
usa cuando un proveedor de soporte técnico ha proporcionado una clave
de paso.

/dt <directory> Muestra el historial de solución de problemas en el directorio especificado.


Los resultados de diagnóstico se almacenan en los directorios
%LOCALAPPDATA%\Diagnostics o
%LOCALAPPDATA%\ElevatedDiagnostics del usuario.
Parámetro Descripción

/af <answerfile> Especifica un archivo de respuesta en formato XML que contiene


respuestas a una o varias interacciones de diagnóstico.

/modal <ownerHWND> Convierte el paquete de solución de problemas modal en una ventana


designada por el identificador primario de ventana de consola (HWND), en
decimal. Normalmente, este parámetro lo usan las aplicaciones que inician
un paquete de solución de problemas. Para obtener más información
sobre cómo obtener identificadores de ventana de consola, vea Cómo
obtener un identificador de ventana de consola (HWND).

/moreoptions Habilita (true) o suprime (false) la pantalla de solución de problemas final


<true|false> que pregunta si el usuario quiere explorar opciones adicionales. Este
parámetro se usa normalmente cuando un solucionador de problemas
inicia un paquete de solución de problemas que no forma parte del
sistema operativo.

/param Especifica un conjunto de respuestas de interacción en la línea de


<parameters> comandos, similar a un archivo de respuesta. Este parámetro no se usa
normalmente en el contexto de los paquetes de solución de problemas
creados con el diseñador de TSP. Para obtener más información sobre el
desarrollo de parámetros personalizados, consulte Plataforma de solución
de problemas de Windows.

/advanced Expande el vínculo avanzado de la página principal de forma


predeterminada cuando se inicia el paquete de solución de problemas.

/custom Solicita al usuario que confirme cada posible resolución antes de aplicarla.

Códigos de retorno
Los paquetes de solución de problemas comprenden un conjunto de causas principales,
cada una de las cuales describe un problema técnico específico. Después de completar
las tareas del paquete de solución de problemas, cada causa principal devuelve un
estado: solucionado, no solucionado, detectado (pero no reparable) o no encontrado.
Además de los resultados específicos notificados en la interfaz de usuario del
solucionador de problemas, el motor de solución de problemas devuelve un código en
los resultados que describen, en términos generales, si el solucionador de problemas ha
corregido o no el problema original. Los códigos son:

Código Descripción

-1 Interrupción: El solucionador de problemas se cerró antes de que se completaran las


tareas de solución de problemas.
Código Descripción

0 Solucionado: El solucionador de problemas identificó y corrigió al menos una causa


principal, y ninguna causa principal permanece en un estado no solucionado.

1 Presente, pero no solucionado: El solucionador de problemas identificó una o varias


causas principales que permanecen en un estado no solucionado. Este código se
devuelve incluso si se ha corregido otra causa principal.

2 No encontrado: El solucionador de problemas no identificó ninguna causa principal.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Paquetes de solución de problemas disponibles

Referencia de PowerShell troubleshootingPack


msg
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Envía un mensaje a un usuario en un servidor host de sesión de escritorio remoto.

7 Nota

Debe tener permiso de acceso especial a Mensajes para enviar un mensaje.

Sintaxis

msg {<username> | <sessionname> | <sessionID>| @<filename> | *} [/server:


<servername>] [/time:<seconds>] [/v] [/w] [<message>]

Parámetros

Parámetro Descripción

<username> Especifica el nombre del usuario al que quiere enviar un mensaje. Si no


especifica un usuario o una sesión, este comando muestra un mensaje de
error. Al especificar una sesión, debe ser una activa.

<sessionname> Especifica el nombre de la sesión a la que quiere enviar un mensaje. Si no


especifica un usuario o una sesión, este comando muestra un mensaje de
error. Al especificar una sesión, debe ser una activa.

<sessionID> Especifica el id. numérico de la sesión a cuyo usuario quiere enviar un


mensaje.

@<filename> Identifica un archivo que contiene una lista de nombres de usuario,


nombres de sesión e id. de sesión a las que quiere enviar un mensaje.

* Envía el mensaje a todos los nombres de usuario del sistema.

/server: <servername> Especifica el servidor host de sesión de escritorio remoto a cuya sesión o
usuario quiere enviar un mensaje. Si no se especifica, /server usa el
servidor en el que haya iniciado sesión en ese momento.
Parámetro Descripción

/time: <seconds> Especifica el tiempo durante el cual se muestra en la pantalla del usuario
el mensaje que envió. Una vez alcanzado el límite de tiempo, el mensaje
desaparece. Si no se establece ningún límite de tiempo, el mensaje tiene
como valor predeterminado 60 segundos y desaparece.

/v Muestra información sobre las acciones que se realizan.

/w Espera una confirmación del usuario de que se ha recibido el mensaje. Use


este parámetro con /time:<*seconds*> para evitar un posible tiempo de
espera largo si el usuario no responde inmediatamente. El uso de este
parámetro con /v también es útil.

<message> Especifica el texto del mensaje que quiere enviar. Si no se especifica


ningún mensaje, se le pedirá que escriba uno. Para enviar un mensaje
contenido en un archivo, escriba el símbolo menor que (<) seguido del
nombre del archivo.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para enviar un mensaje con el título: Nos vemos hoy a la 13:00 a todas las sesiones de
User1, escriba:

msg User1 Let's meet at 1PM today

Para enviar el mismo mensaje a la sesión modeM02, escriba:

msg modem02 Let's meet at 1PM today

Para enviar el mensaje a todas las sesiones contenidas en el archivo userlist, escriba:

msg @userlist Let's meet at 1PM today

Para enviar el mensaje a todos los usuarios que hayan iniciado sesión, escriba:
msg * Let's meet at 1PM today

Para enviar el mensaje a todos los usuarios, con un tiempo de espera de confirmación
(por ejemplo, de 10 segundos), escriba:

msg * /time:10 Let's meet at 1PM today

Vínculos relacionados
Clave de sintaxis de línea de comandos
msiexec
Artículo • 14/04/2023

Proporciona los medios para instalar, modificar y realizar operaciones en Windows


Installer desde la línea de comandos.

Opciones de instalación
Establezca el tipo de instalación para iniciar un paquete de instalación.

Sintaxis

msiexec.exe [/i][/a][/j{u|m|/g|/t}][/x] <path_to_package>

Parámetros

Parámetro Descripción

/i Especifica la instalación normal.

/a Especifica la instalación administrativa.

/ju Anuncia el producto al usuario actual.

/jm Anuncia el producto a todos los usuarios.

/j/g Especifica el identificador de idioma utilizado por el paquete anunciado.

/j/t Aplica la transformación al paquete anunciado.

/x Desinstala el paquete.

<path_to_package> Especifica la ubicación y el nombre del archivo de paquete de instalación.

Ejemplos

Para instalar un paquete denominado example.msi desde la unidad C: mediante un


proceso de instalación normal, escriba:
msiexec.exe /i "C:\example.msi"

Opciones de presentación
Puede configurar lo que ve un usuario durante el proceso de instalación, en función del
entorno de destino. Por ejemplo, si va a distribuir un paquete a todos los clientes para la
instalación manual, debe haber una interfaz de usuario completa. Sin embargo, si va a
implementar un paquete mediante directiva de grupo, lo que no requiere ninguna
interacción del usuario, no debería haber ninguna interfaz de usuario implicada.

Sintaxis

msiexec.exe /i <path_to_package> [/quiet][/passive][/q{n|b|r|f}]

Parámetros

Parámetro Descripción

<path_to_package> Especifica la ubicación y el nombre del archivo de paquete de instalación.

/quiet Especifica el modo silencioso, lo que significa que no se requiere ninguna


interacción del usuario.

/passive Especifica el modo desatendido, lo que significa que la instalación solo


muestra una barra de progreso.

/qn Especifica que no hay ninguna interfaz de usuario durante el proceso de


instalación.

/qn+ Especifica que no hay ninguna interfaz de usuario durante el proceso de


instalación, excepto un cuadro de diálogo final al final.

/qb Especifica que hay una interfaz de usuario básica durante el proceso de
instalación.

/qb+ Especifica que hay una interfaz de usuario básica durante el proceso de
instalación, incluido un cuadro de diálogo final al final.

/qr Especifica una experiencia de interfaz de usuario reducida durante el


proceso de instalación.
Parámetro Descripción

/qf Especifica una experiencia de interfaz de usuario completa durante el


proceso de instalación.

Comentarios

El cuadro modal no se muestra si el usuario cancela la instalación. Puede usar qb+!


o qb!+ para ocultar el botón CANCELAR.

Ejemplos

Para instalar el paquete C:\example.msi, con un proceso de instalación normal y sin


interfaz de usuario, escriba:

msiexec.exe /i "C:\example.msi" /qn

Opciones de reinicio
Si el paquete de instalación sobrescribe archivos o intenta cambiar los archivos que
están en uso, es posible que se requiera un reinicio antes de que se complete la
instalación.

Sintaxis

msiexec.exe /i <path_to_package> [/norestart][/promptrestart][/forcerestart]

Parámetros

Parámetro Descripción

<path_to_package> Especifica la ubicación y el nombre del archivo de paquete de instalación.

/norestart Impide que el dispositivo se reinicie una vez completada la instalación.

/promptrestart Solicita al usuario si se requiere un reinicio.


Parámetro Descripción

/forcerestart Reinicia el dispositivo una vez completada la instalación.

Ejemplos

Para instalar el paquete C:\example.msi, mediante un proceso de instalación normal sin


reinicio al final, escriba:

msiexec.exe /i "C:\example.msi" /norestart

Opciones de registro
Si necesita depurar el paquete de instalación, puede establecer los parámetros para
crear un archivo de registro con información específica.

Sintaxis

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 Descripción

/i Especifica la instalación normal.

/x Desinstala el paquete.

<path_to_package> Especifica la ubicación y el nombre del archivo de paquete de instalación.

/li Activa el registro e incluye mensajes de estado en el archivo de registro de


salida.

/lw Activa el registro e incluye advertencias no irrecuperables en el archivo de


registro de salida.

/le Activa el registro e incluye todos los mensajes de error en el archivo de


registro de salida.
Parámetro Descripción

/la Activa el registro e incluye información sobre cuándo se inició una acción en
el archivo de registro de salida.

/lr Activa el registro e incluye registros específicos de la acción en el archivo de


registro de salida.

/lu Activa el registro e incluye información de solicitud de usuario en el archivo


de registro de salida.

/lc Activa el registro e incluye los parámetros de interfaz de usuario iniciales en


el archivo de registro de salida.

/lm Activa el registro e incluye información de memoria insuficiente o salida


irrecuperable en el archivo de registro de salida.

/lo Activa el registro e incluye mensajes de espacio fuera del disco en el archivo
de registro de salida.

/lp Activa el registro e incluye propiedades de terminal en el archivo de registro


de salida.

/lv Activa el registro e incluye la salida detallada en el archivo de registro de


salida.

/lx Activa el registro e incluye información adicional de depuración en el archivo


de registro de salida.

/l+ Activa el registro y anexa la información a un archivo de registro existente.

/l! Activa el registro y vacía cada línea en el archivo de registro.

/l* Activa el registro y registra toda la información, excepto la información


detallada (/lv) o información adicional de depuración (/lx).

<path_to_logfile> Especifica la ubicación y el nombre del archivo de registro de salida.

Ejemplos
Para instalar el paquete C:\example.msi mediante un proceso de instalación normal con
toda la información de registro proporcionada, incluida la salida detallada y el
almacenamiento del archivo de registro de salida en C:\package.log, escriba:

msiexec.exe /i "C:\example.msi" /L*V "C:\package.log"


Opciones de actualización
Puede aplicar o quitar actualizaciones mediante un paquete de instalación.

Sintaxis

msiexec.exe [/p][/update][/uninstall[/package<product_code_of_package>]]
<path_to_package>

Parámetros

Parámetro Descripción

/p Instala una revisión. Si va a instalar en modo silencioso, también debe establecer la


propiedad REINSTALLMODE en ecmus y REINSTALL en ALL. De lo contrario, la
revisión solo actualiza la MSI almacenada en caché en el dispositivo de destino.

/update Opción Instalar revisiones. Si va a aplicar varias actualizaciones, debe separarlas


mediante un punto y coma (;).

/package Instala o configura un producto.

Ejemplos

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}

Donde el primer GUID es el GUID de revisión y el segundo es el código de producto MSI


al que se aplicó la revisión.

Opciones de reparación
Puede usar este comando para reparar un paquete instalado.

Sintaxis

msiexec.exe [/f{p|o|e|d|c|a|u|m|s|v}] <product_code>

Parámetros

Parámetro Descripción

/fp Repara el paquete si falta un archivo.

/fo Repara el paquete si falta un archivo o si hay instalada una versión anterior.

/fe Repara el paquete si falta el archivo o si hay instalada una versión igual o anterior.

/fd Repara el paquete si falta el archivo o si hay una versión diferente instalada.

/fc Repara el paquete si falta el archivo o si la suma de comprobación no coincide con


el valor calculado.

/fa Obliga a que se vuelvan a instalar todos los archivos.

/fu Repara todas las entradas del registro específicas del usuario necesarias.

/fm Repara todas las entradas del registro específicas del equipo necesarias.

/fs Repara todos los accesos directos existentes.

/fv Se ejecuta desde el origen y vuelve a almacenar en caché el paquete local.

Ejemplos
Para forzar que todos los archivos se vuelvan a instalar en función del código de
producto MSI que se va a reparar, {AAD3D77A-7476-469F-ADF4-04424124E91D},
escriba:

msiexec.exe /fa {AAD3D77A-7476-469F-ADF4-04424124E91D}

Establecimiento de propiedades públicas


Puede establecer propiedades públicas a través de este comando. Para obtener
información sobre las propiedades disponibles y cómo establecerlas, consulte
Propiedades públicas.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Opciones Msiexec.exe Command-Line

Opciones de la línea de comandos del instalador estándar


msinfo32
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Abre la herramienta Información del sistema para mostrar una vista completa del
hardware, los componentes del sistema y el entorno de software del equipo local.

Algunas categorías de Información del sistema contienen grandes cantidades de datos.


Puede usar el comando start /wait para optimizar el rendimiento de los informes de
estas categorías. Para más información, consulte Información del sistema.

Sintaxis

msinfo32 [/pch] [/nfo <path>] [/report <path>] [/computer <computername>]


[/showcategories] [/category <categoryID>] [/categories {+<categoryID>(+
<categoryID>)|+all(-<categoryID>)}]

Parámetros

Parámetro Descripción

<path> Especifica el archivo que se abrirá en el formato C:\Folder1\File1.xxx, donde C


es la letra de la unidad, Folder1 es la carpeta, File1 es el nombre del archivo y
xxx es la extensión del nombre del archivo.

Este archivo puede ser un archivo .nfo, .xml, .txt o .cab.

<computername> Especifica el nombre del equipo local o de destino. Puede ser un nombre UNC,
una dirección IP o un nombre de equipo completo.

<categoryID> Especifica el identificador del elemento de categoría. Puede obtener el


identificador de categoría mediante /showcategories.

/pch Muestra la vista Historial del sistema en la herramienta Información del


sistema.

/nfo Guarda el archivo exportado como un archivo .nfo. Si el nombre del archivo
que se especifica en path no termina en una extensión .nfo, la extensión .nfo
se añade automáticamente al nombre del archivo.
Parámetro Descripción

/report Guarda el archivo en path como un archivo de texto. El nombre de archivo se


guarda exactamente como aparece en path. La extensión .txt no se anexa al
archivo a menos que se especifique en la ruta de acceso.

/computer Inicia la herramienta Información del sistema para el equipo remoto


especificado. Debe tener los permisos adecuados para acceder al equipo
remoto.

/showcategories Inicia la herramienta de Información del sistema mostrando todos los id. de
categoría disponibles, en lugar de mostrar los nombres descriptivos o
localizados. Por ejemplo, la categoría Entorno de software se muestra como la
categoría SWEnv.

/categoría Inicia Información del sistema con la categoría especificada seleccionada. Use
/showcategories para mostrar una lista de identificadores de categoría
disponibles.

/categories Inicia Información del sistema mostrando solo la categoría o categorías


especificadas. También limita la salida a la categoría o categorías
seleccionadas. Use /showcategories para mostrar una lista de identificadores
de categoría disponibles.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para enumerar los identificadores de categoría disponibles, escriba:

msinfo32 /showcategories

Para iniciar la herramienta Información del sistema con toda la información disponible
mostrada, excepto Módulos cargados, escriba:

msinfo32 /categories +all -loadedmodules

Para mostrar la información Resumen del sistema y crear un archivo .nfo llamado
syssum.nfo, que contiene información de la categoría Resumen del sistema, escriba:

msinfo32 /nfo syssum.nfo /categories +systemsummary


Para mostrar información sobre conflictos de recursos y crear un archivo .nfo llamado
conflicts.nfo, que contiene información sobre los conflictos de recursos, escriba:

msinfo32 /nfo conflicts.nfo /categories


+componentsproblemdevices+resourcesconflicts+resourcesforcedhardware

Vínculos relacionados
Clave de sintaxis de línea de comandos
mstsc
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Mstsc.exe crea conexiones a servidores host de sesión de escritorio remoto o a otros


equipos remotos, y edita un archivo de configuración existente de Conexión a escritorio
remoto (.rdp).

Sintaxis

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 Descripción

<connectionfile> Especifica el nombre de un archivo .rdp para la conexión.

/v: <server>[:<port>] Especifica el equipo remoto y, opcionalmente, el número de puerto al que


quiere conectarse.

/g: <gateway> Especifica el servidor de puerta de enlace de escritorio remoto que se va a


usar para la conexión. Este parámetro solo se lee si el equipo del punto
de conexión se especifica con /v.

/admin Le conecta a una sesión para administrar el servidor.

/f Inicia Conexión a Escritorio remoto en modo de pantalla completa.

/w: <width> Especifica el ancho de la ventana Conexión a escritorio remoto.

/h: <height> Especifica el alto de la ventana Conexión a Escritorio remoto.

/public Ejecuta la Conexión a Escritorio remoto en modo público. En el modo


público, las contraseñas y los mapas de bits no se almacenan en caché.
Parámetro Descripción

/multimon Configura el diseño del monitor de sesión de Servicios de escritorio


remoto para que sea idéntico a la configuración actual del lado cliente.

/l Enumera el monitor asociado al equipo local y el id. asociado a cada


monitor. El id. de monitor se puede usar para rellenar la configuración del
archivo RDP de monitores seleccionado.

/edit Abre el archivo de conexión .rdp especificado para su modificación.


<connectionfile>

/restrictedAdmin Este modo no enviará sus credenciales al equipo remoto, que puede
protegerle si se conecta a un dispositivo en peligro. Es posible que otras
conexiones realizadas desde el equipo remoto no se autentiquen en otros
equipos, lo que afecta a la funcionalidad y compatibilidad de la
aplicación. El parámetro /admin está implícito.

/remoteGuard Este modo impide que las credenciales se envíen al equipo remoto, lo
que puede ayudar a proteger las credenciales si se conecta a un
dispositivo en peligro. A diferencia del modo Administrador restringido,
Remote Guard también admite conexiones realizadas desde el equipo
remoto redirigiendo todas las solicitudes de vuelta al dispositivo.

/prompt Le pide sus credenciales al conectarse al equipo remoto.

/shadow: <sessionID> Especifica el identificador de la sesión que se va a controlar en remoto.

/control Permite el control de la sesión al controlar en remoto.

/noConsentPrompt Permite el control remoto sin consentimiento del usuario.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Default.rdp se almacena para cada usuario como un archivo oculto en la carpeta


Documentos del usuario.

Los archivos .rdp creados por el usuario se guardan de forma predeterminada en


la carpeta Documentos del usuario, pero se pueden guardar en cualquier lugar.

Para abarcar varios monitores, estos deben tener la misma resolución y estar
alineados horizontalmente (es decir, uno al lado del otro). Actualmente no hay
soporte para extender múltiples monitores verticalmente en el sistema cliente.

Ejemplos
Para conectarse a una sesión en modo de pantalla completa, escriba:

mstsc /f

mstsc /v:computer1 /f

Para asignar el ancho o alto, escriba:

mstsc /v:computer1 /w:1920 /h:1080

Para abrir un archivo denominado filename.rdp para su edición, escriba:

mstsc /edit filename.rdp

Vínculos relacionados
Clave de sintaxis de línea de comandos
nbtstat
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra estadísticas del protocolo NetBIOS a través de TCP/IP (NetBT), tablas de


nombres NetBIOS para el equipo local y equipos remotos, y la caché de nombres
NetBIOS. Este comando también permite actualizar la caché de nombres NetBIOS y los
nombres registrados con el Servicio de nombres Internet de Windows (WINS). Si se usa
sin parámetros, este comando muestra información de la Ayuda.

Este comando solo está disponible si el protocolo de Internet (TCP/IP) está instalado
como componente en las propiedades de un adaptador de red en conexiones de red.

Sintaxis

nbtstat [/a <remotename>] [/A <IPaddress>] [/c] [/n] [/r] [/R] [/RR] [/s]
[/S] [<interval>]

Parámetros

Parámetro Descripción

/a Muestra la tabla de nombres NetBIOS de un equipo remoto, donde remotename


<remotename> es el nombre de equipo NetBIOS del equipo remoto. La tabla de nombres
NetBIOS es la lista de nombres NetBIOS correspondientes a las aplicaciones
NetBIOS que se ejecutan en ese equipo.

/A Muestra la tabla de nombres NetBIOS de un equipo remoto, especificado por la


<IPaddress> dirección IP (en notación decimal con puntos) del equipo remoto.

/C Muestra el contenido de la caché de nombres NetBIOS, la tabla de nombres


NetBIOS y sus direcciones IP resueltas.

/n Muestra la tabla de nombres NetBIOS del equipo local. El estado de registrado


indica que el nombre se registra mediante difusión o con un servidor WINS.

/r Muestra estadísticas de resolución de nombres NetBIOS.


Parámetro Descripción

/R Purga el contenido de la caché de nombres NetBIOS y, luego, vuelve a cargar las


entradas etiquetadas previamente del archivo Lmhosts.

/RR Libera y actualiza los nombres NetBIOS para el equipo local que está registrado
con servidores WINS.

/s Muestra sesiones de cliente y servidor NetBIOS, intentando convertir la dirección


IP de destino en un nombre.

/S Muestra sesiones de cliente y servidor NetBIOS, enumerando los equipos remotos


solo por dirección IP de destino.

<interval> Muestra las estadísticas seleccionadas, pausando el número de segundos que se


especifica en el intervalo entre cada visualización. Presione CTRL+C para dejar de
mostrar estadísticas. Si se omite este parámetro, nbtstat imprime la información
de configuración actual solo una vez.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Los parámetros de la línea de comandos nbtstat distinguen las mayúsculas de las


minúsculas.

Los encabezados de columna generados por el comando nbtstat incluyen:

Dirección Descripción

Entrada Número de bytes recibidos.

Resultados Número de bytes enviados.

Entrada o Si la conexión procede del equipo (saliente) o de otro equipo al equipo local
salida (entrante).

Life El tiempo restante en que residirá una entrada de caché de tabla de nombres
antes de purgarla.

Nombre El nombre netBIOS local asociado a la conexión.


local

Host El nombre o la dirección IP asociados con el equipo remoto.


remoto
Dirección Descripción

<03> El último byte de un nombre NetBIOS convertido a formato hexadecimal.


Cada nombre NetBIOS tiene una longitud de 16 caracteres. Este último byte
suele tener una importancia especial, ya que el mismo nombre puede existir
varias veces en un equipo y solo diferenciarse en el último byte. Por ejemplo,
<20> es un espacio en texto ASCII.

tipo Tipo de nombre. Un nombre puede ser un nombre único o un nombre de


grupo.

Estado Si el servicio NetBIOS del equipo remoto está en ejecución (registrado) o si un


nombre de equipo duplicado registró el mismo servicio (Conflicto).

State El estado de las conexiones NetBIOS.

Los estados de conexión NetBIOS posibles incluyen:

State Descripción

Conectado Se estableció una sesión.

escuchar Este punto de conexión está disponible para una conexión entrante.

Inactivo Este punto de conexión se abrió, pero no puede recibir conexiones.

Connecting Una sesión se encuentra en la fase de conexión y se resuelve la


asignación de direcciones de nombre a IP del destino.

Aceptación Actualmente, se está aceptando una sesión entrante y se conectará en


breve.

Reconectando Una sesión está intentando volver a conectarse (no se pudo conectar en
el primer intento).

Salida Una sesión está en la fase de conexión y la conexión TCP se está creando
actualmente.

Entrada Una sesión de entrada se encuentra en la fase de conexión.

Desconectando Una sesión se encuentra en el proceso de desconexión.

Escenario El equipo local ha emitido una desconexión y está esperando la


desconectado confirmación del sistema remoto.

Ejemplos
Para mostrar la tabla de nombres NetBIOS del equipo remoto con el nombre de equipo
NetBIOS de CORP07, escriba:
nbtstat /a CORP07

Para mostrar la tabla de nombres NetBIOS del equipo remoto asignado a la dirección IP
de 10.0.0.99, escriba:

nbtstat /A 10.0.0.99

Para mostrar la tabla de nombres NetBIOS del equipo local, escriba:

nbtstat /n

Para mostrar el contenido de la caché de nombres NetBIOS del equipo local, escriba:

nbtstat /c

Para purgar la caché de nombres NetBIOS y volver a cargar las entradas etiquetadas
previamente en el archivo Lmhosts local, escriba:

nbtstat /R

Para liberar los nombres NetBIOS registrados en el servidor WINS y volver a registrarlos,
escriba:

nbtstat /RR

Para mostrar las estadísticas de sesión de NetBIOS por dirección IP cada cinco
segundos, escriba:

nbtstat /S 5
Vínculos relacionados
Clave de sintaxis de línea de comandos
netcfg
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Instala el Entorno de preinstalación de Windows (WinPE), una versión ligera de Windows


que se usa para implementar estaciones de trabajo.

Sintaxis

netcfg [/v] [/e] [/winpe] [/l ] /c /i

Parámetros

Parámetro Descripción

/v Se ejecuta en modo detallado.

/e Usa variables de entorno de mantenimiento durante la instalación y desinstalación.

/winpe Instala TCP/IP, NetBIOS y Microsoft Client para el entorno de preinstalación de


Windows (WinPE).

/l Proporciona la ubicación del archivo INF.

/C Proporciona la clase del componente que se va a instalar; protocolo, servicio o


cliente.

/i <comp- Proporciona el identificador del componente.


ID>

/s Proporciona el tipo de componentes que se van a mostrar, incluidos \ta para


adaptadores o n para componentes net.

/b Muestra las rutas de acceso de enlace cuando va seguido de una cadena que
contiene el nombre de la ruta de acceso.

/q <comp- Consulta si está instalado el identificador del componente


ID>
Parámetro Descripción

/u <comp- Desinstala el identificador del componente.


ID>

/m Genera la asignación de enlace a NetworkBindingMap.txt en el directorio actual. Si


se usa con /v también se mostrará el mapa de enlace a la consola.

/d Realiza una limpieza en todos los dispositivos de red. Esto requerirá un reinicio.

/x Realiza una limpieza en los dispositivos de red en la que omite los que no tienen
nombres de objetos físicos. Esto requerirá un reinicio.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para instalar el protocolo example con c:\oemdir\example.inf, escriba:

netcfg /l c:\oemdir\example.inf /c p /i example

Para instalar el servicio MS_Server, escriba:

netcfg /c s /i MS_Server

Para instalar TCP/IP, NetBIOS y Microsoft Client para el entorno de preinstalación de


Windows, escriba:

netcfg /v /winpe

Para mostrar si el componente MS_IPX está instalado, escriba:

netcfg /q MS_IPX

Para desinstalar el componente MS_IPX, escriba:


netcfg /u MS_IPX

Para mostrar todos los componentes net instalados, escriba:

netcfg /s n

Para mostrar las rutas de acceso de enlace que contienen MS_TCPIP, escriba:

netcfg /b ms_tcpip

Vínculos relacionados
Clave de sintaxis de línea de comandos
net print
Artículo • 06/04/2023

) Importante

Este comando está en desuso. Sin embargo, puede realizar muchas de las mismas
tareas usando el comando Prnjobs, Instrumental de administración de Windows
(WMI), PrintManagement en Powershell, o Recursos de script para profesionales
de TI .

Muestra información sobre una cola de impresora especificada o un trabajo de


impresión especificado, o controla un trabajo de impresión especificado.

Sintaxis

net print {\\<computername>\<sharename> | \\<computername> <jobnumber>


[/hold | /release | /delete]} [help]

Parámetros

Parámetros Descripción

\\ Especifica (por nombre) el equipo y la cola de impresión sobre los que desea
<computername>\ mostrar información.
<sharename>

\\ Especifica (por nombre) el equipo que hospeda el trabajo de impresión que


<computername> desea controlar. Si no especifica un equipo, se asume el equipo local. Requiere
el parámetro <jobnumber> .

<jobnumber> Especifica el número del trabajo de impresión que desea controlar. Este
número lo asigna el equipo que aloja la cola de impresión a la que se envía el
trabajo de impresión. Después de que un equipo asigne un número a un
trabajo de impresión, ese número no se asigna a ningún otro trabajo de
impresión en ninguna cola hospedada por ese equipo. Requerido cuando se
usa el parámetro \\<computername> .
Parámetros Descripción

[/hold | Especifica la acción que se va a realizar con el trabajo de impresión. Si


/release | especifica un número de trabajo, pero no especifica ninguna acción, se
/delete] mostrará información sobre el trabajo de impresión.
/hold: retrasa el trabajo, lo que permite que otros trabajos de impresión
lo omitan hasta que se libere.
/release: libera un trabajo de impresión que se ha retrasado.
/delete: quita un trabajo de impresión de una cola de impresión.

help Muestra la ayuda en el símbolo del sistema.

Comentarios

El comando net print\\<computername> muestra información sobre los trabajos de


impresión en una cola de impresión compartida. A continuación se muestra un
ejemplo de informe de todos los trabajos de impresión en cola para una impresora
compartida denominada 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

A continuación se muestra un ejemplo de un informe para un trabajo de


impresión:

Job # 35
Status Waiting
Size 3096
remark
Submitting user USER2
Notify USER2
Job data type
Job parameters
additional info

Ejemplos
Para enumerar el contenido de la cola de impresión de Dotmatrix en el equipo
\Production, escriba:

net print \\Production\Dotmatrix

Para mostrar información sobre el trabajo número 35} en el equipo \Production, escriba:

net print \\Production 35

Para retrasar el número de trabajo 263 en el equipo de \Production, escriba:

net print \\Production 263 /hold

Para liberar el trabajo número 263 en el equipo \Production, escriba:

net print \\Production 263 /release

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia del comando print

Comando prnjobs

Instrumental de administración de Windows (WMI)

PrintManagement en PowerShell

Recursos de scripts para profesionales de TI


netsh
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016

La utilidad de scripting de línea de comandos Network Shell que le permite, de forma


local o remota, visualizar o modificar la configuración de red de un equipo que se esté
ejecutando en ese momento. Puede iniciar esta utilidad en el símbolo del sistema o en
Windows PowerShell.

Sintaxis

netsh [-a <Aliasfile>][-c <Context>][-r <Remotecomputer>][-u [<domainname>\


<username>][-p <Password> | [{<NetshCommand> | -f <scriptfile>}]

Parámetros

Parámetro Descripción

-a <Aliasfile> Especifica que se le devuelva al indicador de netsh después de ejecutar


Aliasfile y el nombre del archivo de texto que contiene uno o más comandos
netsh.

-c <Context> Especifica que netsh entre en el contexto netsh especificado y el contexto


netsh en el que debe entrar.

-r Especifica el equipo remoto a configurar.


<Remotecomputer> Importante: Si usa este parámetro, debe asegurarse de que el servicio
Registro remoto se ejecuta en el equipo remoto. Si no está en ejecución,
Windows muestra un mensaje de error "No se encontró la ruta de red".

-u <domainname>\ Especifica el dominio y el nombre de la cuenta de usuario que se van a usar


<username> mientras se ejecuta el comando netsh en una cuenta de usuario. Si omite el
dominio, el dominio local se usa de forma predeterminada.

-p <Password> Especifica la contraseña de la cuenta de usuario especificada por el


parámetro -u <username> .

<NetshCommand> Especifica el comando netsh que se va a ejecutar.

-f <scriptfile> Sale del comando netsh después de ejecutar el archivo de script especificado.
Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Si especificas -r seguido de otro comando, netsh ejecuta el comando en el equipo


remoto y, luego, vuelve al símbolo del sistema Cmd.exe. Si especifica -r sin otro
comando, netsh se abre en modo remoto. El proceso es similar al uso de set
machine en el símbolo del sistema de netsh. Cuando usa -r, establece el equipo de
destino para la instancia actual de netsh únicamente. Después de salir de netsh y
volver a entrar, el equipo de destino se restablece como equipo local. Puedes
ejecutar comandos netsh en un equipo remoto si especificas un nombre de equipo
almacenado en WINS, un nombre de UNC, un nombre de Internet que deba
resolver el servidor DNS, o una dirección IP.

Si su valor de cadena contiene espacios entre caracteres, deberá encerrar el valor


de cadena entre comillas. Por ejemplo: -r "contoso remote device"

Vínculos relacionados
Clave de sintaxis de línea de comandos
Shell de red (netsh)
netstat
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra las conexiones TCP activas, los puertos en los que escucha el equipo, las
estadísticas de Ethernet, la tabla de enrutamiento IP, las estadísticas IPv4 (para los
protocolos IP, ICMP, TCP y UDP) y las estadísticas de IPv6 (para los protocolos IPv6,
ICMPv6, TCP a través de IPv6 y UDP a través de IPv6). Se usa sin parámetros; este
comando muestra conexiones TCP activas.

) Importante

Este comando solo está disponible si el protocolo de Internet (TCP/IP) está


instalado como componente en las propiedades de un adaptador de red en
conexiones de red.

Sintaxis

netstat [-a] [-b] [-e] [-n] [-o] [-p <Protocol>] [-r] [-s] [<interval>]

Parámetros

Parámetro Descripción

-a Muestra todas las conexiones TCP activas y los puertos TCP y UDP en los que
escucha el equipo.

-b Muestra el ejecutable implicado en la creación de cada conexión o puerto de


escucha. En algunos casos, los ejecutables conocidos hospedan varios componentes
independientes y, en estos casos, se muestra la secuencia de componentes
implicados en la creación de la conexión o el puerto de escucha. En este caso, el
nombre del ejecutable se encuentra en la parte inferior entre []. En la parte superior
se encuentra el componente al que llamó, y así sucesivamente hasta que se alcanzó
el TCP/IP. Tenga en cuenta que esta opción puede llevar mucho tiempo y producirá
un error a menos que cuente con los permisos suficientes.
Parámetro Descripción

-E Muestra estadísticas Ethernet, como el número de bytes y paquetes enviados y


recibidos. Este parámetro se puede combinar con -s.

-n Muestra las conexiones TCP activas, pero las direcciones y los números de puerto se
expresan en forma de número y no se intenta determinar los nombres.

-o Muestra las conexiones TCP activas e incluye el identificador de proceso (PID) para
cada conexión. Puede encontrar la aplicación en función del PID en la pestaña
Procesos del Administrador de tareas de Windows. Este parámetro se puede
combinar con -a, -n y -p.

-p Muestra las conexiones para el protocolo especificado por Protocol. En este caso, el
<Protocol> Protocol puede ser tcp, udp, tcpv6 o udpv6. Si este parámetro se usa con -s para
mostrar estadísticas por protocolo, Protocol puede ser tcp, udp, icmp, ip, tcpv6,
udpv6, icmpv6 o ipv6.

-S Muestra las estadísticas por protocolo. De forma predeterminada, se muestran


estadísticas para los protocolos TCP, UDP, ICMP e IP. Si se instala el protocolo IPv6,
se muestran estadísticas para los protocolos TCP a través de IPv6, UDP a través de
IPv6, ICMPv6 e IPv6. El parámetro -p se puede usar para especificar un conjunto de
protocolos.

-r Muestra el contenido de la tabla de enrutamiento de IP. Esto equivale al comando


route print.

<interval> Vuelve a mostrar la información seleccionada cada x segundos de un intervalo.


Pulse CTRL+C para evitar que se vuelva a mostrar la información. Si se omite este
parámetro, este comando imprime la información seleccionada una sola vez.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
El comando netstat proporciona estadísticas para los siguientes parámetros:

Parámetro Descripción

Proto Nombre del protocolo (TCP o UDP).

Local La dirección IP del equipo local y el número de puerto que se usa. El nombre
address del equipo local que corresponde a la dirección IP y el nombre del puerto se
(Dirección muestran a menos que se especifique el parámetro -n. Si aún no se ha
local) establecido el puerto, el número de puerto se muestra como un asterisco (*).
Parámetro Descripción

Dirección La dirección IP y el número de puerto del equipo remoto al que está


externa conectado el socket. Los nombres que corresponden a la dirección IP y el
puerto se muestran a menos que se especifique el parámetro -n. Si aún no se
ha establecido el puerto, el número de puerto se muestra como un asterisco
(*).

State Indica el estado de una conexión TCP, donde se incluyen:


CLOSE_WAIT
CLOSED
ESTABLISHED
FIN_WAIT_1
FIN_WAIT_2
LAST_ACK
LISTEN
SYN_RECEIVED
SYN_SEND
TIMED_WAIT

Ejemplos
Para mostrar tanto las estadísticas Ethernet como las estadísticas de todos los
protocolos, escriba:

netstat -e -s

Para mostrar solo las estadísticas de los protocolos TCP y UDP, escriba:

netstat -s -p tcp udp

Para mostrar las conexiones TCP activas y los identificadores de proceso cada 5
segundos, escriba:

netstat -o 5

Para mostrar las conexiones TCP activas y los identificadores de proceso mediante
formato numérico, escriba:
netstat -n -o

Vínculos relacionados
Clave de sintaxis de línea de comandos
nfsadmin
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Una utilidad de línea de comandos que administra el servidor para NFS o el cliente para
NFS en el equipo local o remoto que ejecuta Servicios Microsoft para el sistema de
archivos de red (NFS). Si se usa sin parámetros, el servidor nfsadmin muestra el servidor
actual para los ajustes de configuración de NFS y el cliente nfsadmin muestra el cliente
actual para los ajustes de configuración de NFS.

Sintaxis

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 generales

Parámetro Descripción
Parámetro Descripción

computername Especifica el equipo remoto que desea administrar. Puede especificar el equipo
mediante un nombre del Servicio de nombres Internet de Windows (WINS), un
nombre del servicio de nombres de dominio (DNS) o una dirección del
protocolo de Internet (IP).

-u Username Especifica el nombre del usuario cuyas credenciales se van a usar. Es posible
que sea necesario agregar el nombre de dominio al nombre de usuario, con el
formato dominio\nombreDeUsuario.

-p Password Especifica la contraseña del usuario especificado con la opción -u. Si se


especifica la opción -u, pero se omite la opción -p, se solicita la contraseña del
usuario.

Servidor para parámetros relacionados con NFS

Parámetro Descripción

-l Enumera todos los bloqueos mantenidos por los clientes.

-r {client|all} Libera los bloqueos mantenidos por un cliente o, si se especifican todos,


por todos los clientes.

start Inicia el servicio Servidor para NFS.

stop Detiene el servicio Servidor para NFS.

config Especifica la configuración general del servidor para NFS. Debe


proporcionar al menos una de las siguientes opciones con el argumento
del comando config:

mapsvr= <server> : establece el servidor como servidor de


asignación de nombres de usuario para el servidor para NFS.
Aunque esta opción sigue siendo compatible con versiones
anteriores, debe usar la utilidad sfuadmin en su lugar.
auditlocation= {eventlog|file|both|none} : especifica si se auditarán
los eventos y dónde se registrarán los eventos. Se requiere uno de
los argumentos siguientes:
eventlog: especifica que los eventos auditados solo se
registrarán en el registro de aplicaciones del Visor de eventos.
file: especifica que los eventos auditados solo se registrarán en el
archivo especificado por config fname .
both: especifica que los eventos auditados se registrarán en el
registro de aplicaciones del Visor de eventos, así como en el
archivo especificado por config fname .
none: especifica que los eventos no se auditan.
fname= <file> : establece el archivo especificado por el archivo
como archivo de auditoría. El valor predeterminado es
Parámetro Descripción

%sfudir%\log\nfssvr.log.
fsize= <size> : establece el tamaño como el tamaño máximo en
megabytes del archivo de auditoría. El tamaño máximo
predeterminado es 7 MB.
audit=[+|-]mount [+|-]read [+|-]write [+|-]create [+|-]delete
[+|-]locking [+|-]all : especifica los eventos que se van a registrar.
Para empezar a registrar un evento, escriba un signo más (+) antes
del nombre del evento; para detener el registro de un evento,
escriba un signo menos (-) antes del nombre del evento. Si se omite
el signo, se asume el signo +. No use todos con ningún otro
nombre de evento.
lockperiod= <seconds> : especifica el número de segundos que el
servidor para NFS esperará a reclamar bloqueos después de que se
haya perdido y se haya vuelto a restablecer una conexión con el
servidor para NFS o después de que se haya reiniciado el servicio
del servidor para NFS.
portmapprotocol= {TCP|UDP|TCP+UDP} : especifica qué protocolos de
transporte admite Portmap. La configuración predeterminada es
TCP+UDP.
mountprotocol= {TCP|UDP|TCP+UDP} : especifica qué protocolos de
transporte admite el montaje. La configuración predeterminada es
TCP+UDP.
nfsprotocol= {TCP|UDP|TCP+UDP} : especifica qué protocolos de
transporte admite el sistema de archivos de red (NFS). La
configuración predeterminada es TCP+UDP
nlmprotocol= {TCP|UDP|TCP+UDP} : especifica qué protocolos de
transporte admite Network Lock Manager (NLM). La configuración
predeterminada es TCP+UDP.
nsmprotocol= {TCP|UDP|TCP+UDP} : especifica qué protocolos de
transporte admite el Administrador de estado de red (NSM). La
configuración predeterminada es TCP+UDP.
enableV3= {yes|no} : especifica si se admitirán los protocolos NFS
versión 3. El valor predeterminado es sí.
renewauth= {yes|no} : especifica si es necesario volver a autenticar
las conexiones de cliente después del período especificado por
config renewauthinterval. La configuración predeterminada es no.
renewauthinterval= <seconds> : especifica el número de segundos
que transcurren antes de que se obligue a un cliente a volver a
autenticarse si se establece config renewauth en sí. El valor
predeterminado es 600 (segundos).
dircache= <size> : especifica el tamaño en kilobytes de la caché del
directorio. El número especificado como tamaño debe ser un
múltiplo de 4 entre 4 y 128. El tamaño predeterminado de la caché
de directorios es de 128 KB.
translationfile= <file> : especifica un archivo que contiene
información de asignación para reemplazar caracteres en los
nombres de los archivos al moverlos de sistemas de archivos
Parámetro Descripción

basados en Windows a basados en UNIX. Si no se especifica el


archivo, la traducción de caracteres de nombre de archivo está
deshabilitada. Si se cambia el valor de translationfile, debe reiniciar
el servidor para que el cambio surta efecto.
dotfileshidden= {yes|no} : especifica si los archivos con nombres
que comienzan por un punto (.) se marcan como ocultos en el
sistema de archivos de Windows y, por tanto, se ocultan de los
clientes NFS. La configuración predeterminada es no.
casesensitivelookups= {yes|no} : especifica si las búsquedas de
directorio distinguen mayúsculas de minúsculas (requieren
coincidencia exacta de mayúsculas y minúsculas).

Además, debe deshabilitar la ausencia de distinción entre


mayúsculas y minúsculas del kernel de Windows para que el
servidor para NFS admita los nombres de archivo con distinción
entre mayúsculas y minúsculas. Para admitir la distinción entre
mayúsculas y minúsculas, cambie el valor DWord de la clave del
Registro, HKLM\SYSTEM\CurrentControlSet\Control\Session
Manager\kernel , a 0.
ntfscase= {lower|upper|preserve} : especifica si las mayúsculas y
minúsculas de los nombres de los archivos del sistema de archivos
NTFS se devolverán en minúsculas, mayúsculas o en el formulario
almacenado en el directorio. La configuración predeterminada es
conservar. Esta configuración no se puede cambiar si
casesensitivelookups se fija en sí.

creategroup <name> Crea un nuevo grupo de clientes, con lo que se le asigna el nombre
especificado.

listgroups Muestra los nombres de todos los grupos de clientes.

deletegroup <name> Quita el grupo de clientes especificado por nombre.

renamegroup Cambia el nombre del grupo de clientes especificado de oldname a


<oldname> <newname> newname.

addmembers Agrega un host al grupo de clientes especificado por nombre.


<hostname>[...]

listmembers <name> Enumera los equipos host en el grupo de clientes especificado por
nombre.

deletemembers Quita el cliente especificado por host del grupo de clientes especificado
<hostname> por grupo.
<groupname>[...]

Cliente para parámetros relacionados con NFS


Parámetro Descripción

start Inicia el cliente para el servicio NFS.

stop Detiene el cliente para el servicio NFS.

config Especifica la configuración general del cliente para NFS. Debe proporcionar al
menos una de las siguientes opciones con el argumento del comando config:

fileaccess= <mode> : especifica el modo de permiso predeterminado para los


archivos creados en los servidores del sistema de archivos de red (NFS). El
argumento mode consta de un número de tres dígitos, de 0 a 7 (inclusive),
que representa los permisos predeterminados concedidos al usuario, al grupo
y a otros. Los dígitos se traducen en permisos de estilo UNIX de la siguiente
manera: 0=ninguno, 1=x (ejecución), 2=w (solo escritura), 3=wx (escritura y
ejecución), 4=r (solo lectura), 5=rx (lectura y ejecución), 6=rw (lectura y
escritura) y 7=rwx (lectura, escritura y ejecución). Por ejemplo, fileaccess=750
proporciona permisos de lectura, escritura y ejecución al propietario, permisos
de lectura y ejecución para el grupo y ningún permiso de acceso a otros
usuarios.
mapsvr= <server> : establece el servidor como el servidor de asignación de
nombres de usuario para el cliente para NFS. Aunque esta opción sigue
siendo compatible con versiones anteriores, debe usar la utilidad sfuadmin en
su lugar.
mtype= {hard|soft} : especifica el tipo de montaje predeterminado. En el caso
de un montaje forzado, el cliente para NFS sigue reintentando un RPC
erróneo hasta que se realiza correctamente. Para un montaje flexible, el
cliente para NFS devuelve un error en la aplicación que realiza la llamada
después de reintentar la llamada al número de veces especificado por la
opción de reintento.
retry= <number> : especifica el número de veces que se intenta realizar una
conexión para un montaje flexible. Este valor debe ser de 1 a 10, ambos
incluidos. El valor predeterminado es 1.
timeout= <seconds> : especifica el número de segundos que se esperará a una
conexión (llamada a procedimiento remoto). Este valor debe ser 0,8, 0,9 o un
número entero comprendido entre 1 y 60, ambos incluidos. El valor
predeterminado es 0,8.
protocol= {TCP|UDP|TCP+UDP} : especifica qué protocolos de transporte admite
el cliente. La configuración predeterminada es TCP+UDP.
rsize= <size> : especifica el tamaño, en kilobytes, del búfer de lectura. Este
valor puede ser 0,5, 1, 2, 4, 8, 16 o 32. El valor predeterminado es 32.
wsize= <size> : especifica el tamaño, en kilobytes, del búfer de escritura. Este
valor puede ser 0,5, 1, 2, 4, 8, 16 o 32. El valor predeterminado es 32.
perf=default: restaura la siguiente configuración de rendimiento en valores
predeterminados, mtype, retry, timeout, rsize o wsize.

Ejemplos
Para detener el servidor para NFS o el cliente para NFS, escriba:

nfsadmin server stop


nfsadmin client stop

Para iniciar el servidor para NFS o el cliente para NFS, escriba:

nfsadmin server start


nfsadmin client start

Para establecer que el servidor para NFS no distinga entre mayúsculas y minúsculas,
escriba:

nfsadmin server config casesensitive=no

Para establecer que el cliente para NFS distinga entre mayúsculas y minúsculas, escriba:

nfsadmin client config casesensitive=yes

Para mostrar todas las opciones del servidor actual para NFS o cliente para NFS, escriba:

nfsadmin server config


nfsadmin client config

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de cmdlets de NFS


nfsshare
Artículo • 06/04/2023

Controla los recursos compartidos del Sistema de archivos de red (NFS). Si se usa sin
parámetros, este comando muestra todos los recursos compartidos del Sistema de
archivos de red (NFS) exportados por el Servidor para NFS.

Sintaxis

nfsshare <sharename>=<drive:path> [-o <option=value>...]


nfsshare {<sharename> | <drive>:<path> | * } /delete

Parámetros

Parámetro Descripción

-o anon= {yes|no} Especifica si los usuarios anónimos (sin asignar) tienen acceso al
directorio compartido.

-o rw= [<host>[: Proporciona acceso de lectura y escritura al directorio compartido por


<host>]...] parte de los hosts o grupos de clientes especificados por host. Debe
separar los nombres de host y grupo con dos puntos (:). Si no se
especifica host, todos los host y grupos de clientes (excepto los
especificados con la opción ro) obtienen acceso de lectura y escritura.
Si no se establece ni la opción ro ni la rw, todos los clientes tendrán
acceso de lectura y escritura al directorio compartido.

-o ro= [<host>[: Proporciona acceso de solo lectura al directorio compartido por parte
<host>]...] de los host o grupos de clientes especificados por host. Debe separar
los nombres de host y grupo con dos puntos (:). Si no se especifica
host, todos los clientes (excepto los especificados con la opción rw)
obtienen acceso de solo lectura. Si se establece la opción ro para uno
o varios clientes, pero no se establece la opción rw, solo los clientes
especificados con la opción ro tendrán acceso al directorio
compartido.
Parámetro Descripción

-o encoding= {euc- Especifica la codificación de idioma a configurar en un recurso


jp|euc-tw|euc-kr|shift- compartido de NFS. Solo puede usar un idioma en el recurso
jis|Big5|Ksc5601|Gb2312- compartido. Este valor puede incluir cualquiera de los siguientes
80|Ansi) valores:
euc-jp: japonés
euc-tw: chino
euc-kr: coreano
shift-jis: japonés
Big5: chino
Ksc5601: coreano
Gb2312-80: chino simplificado
Ansi: codificado en ANSI

-o anongid= <gid> Especifica que los usuarios anónimos (sin asignar) tendrán acceso al
directorio compartido mediante el uso de gid como identificador de
grupo (GID). El valor predeterminado es -2. El GID anónimo se usa al
notificar quién es el propietario de un archivo de un usuario sin
asignar, incluso si el acceso anónimo está deshabilitado.

-o anonuid= <uid> Especifica que los usuarios anónimos (sin asignar) tendrán acceso al
directorio compartido mediante el uso de uid como identificador de
usuario (UID). El valor predeterminado es -2. El UID anónimo se usa al
notificar quién es el propietario de un archivo de un usuario sin
asignar, incluso si el acceso anónimo está deshabilitado.

-o root= [<host>[: Proporciona acceso raíz al directorio compartido por parte de los
<host>]...] hosts o grupos de clientes especificados por host. Debe separar los
nombres de host y grupo con dos puntos (:). Si no se especifica host,
todos los clientes obtienen acceso raíz. Si no se establece la opción
root, ningún cliente tiene acceso raíz al directorio compartido.

/delete Si se especifica sharename o <drive>:<path> , este parámetro elimina


el recurso compartido especificado. Si se especifica un carácter
comodín (*), este parámetro elimina todos los recursos compartidos
de NFS.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si sharename es el único parámetro, este comando enumera las propiedades del
recurso compartido de NFS identificado por sharename.

Si se usan sharename y <drive>:<path> , este comando exporta la carpeta


identificada por <drive>:<path> como sharename. Si usa la opción /delete, la
carpeta especificada deja de estar disponible para los clientes NFS.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Servicios de referencia de comandos de sistema de archivos de red

Referencia de cmdlets de NFS


nfsstat
Artículo • 08/04/2023

Utilidad de línea de comandos que muestra información estadística sobre las llamadas
del Sistema de archivos de red (NFS) y llamada a procedimiento remoto (RPC). Si se usa
sin parámetros, este comando muestra todos los datos estadísticos sin restablecer nada.

Sintaxis

nfsstat [-c][-s][-n][-r][-z][-m]

Parámetros

Parámetro Descripción

-c Muestra solo las llamadas NFS y RPC del lado cliente y NFS enviadas y rechazadas
por el cliente. Para mostrar solo la información de NFS o RPC, combine esta marca
con el parámetro -n o -r.

-S Muestra solo las llamadas NFS y RPC del lado del servidor y NFS enviadas y
rechazadas por el servidor. Para mostrar solo la información de NFS o RPC, combine
esta marca con el parámetro -n o -r.

-M Muestra información sobre las marcas de montaje establecidas por opciones de


montaje, marcas de montaje internas en el sistema y otra información de montaje.

-n Muestra información de NFS para el cliente y el servidor. Para mostrar solo la


información del cliente o servidor NFS, combine esta bandera con el parámetro -c o
-s.

-r Muestra información de RPC para el cliente y el servidor. Para mostrar solo la


información del cliente o servidor RPC, combine esta bandera con el parámetro -c o
-s.

-Z Restablece las estadísticas de llamada. Esta marca solo está disponible para el
usuario raíz y se puede combinar con cualquiera de los demás parámetros para
restablecer determinados conjuntos de estadísticas después de mostrarlas.

Ejemplos
Para mostrar información sobre el número de llamadas RPC y NFS enviadas y
rechazadas por el cliente, escriba:

nfsstat -c

Para mostrar e imprimir la información relacionada con la llamada NFS del cliente,
escriba:

nfsstat -cn

Para mostrar la información relacionada con las llamadas RPC tanto para el cliente como
para el servidor, escriba:

nfsstat -r

Para mostrar información sobre el número de llamadas RPC y NFS recibidas y


rechazadas por el servidor, escriba:

nfsstat -s

Para restablecer a cero toda la información relacionada con las llamadas en el cliente y
el servidor, escriba:

nfsstat -z

Vínculos relacionados
Clave de sintaxis de línea de comandos

Servicios de referencia de comandos de sistema de archivos de red

Referencia de cmdlets de NFS


nlbmgr
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Configure y administre sus clústeres de equilibrio de carga de red y todos los hosts de
clúster desde un único equipo, usando el Administrador de equilibrio de carga de red.
También puede usar este comando para replicar la configuración del clúster en otros
hosts.

Puede iniciar el Administrador de equilibrio de carga de red desde la línea de comandos


usando el comando nlbmgr.exe, que se instala en la carpeta systemroot\System32.

Sintaxis

nlbmgr [/noping][/hostlist <filename>][/autorefresh <interval>][/help | /?]

Parámetros

Parámetro Descripción

/noping Evita que el Administrador de equilibrio de carga de red haga ping a los hosts
antes de intentar ponerse en contacto con ellos a través de Instrumental de
administración de Windows (WMI). Use esta opción si ha deshabilitado el
Protocolo de mensajes de control de Internet (ICMP) en todos los adaptadores de
red disponibles. Si el Administrador de equilibrio de carga de red intenta ponerse
en contacto con un host que no está disponible, experimentará un retraso al usar
esta opción.

/hostlist Carga los hosts especificados en el nombre de archivo en el Administrador de


<filename> equilibrio de carga de red.

/autorefresh Hace que el Administrador de equilibrio de carga de red actualice la información


<interval> sobre hosts y clústeres cada <interval> segundos. Si no se especifica ningún
intervalo, la información se actualiza cada 60 segundos.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.


Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de cmdlets de NetworkLoadBalancingClusters


nslookup
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información que puede usar para diagnosticar la infraestructura del Sistema de
nombres de dominio (DNS). Antes de usar esta herramienta, debe estar familiarizado
con el funcionamiento del DNS. La herramienta de línea de comandos nslookup solo
está disponible si ha instalado el protocolo TCP/IP.

Sintaxis

nslookup [exit | finger | help | ls | lserver | root | server | set | view]


[options]

Parámetros

Parámetro Descripción

nslookup exit Sale de la herramienta de línea de comandos nslookup.

nslookup Se conecta con el servidor de dedo en el equipo actual.


finger

nslookup help Muestra un breve resumen de los subcomandos.

nslookup ls Muestra información de un dominio DNS.

nslookup Cambia el servidor predeterminado al dominio DNS especificado.


lserver

nslookup root Cambia el servidor predeterminado al servidor para la raíz del espacio de
nombres de dominio DNS.

nslookup Cambia el servidor predeterminado al dominio DNS especificado.


server

nslookup set Cambia los valores de configuración que afectan a cómo funcionan las
búsquedas.
Parámetro Descripción

nslookup set Imprime los valores actuales de los valores de configuración.


all

nslookup set Cambia la clase de consulta. La clase especifica el grupo de protocolos de la


class información.

nslookup set Activa o desactiva el modo de depuración exhaustivo. Se imprimen todos los
d2 campos de cada paquete.

nslookup set Activa o desactiva el modo de depuración.


debug

nslookup set Cambia el nombre de dominio DNS predeterminado al nombre especificado.


domain

nslookup set Cambia el puerto predeterminado del servidor de nombres DNS TCP/UDP al
port valor especificado.

nslookup set Cambia el tipo de registro de recursos de la consulta.


querytype

nslookup set Indica al servidor de nombres DNS que consulte otros servidores si no tiene la
recurse información.

nslookup set Establece el número de reintentos.


retry

nslookup set Cambia el nombre del servidor raíz usado para las consultas.
root

nslookup set Anexa los nombres de dominio de DNS de la lista de búsqueda de dominios
search DNS a la solicitud hasta que se recibe una respuesta. Esto se aplica cuando el
conjunto y la solicitud de búsqueda contienen al menos un período, pero no
terminan con un período final.

nslookup set Cambia el nombre de dominio DNS predeterminado y la lista de búsqueda.


srchlist

nslookup set Cambia el número inicial de segundos para esperar una respuesta a una
timeout solicitud.

nslookup set Cambia el tipo de registro de recursos de la consulta.


type

nslookup set Especifica el uso o no de un circuito virtual al enviar solicitudes al servidor.


vc

nslookup view Ordena y enumera la salida de los comandos o subcomandos ls anteriores.


Comentarios
La herramienta de línea de comandos nslookup tiene dos modos: interactivo y no
interactivo.

Si necesita buscar solo un solo fragmento de datos o usa nslookup en scripts,


líneas de comandos o PowerShell, use el modo no interactivo. En el modo no
interactivo, también denominado modo de comandos, el primer parámetro de
la línea de comandos es el nombre o la dirección IP del equipo que quiere
buscar. El segundo parámetro es el nombre o la dirección IP de un servidor de
nombres DNS. Si omite el segundo argumento, nslookup usa el servidor de
nombres DNS predeterminado.

Si necesita buscar más de un fragmento de datos o establecer varias


configuraciones, puede usar el modo interactivo. Para especificar el modo
interactivo, escriba un guión (-) en lugar del primer parámetro de la línea de
comandos de nslookup. Para el segundo parámetro, escriba el nombre o la
dirección IP de un servidor de nombres DNS. Si omite el segundo argumento,
nslookup usa el servidor de nombres DNS predeterminado. También puede
invocar el modo interactivo si simplemente escribe nslookup en el símbolo del
sistema y, después, nombres o direcciones IP para buscar en la línea de
comandos interactiva.

Una vez que escriba nslookup - o nslookup solo, el símbolo del sistema cambia al
símbolo del sistema interactivo > . En el modo interactivo, puede hacer lo
siguiente:
Escribir nombres o direcciones IP, variables set y otras opciones en líneas
independientes.
Interrumpir los comandos interactivos en cualquier momento si presiona
CTRL+B.
Salir, si escribe exit .
Tratar un comando integrado como un nombre de equipo si lo precede de un
carácter de escape ( \ ). Un comando no reconocido se interpreta como un
nombre de equipo.

Si el equipo que quiere buscar es una dirección IP y la consulta es para un tipo de


registro de recursos A o PTR, se devuelve el nombre del equipo.

Si el equipo que quiere buscar es un nombre y no tiene un punto final, el nombre


de dominio DNS predeterminado se anexa al nombre. Este comportamiento
depende del estado de los siguientes subcomandos set: domain, srchlist, defname
y search.
Si se produce un error en la solicitud de búsqueda, la herramienta de línea de
comandos proporciona uno de los mensajes de error siguientes:

Mensaje de error Descripción

agotarse el El servidor no respondió a una solicitud después de un período de


tiempo de espera tiempo determinado y un número determinado de reintentos. Puede
establecer el período de tiempo de espera con el comando nslookup
set timeout. Puede establecer el número de reintentos con el comando
nslookup set retry.

Sin respuesta del No se ejecuta ningún servidor de nombres DNS en el equipo del
servidor servidor.

Ningún registro El servidor de nombres DNS no tiene registros de recursos del tipo de
consulta actual para el equipo, aunque el nombre del equipo es válido.
El tipo de consulta se especifica con el comando nslookup set
querytype.

Dominio El equipo o el nombre de dominio DNS no existen.


inexistente

La conexión No se pudo establecer la conexión con el servidor de nombres DNS o


rechazada o la el servidor de finger. Este error suele producirse con las solicitudes ls y
red no es finger.
accesible

Error de servidor El servidor de nombres DNS encontró una incoherencia interna en su


base de datos y no pudo devolver una respuesta válida.

Rechazado El servidor de nombres DNS rechazó atender la solicitud.

Error de formato El servidor de nombres DNS encontró que el paquete de solicitud no


tenía el formato adecuado. Puede indicar un error en nslookup.

Ejemplos
En el modo no interactivo de nslookup, se especifican parámetros y opciones en la línea
de comandos o script de Windows. En el modo interactivo, se especifican argumentos y
opciones en líneas independientes en el símbolo del sistema interactivo.

Modo no interactivo
En el modo no interactivo de nslookup, el primer parámetro es el equipo que se va a
buscar y el segundo parámetro es el servidor de nombres DNS que se va a usar. Si no
especifica un segundo parámetro, nslookup usa el servidor de nombres DNS
predeterminado. En los ejemplos siguientes se usa nslookup en modo no interactivo.

En el ejemplo siguiente se buscan las direcciones IP del nombre de dominio


mydomain.com en el servidor de nombres DNS en 1.1.1.1 :

Símbolo del sistema de Windows

nslookup mydomain.com 1.1.1.1

En el ejemplo siguiente se busca el nombre de dominio de la dirección IP 4.4.4.4


en el servidor de nombres DNS predeterminado:

Símbolo del sistema de Windows

nslookup 4.4.4.4

Para especificar opciones, puede usar nslookup -<option> . Por ejemplo, el


siguiente comando activa la opción debug de nslookup para obtener más
información sobre los paquetes enviados.

Símbolo del sistema de Windows

nslookup -debug mydomain.com

Para devolver determinados tipos de registros o información, use la opción -type=


<resourcerecordtype> . Por ejemplo, el siguiente comando devuelve solo los tipos
de registro IPv6:

Símbolo del sistema de Windows

nslookup -type=AAAA mydomain.com

Puede combinar opciones y consultas de tipo de registro de recursos en líneas de


comandos. En el ejemplo siguiente se habilita la salida de depuración, se
recuperan las direcciones IPv6 e IPv4, no se intenta usar el dominio de búsqueda,
se usa la búsqueda recursiva y se utiliza el servidor de búsqueda DNS 1.1.1.1:

Símbolo del sistema de Windows

nslookup -debug -type=A+AAAA -nosearch -recurse mydomain.com 1.1.1.1


Modo interactivo
Para usar el modo interactivo, escriba - en lugar del primer parámetro de una línea de
comandos de nslookup, o bien simplemente escriba nslookup . Después, el símbolo del
sistema cambia al símbolo del sistema interactivo > . En los ejemplos siguientes se
muestran comandos en modo interactivo.

El siguiente comando coloca nslookup en modo interactivo y establece 1.1.1.1


como el servidor de búsqueda DNS predeterminado:

Símbolo del sistema de Windows

nslookup - 1.1.1.1

El siguiente comando en el símbolo del sistema interactivo devuelve la opción


nslookup y la configuración de parámetros del servidor actual:

Símbolo del sistema de Windows

set all

El siguiente comando en el símbolo del sistema interactivo devuelve las


direcciones IP de mydomain.com :

Símbolo del sistema de Windows

mydomain.com

El siguiente comando en el símbolo del sistema interactivo cambia el servidor de


nombres DNS predeterminado a 4.4.4.4 :

Símbolo del sistema de Windows

server 4.4.4.4

El siguiente comando en el símbolo del sistema interactivo establece el tipo de


registro de recursos de consulta en HINFO :

Símbolo del sistema de Windows

set type=HINFO
El siguiente comando en el símbolo del sistema interactivo sale del modo
interactivo y vuelve al símbolo del sistema de Windows:

Símbolo del sistema de Windows

exit

Vínculos relacionados
Clave de sintaxis de línea de comandos
nslookup /exit
Artículo • 14/04/2023

Sale de la herramienta de línea de comandos nslookup.

Sintaxis

nslookup /exit

Parámetros

Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
nslookup /finger
Artículo • 14/04/2023

Se conecta con el servidor de dedos en el dispositivo actual.

Sintaxis

finger [<username>] [{[>] <filename> | [>>] <filename>}]

Parámetros

Parámetro Descripción

<username> Especifica el nombre del usuario que se va a buscar.

<filename> Especifica un nombre de archivo en el que se va a guardar la salida. Puede usar los
caracteres mayor que ( > ) y doble mayor que ( >> ) para redirigir la salida de la forma
habitual.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
nslookup help
Artículo • 06/04/2023

Muestra el texto de ayuda del subcomando.

Sintaxis

help

Parámetros

Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
nslookup ls
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Enumera la información del dominio DNS.

Sintaxis

ls [<option>] <DNSdomain> [{[>] <filename>|[>>] <filename>}]

Parámetros

Parámetro Descripción

<option> Las opciones válidas incluyen:


-t: Enumera todos los registros del tipo especificado. Para más información,
vea nslookup set querytype.
-a: Enumera los alias de los equipos del dominio DNS. Este parámetro es el
mismo que -t CNAME
-d: Enumera todos los registros del dominio DNS. Este parámetro es el
mismo que -t ANY
-h: Enumera la información de la CPU y del sistema operativo para el
dominio DNS. Este parámetro es el mismo que -t HINFO
-s: Enumera los servicios conocidos de los equipos en el dominio DNS. Este
parámetro es el mismo que -t WKS.

<DNSdomain> Especifica el dominio DNS para el que desea obtener información.

<filename> Especifica un nombre de archivo que se va a usar para la salida guardada. Puede
usar los caracteres mayor que ( > ) y doble mayor que ( >> ) para redirigir la salida
de la forma habitual.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Comentarios
La salida predeterminada de este comando incluye nombres de equipo y sus
direcciones IP asociadas.

Si la salida se dirige a un archivo, se agregan marcas hash para cada 50 registros


recibidos del servidor.

Vínculos relacionados
Clave de sintaxis de línea de comandos

nslookup set querytype


nslookup lserver
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el servidor inicial al dominio del Sistema de nombres de dominio (DNS)


especificado.

Este comando usa el servidor inicial para buscar la información sobre el dominio DSN
especificado. Si quiere buscar información usando el servidor predeterminado actual,
use el comando nslookup server.

Sintaxis

lserver <DNSdomain>

Parámetros

Parámetro Descripción

<DNSdomain> Especifica el dominio DNS para el servidor inicial.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos

nslookup server
nslookup root
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el servidor predeterminado por el servidor de la raíz del espacio de nombres de


dominio del Sistema de nombres de dominio (DNS). Actualmente, se usa el servidor de
nombres ns.nic.ddn.mil. Puede cambiar el nombre del servidor raíz usando el comando
nslookup set root.

7 Nota

Este comando es el mismo que lserver ns.nic.ddn.mil .

Sintaxis

root

Parámetros

Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos

nslookup set root


nslookup server
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el servidor predeterminado al dominio del servicio de nombres de dominio


(DNS) especificado.

Este comando usa el servidor predeterminado actual para buscar la información sobre el
dominio DNS especificado. Si desea buscar información mediante el servidor inicial, use
el comando nslookup lserver.

Sintaxis

server <DNSdomain>

Parámetros

Parámetro Descripción

<DNSdomain> Especifica el dominio DNS para el servidor predeterminado.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos

nslookup lserver
nslookup set
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia los valores de configuración que afectan a cómo funcionan las búsquedas.

Sintaxis

set all [class | d2 | debug | domain | port | querytype | recurse | retry |


root | search | srchlist | timeout | type | vc] [options]

Parámetros

Parámetro Descripción

nslookup Enumera todas las configuraciones actuales.


set all

nslookup Cambia la clase de consulta, que especifica el grupo de protocolos de la


set class información.

nslookup Activa o desactiva el modo de depuración detallado.


set d2

nslookup Desactiva completamente el modo de depuración.


set debug

nslookup Cambia el nombre de dominio predeterminado del Sistema de nombres de dominio


set domain (DNS) al nombre especificado.

nslookup Cambia el puerto predeterminado del servidor de nombres del Sistema de nombres
set port de dominio (DNS) TCP/UDP al valor especificado.

nslookup Cambia el tipo de registro de recursos de la consulta.


set
querytype

nslookup Indica al servidor de nombres del Sistema de nombres de dominio (DNS) que
set recurse consulte otros servidores si no encuentra ninguna información.
Parámetro Descripción

nslookup Establece el número de reintentos.


set retry

nslookup Cambia el nombre del servidor raíz usado para las consultas.
set root

nslookup Anexa los nombres de dominio del Sistema de nombres de dominio (DNS) de la
set search lista de búsqueda de dominios DNS a la solicitud hasta que se recibe una respuesta.

nslookup Cambia el nombre de dominio y la lista de búsqueda predeterminados del Sistema


set srchlist de nombres de dominio (DNS).

nslookup Cambia el número inicial de segundos para esperar una respuesta a una solicitud de
set búsqueda.
timeout

nslookup Cambia el tipo de registro de recursos de la consulta.


set type

nslookup Especifica si se debe usar un circuito virtual al enviar solicitudes al servidor.


set vc

Vínculos relacionados
Clave de sintaxis de línea de comandos
nslookup set all
Artículo • 06/04/2023

Genera los valores de configuración actuales, incluidos el servidor y el equipo


predeterminados (el host).

Sintaxis

set all

Parámetros

Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
nslookup set class
Artículo • 14/04/2023

Cambia la clase de consulta. La clase especifica el grupo de protocolos de la


información.

Sintaxis

set class=<class>

Parámetros

Parámetro Descripción

<class> Los valores válidos incluyen:


IN: especifica la clase de Internet. Este es el valor predeterminado.
CHAOS: especifica la clase Chaos.
HESIOD: especifica la clase MIT Athena Hesiod.
ANY: especifica el uso de cualquiera de los valores enumerados
anteriormente.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
nslookup set d2
Artículo • 06/04/2023

Activa o desactiva el modo de depuración detallado. Se imprimen todos los campos de


cada paquete.

Sintaxis

set [no]d2

Parámetros

Parámetro Descripción

nod2 Desactiva el modo de depuración detallado. Este es el valor predeterminado.

d2 Activa el modo de depuración detallado.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
nslookup set debug
Artículo • 06/04/2023

Activa o desactiva el modo de depuración.

Sintaxis

set [no]debug

Parámetros

Parámetro Descripción

nodebug Desactiva el modo de depuración. Este es el valor predeterminado.

debug Activa el modo de depuración. Al activar el modo de depuración, puede ver más
información sobre el paquete enviado al servidor y la respuesta resultante.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
nslookup set domain
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el nombre de dominio predeterminado del Sistema de nombres de dominio


(DNS) al nombre especificado.

Sintaxis

set domain=<domainname>

Parámetros

Parámetro Descripción

<domainname> Especifica un nuevo nombre para el nombre de dominio DNS predeterminado. El


valor predeterminado es el nombre del host.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Comentarios
El nombre de dominio DNS predeterminado se anexa a una solicitud de búsqueda
en función del estado de las opciones defname y search.

La lista de búsqueda de dominios DNS contiene los elementos primarios del


dominio DNS predeterminado si tiene al menos dos componentes en su nombre.
Por ejemplo, si el dominio DNS predeterminado es mfg.widgets.com, la lista de
búsqueda se denomina tanto mfg.widgets.com como widgets.com.

Use el comando nslookup set srchlist para especificar una lista diferente y el
comando nslookup set all para mostrar la lista.

Vínculos relacionados
Clave de sintaxis de línea de comandos

nslookup set srchlist

nslookup set all


nslookup set port
Artículo • 06/04/2023

Cambia el puerto predeterminado del servidor de nombres del Sistema de nombres de


dominio (DNS) TCP/UDP al valor especificado.

Sintaxis

set port=<port>

Parámetros

Parámetro Descripción

<port> Especifica el nuevo valor para el puerto predeterminado del servidor de nombres
DNS TCP/UDP. El puerto predeterminado es 53.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
nslookup set querytype
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el tipo de registro de recursos de la consulta. Para obtener información sobre


los tipos de registros de recursos, consulte Solicitud de comentario (Rfc) 1035 .

7 Nota

Este comando es el mismo que el comando nslookup set type.

Sintaxis

set querytype=<resourcerecordtype>

Parámetros

Parámetro Descripción
Parámetro Descripción

<resourcerecordtype> Especifica un tipo de registro de recursos DNS. El tipo de registro de


recursos predeterminado es A, pero puede usar cualquiera de los valores
siguientes:

A: Especifica la dirección IP de un equipo.


ANY: Especifica la dirección IP de un equipo.
CNAME: Especifica un nombre canónico para un alias.
GID Especifica un identificador de grupo de un nombre de grupo.
HINFO: Especifica la CPU y el tipo de sistema operativo de un
equipo.
MB: Especifica un nombre de dominio de buzón.
MG: Especifica un miembro del grupo de correo.
MINFO: Especifica información de buzón o lista de correo.
SR: Especifica el nombre de dominio de cambio de nombre de
correo.
MX: Especifica el agente de intercambio de correo.
NS: Especifica un servidor de nombres DNS para la zona con
nombre.
PTR: Especifica un nombre de equipo si la consulta es una
dirección IP; de lo contrario, especifica el puntero a otra
información.
SOA: Especifica el inicio de la autoridad para una zona DNS.
TXT: Especifica la información de texto.
UID: Especifica el identificador de usuario.
UINFO: Especifica la información del usuario.
WKS: Describe un servicio conocido.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos

nslookup set type


nslookup set recurse
Artículo • 14/04/2023

Indica al servidor de nombres del servicio de nombres de dominio (DNS) que consulte
otros servidores si no encuentra la información en el servidor especificado.

Sintaxis

set [no]recurse

Parámetros

Parámetro Descripción

norecurse Impide al servidor de nombres del servicio de nombres de dominio (DNS) que
consulte otros servidores si no encuentra la información en el servidor especificado.

recurse Indica al servidor de nombres del servicio de nombres de dominio (DNS) que
consulte otros servidores si no encuentra la información en el servidor especificado.
Este es el valor predeterminado.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
nslookup set retry
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Si no se recibe una respuesta en un cierto plazo, se duplica el tiempo de espera y se


vuelve a enviar la solicitud. Este comando establece el número de veces que una
solicitud se reenvía a un servidor para obtener información antes de renunciar.

7 Nota

Para cambiar el período de tiempo antes de que se agote el tiempo de espera de la


solicitud, use el comando nslookup set timeout.

Sintaxis

set retry=<number>

Parámetros

Parámetro Descripción

<number> Especifica el nuevo valor para el número de reintentos. El número predeterminado


de reintentos es 4.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos

nslookup set timeout


nslookup set root
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el nombre del servidor raíz usado para las consultas.

7 Nota

Este comando admite el comando root nslookup.

Sintaxis

set root=<rootserver>

Parámetros

Parámetro Descripción

<rootserver> Especifica el nuevo nombre del servidor raíz. El valor predeterminado es


ns.nic.ddn.mil.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos

nslookup root
nslookup set search
Artículo • 14/04/2023

Anexa los nombres de dominio del Sistema de nombres de dominio (DNS) de la lista de
búsqueda de dominios DNS a la solicitud hasta que se recibe una respuesta. Esto se
aplica cuando el conjunto y la solicitud de búsqueda contienen al menos un período,
pero no terminan con un período final.

Sintaxis

set [no]search

Parámetros

Parámetro Descripción

nosearch Deja de anexar los nombres de dominio del Sistema de nombres de dominio (DNS)
en la lista de búsqueda de dominios DNS para la solicitud.

paquetes Anexa los nombres de dominio del Sistema de nombres de dominio (DNS) en la
Bower lista de búsqueda de dominios DNS para la solicitud hasta que se recibe una
respuesta. Este es el valor predeterminado.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
nslookup set srchlist
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el nombre de dominio y la lista de búsqueda predeterminados del Sistema de


nombres de dominio (DNS). Este comando invalida el nombre de dominio DNS
predeterminado y la lista de búsqueda del comando nslookup set domain.

Sintaxis

set srchlist=<domainname>[/...]

Parámetros

Parámetro Descripción

<domainname> Especifica nuevos nombres para el dominio DNS predeterminado y la lista de


búsqueda. El valor predeterminado del nombre de dominio se basa en el nombre
de host. Puede especificar un máximo de seis nombres separados por barras
diagonales (/).

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Comentarios

Use el comando nslookup set all para mostrar la lista.

Ejemplos
Para establecer el dominio DNS en mfg.widgets.com y la lista de búsqueda en los tres
nombres:
set srchlist=mfg.widgets.com/mrp2.widgets.com/widgets.com

Vínculos relacionados
Clave de sintaxis de línea de comandos

nslookup set domain

nslookup set all


nslookup set timeout
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el número inicial de segundos para esperar una respuesta a una solicitud de
búsqueda. Si no se recibe una respuesta en el plazo especificado, se duplica el tiempo
de espera y se vuelve a enviar la solicitud. Use el comando nslookup set retry para
determinar el número de veces que se intenta enviar la solicitud.

Sintaxis

set timeout=<number>

Parámetros

Parámetro Descripción

<number> Especifica el número de segundos que se esperarán para una respuesta. El número
predeterminado de segundos que se debe esperar es 5.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para establecer el tiempo de espera para obtener una respuesta en 2 segundos:

set timeout=2

Vínculos relacionados
Clave de sintaxis de línea de comandos
nslookup set retry
nslookup set type
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el tipo de registro de recursos de la consulta. Para obtener información sobre


los tipos de registros de recursos, consulte Solicitud de comentario (Rfc) 1035 .

7 Nota

Este comando es el mismo que el comando nslookup set querytype.

Sintaxis

set type=<resourcerecordtype>

Parámetros

Parámetro Descripción
Parámetro Descripción

<resourcerecordtype> Especifica un tipo de registro de recursos DNS. El tipo de registro de


recursos predeterminado es A, pero puede usar cualquiera de los valores
siguientes:

A: Especifica la dirección IP de un equipo.


ANY: Especifica la dirección IP de un equipo.
CNAME: Especifica un nombre canónico para un alias.
GID Especifica un identificador de grupo de un nombre de grupo.
HINFO: Especifica la CPU y el tipo de sistema operativo de un
equipo.
MB: Especifica un nombre de dominio de buzón.
MG: Especifica un miembro del grupo de correo.
MINFO: Especifica información de buzón o lista de correo.
SR: Especifica el nombre de dominio de cambio de nombre de
correo.
MX: Especifica el agente de intercambio de correo.
NS: Especifica un servidor de nombres DNS para la zona con
nombre.
PTR: Especifica un nombre de equipo si la consulta es una
dirección IP; de lo contrario, especifica el puntero a otra
información.
SOA: Especifica el inicio de la autoridad para una zona DNS.
TXT: Especifica la información de texto.
UID: Especifica el identificador de usuario.
UINFO: Especifica la información del usuario.
WKS: Describe un servicio conocido.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos

nslookup set type


nslookup set vc
Artículo • 06/04/2023

Especifica si se debe usar un circuito virtual al enviar solicitudes al servidor.

Sintaxis

set [no]vc

Parámetros

Parámetro Descripción

novc Especifica que nunca se use un circuito virtual al enviar solicitudes al servidor. Este
es el valor predeterminado.

vc Especifica que siempre se use un circuito virtual al enviar solicitudes al servidor.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
nslookup view
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Ordena y enumera la salida de los comandos o subcomandos ls anteriores.

Sintaxis

view <filename>

Parámetros

Parámetro Descripción

<filename> Especifica el nombre del archivo que contiene la salida de los comandos o
subcomandos ls anteriores.

/? Muestra la ayuda en el símbolo del sistema.

/help Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos

nslookup ls
ntbackup
Artículo • 10/05/2023

Se aplica a: Windows Server (todas las versiones compatibles)

El comando ntbackup realiza una copia de seguridad y restaura el equipo y los archivos
desde un símbolo del sistema. Este comando ha sido reemplazado por el comando
wbadmin.

) Importante

El comando wbadmin no puede recuperar las copias de seguridad creadas mediante


los comandos ntbackup . La Utilidad de copia de seguridad y restauración de
Windows NT es necesaria para realizar la recuperación de copias de seguridad
heredadas.

Vínculos relacionados
Clave de sintaxis de línea de comandos

wbadmin
ntcmdprompt
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Ejecuta el intérprete de comandos Cmd.exe, en lugar de Command.com, después de


ejecutar un Terminate and Stay Resident (TSR) o después de iniciar el símbolo del
sistema desde dentro de una aplicación de MS-DOS.

Sintaxis

ntcmdprompt

Parámetros

Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Cuando Command.com está en ejecución, algunas características de Cmd.exe,


como la visualización doskey del historial de comandos, no están disponibles. Si
prefiere ejecutar el intérprete de comandos Cmd.exe después de haber iniciado un
Terminate and Stay Resident (TSR) o iniciado el símbolo del sistema desde una
aplicación basada en MS-DOS, puede usar el comando ntcmdprompt. Sin
embargo, tenga en cuenta que es posible que el TSR no esté disponible para su
uso cuando ejecute Cmd.exe. Puede incluir el comando ntcmdprompt en el
archivo Config.nt o el archivo de inicio personalizado equivalente en el archivo de
información del programa de una aplicación (Pif).

Vínculos relacionados
Clave de sintaxis de línea de comandos
ntfrsutl
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Vuelca las tablas internas, el subproceso y la información de memoria del Servicio de


replicación de archivos NT (NTFRS) tanto del servidor local como del remoto. La
configuración de recuperación para NTFRS en el Administrador de control de servicios
(SCM) puede ser fundamental para localizar y mantener eventos de registro importantes
en el equipo. Esta herramienta proporciona un método práctico para revisar esa
configuración.

Sintaxis

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 Descripción

idtable Especifica la tabla de identificadores.

configtable Especifica la tabla de configuración de FRS.

inlog Especifica el registro de entrada.

outlog Especifica el registro de salida.

<computer> Especifica el equipo.

memoria Especifica el uso de memoria.

subprocesos Especifica el uso de memoria.

fase Especifica el uso de memoria.


Parámetro Descripción

ds Enumera la vista del servicio NTFRS del DS.

conjuntos Especifica los conjuntos de réplicas activas.

version Especifica las versiones del servicio de API y NTFRS.

poll Especifica los intervalos de sondeo actuales.


/quickly : Sondea rápidamente hasta que recupera una configuración
estable.
/quickly= : Sondea rápidamente cada número predeterminado de minutos.
/quickly=<n> : Sondea rápidamente cada n minutos.
/slowly : Sondea lentamente hasta que recupera una configuración estable.
/slowly= : Sondea lentamente cada número predeterminado de minutos.
/slowly=<n> : Sondea lentamente cada n minutos.
/now : Sondea ahora.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para determinar el intervalo de sondeo para la replicación de archivos, escriba:

C:\Program Files\SupportTools>ntfrsutl poll wrkstn-1

Para determinar la versión actual de la interfaz de programa de aplicaciones NTFRS


(API), escriba:

C:\Program Files\SupportTools>ntfrsutl version

Vínculos relacionados
Clave de sintaxis de línea de comandos
sin conexión
Artículo • 06/04/2023

Lleva un disco o volumen en línea al estado sin conexión.

Sintaxis

offline disk
offline volume

Parámetros

Parámetro Descripción

offline disk Lleva el disco en línea con el foco al estado sin conexión.

offline volume Lleva el volumen en línea con el foco al estado sin conexión.

Vínculos relacionados
Clave de sintaxis de línea de comandos
offline disk
Artículo • 06/04/2023

Lleva el disco en línea con el foco al estado sin conexión. Si un disco dinámico de un
grupo de discos se desconecta, el estado del disco cambia a faltante y el grupo muestra
un disco sin conexión. El disco que falta se mueve al grupo no válido. Si el disco
dinámico es el último disco del grupo, el estado del disco cambia a sin conexión y se
quita el grupo vacío.

7 Nota

Debe seleccionarse un disco para que el comando offline disk tenga éxito. Use el
comando select disk para seleccionar un disco y desplazar el foco a él.

Este comando también funciona en discos en modo SAN en línea cambiando el


modo SAN a sin conexión.

Sintaxis

offline disk [noerr]

Parámetros

Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para desconectar el disco con el foco, escriba:

offline disk
Vínculos relacionados
Clave de sintaxis de línea de comandos
offline volume
Artículo • 06/04/2023

Lleva el volumen en línea con el foco al estado sin conexión.

7 Nota

Se debe seleccionar un volumen para que el comando offline volume funcione


correctamente. Use el comando select volume para seleccionar un disco y
desplazar el foco a él.

Sintaxis

offline volume [noerr]

Parámetros

Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para desconectar el disco con el foco, escriba:

offline volume

Vínculos relacionados
Clave de sintaxis de línea de comandos
online (en línea)
Artículo • 06/04/2023

Lleva un disco o volumen sin conexión al estado en línea.

Sintaxis

online disk
online volume

Parámetros

Parámetro Descripción

online disk Lleva el disco sin conexión con el foco al estado en línea.

online volume Lleva el volumen sin conexión con el foco al estado en línea.

Vínculos relacionados
Clave de sintaxis de línea de comandos
online disk
Artículo • 14/04/2023

Lleva el disco sin conexión al estado en línea. En el caso de los discos básicos, este
comando intenta conectar el disco seleccionado y todos los volúmenes de ese disco. En
el caso de los discos dinámicos, este comando intenta poner en línea todos los discos
que no están marcados como externos en el equipo local. También intenta poner en
línea todos los volúmenes en el conjunto de discos dinámicos.

Si un disco dinámico de un grupo de discos se pone en línea y es el único disco del


grupo, el grupo original se vuelve a crear y el disco se mueve a ese grupo. Si hay otros
discos en el grupo y están en línea, el disco se vuelve a agregar al grupo. Si el grupo de
un disco seleccionado contiene volúmenes reflejados o RAID-5, este comando también
resincroniza estos volúmenes.

7 Nota

Debe seleccionarse un disco para que el comando online disk tenga éxito. Use el
comando select disk para seleccionar un disco y desplazar el foco a él.

) Importante

Este comando producirá un error si se usa en un disco de solo lectura.

Sintaxis

online disk [noerr]

Parámetros
Para obtener instrucciones sobre cómo usar este comando, consulte Reactivación de un
disco dinámico que falta o sin conexión.

Parámetro Descripción
Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para poner el disco con el foco en línea, escriba:

online disk

Vínculos relacionados
Clave de sintaxis de línea de comandos
online volume
Artículo • 14/04/2023

Lleva el volumen sin conexión al estado en línea. Este comando funciona en volúmenes
que han fallado, donde se producen errores o que están en estado de redundancia con
errores.

7 Nota

Se debe seleccionar un volumen para que el comando online volume funcione


correctamente. Use el comando select volume para seleccionar un volumen y
desplazar el foco a él.

) Importante

Este comando producirá un error si se usa en un disco de solo lectura.

Sintaxis

online volume [noerr]

Parámetros

Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para tomar el volumen con el foco en línea, escriba:

online volume
Vínculos relacionados
Clave de sintaxis de línea de comandos
openfiles
Artículo • 08/04/2023

Permite a un administrador consultar, visualizar o desconectar los archivos y directorios


que se han abierto en un sistema. Este comando también activa o desactiva la marca
global del sistema Mantener lista de objetos.

openfiles /disconnect
Permite a un administrador desconectar archivos y carpetas que se han abierto de forma
remota a través de una carpeta compartida.

Sintaxis

openfiles /disconnect [/s <system> [/u [<domain>\]<username> [/p


[<password>]]]] {[/id <openfileID>] | [/a <accessedby>] | [/o {read | write
| read/write}]} [/op <openfile>]

Parámetros

Parámetro Descripción

/s <system> Especifica el sistema remoto al que conectarse (por nombre o dirección IP). No
use barras diagonales inversas. Si no usa la opción /s, el comando se ejecuta en el
equipo local de forma predeterminada. Este parámetro se aplica a todos los
archivos y carpetas especificados en el comando.

/u Ejecuta el comando con los permisos del usuario especificado. Si no usa la opción
[<domain>\] /u, los permisos del sistema se usan de forma predeterminada.
<username>

/p Especifica la contraseña de la cuenta de usuario especificada en la opción /u. Si


[<password>] no usa la opción /p, aparece un símbolo del sistema de contraseña cuando se
ejecuta el comando.

/id Desconecta los archivos abiertos por el identificador de archivo especificado.


<openfileID> Puede usar el carácter comodín (*) con este parámetro.

Nota: Puede usar el comando openfiles /query para buscar el identificador de


archivo.
Parámetro Descripción

/a Desconecta todos los archivos abiertos asociados al nombre de usuario


<accessedby> especificado en el parámetro accessedby. Puede usar el carácter comodín (*) con
este parámetro.

/o {read | Desconecta todos los archivos abiertos con el valor de modo abierto
write | especificado. Los valores válidos son Read, Write o Read/Write. Puede usar el
read/write} carácter comodín (*) con este parámetro.

/op Desconecta todas las conexiones de archivos abiertas creadas por un nombre de
<openfile> archivo abierto específico. Puede usar el carácter comodín (*) con este parámetro.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para desconectar todos los archivos abiertos con el identificador de archivo 26843578,
escriba:

openfiles /disconnect /id 26843578

Para desconectar todos los archivos abiertos y directorios a los que tiene acceso el
usuario hiropln, escriba:

openfiles /disconnect /a hiropln

Para desconectar todos los archivos y directorios abiertos con el modo de lectura y
escritura, escriba:

openfiles /disconnect /o read/write

Para desconectar el directorio con el nombre de archivo abierto *C:\testshare*,


independientemente de quién acceda a él, escriba:

openfiles /disconnect /a * /op c:\testshare\


Para desconectar todos los archivos abiertos en el equipo remoto srvmain a los que está
accediendo el usuario hiropln, independientemente de su id., escriba:

openfiles /disconnect /s srvmain /u maindom\hiropln /id *

openfiles /query
Consulta y muestra todos los archivos abiertos.

Sintaxis

openfiles /query [/s <system> [/u [<domain>\]<username> [/p [<password>]]]]


[/fo {TABLE | LIST | CSV}] [/nh] [/v]

Parámetros

Parámetro Descripción

/s <system> Especifica el sistema remoto al que conectarse (por nombre o dirección IP). No
use barras diagonales inversas. Si no usa la opción /s, el comando se ejecuta en el
equipo local de forma predeterminada. Este parámetro se aplica a todos los
archivos y carpetas especificados en el comando.

/u Ejecuta el comando con los permisos del usuario especificado. Si no usa la opción
[<domain>\] /u, los permisos del sistema se usan de forma predeterminada.
<username>

/p Especifica la contraseña de la cuenta de usuario especificada en la opción /u. Si


[<password>] no usa la opción /p, aparece un símbolo del sistema de contraseña cuando se
ejecuta el comando.

[/fo {TABLE | Muestra la salida en el formato especificado. Los valores válidos son:
LIST | CSV} ] TABLE: muestra la salida en una tabla.
LIST: muestra la salida en una lista.
CSV: muestra la salida en formato de valores separados por comas (CSV).

/nh Suprime los encabezados de columna en la salida. Válido solo cuando el


parámetro /fo se establece en TABLE o CSV.

/v Especifica que la información detallada (verbose) se mostrará en la salida.


Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para consultar y mostrar todos los archivos abiertos, escriba:

openfiles /query

Para consultar y mostrar todos los archivos abiertos en formato de tabla sin
encabezados, escriba:

openfiles /query /fo table /nh

Para consultar y mostrar todos los archivos abiertos en formato de lista con información
detallada, escriba:

openfiles /query /fo list /v

Para consultar y mostrar todos los archivos abiertos en el srvmain del sistema remoto
mediante las credenciales del usuario hiropln en el dominio maindom, escriba:

openfiles /query /s srvmain /u maindom\hiropln /p p@ssW23

7 Nota

En este ejemplo, la contraseña se proporciona en la línea de comandos. Para evitar


mostrar la contraseña, deje la opción /p. Se le pedirá la contraseña, que no se
volverá a reproducir en la pantalla.

openfiles /local
Habilita o deshabilita la marca global del sistema Mantener lista de objetos. Si se usa
sin parámetros, openfiles /local muestra el estado actual de la marca global Mantener
lista de objetos.

7 Nota

Los cambios realizados usando la opción on u off no surten efecto hasta que
reinicie el sistema. La habilitación de la marca global Mantener lista de objetos
puede ralentizar el sistema.

Sintaxis

openfiles /local [on | off]

Parámetros

Parámetro Descripción

[on | Habilita o deshabilita la marca global del sistema Mantener lista de objetos, que
off] realiza un seguimiento de los identificadores de archivos locales.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para comprobar el estado actual de la marca global Mantener lista de objetos, escriba:

openfiles /local

De forma predeterminada, la marca global Mantener lista de objetos está deshabilitada


y aparece el siguiente mensaje: INFO: The system global flag 'maintain objects list'
is currently disabled.

Para habilitar la marca global Mantener lista de objetos, escriba:


openfiles /local on

El mensaje siguiente aparece cuando la marca global está habilitada, SUCCESS: The
system global flag 'maintain objects list' is enabled. This will take effect after
the system is restarted.

Para deshabilitar la marca global Mantener lista de objetos, escriba:

openfiles /local off

Vínculos relacionados
Clave de sintaxis de línea de comandos
pagefileconfig
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2003,
Windows Server 2003 R2, Windows Server 2003 con SP1, Windows Server 2003 con
SP2

) Importante

Este comando está en desuso.

Permite a un administrador mostrar y configurar la configuración de memoria virtual del


archivo de paginación de un sistema. Para obtener descripciones e información de uso,
consulte pagefileconfig.

Vínculos relacionados
Clave de sintaxis de línea de comandos
path
Artículo • 08/04/2023

Establece la ruta de acceso del comando en la variable de entorno PATH, especificando


el conjunto de directorios utilizados para buscar archivos ejecutables (.exe). Si se usa sin
parámetros, este comando muestra la ruta de acceso del comando actual.

Sintaxis

path [[<drive>:]<path>[;...][;%PATH%]]
path ;

Parámetros

Parámetro Descripción

[<drive>:] Especifica la unidad y el directorio que se van a establecer en la ruta de acceso del
<path> comando. El directorio actual siempre se busca antes de los directorios
especificados en la ruta de acceso del comando.

; Separa directorios en la ruta de acceso del comando. Si se usa sin otros parámetros,
; borra las rutas de acceso a comandos existentes de la variable de entorno PATH e
indica a Cmd.exe que busque solo en el directorio actual.

%PATH% Añade la ruta de acceso del comando al conjunto existente de directorios


enumerados en la variable de entorno PATH. Si incluye este parámetro, Cmd.exe lo
reemplazará por los valores de la ruta de acceso a comandos que se encuentran en
la variable de entorno PATH, eliminando la necesidad de escribir manualmente estos
valores en el símbolo del sistema.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
El sistema operativo Windows busca usando las extensiones de nombre de archivo
predeterminadas en el siguiente orden de precedencia: .exe, .com, .bat y .cmd. Lo
que significa que si está buscando un archivo por lotes llamado, acct.bat, pero
tiene una aplicación llamada acct.exe en el mismo directorio, debe incluir la
extensión .bat en el símbolo del sistema.
Si dos o más archivos de la ruta de acceso del comando tienen el mismo nombre
de archivo y extensión, este comando busca primero el nombre de archivo
especificado en el directorio actual. Después, busca en los directorios de la ruta de
acceso del comando en el orden en que están enumerados en la variable de
entorno PATH.

Si coloca el comando path en su archivo Autoexec.nt, el sistema operativo


Windows añadirá automáticamente la ruta de búsqueda del subsistema MS-DOS
especificada cada vez que inicie sesión en su equipo. Cmd.exe no usa el archivo
Autoexec.nt. Cuando se inicia desde un acceso directo, Cmd.exe hereda las
variables de entorno establecidas en My
Computer/Properties/Advanced/Environment.

Ejemplos
Para buscar comandos externos en las rutas de acceso c:\user\taxes, b:\user\invest y
b:\bin, escriba:

path c:\user\taxes;b:\user\invest;b:\bin

Vínculos relacionados
Clave de sintaxis de línea de comandos
pathping
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Proporciona información sobre la latencia de red y la pérdida de red en saltos


intermedios entre un origen y un destino. Este comando envía múltiples mensajes de
solicitud de eco a cada enrutador entre un origen y un destino, durante un periodo de
tiempo, y después calcula los resultados basándose en los paquetes devueltos por cada
enrutador. Como este comando muestra el grado de pérdida de paquetes en cualquier
enrutador o vínculo, puede determinar qué enrutadores o subredes pueden estar
teniendo problemas de red. Si se usa sin parámetros, este comando muestra la ayuda.

7 Nota

Este comando solo está disponible si el protocolo de Internet (TCP / IP) está
instalado como componente en las propiedades de un adaptador de red en
conexiones de red.

Además, este comando identifica qué enrutadores están en la ruta de acceso, igual
que el uso del comando tracert. Sin embargo, este comando también envía pings
periódicamente a todos los enrutadores durante un periodo de tiempo
especificado y calcula las estadísticas en función del número devuelto por cada uno
de ellos.

Sintaxis

pathping [/n] [/h <maximumhops>] [/g <hostlist>] [/p <Period>] [/q


<numqueries> [/w <timeout>] [/i <IPaddress>] [/4 <IPv4>] [/6 <IPv6>]
[<targetname>]

Parámetros

Parámetro Descripción
Parámetro Descripción

/n Evita que pathping intente resolver las direcciones IP de los enrutadores


intermedios a sus nombres. Esto podría agilizar la visualización de los resultados
de pathping.

/h Especifica el número máximo de saltos en la ruta de acceso para buscar el


<maximumhops> destino. El valor predeterminado es de 30 saltos.

/g <hostlist> Especifica que los mensajes de solicitud de eco usan la opción Ruta de origen
flexible en la cabecera IP con el conjunto de destinos intermedios especificados
en hostlist. Con el enrutamiento de origen flexible, los destinos intermedios
sucesivos se pueden separar por uno o varios enrutadores. El número máximo
de direcciones o nombres de la lista de hosts es 9. hostlist es una serie de
direcciones IP (en notación decimal con puntos) separadas por espacios.

/p <period> Especifica el número de milisegundos que se van a esperar entre pings


consecutivos. El valor predeterminado es 250 milisegundos (1/4 segundos). Este
parámetro envía pings individuales a cada salto intermedio. Por ello, el intervalo
entre dos pings enviados al mismo salto es periodo multiplicado por el número
de saltos.

/q Especifica el número de mensajes de solicitud de eco enviados a cada enrutador


<numqueries> de la ruta de acceso. El valor predeterminado es 100 consultas.

/w <timeout> Especifica el número de milisegundos que se van a esperar para cada respuesta.
El valor predeterminado es 3 000 milisegundos (3 segundos). Este parámetro
envía varios pings en paralelo. Debido a esto, la cantidad de tiempo especificada
en el parámetro timeout no está limitada por la cantidad de tiempo especificada
en el parámetro period para esperar entre pings.

/i <IPaddress> Especifica la dirección de origen.

/4 <IPv4> Especifica que pathping solo usa IPv4.

/6 <IPv6> Especifica que pathping solo usa IPv6.

<targetname> Especifica el destino, que se identifica mediante la dirección IP o el nombre del


host.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Todos los parámetros distinguen mayúsculas de minúsculas.

Para evitar la congestión de la red y minimizar los efectos de las pérdidas por
ráfagas, los pings deben enviarse a un ritmo suficientemente lento.
Ejemplo de la salida del 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.

Cuando se ejecuta pathping, los primeros resultados enumeran la ruta de acceso. A


continuación, aparece un mensaje de ocupado durante aproximadamente 90 segundos
(el tiempo varía según el recuento de saltos). Durante este tiempo, se recopila
información de todos los enrutadores enumerados previamente y de los vínculos entre
ellos. Al final de este periodo, se muestran los resultados de la prueba.

En el informe de muestra anterior, las columnas Este Nodo/Vínculo, Perdido/Enviado =


Pct y dirección muestran que el vínculo entre 172.16.87.218 y 192.168.52.1 está
perdiendo el 13 % de los paquetes. Los enrutadores de los saltos 2 y 4 también están
perdiendo paquetes dirigidos a ellos, pero esta pérdida no afecta a su capacidad para
reenviar el tráfico que no va dirigido a ellos.

Los índices de pérdida mostrados para los vínculos, identificados como una barra
vertical (|) en la columna dirección, indican la congestión del vínculo que está causando
la pérdida de paquetes que se están reenviando en la ruta de acceso. Los índices de
pérdida mostrados para los enrutadores (identificados por sus direcciones IP) indican
que estos enrutadores podrían sobrecargarse.
Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando tracert
pause
Artículo • 08/04/2023

Suspende el procesamiento de un programa por lotes, mostrando el mensaje, Press any


key to continue . . .

Sintaxis

pause

Parámetros

Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si presiona CTRL+C para detener un programa por lotes, aparece el siguiente
mensaje, Terminate batch job (Y/N)? . Si presiona Y (para sí) en respuesta a este
mensaje, el programa por lotes finaliza y el control vuelve al sistema operativo.

Puede insertar el comando pause antes de una sección del archivo por lotes que
es posible que no quiera procesar. Cuando pause suspende el procesamiento del
programa por lotes, puede presionar CTRL+C y presionar Y para detener el
programa por lotes.

Ejemplos
Para crear un programa por lotes que pida al usuario que cambie los discos de una de
las unidades, escriba:

@echo off
:Begin
copy a:*.*
echo Put a new disk into Drive A
pause
goto begin

En este ejemplo, todos los archivos del disco de la unidad A se copian en el directorio
actual. Después de que el mensaje le pida que coloque un nuevo disco en la unidad A,
el comando pause suspende el procesamiento para que pueda cambiar los discos y, a
continuación, presione cualquier tecla para reanudar el procesamiento. Este programa
por lotes se ejecuta en un bucle sin fin: el comando goto begin envía el intérprete de
comandos a la etiqueta Begin del archivo por lotes.

Vínculos relacionados
Clave de sintaxis de línea de comandos
pbadmin
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2003,
Windows Server 2003 R2, Windows Server 2003 con SP1, Windows Server 2003 con
SP2

) Importante

Este comando está en desuso.

Administra las libretas de teléfonos. Se usa sin parámetros, pbadmin inicia el


administrador de la libreta de teléfonos. Para obtener descripciones e información de
uso, consulte pbadmin.

Vínculos relacionados
Clave de sintaxis de línea de comandos
pentnt
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2003,
Windows Server 2003 R2, Windows Server 2003 con SP1, Windows Server 2003 con
SP2

) Importante

Este comando está en desuso.

Detecta el error de división de punto flotante (si está presente) en el chip Pentium,
deshabilita el hardware de punto flotante y activa la emulación de punto flotante. Para
obtener descripciones e información de uso, consulte pentnt.

Vínculos relacionados
Clave de sintaxis de línea de comandos
perfmon
Artículo • 14/04/2023

Inicie el Monitor de confiabilidad y rendimiento de Windows en un modo independiente


específico.

Sintaxis

perfmon </res|report|rel|sys>

Parámetros

Parámetro Descripción

/res Inicia la Vista de recursos.

/report Inicia el conjunto de recopiladores de datos de diagnóstico del sistema y muestra


un informe de los resultados.

/rel Inicia el Monitor de confiabilidad.

/sys Inicia el Monitor de rendimiento.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Monitor de rendimiento de Windows


ping
Artículo • 15/09/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Comprueba la conectividad a nivel de IP con otro equipo TCP/IP mediante el envío de


mensajes de solicitud de eco del protocolo de mensajes de control de Internet (ICMP).
Se muestra la recepción de los mensajes de respuesta de eco correspondientes, junto
con los tiempos de ida y vuelta. ping es el comando TCP/IP principal que se usa para
solucionar problemas de conectividad, disponibilidad y resolución de nombres. Si se usa
sin parámetros, este comando muestra el contenido de la Ayuda.

También puede usar este comando para probar el nombre del equipo y la dirección IP
del equipo. Si el ping a la dirección IP se realiza correctamente, pero el ping al nombre
del equipo no, es posible que tenga un problema de resolución de nombres. En este
caso, asegúrese de que el nombre de equipo que especifique se puede resolver a través
del archivo hosts local, utilizando consultas del sistema de nombres de dominio (DNS) o
mediante técnicas de resolución de nombres NetBIOS.

7 Nota

Este comando solo está disponible si el protocolo de Internet (TCP / IP) está
instalado como componente en las propiedades de un adaptador de red en
conexiones de red.

Sintaxis

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 Descripción

/t Especifica que ping continúa enviando mensajes de solicitud de eco al destino


hasta que se interrumpa. Para interrumpir y mostrar estadísticas, presione
CTRL+ENTRAR. Para interrumpir y salir de este comando, presione CTRL+C.

/a Especifica que la resolución inversa de nombres se realice en la dirección IP de


destino. Si esta operación se completa con éxito, ping muestra el nombre del host
correspondiente.

/n <count> Especifica el número de mensajes de solicitud de eco que se envían. El valor


predeterminado es 4.

/l <size> Especifica la longitud, en bytes, del campo Data en los mensajes de solicitud de
eco. El valor predeterminado es 32. El tamaño máximo es de 65 500.

/f Especifica que los mensajes de solicitud de eco se envían con la marca No


fragmentar en el encabezado IP establecido en 1 (disponible solo en IPv4). Los
enrutadores no pueden fragmentar el mensaje de solicitud de eco en la ruta de
acceso al destino. Este parámetro es útil para solucionar problemas de unidad de
transmisión máxima (PMTU).

/I <TTL> Especifica el valor del campo Período de vida (TTL) en el encabezado IP para los
mensajes de solicitud de eco enviados. El valor predeterminado es el valor TTL
predeterminado para el host. El TTL máximo es 255.

/v <TOS> Especifica el valor del campo Tipo de servicio (TOS) en el encabezado IP para los
mensajes de solicitud de eco enviados (disponible solo en IPv4). El valor
predeterminado es 0. TOS se especifica como un valor decimal comprendido
entre 0 y 255.

/r <count> Especifica la opción Ruta de registro del encabezado IP que se usa para registrar
la ruta de acceso tomada por el mensaje de solicitud de eco y el mensaje de
respuesta de eco correspondiente (disponible solo en IPv4). Cada salto de la ruta
de acceso usa una entrada en la opción Ruta de registro. Si es posible,
especifique un recuento igual o mayor que el número de saltos entre el origen y
el destino. El recuento debe ser un mínimo de 1 y un máximo de 9.

/s <count> Especifica que se use la opción Internet timestamp en el encabezado IP para


registrar la hora de llegada del mensaje de solicitud de eco y del correspondiente
mensaje de respuesta de eco para cada salto. El recuento debe ser un mínimo de
1 y un máximo de 4. Este parámetro es necesario para las direcciones de destino
de vínculos locales.

/j <hostlist> Especifica que los mensajes de solicitud de eco usan la opción Ruta de origen
flexible en el encabezado IP con el conjunto de destinos intermedios
especificados en hostlist (solo disponible en IPv4). Con el enrutamiento de origen
flexible, los destinos intermedios sucesivos se pueden separar por uno o varios
enrutadores. El número máximo de direcciones o nombres de la lista de hosts es
9. La lista de hosts es una serie de direcciones IP (en notación decimal con
puntos) separadas por espacios.
Parámetro Descripción

/k Especifica que los mensajes de solicitud de eco usan la opción Ruta de origen
<hostlist> estricta en el encabezado IP con el conjunto de destinos intermedios
especificados en hostlist (solo disponible en IPv4). Con el enrutamiento de origen
estricto, el siguiente destino intermedio debe ser accesible directamente (debe
ser un vecino en una interfaz del enrutador). El número máximo de direcciones o
nombres de la lista de hosts es 9. La lista de hosts es una serie de direcciones IP
(en notación decimal con puntos) separadas por espacios.

/w <timeout> Especifica la cantidad de tiempo, en milisegundos, para esperar el mensaje de


respuesta de eco correspondiente a un mensaje de solicitud de eco determinado.
Si el mensaje de respuesta de eco no se recibe dentro del tiempo de espera, se
muestra el mensaje de error "Tiempo de espera de solicitud". El tiempo de espera
predeterminado es 4000 (4 segundos).

/R Especifica que se realiza un seguimiento de la ruta de acceso de ida y vuelta


(disponible solo en IPv6).

/S <Srcaddr> Especifica la dirección de origen que se va a usar (disponible solo en IPv6).

/4 Especifica qué IPv4 que se usa para hacer ping. Este parámetro no es necesario
para identificar el host de destino con una dirección IPv4. Solo es necesario
identificar el host de destino por nombre.

/6 Especifica qué IPv6 que se usa para hacer ping. No es necesario este parámetro
para identificar el host de destino con una dirección IPv6. Solo es necesario
identificar el host de destino por nombre.

<targetname> Especifica el nombre del host o la dirección IP del destino.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplo de salida del 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

Ejemplos
Para hacer ping al destino 10.0.99.221 y resolver 10.0.99.221 en su nombre de host,
escriba:

ping /a 10.0.99.221

Para hacer ping al destino 10.0.99.221 con 10 mensajes de solicitud de eco, cada uno de
los cuales tiene un campo Datos de 1 000 bytes, escriba:

ping /n 10 /l 1000 10.0.99.221

Para hacer ping al destino 10.0.99.221 y registrar la ruta de 4 saltos, escriba:

ping /r 4 10.0.99.221

Para hacer ping al destino 10.0.99.221 y especificar la ruta de origen flexible de


10.12.0.1-10.29.3.1-10.1.44.1, escriba:

ping /j 10.12.0.1 10.29.3.1 10.1.44.1 10.0.99.221

Vínculos relacionados
Clave de sintaxis de línea de comandos
pktmon
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure Stack Hub, Azure

El Monitor de paquetes (Pktmon) es una herramienta de diagnóstico de red integrada


para componentes de Windows. Puede usarse para la captura avanzada de paquetes y
la recopilación de eventos, la detección de pérdidas, el filtrado y el recuento. Pktmon es
especialmente útil en escenarios de virtualización como las redes de contenedores y
SDN, porque proporciona visibilidad dentro de la pila de redes.

Sintaxis

pktmon { filter | list | start | stop | status | unload | counters | reset |


etl2txt | etl2pcap | hex2pkt | help } [options]

Comandos

Comando Descripción

pktmon filter Administrar filtros de paquetes.

pktmon list Enumerar los componentes de procesamiento de paquetes.

pktmon start Iniciar la captura de paquetes y la recopilación de eventos.

pktmon stop Detener recopilación de datos.

pktmon status Consultar el estado actual.

pktmon unload Descargar controlador PktMon.

pktmon counters Mostrar los contadores de paquetes actuales.

pktmon reset Restablecer a cero los contadores de paquetes.

pktmon etl2txt Convertir el archivo de registro a formato de texto.

pktmon etl2pcap Convertir el archivo de registro a formato pcapng.

pktmon hex2pkt Descodificar paquete en formato hexadecimal.


Comando Descripción

pktmon help Mostrar texto de ayuda para un comando específico.

Vínculos relacionados
Introducción al Monitor de paquetes
Compatibilidad de Pktmon con el Monitor de red de Microsoft (Netmon)
pktmon counters
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure Stack Hub, Azure

Pktmon counters le permite consultar y mostrar los contadores de paquetes actuales de


los componentes supervisados para confirmar la presencia del tráfico esperado y
obtener una visión global de cómo fluye el tráfico en la máquina.

Sintaxis

pktmon counters [--type { all | flow | drop }] [--include-hidden] [--zero]


[--drop-reason] [--live] [--refresh-rate <n>] [--json]

Parámetros

Parámetro Descripción

-t, --type Seleccionar qué tipos de contadores mostrar. Los valores admitidos son all (todos
los contadores) (valor predeterminado), flow (solo flujos) o drop (solo pérdidas).

-z, --zero Mostrar los contadores que son cero en ambas direcciones.

-i, -- Mostrar los contadores de los componentes que están ocultos de manera
include- predeterminada.
hidden

-r, --drop- Muestra el motivo de pérdida más reciente para cada contador de pérdidas.
reason

--live Actualizar automáticamente los contadores. Pulse Ctrl+C para parar.

--refresh- Número de veces que se actualizan los contadores por segundo, de 1 a 30. El valor
rate <n> predeterminado es 10.

--json Mostrar los contadores en formato JSON. Implica -i y -r.

Vínculos relacionados
Pktmon
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon start
Pktmon status
Pktmon unload
Introducción al Monitor de paquetes
pktmon etl2pcap
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure Stack Hub, Azure

Convertir el archivo de registro pktmon al formato pcapng. Los paquetes perdidos no se


incluyen de forma predeterminada. Estos registros se pueden analizar mediante
Wireshark (o cualquier analizador de pcapng).

Sintaxis

pktmon etl2pcap <file> [--out <name>] [--drop-only] [--component-id <id>]

Donde <file> es el archivo ETL que se va a convertir.

Parámetros

Parámetro Descripción

-o, --out <name> Nombre del archivo pcapng con formato.

-d, --drop-only Convertir solo los paquetes perdidos.

-c, --component-id <id> Filtra los paquetes por un id. de componente específico.

Filtrado del resultado


Toda la información sobre los informes de colocación de paquetes y el flujo de paquetes
a través de la pila de conexión de red se perderá en la salida en formato pcapng. El
contenido del registro debe estar cuidadosamente filtrado previamente para mostrar la
conversión completa. Por ejemplo:

El formato pcapng no distingue entre un paquete en flujo y un paquete


descartado. Para separar todos los paquetes en la captura de los paquetes
descartados, genere dos archivos pcapng; uno que contenga todos los paquetes
( pktmon etl2pcap log.etl --out log-capture.etl ) y otro que contenga solo los
paquetes descartados ( pktmon etl2pcap log.etl --drop-only --out log-drop.etl ).
De este modo, puede analizar los paquetes descartados en un registro
independiente.
El formato pcapng no distingue entre distintos componentes de conexión de red
en los que se capturó un paquete. Para estos escenarios multicapa, especifique el
id. de componente deseado en la salida de pcapng pktmon etl2pcap log.etl --
component-id 5 . Repita este comando para cada conjunto de id. de componentes

que le interesen.

Vínculos relacionados
Pktmon
Pktmon counters
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon start
Pktmon status
Pktmon unload
Introducción al Monitor de paquetes
pktmon etl2txt
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure Stack Hub, Azure

Convierta el archivo de registro ETL en formato de texto.

Sintaxis

pktmon etl2txt <file> [--out <name>] [--stats-only] [--timestamp-only] [--


metadata]
[--tmfpath <path>] [--brief] [--verbose <n>] [--hex]
[--no-ethernet] [--vxlan <port>]

Donde <file> es el archivo ETL que se va a convertir.

Parámetros

Parámetro Descripción

-o, --out Nombre del archivo de texto con formato.


<name>

-s, --stats- Mostrar información estadística del archivo de registro.


only

-t, -- Use solo el prefijo timestamp para eventos y paquetes.


timestamp-
only

-m, -- Imprima metadatos de eventos, como el nivel de registro y las palabras clave.
metadata

-p, -- Ruta de acceso a los archivos TMF para descodificar seguimientos de WPP. En caso
tmfpath de varias rutas de acceso, se deben separar con punto y coma. Todos los
<path> seguimientos de WPP se omiten cuando no se especifica esta opción.

Opciones de formato de paquetes de red


Parámetro Descripción

-b, --brief Use el formato de paquete abreviado.

-v, --verbose <n> Nivel de detalle de 1 a 3.

-x, --hex Incluya el formato hexadecimal.

-e, --no-ethernet No imprima el encabezado Ethernet.

-l, --vxlan <port> Puerto VXLAN personalizado.

Vínculos relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon start
Pktmon status
Pktmon unload
Introducción al Monitor de paquetes
pktmon filter
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure Stack Hub, Azure

El filtro pktmon permite enumerar, agregar o quitar filtros de paquetes.

Sintaxis

pktmon filter { list | add | remove } [OPTIONS | help]

Parámetros

Parámetro Descripción

pktmon filter list Mostrar filtros de paquetes activos.

pktmon filter add Agregar un filtro para controlar qué paquetes se notifican.

pktmon filter remove Quita todos los filtros de paquetes.

Vínculos relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon start
Pktmon status
Pktmon unload
Introducción al Monitor de paquetes
pktmon filter add
Artículo • 05/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure Stack Hub, Azure

Añadir filtros Pktmon permite agregar un filtro para controlar qué paquetes se notifican.
Para que se notifique un paquete, debe coincidir con todas las condiciones
especificadas en al menos un filtro. Se pueden activar hasta 32 filtros a la vez.

Sintaxis

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]]

Puede proporcionar un nombre o una descripción opcionales del filtro.

7 Nota

Cuando se especifican dos MAC (-m), direcciones IP (-i) o puertos (-p), el filtro
coincide con los paquetes que contienen ambos. No distinguirá entre el origen o el
destino para este fin.

Parámetros
Puede proporcionar parámetros para el marco Ethernet, el encabezado IP, el
encabezado TCP/UDP, el latido del clúster y la encapsulación.

Parámetro Descripción

-m, --mac[- Coincide con la dirección MAC de origen o destino. Consulte la nota anterior.
address]

-v, --vlan Coincide con el identificador de VLAN (VID) en el encabezado 802.1Q.


Parámetro Descripción

-d, --data-link[- Coincide con el protocolo de vínculo de datos (capa 2). Puede ser IPv4, IPv6,
protocol], -- ARP o un número de protocolo.
ethertype

-t, --transport[- Coincide con el protocolo de transporte (capa 4). Puede ser TCP, UDP, ICMP,
protocol], --ip- ICMPv6 o un número de protocolo. Para filtrar aún más los paquetes TCP, se
protocol puede proporcionar una lista opcional de marcas TCP para que coincidan. Las
marcas admitidas son FIN, SYN, RST, PSH, ACK, URG, ECE y CWR.

-i, --ip[-address] Coincide con la dirección IP de origen o de destino. Consulte la nota anterior.
Para que coincida con la subred, use la notación CIDR con la longitud del
prefijo.

-p, --port Coincide con el número de puerto de origen o de destino. Consulte la nota
anterior.

-b, --heartbeat Coincide con los mensajes de latido de RCP a través del puerto UDP 3343.

-e, --encap Aplique los parámetros de filtrado anteriores a los encabezados de


encapsulación interna y externa. Los métodos de encapsulación admitidos
son VXLAN, GRE, NVGRE e IP en IP. El puerto VXLAN personalizado es
opcional y su valor predeterminado es 4789.

Ejemplos
El siguiente conjunto de filtros capturará cualquier tráfico ICMP de o a la dirección IP
10.0.0.10, así como cualquier tráfico en el puerto 53.

PowerShell

C:\Test> pktmon filter add -i 10.0.0.10 -t icmp


C:\Test> pktmon filter add -p 53

El siguiente filtro capturará todos los paquetes SYN enviados o recibidos por la
dirección IP 10.0.0.10:

PowerShell

C:\Test> pktmon filter add -i 10.0.0.10 -t tcp syn

El siguiente filtro denominado MyPing hace pings 10.10.10.10 mediante el protocolo


ICMP:

PowerShell
C:\Test> pktmon filter add MyPing -i 10.10.10.10 -t ICMP

El siguiente filtro denominado MySmbSyb captura el tráfico SMB sincronizado por TCP:

PowerShell

C:\Test> pktmon filter add MySmbSyn -i 10.10.10.10 -t TCP SYN -p 445

El siguiente filtro llamado MySubnet captura el tráfico en la máscara de subred


255.255.255.0 o /24 en notación CIDR:

PowerShell

C:\Test> pktmon filter add MySubnet -i 10.10.10.0/24

Otras referencias
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon start
Pktmon status
Pktmon unload
Introducción al Monitor de paquetes
pktmon hex2pkt
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure Stack Hub, Azure

Descodificar paquete en formato hexadecimal.

Sintaxis

pktmon hex2pkt [--type { Ethernet | IP | HTTP }]

Parámetros

Parámetro Descripción

-t, --type Tipo de paquete que se va a descodificar. Las opciones son Ethernet, IP y HTTP. El
valor predeterminado es Ethernet.

Vínculos relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon list
Pktmon reset
Pktmon start
Pktmon status
Pktmon unload
Introducción al Monitor de paquetes
pktmon list
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure Stack Hub, Azure

Enumera todos los componentes de red activos que se pueden supervisar, lo que le
permite examinar la distribución de la pila de red. El comando muestra los componentes
de red (controladores) ordenados por enlaces de adaptadores.

Sintaxis

pktmon list [--all] [--include-hidden] [--json]

Parámetros

Parámetro Descripción

-a, --all Mostrar todos los tipos de componentes. De forma predeterminada, solo se
muestran los adaptadores de red.

-i, --include- Mostrar los componentes que están ocultos de manera predeterminada.
hidden

--json Mostrar la lista en formato JSON. Implica -i y -a.

Vínculos relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon reset
Pktmon start
Pktmon status
Pktmon unload
Introducción al Monitor de paquetes
pktmon reset
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure Stack Hub, Azure

Restablezca los contadores a cero.

Sintaxis

pktmon reset [-counters]

Vínculos relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon start
Pktmon status
Pktmon unload
Introducción al Monitor de paquetes
pktmon start
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure Stack Hub, Azure

Inicia la captura de paquetes y la recopilación de eventos.

Sintaxis

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 paquetes


Use -c o --capture para habilitar la captura de paquetes y los contadores de paquetes,
junto con los siguientes parámetros opcionales.

Parámetro Descripción

-o, -- Recopilar solo contadores de paquetes. No hay registro de paquetes.


counters-
only

--comp Seleccionar los componentes en los que se capturarán los paquetes. Puede ser todos
los componentes (all), solo NIC (nics) o una lista de identificadores de componente.
El valor predeterminado es "all".

--type Seleccionar los paquetes que se van a capturar. Puede ser all, flow o drop. El valor
predeterminado es todos.

--pkt-size Número de bytes que se van a registrar desde cada paquete. Para registrar siempre
<bytes> todo el paquete, establézcalo en 0. El valor predeterminado es de 128 bytes.

--flags Máscara de bits hexadecimal que controla la información registrada durante la


<mask> captura de paquetes. El valor predeterminado es 0x012. Marcas de captura de
paquetes, a continuación.

Marcas de captura de paquetes


Las marcas siguientes se aplican al parámetro --flags (consulte anteriormente).

Marca Descripción

0x001 Errores internos del Monitor de paquetes.

0x002 Información sobre componentes, contadores y filtros. Esta información se agrega al final
del archivo de registro.

0x004 Información de origen y destino del primer paquete del grupo NET_BUFFER_LIST.

0x008 Seleccionar los metadatos del paquete de la enumeración NDIS_NET_BUFFER_LIST_INFO.

0x010 Paquete sin formato, truncado al tamaño especificado en el parámetro [--pkt-size].

Parámetros de la colección de eventos


Use -t o --trace para habilitar la recopilación de eventos, junto con los siguientes
parámetros opcionales.

Parámetro Descripción

-p, -- Nombre o GUID del proveedor de eventos. Para varios proveedores, use este
provider parámetro más de una vez.
<name>

-k, -- Máscara de bits hexadecimal que controla qué eventos se registran para el
keywords proveedor correspondiente. El valor predeterminado es 0xFFFFFFFF.
<k>

-l, --level Nivel de registro para el proveedor correspondiente. El valor predeterminado es 4


<n> (nivel de información).

Parámetros de registro
Use los parámetros siguientes para el registro:

Parámetro Descripción

-f, --file-name Nombre del archivo de registro. El valor predeterminado es PktMon.etl.


<name>

-s, --file-size Tamaño máximo del archivo de registro en megabytes. El valor


<size> predeterminado es 512 MB.

-m, --log-mode Establece el modo de registro (consulte a continuación). El valor


predeterminado es circular.
Modos de registro
Los modos siguientes se aplican al parámetro -m o --log-mode (consulte más arriba).

Modo Descripción

circular Los nuevos eventos sobrescriben los más antiguos cuando el registro está lleno.

multi- Se crea un nuevo archivo de registro cada vez que el registro está lleno. Los archivos
file de registro están numerados secuencialmente: PktMon1.etl, PktMon2.etl, etc. No hay
límite en el número de eventos capturados.

real- Mostrar eventos y paquetes en pantalla en tiempo real. No se crea ningún archivo de
time registro. Pulse Ctrl+C para detener la supervisión.

memory Al igual que circular, pero todo el registro se almacena en memoria. Se escribe en un
archivo cuando se detiene pktmon. El tamaño del búfer de memoria se especifica en el
parámetro [--file-size].

Ejemplos
Ejemplo 1: Captura de paquetes

PowerShell

C:\Test> pktmon start --capture

Ejemplo 2: Solo contadores de paquetes

PowerShell

C:\Test> pktmon start --capture --counters-only

Ejemplo 3: Registro de eventos

PowerShell

C:\Test> pktmon start --trace -p Microsoft-Windows-TCPIP -p Microsoft-


Windows-NDIS

Ejemplo 4: Captura de paquetes con registro de eventos

PowerShell

C:\Test> pktmon start --capture --trace -p Microsoft-Windows-TCPIP -k 0xFF -


l 4
Vínculos relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon status
Pktmon unload
Introducción al Monitor de paquetes
pktmon status
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure Stack Hub, Azure

Consultar el estado actual del Monitor de paquetes.

Sintaxis

pktmon status [--buffer-info]

Parámetros

Parámetro Descripción

-b, --buffer-info Mostrar información del búfer ETW.

Vínculos relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon start
Pktmon unload
Introducción al Monitor de paquetes
pktmon unload
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 10, Azure Stack
HCI, Azure Stack Hub, Azure Stack Hub, Azure

Detiene el servicio del controlador PktMon y descargar PktMon.sys. Equivalente eficaz a


“sc.exe detener PktMon”. La medida (si está activa) se detendrá inmediatamente y se
eliminará cualquier estado (contadores, filtros, etc.).

Sintaxis

pktmon unload

Vínculos relacionados
Pktmon
Pktmon counters
Pktmon etl2pcap
Pktmon etl2txt
Pktmon filter
Pktmon filter add
Pktmon hex2pkt
Pktmon list
Pktmon reset
Pktmon start
Pktmon status
Introducción al Monitor de paquetes
pnpunattend
Artículo • 14/04/2023

Audita un equipo para controladores de dispositivos y realiza instalaciones de


controladores desatendidas o busca controladores sin instalar y, opcionalmente, notifica
los resultados a la línea de comandos. Use este comando para especificar la instalación
de controladores específicos para dispositivos de hardware específicos.

Requisitos previos
La preparación preliminar es necesaria para versiones anteriores del sistema operativo
Windows. Antes de usar este comando, debe completar las siguientes tareas:

1. Cree un directorio para los controladores que desea instalar. Por ejemplo, cree una
carpeta en C:\Drivers\Video para controladores de adaptador de vídeo.

2. Descargue y extraiga el paquete de controladores del dispositivo. Copie el


contenido de la subcarpeta que contiene el archivo INF para la versión del sistema
operativo y las subcarpetas en la carpeta de vídeo que ha creado. Por ejemplo,
copie los archivos del controlador de vídeo en C:\Drivers\Video.

3. Agregue una variable de ruta de acceso del entorno del sistema a la carpeta que
creó en el paso 1. Por ejemplo, C:\Drivers\Video.

4. Cree la siguiente clave del registro y, a continuación, para la clave DriverPaths que
cree, establezca los datos del valor en 1.

5. Para Windows® 7, vaya a la ruta de acceso del registro:


HKEY_LOCAL_Machine\Software\Microsoft\Windows NT\CurrentVersion\ y, a
continuación, cree las claves: UnattendSettings\PnPUnattend\DriverPaths\

Sintaxis

PnPUnattend.exe auditsystem [/help] [/?] [/h] [/s] [/l]

Parámetros

Parámetro Descripción
Parámetro Descripción

auditsystem Especifica la instalación del controlador en línea.


Obligatorio, excepto cuando se ejecuta este comando con los parámetros /help o
/?.

/s Opcional. Especifica que se van a buscar controladores sin instalar.

/l Opcional. Especifica que se va mostrar la información de registro de este comando


en el símbolo del sistema.

/? | /help Opcional. Muestra ayuda para este comando en el símbolo del sistema.

Ejemplos
Para el comando se muestra cómo usar el PNPUnattend.exe para auditar un equipo con
posibles actualizaciones de controladores y, a continuación, notificar los resultados al
símbolo del sistema, escriba:

pnpunattend auditsystem /s /l

Vínculos relacionados
Clave de sintaxis de línea de comandos
pnputil
Artículo • 14/04/2023

Pnputil.exe es una utilidad de línea de comandos que puede usar para administrar el
almacén de controladores. Puede usar este comando para agregar paquetes de
controladores, quitar paquetes de controladores y enumerar los paquetes de
controladores que se encuentran en el almacén.

Sintaxis

pnputil.exe [-f | -i] [ -? | -a | -d | -e ] <INF name>

Parámetros

Parámetro Descripción

-a Especifica que se va a agregar el archivo INF identificado.

-d Especifica que se va a eliminar el archivo INF identificado.

-E Especifica que se van a enumerar todos los archivos INF de terceros.

-f Especifica que se va a forzar la eliminación del archivo INF identificado. No se puede


usar junto con el parámetro –i.

-i Especifica que se va a instalar el archivo INF identificado. No se puede usar junto


con el parámetro -f.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para agregar un archivo INF, denominado USBCAM.INF, escriba:

pnputil.exe -a a:\usbcam\USBCAM.INF

Para agregar todos los archivos INF, ubicados en c:\drivers, escriba:


pnputil.exe -a c:\drivers\*.inf

Para agregar e instalar el controlador USBCAM.INF, escriba:

pnputil.exe -i -a a:\usbcam\USBCAM.INF

Para enumerar todos los controladores de terceros, escriba:

pnputil.exe –e

Para eliminar el archivo INF y el controlador denominado oem0.inf, escriba:

pnputil.exe -d oem0.inf

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando popd
popd
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

El comando popd cambia el directorio actual al directorio almacenado más


recientemente por el comando pushd.

Cada vez que usa el comando pushd, se almacena un único directorio para su uso. Sin
embargo, puede almacenar varios directorios usando varias veces el comando pushd.
Los directorios se almacenan secuencialmente en una pila virtual, de modo que si usa el
comando pushd una vez, el directorio en el que usa el comando se coloca en la parte
inferior de la pila. Si vuelve a usar el comando, el segundo directorio se coloca encima
del primero. El proceso se repite cada vez que se usa el comando pushd.

Si usa el comando popd, el directorio de la parte superior de la pila se quita y el


directorio actual se cambia a ese directorio. Si vuelve a usar el comando popd, se quita
el siguiente directorio de la pila. Si las extensiones de comandos están habilitadas, el
comando popd quita las asignaciones de letras de unidad creadas por el comando
pushd.

Sintaxis

popd

Parámetros

Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para cambiar el directorio actual de aquel en el que se ejecutó el programa por lotes, y
después volver a cambiarlo, escriba:
@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

Vínculos relacionados
Clave de sintaxis de línea de comandos

pushd
PowerShell
Artículo • 08/04/2023

Windows PowerShell es un lenguaje de scripting y shell de línea de comandos basado


en tareas diseñado especialmente para la administración del sistema. Basado en .NET
Framework, Windows PowerShell ayuda a los profesionales de TI y a los usuarios
avanzados a controlar y automatizar la administración tanto del sistema operativo
Windows como de las aplicaciones que se ejecutan en Windows.

Uso de PowerShell.exe
La herramienta de línea de comandos PowerShell.exe inicia una sesión de Windows
PowerShell en una ventana del símbolo del sistema. Al usar PowerShell.exe, puede usar
sus parámetros opcionales para personalizar la sesión. Por ejemplo, puede iniciar una
sesión que use una directiva de ejecución determinada o una que excluya un perfil de
Windows PowerShell. De lo contrario, la sesión es la misma que cualquier sesión que se
inicie en la consola de Windows PowerShell.

Para iniciar una sesión de Windows PowerShell en una ventana del símbolo del
sistema, escriba PowerShell . Se agrega un prefijo PS al símbolo del sistema para
indicar que se encuentra en una sesión de Windows PowerShell.

Para iniciar una sesión con una directiva de ejecución determinada, use el
parámetro ExecutionPolicy y escriba:

PowerShell

PowerShell.exe -ExecutionPolicy Restricted

Para iniciar una sesión de Windows PowerShell sin los perfiles de Windows
PowerShell, use el parámetro NoProfile y escriba:

PowerShell

PowerShell.exe -NoProfile

Para iniciar una sesión, use el parámetro ExecutionPolicy y escriba:

PowerShell

PowerShell.exe -ExecutionPolicy Restricted


Para ver el archivo de ayuda de PowerShell.exe, escriba:

PowerShell

PowerShell.exe -help
PowerShell.exe -?
PowerShell.exe /?

Para finalizar una sesión de Windows PowerShell en una ventana del símbolo del
sistema, escriba exit . Se muestra el típico símbolo del sistema.

Comentarios
Para obtener una lista completa de los parámetros de la línea de comandos de
PowerShell.exe, consulte about_PowerShell.Exe.

Para obtener información sobre otras formas de iniciar Windows PowerShell, vea
Iniciar Windows PowerShell.

Windows PowerShell se ejecuta en la opción de instalación Server Core de los


sistemas operativos Windows Server. Sin embargo, las características que
requieren una interfaz de usuario gráfica, como el entorno de scripting integrado
(ISE) de Windows PowerShell y los cmdlets Out-GridView y Show-Command, no se
ejecutan en instalaciones de Server Core.

Vínculos relacionados
about_PowerShell.Exe

about_PowerShell_Ise.exe

Windows PowerShell
PowerShell_ise
Artículo • 12/04/2023

Windows PowerShell ISE es una aplicación host gráfica que le permite leer, escribir,
ejecutar y probar scripts y módulos en un entorno asistido por gráficos. Las
características principales, como IntelliSense, Show-Command, fragmentos de código,
finalización con tabulación, coloración de sintaxis, depuración visual y la ayuda
contextual proporcionan una experiencia de scripting muy completa.

Uso de PowerShell.exe
La herramienta PowerShell_ISE.exe inicia una sesión Windows PowerShell ISE. Al usar
PowerShell_ISE.exe, puede usar sus parámetros opcionales para abrir archivos en
Windows PowerShell ISE o para iniciar una sesión de Windows PowerShell ISE sin perfil o
con un apartamento multiproceso.

Para iniciar una sesión de Windows PowerShell ISE en una ventana de símbolo del
sistema, en Windows PowerShell o en el menú Inicio, escriba:

PowerShell

PowerShell_Ise.exe

Para abrir un script (.ps1), módulo de script (.psm1), manifiesto de módulo (.psd1),
archivo XML o cualquier otro archivo admitido en Windows PowerShell ISE, escriba:

PowerShell

PowerShell_Ise.exe <filepath>

En Windows PowerShell 3.0, puede usar el parámetro opcional File de la siguiente


manera:

PowerShell

PowerShell_Ise.exe -file <filepath>

Para iniciar una sesión de Windows PowerShell ISE sin los perfiles de Windows
PowerShell, use el parámetro NoProfile. (El parámetro NoProfile se introduce en
Windows PowerShell 3.0).), escriba:
PowerShell

PowerShell_Ise.exe -NoProfile

Para ver el archivo de ayuda PowerShell_ISE.exe, escriba:

PowerShell

PowerShell_Ise.exe -help
PowerShell_Ise.exe -?
PowerShell_Ise.exe /?

Comentarios
Para obtener una lista completa de los parámetros de la línea de comandos de
PowerShell_ISE.exe, consulte about_PowerShell_Ise.Exe.

Para obtener información sobre otras formas de iniciar Windows PowerShell,


consulte Iniciar Windows PowerShell.

Windows PowerShell se ejecuta en la opción de instalación Server Core de los


sistemas operativos Windows Server. Sin embargo, dado que Windows PowerShell
ISE requiere una interfaz gráfica de usuario, no se ejecuta en instalaciones de
Server Core.

Vínculos relacionados
about_PowerShell_Ise.exe
print
Artículo • 08/04/2023

Envía un archivo de texto a una impresora. Un archivo puede imprimirse en segundo


plano si lo envía a una impresora conectada a un puerto de serie o paralelo del equipo
local.

7 Nota

Puede realizar muchas tareas de configuración desde el símbolo del sistema


usando el comando Mode, incluida la configuración de una impresora conectada a
un puerto paralelo o serie, la visualización del estado de la impresora o la
preparación de una impresora para el cambio de página de códigos.

Sintaxis

print [/d:<printername>] [<drive>:][<path>]<filename>[ ...]

Parámetros

Parámetro Descripción

/d: <printername> Especifica la impresora en la que quiere imprimir el trabajo. Para imprimir en
una impresora conectada localmente, especifique el puerto en el equipo
donde está conectada la impresora. Los valores válidos para los puertos
paralelos son LPT1, LPT2 y LPT3. Los valores válidos para los puertos de serie
son COM1, COM2, COM3 y COM4. También puede especificar una impresora
de red mediante su nombre de cola ( \\server_name\printer_name ). Si no
especifica una impresora, el trabajo de impresión se envía a LPT1 de forma
predeterminada.

<drive> : Especifica la unidad lógica o física donde se encuentra el archivo que quiere
imprimir. Este parámetro no es necesario si el archivo que quiere imprimir se
encuentra en la unidad actual.

<path> Especifica la ubicación del archivo que quiere imprimir. Este parámetro no es
necesario si el archivo que quiere imprimir se encuentra en el directorio
actual.
Parámetro Descripción

<filename>[ Necesario. Especifica el archivo que quiere imprimir. Puede incluir varios
...] archivos en un comando.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para enviar el archivo report.txt, ubicado en el directorio actual, a una impresora
conectada a lpt2 en el equipo local, escriba:

print /d:lpt2 report.txt

Para enviar el archivo report.txt, ubicado en el directorio c:\accounting, a la cola de


impresión printer1 en el servidor /d:\copyroom, escriba:

print /d:\\copyroom\printer1 c:\accounting\report.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos de impresión

Comando Mode
prncnfg
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Configura o muestra información de la configuración de una impresora. Este comando


es un script de Visual Basic ubicado en el directorio
%WINdir%\System32\printing_Admin_Scripts\<language> . Para usar este comando en un

símbolo del sistema, escriba cscript seguido de la ruta de acceso completa al archivo
prncnfg o cambie los directorios a la carpeta adecuada. Por ejemplo: cscript
%WINdir%\System32\printing_Admin_Scripts\en-US\prncnfg .

Sintaxis

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 Descripción

-g Muestra información de configuración sobre una impresora.

-T Configura una impresora.

-X Cambia el nombre de una impresora.

-S <Servername> Especifica el nombre del equipo remoto que aloja la impresora que
quiere administrar. Si no especifica un equipo, se usa el equipo local.

-P <Printername> Especifica el nombre de la impresora que quiere administrar. Necesario.

-z <newprintername> Especifica el nuevo nombre de la impresora. Requiere los parámetros -x


y -P.
Parámetro Descripción

-u <Username> -w Especifica una cuenta con permisos para conectarse al equipo que
<password> hospeda la impresora que quiere administrar. Todos los miembros del
grupo local de Administradores del equipo de destino tienen estos
permisos, pero los permisos también pueden concederse a otros
usuarios. Si no especifica una cuenta, debe iniciar sesión en una cuenta
con estos permisos para que el comando funcione.

-r <portname> Especifica el puerto donde está conectada la impresora. Si se trata de un


puerto paralelo o serie, use el identificador del puerto (por ejemplo, LPT1
o COM1). Si se trata de un puerto TCP/IP, use el nombre de puerto que
se especificó cuando se agregó el puerto.

-l <location> Especifica la ubicación de la impresora, como Copyroom. Si la ubicación


contiene espacios, use comillas alrededor del texto, como “Sala de
copia”.

-h <sharename> Especifica el nombre del recurso compartido de la impresora.

-m <comment> Especifica la cadena de comentario de la impresora.

-f Especifica un archivo que contiene el texto que aparece en la página del


<separatorfilename> separador.

-y <datatype> Especifica los tipos de datos que la impresora puede aceptar.

-st <starttime> Configura la impresora para una disponibilidad limitada. Especifica la


hora del día en que la impresora está disponible. Si envía un documento
a una impresora cuando no está disponible, el documento se mantiene
(en cola) hasta que la impresora esté disponible. Debe especificar la hora
en formato de reloj de 24 horas. Por ejemplo, para especificar 11:00
p. m., escriba 2300.

-ut <endtime> Configura la impresora para una disponibilidad limitada. Especifica la


hora del día en que la impresora ya no está disponible. Si envía un
documento a una impresora cuando no está disponible, el documento se
mantiene (en cola) hasta que la impresora esté disponible. Debe
especificar la hora en formato de reloj de 24 horas. Por ejemplo, para
especificar 11:00 p. m., escriba 2300.

-o <priority> Especifica una prioridad que el administrador de trabajos de cola usa


para enrutar los trabajos de impresión a la cola de impresión. Una cola
de impresión con una prioridad más alta recibe todos sus trabajos antes
de cualquier cola con una prioridad más baja.

-i <defaultpriority> Especifica la prioridad predeterminada asignada a cada trabajo de


impresión.

{+|-} shared Especifica si esta impresora se comparte en la red.


Parámetro Descripción

{+|-} direct Especifica si el documento se debe enviar directamente a la impresora


sin que se ponga en cola.

{+|-} published Especifica si esta impresora debe publicarse en Active Directory. Si


publica la impresora, otros usuarios pueden buscarla en función de su
ubicación y funcionalidades (como la impresión en color y la asociación).

{+|-} hidden Función reservada.

{+|-} rawonly Especifica si solo se pueden poner en cola trabajos de impresión de


datos sin procesar en esta cola.

{+|-} }queued Especifica que la impresora no debe empezar a imprimir hasta después
de que la última página del documento esté en cola. El programa de
impresión no está disponible hasta que el documento haya terminado de
imprimirse. Sin embargo, el uso de este parámetro garantiza que todo el
documento esté disponible para la impresora.

{+|-} keepprintedjobs Especifica si el administrador de colas debe conservar los documentos


una vez impresos. Al habilitar esta opción, un usuario puede volver a
enviar un documento a la impresora desde la cola de impresión en lugar
de desde el programa de impresión.

{+|-} workoffline Especifica si un usuario puede enviar trabajos de impresión a la cola de


impresión si el equipo no está conectado a la red.

{+|-} enabledevq Especifica si los trabajos de impresión que no coinciden con la


configuración de la impresora (por ejemplo, los archivos PostScript
agrupados en impresoras que no son PostScript) deben mantenerse en la
cola en lugar de imprimirse.

{+|-} docompletefirst Especifica si el administrador de trabajos de impresión debe enviar


trabajos de impresión con una prioridad más baja que haya completado
la cola antes de enviar trabajos de impresión con una prioridad más alta
que no haya completado la cola. Si esta opción está habilitada y no se ha
completado la cola de documentos, el administrador de cola enviará los
documentos más grandes antes de los más pequeños. Debe habilitar
esta opción si desea maximizar la eficiencia de la impresora a costa de la
prioridad del trabajo. Si esta opción está deshabilitada, el administrador
de colas siempre envía los trabajos de mayor prioridad a sus respectivas
colas primero.

{+|-} enablebidi Especifica si la impresora envía información de estado al administrador


de trabajos en cola.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para mostrar la información de configuración de la impresora denominada
colorprinter_2 con una cola de impresión hospedada por el equipo remoto denominado
HRServer, escriba:

cscript prncnfg -g -S HRServer -P colorprinter_2

Para configurar una impresora denominada colorprinter_2 para que el administrador de


trabajos en cola del equipo remoto denominado HRServer mantenga los trabajos de
impresión después de que se hayan impreso, escriba:

cscript prncnfg -t -S HRServer -P colorprinter_2 +keepprintedjobs

Para cambiar el nombre de una impresora en el equipo remoto denominado HRServer


de colorprinter_2 a colorprinter 3, escriba:

cscript prncnfg -x -S HRServer -P colorprinter_2 -z "colorprinter 3"

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos de impresión


prndrvr
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Agrega, elimina y enumera controladores de impresora. Este comando es un script de


Visual Basic ubicado en el directorio %WINdir%\System32\printing_Admin_Scripts\
<language> . Para usar este comando en un símbolo del sistema, escriba cscript seguido

de la ruta de acceso completa al archivo prndrvr o cambie los directorios a la carpeta


adecuada. Por ejemplo: cscript %WINdir%\System32\printing_Admin_Scripts\en-
US\prndrvr .

Si se usa sin parámetros, prndrvr muestra la ayuda de la línea de comandos.

Sintaxis

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 Descripción

-a Instala un controlador.

-d Elimina un controlador.

-l Enumera todos los controladores de impresora instalados en el servidor


especificado por el parámetro -s. Si no especifica un servidor, Windows
enumera los controladores de impresora instalados en el equipo local.

-X Elimina todos los controladores de impresora y los controladores de


impresora adicionales que no están en uso por una impresora lógica en el
servidor especificado por el parámetro -s. Si no especifica un servidor para
quitar de la lista, Windows elimina todos los controladores de impresora no
usados en el equipo local.

-m <model_name> Especifica (por nombre) el controlador que desea instalar. Los controladores
suelen denominarse según el modelo de impresora que admiten. Consulte la
Parámetro Descripción

documentación de la impresora para obtener más información.

-v {0|1|2|3} Especifica la versión del controlador que desea instalar. Consulte la


descripción del parámetro -epara obtener información sobre qué versiones
están disponibles para cada entorno. Si no especifica una versión, se instala la
versión del controlador adecuada para la versión de Windows que se ejecuta
en el equipo donde está instalando el controlador.

-e <environment> Especifica el entorno para el controlador que desea instalar. Si no especifica


un entorno, se usará el entorno del equipo en el que está instalando el
controlador. Los parámetros de entorno admitidos son: Windows NT x86,
Windows x64 o Windows IA64.

-s <Servername> Especifica el nombre del equipo remoto que aloja la impresora que quiere
administrar. Si no especifica un equipo, se usa el equipo local.

-u <Username> -w Especifica una cuenta con permisos para conectarse al equipo que hospeda la
<password> impresora que quiere administrar. Todos los miembros del grupo local de
Administradores del equipo de destino tienen estos permisos, pero los
permisos también pueden concederse a otros usuarios. Si no especifica una
cuenta, debe iniciar sesión con una cuenta que tenga estos permisos para
que el comando funcione.

-h <path> Especifica la ruta de acceso al archivo del controlador. Si no especifica una


ruta de acceso, se usará la ruta de acceso a la ubicación donde se instaló
Windows.

-i <filename.inf> Especifica la ruta de acceso completa y el nombre de archivo del controlador


que desea instalar. Si no especifica un nombre de archivo, el script usa uno
de los archivos .inf de la impresora de bandeja de entrada en el subdirectorio
inf del directorio de Windows.
Si no se especifica la ruta de acceso del controlador, el script busca archivos
de controlador en el archivo driver.cab.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si la información que proporciona contiene espacios, use comillas (por ejemplo,
"Nombre del equipo").

El parámetro -x elimina todos los controladores de impresora adicionales


(controladores instalados para su uso en clientes que ejecutan versiones
alternativas de Windows), incluso si el controlador principal está en uso. Si el
componente del fax está instalado, esta opción también elimina los controladores
del fax. El controlador del fax principal se elimina si no está en uso (es decir, si no
hay ninguna cola que lo use). Si se elimina el controlador del fax principal, la única
manera de volver a habilitar el fax es volver a instalar el componente del fax.

Ejemplos
Para enumerar todos los controladores del servidor local \printServer1, escriba:

cscript prndrvr -l -s

Para añadir un controlador de impresora versión 3 Windows x64 para el modelo 1 de


impresora láser utilizando el archivo de información del controlador
c:\temp\Laserprinter1.inf para un controlador almacenado en la carpeta c:\temp, escriba:

cscript prndrvr -a -m Laser printer model 1 -v 3 -e Windows x64 -i


c:\temp\Laserprinter1.inf -h c:\temp

Para eliminar un controlador de impresora Windows x64 versión 3 para impresora láser
modelo 1, escriba:

cscript prndrvr -a -m Laser printer model 1 -v 3 -e Windows x64

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos de impresión


prnjobs
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Pausa, reanuda, cancela y enumera los trabajos de impresión. Este comando es un script
de Visual Basic ubicado en el directorio %WINdir%\System32\printing_Admin_Scripts\
<language> . Para usar este comando en un símbolo del sistema, escriba cscript seguido

de la ruta de acceso completa al archivo prnjobs o cambie los directorios a la carpeta


adecuada. Por ejemplo: cscript %WINdir%\System32\printing_Admin_Scripts\en-
US\prnjobs.vbs .

Sintaxis

cscript prnjobs {-z | -m | -x | -l | -?} [-s <Servername>] [-p


<Printername>] [-j <JobID>] [-u <Username>] [-w <password>]

Parámetros

Parámetro Descripción

-Z Pausa el trabajo de impresión especificado por el parámetro -j.

-M Reanuda el trabajo de impresión especificado por el parámetro -j.

-X Cancela el trabajo de impresión especificado por el parámetro -j.

-l Enumera todos los trabajos de impresión de una cola de impresión.

-s Especifica el nombre del equipo remoto que aloja la impresora que quiere
<Servername> administrar. Si no especifica un equipo, se usa el equipo local.

-p Necesario. Especifica el nombre de la impresora que quiere administrar.


<Printername>

-j <JobID> Especifica (por número de identificador) el trabajo de impresión que desea


cancelar.
Parámetro Descripción

-u <Username> Especifica una cuenta con permisos para conectarse al equipo que hospeda la
-w <password> impresora que quiere administrar. Todos los miembros del grupo local de
Administradores del equipo de destino tienen estos permisos, pero los permisos
también pueden concederse a otros usuarios. Si no especifica una cuenta, debe
iniciar sesión en una cuenta con estos permisos para que el comando funcione.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si la información que proporciona contiene espacios, use comillas alrededor del
texto (por ejemplo, “Nombre del equipo”).

Ejemplos
Para pausar un trabajo de impresión con un identificador de trabajo de 27 enviado al
equipo remoto denominado HRServer para imprimir en la impresora denominada
colorprinter, escriba:

cscript prnjobs.vbs -z -s HRServer -p colorprinter -j 27

Para enumerar todos los trabajos de impresión actuales de la cola de la impresora local
denominada colorprinter_2, escriba:

cscript prnjobs.vbs -l -p colorprinter_2

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos de impresión


prnmngr
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Agrega, elimina y enumera impresoras o conexiones de impresora, además de


establecer y mostrar la impresora predeterminada. Este comando es un script de Visual
Basic ubicado en el directorio %WINdir%\System32\printing_Admin_Scripts\<language> .
Para usar este comando en un símbolo del sistema, escriba cscript seguido de la ruta de
acceso completa al archivo prnmngr o cambie los directorios a la carpeta adecuada. Por
ejemplo: cscript %WINdir%\System32\printing_Admin_Scripts\en-US\prnmngr .

Sintaxis

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 Descripción

-a Agrega una conexión de impresora local.

-d Elimina una conexión de impresora.

-X Elimina todas las impresoras del servidor especificado por el parámetro -s. Si no
especifica un servidor, Windows elimina todas las impresoras del equipo local.

-g Muestra la impresora predeterminada.

-T Establece la impresora predeterminada en la impresora especificada por el


parámetro -p.

-l Enumera todas las impresoras instaladas en el servidor especificado por el


parámetro -s. Si no especifica un servidor, Windows enumera las impresoras
instaladas en el equipo local.

c Especifica que el parámetro se aplica a las conexiones de impresora. Se puede


usar con los parámetros -a y -x.
Parámetro Descripción

-s Especifica el nombre del equipo remoto que aloja la impresora que quiere
<Servername> administrar. Si no especifica un equipo, se usa el equipo local.

-p Especifica el nombre de la impresora que quiere administrar.


<Printername>

-m Especifica (por nombre) el controlador que desea instalar. Los controladores


<Modelname> suelen denominarse según el modelo de impresora que admiten. Consulte la
documentación de la impresora para más información.

-r <portname> Especifica el puerto donde está conectada la impresora. Si se trata de un puerto


paralelo o serie, use el identificador del puerto (por ejemplo, LPT1: o COM1:). Si
se trata de un puerto TCP/IP, use el nombre de puerto que se especificó cuando
se agregó el puerto.

-u <Username> Especifica una cuenta con permisos para conectarse al equipo que hospeda la
-w <password> impresora que quiere administrar. Todos los miembros del grupo local de
Administradores del equipo de destino tienen estos permisos, pero los permisos
también pueden concederse a otros usuarios. Si no especifica una cuenta, debe
iniciar sesión en una cuenta con estos permisos para que el comando funcione.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si la información que proporciona contiene espacios, use comillas alrededor del
texto (por ejemplo, "Nombre del equipo").

Ejemplos
Para agregar una impresora llamada colorprinter_2 que está conectada a LPT1 en el
equipo local y requiere un controlador de impresora llamado color printer Driver1,
escriba:

cscript prnmngr -a -p colorprinter_2 -m "color printer Driver1" -r lpt1:

Para eliminar la impresora denominada colorprinter_2 del equipo remoto denominado


HRServer, escriba:

cscript prnmngr -d -s HRServer -p colorprinter_2


Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos de impresión


prnport
Artículo • 09/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea, elimina y enumera los puertos de impresora TCP/IP estándar, además de mostrar y
cambiar la configuración del puerto. Este comando es un script de Visual Basic ubicado
en el directorio %WINdir%\System32\printing_Admin_Scripts\<language> . Para usar este
comando en un símbolo del sistema, escriba cscript seguido de la ruta de acceso
completa al archivo prnport o cambie los directorios a la carpeta adecuada. Por ejemplo:
cscript %WINdir%\System32\printing_Admin_Scripts\en-US\prnport .

Sintaxis

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 Descripción

-a Crea un puerto de impresora TCP/IP estándar.

-d Elimina un puerto de impresora TCP/IP estándar.

-l Enumera todos los puertos de impresora TCP/IP estándar en el equipo


especificado por el parámetro -s.

-g Muestra la configuración de un puerto de impresora TCP/IP estándar.

-T Configura los valores de puerto para un puerto de impresora TCP/IP estándar.

-r <portname> Especifica el puerto al que está conectada la impresora.

-s <Servername> Especifica el nombre del equipo remoto que aloja la impresora que quiere
administrar. Si no especifica un equipo, se usa el equipo local.
Parámetro Descripción

-u <Username> - Especifica una cuenta con permisos para conectarse al equipo que hospeda la
w <password> impresora que quiere administrar. Todos los miembros del grupo local de
Administradores del equipo de destino tienen estos permisos, pero los
permisos también pueden concederse a otros usuarios. Si no especifica una
cuenta, debe iniciar sesión en una cuenta con estos permisos para que el
comando funcione.

-o {raw|lpr} Especifica el protocolo que usa el puerto: TCP raw o TCP lpr. El protocolo TCP
raw es un protocolo de mayor rendimiento en Windows que el protocolo lpr.
Si usa TCP raw, opcionalmente puede especificar el número de puerto
mediante el parámetro -n. El número de puerto predeterminado es 9100.

-h Especifica (por dirección IP) la impresora para la que desea configurar el


<Hostaddress> puerto.

-q <Queuename> Especifica el nombre de la cola para un puerto sin formato TCP.

-n <portnumber> Especifica el número de puerto de un puerto sin formato TCP. El número de


puerto predeterminado es 9100.

-M {e|d} Especifica si SNMP está habilitado. El parámetro e habilita SNMP. El parámetro


d deshabilita SNMP.

-i <SNMPindex Especifica el índice SNMP, si SNMP está habilitado. Para más información,
consulte Rfc 1759 en el sitio web del editor de Rfc .

-y Especifica el nombre de la comunidad SNMP, si SNMP está habilitado.


<communityname>

-2 {e|-d} Especifica si las colas dobles (también conocidas como reespooling) están
habilitadas para los puertos TCP lpr. Las colas dobles son necesarias porque
TCP lpr debe incluir un recuento de bytes preciso en el archivo de control que
se envía a la impresora, pero el protocolo no puede obtener el recuento del
proveedor de impresión local. Por lo tanto, cuando un archivo se pone en cola
en una cola de impresión de TCP lpr, también se pone en cola como un
archivo temporal en el directorio system32. TCP lpr determina el tamaño del
archivo temporal y envía el tamaño al servidor que ejecuta LPD. El parámetro e
habilita las colas dobles. El parámetro d deshabilita las colas dobles.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si la información que proporciona contiene espacios, use comillas alrededor del
texto (por ejemplo, "Nombre del equipo").
Ejemplos
Para mostrar todos los puertos de impresión TCP/IP estándar en el servidor \Server1,
escriba:

cscript prnport -l -s Server1

Para eliminar el puerto de impresión TCP/IP estándar en el servidor \Server1 que se


conecta a una impresora de red en 10.2.3.4, escriba:

cscript prnport -d -s Server1 -r IP_10.2.3.4

Para agregar un puerto de impresión TCP/IP estándar en el servidor \Server1 que se


conecta a una impresora de red en la versión 10.2.3.4 y usa el protocolo TCP raw en el
puerto 9100, escriba:

cscript prnport -a -s Server1 -r IP_10.2.3.4 -h 10.2.3.4 -o raw -n 9100

Para activar SNMP, especificar el nombre de comunidad "public" y establecer el índice


SNMP en 1 en una impresora de red en 10.2.3.4 compartida por el servidor \Server1,
tipo:

cscript prnport -t -s Server1 -r IP_10.2.3.4 -me -y public -i 1 -n 9100

Para agregar un puerto de impresión TCP/IP estándar en el equipo local que se conecta
a una impresora de red a la 10.2.3.4 y obtener automáticamente la configuración del
dispositivo de la impresora, escriba:

cscript prnport -a -r IP_10.2.3.4 -h 10.2.3.4

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos de impresión


prnqctl
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Imprime una página de prueba, pausa o reanuda una impresora y borra una cola de
impresora. Este comando es un script de Visual Basic ubicado en el directorio
%WINdir%\System32\printing_Admin_Scripts\<language> . Para usar este comando en un

símbolo del sistema, escriba cscript seguido de la ruta de acceso completa al archivo
prnqctl o cambie los directorios a la carpeta adecuada. Por ejemplo: cscript
%WINdir%\System32\printing_Admin_Scripts\en-US\prnqctl .

Sintaxis

cscript Prnqctl {-z | -m | -e | -x | -?} [-s <Servername>] [-p


<Printername>] [-u <Username>] [-w <password>]

Parámetros

Parámetro Descripción

-Z Pausa la impresión en la impresora especificada por el parámetro -p.

-M Reanuda la impresión en la impresora especificada por el parámetro -p.

-E Imprime una página de prueba en la impresora especificada por el parámetro -p.

-X Cancela todos los trabajos de impresión de la impresora especificada por el


parámetro -p.

-s Especifica el nombre del equipo remoto que aloja la impresora que quiere
<Servername> administrar. Si no especifica un equipo, se usa el equipo local.

-p Necesario. Especifica el nombre de la impresora que quiere administrar.


<Printername>
Parámetro Descripción

-u <Username> Especifica una cuenta con permisos para conectarse al equipo que hospeda la
-w <password> impresora que quiere administrar. Todos los miembros del grupo local de
Administradores del equipo de destino tienen estos permisos, pero los permisos
también pueden concederse a otros usuarios. Si no especifica una cuenta, debe
iniciar sesión en una cuenta con estos permisos para que el comando funcione.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si la información que proporciona contiene espacios, use comillas alrededor del
texto (por ejemplo, "Nombre del equipo").

Ejemplos
Para imprimir una página de prueba en la impresora Laserprinter1 compartida por el
equipo \Server1, escriba:

cscript prnqctl -e -s Server1 -p Laserprinter1

Para pausar la impresión en la impresora Laserprinter1 del equipo local, escriba:

cscript prnqctl -z -p Laserprinter1

Para cancelar todos los trabajos de impresión en la impresora Laserprinter1 del equipo
local, escriba:

cscript prnqctl -x -p Laserprinter1

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos de impresión


símbolo del sistema
Artículo • 08/04/2023

Cambia el símbolo del sistema Cmd.exe, incluida la visualización de cualquier texto que
desee, como el nombre del directorio actual, la hora y la fecha, o el número de versión
de Microsoft Windows. Si se usa sin parámetros, este comando restablece el símbolo del
sistema a la configuración predeterminada, que es la letra de unidad actual y el
directorio seguidos del símbolo mayor que (>).

Sintaxis

prompt [<text>]

Parámetros

Parámetro Descripción

<text> Especifica el texto y la información que desea incluir en el símbolo del sistema.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Las combinaciones de caracteres que puede incluir en lugar de, o además de, una
o varias cadenas de caracteres en el parámetro text:

Carácter Descripción

$q = (signo igual)

$$ $ (Signo del dólar)

$t Hora actual

$d Fecha actual

$p Unidad y ruta de acceso actuales

$v Número de versión de Windows

$n Unidad actual
Carácter Descripción

$g > (Signo mayor que)

$l < (Signo menor que)

$b | (Símbolo de barra vertical)

$_ ENTER-LINEFEED

$e Código de escape ANSI (código 27)

$h Retroceso (para eliminar un carácter escrito en la línea de comandos)

$a & (Y comercial)

$c ( (Paréntesis izquierdo)

$f ) (Paréntesis derecho)

$s Space

Cuando las extensiones de comandos están activadas, el comando prompt es


compatible con los siguientes caracteres de formato:

Carácter Descripción

$+ Cero o más caracteres de signo más (+), dependiendo de la profundidad de la


pila de directorios pushd (un carácter por cada nivel insertado).

$m Nombre remoto asociado a la letra de unidad actual o a la cadena vacía si la


unidad actual no es una unidad de red.

Si incluye el carácter $p en el parámetro de texto, se leerá su disco después de


escribir cada comando (para determinar la unidad y la ruta de acceso actuales).
Esto puede tardar más tiempo, especialmente en unidades de disquete.

Ejemplos
Para establecer un indicador de comandos de dos líneas con la hora y la fecha actuales
en la primera línea y el signo mayor que en la línea siguiente, escriba:

prompt $d$s$s$t$_$g
El símbolo del sistema se cambia de la siguiente manera, donde la fecha y hora son
actuales:

Fri 06/01/2007 13:53:28.91

Para establecer el símbolo del sistema para que se muestre como una flecha ( --> ),
escriba:

prompt --$g

Para cambiar manualmente el símbolo del sistema a la configuración predeterminada (la


unidad actual y la ruta de acceso seguidas del signo mayor que), escriba:

prompt $p$g

Vínculos relacionados
Clave de sintaxis de línea de comandos
pubprn
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Publica una impresora en Active Directory Domain Services. Este comando es un script
de Visual Basic ubicado en el directorio %WINdir%\System32\printing_Admin_Scripts\
<language> . Para usar este comando en un símbolo del sistema, escriba cscript seguido

de la ruta de acceso completa al archivo pubprn o cambie los directorios a la carpeta


adecuada. Por ejemplo: cscript %WINdir%\System32\printing_Admin_Scripts\en-
US\pubprn .

Sintaxis

cscript pubprn {<servername> | <UNCprinterpath>} LDAP://CN=<container>,DC=


<container>

Parámetros

Parámetro Descripción

<servername> Especifica el nombre del equipo remoto que hospeda la impresora que
desea administrar. Si no especifica un equipo, se usa el equipo local.

<UNCprinterpath> Ruta de acceso de convención de nomenclatura universal (UNC) a la


impresora compartida que quiere publicar.

LDAP://CN= Especifica la ruta de acceso al contenedor en Active Directory Domain


<Container>,DC= Services donde desea publicar la impresora.
<Container>

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si la información que proporciona contiene espacios, use comillas alrededor del
texto (por ejemplo, "Nombre del equipo").
Ejemplos
Para publicar todas las impresoras en el equipo \Server1 en el contenedor MyContainer
del dominio MyDomain.company.com, escriba:

cscript pubprn Server1 LDAP://CN=MyContainer,DC=MyDomain,DC=company,DC=Com

Para publicar la impresora Laserprinter1 en el servidor \\Server1 en el contenedor


MyContainer del dominio MyDomain.company.com, escriba:

cscript pubprn \\Server1\Laserprinter1


LDAP://CN=MyContainer,DC=MyDomain,DC=company,DC=Com

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos de impresión


pushd
Artículo • 14/04/2023

Almacena el directorio actual para que lo use el comando popd y, a continuación,


cambia al directorio especificado.

Cada vez que usa el comando pushd, se almacena un único directorio para su uso. Sin
embargo, puede almacenar varios directorios usando varias veces el comando pushd.
Los directorios se almacenan secuencialmente en una pila virtual, de modo que si usa el
comando pushd una vez, el directorio en el que usa el comando se coloca en la parte
inferior de la pila. Si vuelve a usar el comando, el segundo directorio se coloca encima
del primero. El proceso se repite cada vez que se usa el comando pushd.

Si usa el comando popd, el directorio de la parte superior de la pila se quita y el


directorio actual se cambia a ese directorio. Si vuelve a usar el comando popd, se quita
el siguiente directorio de la pila. Si las extensiones de comandos están habilitadas, el
comando popd quita la asignación de letras de unidad creadas por el comando pushd.

Sintaxis

pushd [<path>]

Parámetros

Parámetro Descripción

<path> Especifica el directorio que se va a convertir en el directorio actual. Este comando


admite rutas de acceso relativas.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Si las extensiones de comandos están habilitadas, el comando pushd acepta una


ruta de acceso de red o una letra de unidad local y una ruta de acceso.

Si especifica una ruta de acceso de red, el comando pushd asigna temporalmente


la letra de unidad sin usar más alta (a partir de Z:) al recurso de red especificado. A
continuación, el comando cambia la unidad actual y el directorio al directorio
especificado en la unidad recién asignada. Si usa el comando popd con
extensiones de comandos habilitadas, el comando popd quita la asignación de
letras de unidad creada por pushd.

Ejemplos
Para cambiar el directorio actual de aquel en el que se ejecutó el programa por lotes, y
después volver a cambiarlo:

@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

Vínculos relacionados
Clave de sintaxis de línea de comandos

comando popd
pushprinterconnections
Artículo • 06/04/2023

Lee la configuración de la Conexión de impresora implementada desde la directiva de


grupo e implementa/elimina las conexiones de impresora según sea necesario.

) Importante

Esta utilidad es para usar en el arranque de la máquina o en scripts de inicio de


sesión de usuario, y no debe ejecutarse desde la línea de comandos.

Sintaxis

pushprinterconnections <-log> <-?>

Parámetros

Parámetro Descripción

<-log> Escribe un archivo de registro de depuración por usuario en %temp o escribe un


registro de depuración por máquina en %windir%\temp.

<-?> Muestra la Ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos de impresión

Implementación de impresoras usando la directiva de grupo


pwlauncher
Artículo • 08/04/2023

Habilita o deshabilita las opciones de inicio de Windows To Go (pwlauncher). La


herramienta de línea de comandos pwlauncher le permite configurar el equipo para que
arranque automáticamente en un área de trabajo de Windows To Go (suponiendo que
exista una), sin necesidad de entrar en su firmware o cambie sus opciones de inicio.

Las opciones de arranque de Windows To Go permiten al usuario configurar su equipo


para arrancar desde USB desde Windows, sin necesidad de entrar en su firmware,
siempre que sea compatible con el arranque desde USB. La habilitación de un sistema
para que arranque siempre primero desde USB tiene implicaciones que debería tener en
cuenta. Por ejemplo, un dispositivo USB que incluye malware podría arrancarse
accidentalmente para poner en peligro el sistema, o se podrían conectar varias unidades
USB para provocar un conflicto de arranque. Por este motivo, la configuración
predeterminada tiene deshabilitadas las opciones de inicio de Windows To Go de forma
predeterminada. Además, se requieren privilegios de administrador para configurar las
opciones de inicio de Windows To Go. Si habilita las opciones de inicio de Windows To
Go usando la herramienta de línea de comandos pwlauncher o la aplicación Cambiar
opciones de inicio de Windows To Go el equipo intentará arrancar desde cualquier
dispositivo USB que se inserte en el equipo antes de iniciarlo.

Sintaxis

pwlauncher {/enable | /disable}

Parámetros

Parámetro Descripción

/enable Habilita las opciones de inicio de Windows To Go, por lo que el equipo arrancará
automáticamente desde un dispositivo USB cuando esté presente.

/disable Deshabilita las opciones de inicio de Windows To Go, por lo que el equipo no se
puede arrancar desde un dispositivo USB a menos que se configure manualmente
en el firmware.

/? Muestra la ayuda en el símbolo del sistema.


Ejemplos
Para habilitar el arranque desde USB:

pwlauncher /enable

Vínculos relacionados
Clave de sintaxis de línea de comandos
qappsrv
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra una lista de todos los servidores host de sesión de Escritorio remoto de la red.
Para conocer las novedades de la última versión, consulte Novedades de Servicios de
Escritorio remoto en Windows Server.

7 Nota

Este comando es el mismo que el comando query termserver.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando query termserver

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


qprocess
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre los procesos que se ejecutan en un servidor host de sesión
de Escritorio remoto. Para conocer las novedades de la última versión, consulte
Novedades de Servicios de Escritorio remoto en Windows Server.

7 Nota

Este comando es el mismo que el comando query process.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando query process

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


Comandos query
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre procesos, sesiones y servidores host de sesión de Escritorio


remoto. Para conocer las novedades de la última versión, consulte Novedades de
Servicios de Escritorio remoto en Windows Server.

Sintaxis

query process
query session
query termserver
query user

Parámetros

Parámetro Descripción

query Muestra información sobre los procesos que se ejecutan en un servidor host de
process sesión de Escritorio remoto.

query Muestra información sobre las sesiones en un servidor host de sesión de Escritorio
session remoto.

query Muestra una lista de todos los servidores host de sesión de Escritorio remoto de la
termserver red.

query user Muestra información sobre las sesiones de usuario en un servidor host de sesión
de Escritorio remoto.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


query process
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre los procesos que se ejecutan en un servidor host de sesión
de Escritorio remoto. Puede usar este comando para averiguar qué programas ejecuta
un usuario específico y también qué usuarios ejecutan un programa específico. Este
comando devuelve la siguiente información:

Usuario al que pertenece el proceso

Sesión a la que pertenece el proceso

Id. de la sesión

Nombre del proceso

Id. del proceso

7 Nota

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de Escritorio remoto en Windows Server.

Sintaxis

query process [*|<processID>|<username>|<sessionname>|/id:<nn>|


<programname>] [/server:<servername>]

Parámetros

Parámetro Descripción

* Enumera los procesos de todas las sesiones.

<processID> Especifica el identificador numérico que identifica el proceso que desea


consultar.
Parámetro Descripción

<username> Especifica el nombre del usuario cuyos procesos quiere enumerar.

<sessionname> Especifica el nombre de la sesión activa cuyos procesos quiere enumerar.

/id: <nn> Especifica el identificador de la sesión cuyos procesos quiere enumerar.

<programname> Especifica el nombre del programa cuyos procesos quiere consultar. La


extensión .exe es obligatoria.

/server: <servername> Especifica el servidor host de sesión de Escritorio remoto cuyos procesos
quiere enumerar. Si no se especifica, se usa el servidor en el que haya
iniciado sesión en ese momento.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Los administradores tienen acceso total a todas las funciones query process.

Si no se especifican los parámetros <username>, <sessionname>, /id: <nn> ,


<programname> o *, esta consulta solo muestra los procesos que pertenecen al
usuario actual.

Cuando query process devuelve información, se muestra un símbolo mayor que


(>) antes de cada proceso que pertenece a la sesión actual.

Ejemplos
Para mostrar información sobre los procesos que todas las sesiones usan, escriba:

query process *

Para mostrar información sobre los procesos que el identificador de sesión 2 usa, escriba:

query process /ID:2

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando query

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


query session
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre las sesiones en un servidor host de sesión de Escritorio


remoto. La lista incluye información no solo sobre las sesiones activas, sino también
sobre otras sesiones que ejecuta el servidor.

7 Nota

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de Escritorio remoto en Windows Server.

Sintaxis

query session [<sessionname> | <username> | <sessionID>] [/server:


<servername>] [/mode] [/flow] [/connect] [/counter]

Parámetros

Parámetro Descripción

<sessionname> Especifica el nombre de la sesión que quiere consultar.

<username> Especifica el nombre del usuario cuyas sesiones quiere consultar.

<sessionID> Especifica el identificador de la sesión que quiere consultar.

/server: Identifica el servidor host de sesión de Escritorio remoto que se va a


<servername> consultar. El valor predeterminado es el servidor actual.

/mode Muestra la configuración de línea actual.

/flow Muestra la configuración actual del control de flujo.

/connect Muestra la configuración de conexión actual.


Parámetro Descripción

/counter Muestra información de contadores actuales, incluido el número total de


sesiones creadas, desconectadas y reconectadas.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Un usuario siempre puede consultar la sesión en la que el usuario ha iniciado
sesión actualmente. Para consultar otras sesiones, el usuario debe tener permiso
de acceso especial.

Si no especifica una sesión usando los parámetros <username>, <sessionname> o


sessionID, esta consulta mostrará información sobre todas las sesiones activas del
sistema.

Cuando query session devuelve información, aparece un símbolo mayor que (>)
antes de la sesión actual. Por ejemplo:

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

Donde:
SESSIONNAME especifica el nombre asignado a la sesión.
USERNAME indica el nombre de usuario del usuario conectado a la sesión.
STATE proporciona información sobre el estado actual de la sesión.
TYPE indica el tipo de sesión.
DEVICE, que no está presente para las sesiones conectadas a la consola o a la
red, es el nombre del dispositivo asignado a la sesión.
Las sesiones en las que el estado inicial esté configurado como DISABLED no
aparecerán en la lista de query session hasta que se habiliten.

Ejemplos
Para mostrar información sobre todas las sesiones activas en el servidor Server2, escriba:
query session /server:Server2

Para mostrar información sobre el modo de sesión activoM02, escriba:

query session modeM02

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando query

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


query termserver
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra una lista de todos los servidores host de sesión de Escritorio remoto de la red.
Este comando busca en la red todos los servidores host de sesión de Escritorio remoto
conectados y devuelve la siguiente información:

Nombre del servidor

Red (y dirección de nodo si se usa la opción /address)

7 Nota

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de Escritorio remoto en Windows Server.

Sintaxis

query termserver [<servername>] [/domain:<domain>] [/address] [/continue]

Parámetros

Parámetro Descripción

<servername> Especifica el nombre que identifica el servidor host de sesión de Escritorio


remoto.

/domain: <domain> Especifica el dominio que se va a consultar para los servidores terminales. No
es necesario especificar un dominio si está consultando el dominio en el que
está trabajando actualmente.

/address Muestra las direcciones de red y nodo de cada servidor.

/continue Evita la pausa después de que se muestre cada pantalla de información.

/? Muestra la ayuda en el símbolo del sistema.


Ejemplos
Para mostrar información sobre todos los servidores host de sesión de Escritorio remoto
de la red, escriba:

query termserver

Para mostrar información sobre el servidor host de sesión de Escritorio remoto


denominado Server3, escriba:

query termserver Server3

Para mostrar información sobre todos los servidores host de sesión de Escritorio remoto
en el dominio CONTOSO, escriba:

query termserver /domain:CONTOSO

Para mostrar la red y la dirección del nodo para el servidor host de sesión de Escritorio
remoto denominado Server3, escriba:

query termserver Server3 /address

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando query

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


query user
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre las sesiones de usuario en un servidor host de sesión de


Escritorio remoto. Puede usar este comando para averiguar si un usuario específico ha
iniciado sesión en un servidor host de sesión de Escritorio remoto específico. Este
comando devuelve la siguiente información:

Nombre del usuario

Nombre de la sesión en el servidor host de sesión de Escritorio remoto

Identificador de sesión

Estado de la sesión (activa o desconectada)

Tiempo de inactividad (el número de minutos transcurridos desde la última


pulsación de tecla o movimiento del mouse en la sesión)

Fecha y hora en que el usuario inició sesión

7 Nota

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de Escritorio remoto en Windows Server.

Sintaxis

query user [<username> | <sessionname> | <sessionID>] [/server:<servername>]

Parámetros

Parámetro Descripción

<username> Especifica el nombre de inicio de sesión del usuario que quiere consultar.
Parámetro Descripción

<sessionname> Especifica el nombre de la sesión que quiere consultar.

<sessionID> Especifica el identificador de la sesión que quiere consultar.

/server: <servername> Especifica el servidor host de sesión de Escritorio remoto que quiere
consultar. En caso contrario, se usará el servidor host de sesión de
Escritorio remoto actual. Este parámetro solo es necesario si usa este
comando desde un servidor remoto.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Para usar este comando, debe tener permiso de Control total o permiso de acceso
especial.

Si no especifica un usuario mediante los parámetros <username>, <sessionname>


o sessionID, se devuelve una lista de todos los usuarios que han iniciado sesión en
el servidor. También puede usar el comando query session para enumerar todas
las sesiones de un servidor.

Cuando query user devuelve información, aparece un símbolo mayor que (>)
antes de la sesión actual.

Ejemplos
Para mostrar información sobre todos los usuarios que han iniciado sesión en el sistema,
escriba:

query user

Para mostrar información sobre el usuario USER1 en el servidor Server1, escriba:

query user USER1 /server:Server1

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando query

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


quser
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre las sesiones de usuario en un servidor host de sesión de


Escritorio remoto. Puede usar este comando para averiguar si un usuario específico ha
iniciado sesión en un servidor host de sesión de Escritorio remoto específico. Este
comando devuelve la siguiente información:

Nombre del usuario

Nombre de la sesión en el servidor host de sesión de Escritorio remoto

Identificador de sesión

Estado de la sesión (activa o desconectada)

Tiempo de inactividad (el número de minutos transcurridos desde la última


pulsación de tecla o movimiento del mouse en la sesión)

Fecha y hora en que el usuario inició sesión

7 Nota

Este comando es el mismo que el comando query user. Para conocer las
novedades de la última versión, consulte Novedades de Servicios de Escritorio
remoto en Windows Server.

Sintaxis

quser [<username> | <sessionname> | <sessionID>] [/server:<servername>]

Parámetros

Parámetro Descripción
Parámetro Descripción

<username> Especifica el nombre de inicio de sesión del usuario que quiere consultar.

<sessionname> Especifica el nombre de la sesión que quiere consultar.

<sessionID> Especifica el identificador de la sesión que quiere consultar.

/server: <servername> Especifica el servidor host de sesión de Escritorio remoto que quiere
consultar. En caso contrario, se usará el servidor host de sesión de
Escritorio remoto actual. Este parámetro solo es necesario si usa este
comando desde un servidor remoto.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Para usar este comando, debe tener permiso de Control total o permiso de acceso
especial.

Si no especifica un usuario mediante los parámetros <username>, <sessionname>


o sessionID, se devuelve una lista de todos los usuarios que han iniciado sesión en
el servidor. También puede usar el comando query session para enumerar todas
las sesiones de un servidor.

Cuando quser devuelve información, aparece un símbolo mayor que (>) antes de
la sesión actual.

Ejemplos
Para mostrar información sobre todos los usuarios que han iniciado sesión en el sistema,
escriba:

quser

Para mostrar información sobre el usuario USER1 en el servidor Server1, escriba:

quser USER1 /server:Server1


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando query user

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


qwinsta
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre las sesiones en un servidor host de sesión de Escritorio


remoto. La lista incluye información no solo sobre las sesiones activas, sino también
sobre otras sesiones que ejecuta el servidor.

7 Nota

Este comando es el mismo que el comando query session. Para conocer las
novedades de la última versión, consulte Novedades de Servicios de Escritorio
remoto en Windows Server.

Sintaxis

qwinsta [<sessionname> | <username> | <sessionID>] [/server:<servername>]


[/mode] [/flow] [/connect] [/counter]

Parámetros

Parámetro Descripción

<sessionname> Especifica el nombre de la sesión que quiere consultar.

<username> Especifica el nombre del usuario cuyas sesiones quiere consultar.

<sessionID> Especifica el identificador de la sesión que quiere consultar.

/server: <servername> Identifica el servidor host de sesión de Escritorio remoto que se va a


consultar. El valor predeterminado es el servidor actual.

/mode Muestra la configuración de línea actual.

/flow Muestra la configuración actual del control de flujo.

/connect Muestra la configuración de conexión actual.


Parámetro Descripción

/counter Muestra información de contadores actuales, incluido el número total de


sesiones creadas, desconectadas y reconectadas.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Un usuario siempre puede consultar la sesión en la que el usuario ha iniciado
sesión actualmente. Para consultar otras sesiones, el usuario debe tener permiso
de acceso especial.

Si no especifica una sesión usando los parámetros <username>, <sessionname> o


sessionID, esta consulta mostrará información sobre todas las sesiones activas del
sistema.

Cuando qwinsta devuelve información, aparece un símbolo mayor que (>) antes
de la sesión actual. Por ejemplo:

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

Donde:
SESSIONNAME especifica el nombre asignado a la sesión.
USERNAME indica el nombre de usuario del usuario conectado a la sesión.
STATE proporciona información sobre el estado actual de la sesión.
TYPE indica el tipo de sesión.
DEVICE, que no está presente para las sesiones conectadas a la consola o a la
red, es el nombre del dispositivo asignado a la sesión.
Las sesiones en las que el estado inicial esté configurado como DISABLED no
aparecerán en la lista de qwinsta hasta que se habiliten.

Ejemplos
Para mostrar información sobre todas las sesiones activas en el servidor Server2, escriba:
qwinsta /server:Server2

Para mostrar información sobre el modo de sesión activoM02, escriba:

qwinsta modeM02

Vínculos relacionados
Clave de sintaxis de línea de comandos

COMANDO query session

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


rd
Artículo • 14/04/2023

Elimina un directorio.

El comando rd también se puede ejecutar desde la Consola de recuperación de


Windows mediante parámetros diferentes. Para obtener más información, consulte
Entorno de recuperación de Windows (WinRE).

7 Nota

Este comando es el mismo que el comando rmdir.

Sintaxis

rd [<drive>:]<path> [/s [/q]]

Parámetros

Parámetro Descripción

[<drive>:] Especifica la ubicación y el nombre del directorio que desea eliminar. La ruta de
<path> acceso es obligatoria. Si incluye una barra diagonal inversa () al principio de la ruta
de acceso especificada. A continuación, la ruta de acceso comienza en el directorio
raíz (independientemente del directorio actual).

/s Elimina un árbol de directorios (el directorio especificado y todos sus subdirectorios,


incluidos todos los archivos).

/q Especifica el modo silencioso. No solicita confirmación al eliminar un árbol de


directorios. El parámetro /q solo funciona si también se especifica /s.

PRECAUCIÓN: Cuando se ejecuta en modo silencioso, se elimina todo el árbol de


directorios sin confirmación. Asegúrese de que los archivos importantes se mueven
o se realiza una copia de seguridad antes de usar la opción de línea de comandos
/q.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
No se puede eliminar un directorio que contenga archivos, incluidos los archivos
ocultos o del sistema. Si intenta hacerlo, aparece el siguiente mensaje:

The directory is not empty

Use el comando dir /a para enumerar todos los archivos (incluidos los archivos
ocultos y del sistema). A continuación, use el comando attrib con -h para quitar
atributos de archivo ocultos, -s para quitar atributos de archivo del sistema o -h -s
para quitar los atributos de archivo ocultos y del sistema. Después de quitar los
atributos ocultos y de archivo, puede eliminar los archivos.

No puede usar el comando rd para eliminar el directorio actual. Si intenta eliminar


el directorio actual, aparece el siguiente mensaje de error:

The process can't access the file because it is being used by another

process.

Si recibe este mensaje de error, debe cambiar a otro directorio (no a un


subdirectorio del directorio actual) e intentarlo de nuevo.

Ejemplos
Para cambiar al directorio primario y poder quitar de forma segura el directorio
deseado, escriba:

cd ..

Para quitar un directorio denominado test (y todos sus subdirectorios y archivos) del
directorio actual, escriba:

rd /s test

Para ejecutar el ejemplo anterior en modo silencioso, escriba:

rd /s /q test
Vínculos relacionados
Clave de sintaxis de línea de comandos
rdpsign
Artículo • 05/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Permite firmar digitalmente un archivo de Protocolo de escritorio remoto (.rdp).

7 Nota

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de Escritorio remoto en Windows Server.

Sintaxis

rdpsign /sha1 <hash> [/q | /v |] [/l] <file_name.rdp>

Parámetros

Parámetro Descripción

/sha1 <hash> Especifica la huella digital, que es el hash de Algoritmo de hash seguro 1
(SHA1) del certificado de firma que se incluye en el almacén de certificados. Se
usa en Windows Server 2012 R2 y versiones anteriores.

/sha256 <hash> Especifica la huella digital, que es el hash de Algoritmo de hash seguro 256
(SHA256) del certificado de firma que se incluye en el almacén de certificados.
Reemplaza /sha1 en Windows Server 2016 y versiones más recientes.

/q Modo silencioso. No hay salida cuando el comando se ejecuta correctamente y


salida mínima si el comando falla.

/v modo detallado. Muestra todas las advertencias, mensajes y estado.

/l Prueba la firma y los resultados de salida sin reemplazar realmente ninguno de


los archivos de entrada.

<file_name.rdp> Nombre del archivo .rdp. Debe especificar el archivo .rdp (o archivos) para
firmar con el nombre de archivo completo. No se aceptan caracteres comodín.
Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
La huella digital del certificado SHA1 o SHA256 debe representar a un editor de
archivos .rdp de confianza. Para obtener la huella digital del certificado, abra el
complemento Certificados, haga doble clic en el certificado que quiera usar (ya
sea en el almacén de certificados del equipo local o en su almacén de certificados
personal), haga clic en la pestaña Detalles y, después, en la lista Campo, haga clic
en Huella digital.

7 Nota

Al copiar la huella digital para su uso con la herramienta rdpsign.exe, debe


quitar los espacios.

Los archivos de salida firmados sobrescriben los archivos de entrada.

Si se especifican varios archivos, y si no se puede leer o escribir en alguno de los


archivos .rdp, la herramienta continúa con el siguiente archivo.

Ejemplos
Para firmar un archivo .rdp denominado file1.rdp, vaya a la carpeta donde guardó el
archivo .rdp y escriba:

rdpsign /sha1 hash file1.rdp

7 Nota

El valor hash representa la huella digital del certificado SHA1, sin espacios.

Para probar si la firma digital se realizará correctamente para un archivo .rdp sin firmar
realmente el archivo, escriba:
rdpsign /sha1 hash /l file1.rdp

Para firmar varios archivos .rdp denominados file1.rdp, file2.rdp y file3.rdp, escriba
(incluidos los espacios entre nombres de archivo):

rdpsign /sha1 hash file1.rdp file2.rdp file3.rdp

Vea también
Clave de sintaxis de línea de comandos

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


recover
Artículo • 06/04/2023

Recupera información legible de un disco dañado o defectuoso. Este comando lee un


archivo, sector por sector, y recupera los datos de los sectores en buen estado. Los
datos en sectores defectuosos se pierden. Dado que todos los datos de los sectores
defectuosos se pierden al recuperar un archivo, debería recuperar solo un archivo cada
vez.

Los sectores defectuosos reportados por el comando chkdsk se marcaron como


defectuosos cuando su disco se preparó para el funcionamiento. No suponen ningún
peligro y recover no les afecta.

Sintaxis

recover [<drive>:][<path>]<filename>

Parámetros

Parámetro Descripción

[<drive>:] Especifica el nombre del archivo (y su ubicación si no se encuentra en el directorio


[<path>] actual) que quiere recuperar. Filename es obligatorio y no se admiten caracteres
<filename> comodín.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para recuperar el archivo story.txt del directorio \fiction de la unidad D, escriba:

recover d:\fiction\story.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos
recover (DiskPart)
Artículo • 14/04/2023

Actualiza el estado de todos los discos de un grupo de discos, intenta recuperar discos
en un grupo de discos no válidos y vuelve a sincronizar volúmenes reflejados y
volúmenes RAID-5 que tienen datos obsoletos. Este comando funciona en discos que
hayan dado un error o que lo estén dando. También funciona en volúmenes que hayan
dado un error, que lo estén dando o en estado de redundancia con errores.

Este comando funciona en grupos de discos dinámicos. Si este comando se usa en un


grupo con un disco básico, no devolverá un error, pero no se llevará ninguna acción a
cabo.

7 Nota

Se debe seleccionar un disco que forme parte de un grupo de discos para que esta
operación se realice correctamente. Use el comando select disk para seleccionar un
disco y desplazar el foco a él.

Sintaxis

recover [noerr]

Parámetros

Parámetro Descripción

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para recuperar el grupo de discos en el que se incluye el disco de concentración, escriba:
recover

Vínculos relacionados
Clave de sintaxis de línea de comandos
ReFSUtil
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows 10

ReFSUtil es una herramienta incluida en Windows y Windows Server que intenta


diagnosticar volúmenes ReFS muy dañados, identificar los archivos restantes y copiar
esos archivos en otro volumen. Esta herramienta se incluye en la carpeta
%SystemRoot%\Windows\System32 .

La recuperación de ReFS es la función principal de ReFSUtil y es útil para recuperar datos


de volúmenes que se muestran como RAW en la administración de discos. ReFS Salvage
tiene dos fases: fase de examen y fase de copia. En el modo automático, la fase de
examen y la fase de copia se ejecutarán secuencialmente. En el modo manual, cada fase
se puede ejecutar por separado. El progreso y los registros se guardan en un directorio
de trabajo para permitir que las fases se ejecuten por separado, y que la fase de examen
se pueda pausar y reanudar. No es necesario usar la herramienta ReFSutil a menos que
el volumen sea RAW. Si es de solo lectura, los datos siguen siendo accesibles.

Parámetros
Parámetro Descripción

<source Especifica el volumen ReFS que se va a procesar. La letra de unidad debe tener el
volume> formato “L:” o debe proporcionar una ruta de acceso al punto de montaje del
volumen.

<working Especifica la ubicación para almacenar la información temporal y los registros. No se


directory> debe ubicar en el <source volume> .

<target Especifica la ubicación en la que se copian los archivos identificados. No se debe


directory> ubicar en el <source volume> .

-M Recupera todos los archivos posibles, incluidos los eliminados.


ADVERTENCIA: Este parámetro no solo hace que el proceso tarde más tiempo en
ejecutarse, sino que también puede provocar resultados inesperados.

-v Especifica el uso del modo detallado.

-X Si es necesario, fuerza el desmontaje del volumen en primer lugar. Todos los


identificadores abiertos del volumen dejarán entonces de ser válidos. Por ejemplo,
refsutil salvage -QA R: N:\WORKING N:\DATA -x .
Uso y opciones disponibles

Modo automático rápido


Realiza una fase de examen rápido seguida de una fase de copia. Este modo se ejecuta
más rápido, ya que supone que algunas estructuras críticas del volumen no están
dañadas y, por lo tanto, no es necesario examinar todo el volumen para localizarlas. Esto
también reduce la recuperación de archivos, directorios o volúmenes obsoletos.

refsutil salvage -QA <source volume> <working directory> <target directory>


<options>

Modo automático completo


Realiza una fase de examen completo seguida de una fase de copia. Este modo puede
tardar mucho tiempo, ya que examinará todo el volumen en busca de archivos,
directorios o volúmenes recuperables.

refsutil salvage -FA <source volume> <working directory> <target directory>


<options>

Fase de diagnóstico (modo manual)


En primer lugar, intente determinar si <source volume> es un volumen ReFS y
determinar si el volumen se puede montar. Si un volumen no se puede montar, se
proporcionarán las razones. Se trata de una fase independiente.

refsutil salvage -D <source volume> <working directory> <options>

Fase de examen rápido


Realiza un examen rápido del <source volume> para encontrar cualquier archivo
recuperable. Este modo se ejecuta más rápido, ya que supone que algunas estructuras
críticas del volumen no están dañadas y, por lo tanto, no es necesario examinar todo el
volumen para localizarlas. Esto también reduce la recuperación de archivos, directorios o
volúmenes obsoletos. Los archivos detectados se registran en el archivo foundfiles.
<volume signature>.txt , que se encuentra en su <working directory> . Si la fase de

examen se detuvo anteriormente, la ejecución con la marca -QS reanuda de nuevo el


examen desde donde se dejó.

refsutil salvage -QS <source volume> <working directory> <options>

Fase de examen completo


Examina todo el <source volume> en busca de archivos recuperables. Este modo puede
tardar mucho tiempo, ya que examinará todo el volumen de los archivos recuperables.
Los archivos detectados se registrarán en el archivo foundfiles.<volume signature>.txt ,
ubicado en <working directory> . Si la fase de examen se detuvo anteriormente, la
ejecución con la marca -FS reanuda de nuevo el examen desde donde se dejó.

refsutil salvage -FS <source volume> <working directory> <options>

Fase de copia
Copia todos los archivos descritos en el archivo foundfiles.<volume signature>.txt en
<target directory> . Si detiene la fase de examen demasiado pronto, es posible que el

archivo foundfiles.<volume signature>.txt aún no exista, por lo que no se copia


ningún archivo en <target directory> .

refsutil salvage -C <source volume> <working directory> <target directory>


<options>

Fase de copia con lista


Copia todos los archivos de la <file list> desde el <source volume> a su <target
directory> . Los archivos de <file list> deben haber sido identificados primero por la

fase de examen, aunque el examen no se haya ejecutado hasta la finalización. La <file


list> se puede generar copiando foundfiles.<volume signature>.txt en un nuevo
archivo, quitando líneas que hacen referencia a archivos que no se deben restaurar y
conservando los archivos que se deben restaurar. El cmdlet de PowerShell Select-String
puede ser útil para filtrar foundfiles.<volume signature>.txt para incluir solo rutas de
acceso, extensiones o nombres de archivo deseados.

refsutil salvage -SL <source volume> <working directory> <target directory>


<file list> <options>

Fase de copia con consola interactiva


Los usuarios avanzados pueden recuperar archivos mediante una consola interactiva.
Este modo también requiere archivos generados a partir de cualquiera de las fases de
examen.

refsutil salvage -IC <source volume> <working directory> <options>

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comandos reg
Artículo • 06/04/2023

Realiza operaciones sobre la información de las subclaves del registro y los valores de
las entradas del registro.

Algunas operaciones le permiten ver o configurar entradas del registro en equipos


locales o remotos, mientras que otras le permiten configurar solo equipos locales. El uso
de reg para configurar el registro de equipos remotos limita los parámetros que puede
usar en algunas operaciones. Compruebe la sintaxis y los parámetros de cada operación
para comprobar que se pueden usar en equipos remotos.

U Precaución

No edite el registro directamente a menos que no tenga otra alternativa. El editor


del registro omite las protecciones estándar, permitiendo parámetros que pueden
degradar el rendimiento, dañar su sistema o incluso obligarle a reinstalar Windows.
Puede modificar con seguridad la mayor parte de la configuración del registro
usando los programas del Panel de control o Microsoft Management Console
(MMC). Si debe editar el registro directamente, haga una copia de seguridad
primero.

Sintaxis

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 Descripción
Parámetro Descripción

reg add Agrega una nueva subclave o entrada al registro.

reg Compara las subclaves o entradas del registro especificadas.


compare

reg copy Copia una entrada del registro en una ubicación especificada del equipo local o
remoto.

reg delete Elimina una subclave o entradas del registro.

reg export Copia las subclaves, entradas y valores especificados del equipo local en un archivo
para su transferencia a otros servidores.

reg import Copia el contenido de un archivo que contiene subclaves, entradas y valores del
registro exportados en el registro del equipo local.

reg load Escribe las subclaves y entradas guardadas en una subclave diferente del registro.

reg query Devuelve una lista del siguiente nivel de subclaves y entradas que se encuentran en
una subclave especificada en el registro.

reg restore Escribe las subclaves guardadas y las entradas en el registro.

reg save Guarda una copia de las subclaves, entradas y valores especificados del registro en
un archivo especificado.

reg unload Elimina una sección del registro que se cargó usando la operación reg load.

Vínculos relacionados
Clave de sintaxis de línea de comandos
reg add
Artículo • 04/10/2023

Agrega una nueva subclave o entrada al registro.

Sintaxis

reg add <keyname> [/v valuename | /ve] [/t datatype] [/s separator] [/d
data] [/f] [/reg:32 | /reg:64]

Parámetros

Parámetro Descripción

<keyname> Especifica la ruta de acceso completa de la subclave o entrada que se va a agregar.


Para especificar un equipo remoto, incluya el nombre del equipo (con el formato
\\<computername>\ ) como parte del nombre de clave. Si se omite \\
<computername>\ , la operación se realiza de forma predeterminada en el equipo
local. El nombre de clave debe incluir una clave raíz válida. Las claves raíz válidas
para el equipo local son: HKLM, HKCU, HKCR, HKU y HKCC. Si se especifica un
equipo remoto, las claves raíz válidas son: HKLM y HKU. Si el nombre de la clave
del registro contiene un espacio, escriba el nombre de la clave entre comillas.

/v Especifica el nombre de la entrada del registro agregada.


<Valuename>

/ve Especifica que la entrada del registro agregada tiene un valor null.

/t <Type> Especifica el tipo para la entrada del registro. Type debe tener uno de los
siguientes valores:

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 Descripción

/s Especifica el carácter que se va a usar para separar varias instancias de datos


<Separator> cuando se especifica el tipo de datos REG_MULTI_SZ y se muestra más de una
entrada. Si no se especifica, el separador predeterminado es \0.

/d <Data> Especifica los datos de la nueva entrada del registro.

/f Agrega la entrada del registro sin pedir confirmación.

/reg:32 Especifica que se debe acceder a la clave mediante la vista de registro de 32 bits.

/reg:64 Especifica que se debe acceder a la clave mediante la vista de registro de 64 bits.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Los subárboles no se pueden agregar con esta operación. Esta versión de reg no
solicita confirmación al agregar una subclave.

Los valores devueltos para la operación reg addson:

Value Descripción

0 Correcto

1 Error

Para el tipo de clave REG_EXPAND_SZ, use el símbolo de intercalación ( ^ ) con %


dentro del parámetro /d.

Ejemplos
Para agregar la clave HKLM\Software\MyCo en el equipo remoto ABC, escriba:

reg add \\ABC\HKLM\Software\MyCo

Para agregar una entrada del registro a HKLM\Software\MyCo con un valor denominado
Data, el tipo REG_BINARY y los datos de fe340ead, escriba:
reg add HKLM\Software\MyCo /v Data /t REG_BINARY /d fe340ead

Para agregar una entrada del registro de varios valores a HKLM\Software\MyCo con un
valor denominado MRU, el tipo REG_MULTI_SZ y los datos de fax\0mail\0, escriba:

reg add HKLM\Software\MyCo /v MRU /t REG_MULTI_SZ /d fax\0mail\0

Para agregar una entrada expandida del registro a HKLM\Software\MyCo con un valor
denominado Path, el tipo REG_EXPAND_SZ y los datos de %systemroot%, escriba:

reg add HKLM\Software\MyCo /v Path /t REG_EXPAND_SZ /d ^%systemroot^%

Vínculos relacionados
Clave de sintaxis de línea de comandos
reg compare
Artículo • 06/04/2023

Compara las subclaves o entradas del registro especificadas.

Sintaxis

reg compare <keyname1> <keyname2> [{/v Valuename | /ve}] [{/oa | /od | /os |
on}] [/s]

Parámetros

Parámetro Descripción

<keyname1> Especifica la ruta de acceso completa de la subclave o entrada que se va a agregar.


Para especificar un equipo remoto, incluya el nombre del equipo (con el formato
\\<computername>\ ) como parte del nombre de clave. Si se omite \\
<computername>\ , la operación se realiza de forma predeterminada en el equipo
local. El nombre de clave debe incluir una clave raíz válida. Las claves raíz válidas
para el equipo local son: HKLM, HKCU, HKCR, HKU y HKCC. Si se especifica un
equipo remoto, las claves raíz válidas son: HKLM y HKU. Si el nombre de la clave
del registro contiene un espacio, escriba el nombre de la clave entre comillas.

<keyname2> Especifica la ruta de acceso completa de la segunda subclave que se va a


comparar. Para especificar un equipo remoto, incluya el nombre del equipo (con el
formato \\<computername>\ ) como parte del nombre de clave. Si se omite \\
<computername>\ , la operación se realiza de forma predeterminada en el equipo
local. Si se especifica solo el nombre del equipo en keyname2, la operación usará la
ruta de acceso a la subclave especificada en keyname1. El nombre de clave debe
incluir una clave raíz válida. Las claves raíz válidas para el equipo local son: HKLM,
HKCU, HKCR, HKU y HKCC. Si se especifica un equipo remoto, las claves raíz
válidas son: HKLM y HKU. Si el nombre de la clave del registro contiene un
espacio, escriba el nombre de la clave entre comillas.

/v Especifica el nombre del valor que se va a comparar en la subclave.


<Valuename>

/ve Especifica que solo se deben comparar las entradas que tienen un nombre de valor
null.

/oa Especifica que se muestran todas las diferencias y coincidencias. De forma


predeterminada, solo se muestran las diferencias.
Parámetro Descripción

/od Especifica que solo se muestran las diferencias. Este es el comportamiento


predeterminado.

/os Especifica que solo se muestran las coincidencias. De forma predeterminada, solo
se muestran las diferencias.

/on Especifica que no se muestra nada. De forma predeterminada, solo se muestran las
diferencias.

/s Compara todas las subclaves y entradas de forma recursiva.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Los valores devueltos por la operación reg compare son:

Value Descripción

0 La comparación es correcta y el resultado es idéntico.

1 Error en la comparación.

2 La comparación se realizó correctamente y se encontraron diferencias.

Los símbolos mostrados en los resultados incluyen:

Símbolo Descripción

= Los datos de KeyName1 son iguales a los datos de keyName2.

< Los datos de keyName1 son menores que los datos de keyName2.

> Los datos de KeyName1 son mayores que los datos de keyName2.

Ejemplos
Para comparar todos los valores de la clave MyApp con todos los valores de la clave
SaveMyApp, escriba:

reg compare HKLM\Software\MyCo\MyApp HKLM\Software\MyCo\SaveMyApp


Para comparar el valor de la versión en la clave MyCo y el valor de la versión en la clave
MyCo1, escriba:

reg compare HKLM\Software\MyCo HKLM\Software\MyCo1 /v Version

Para comparar todas las subclaves y valores en HKLM\Software\MyCo en el equipo


denominado ZODIAC, con todas las subclaves y valores en HKLM\Software\MyCo en el
equipo local, escriba:

reg compare \\ZODIAC\HKLM\Software\MyCo \\. /s

Vínculos relacionados
Clave de sintaxis de línea de comandos
reg copy
Artículo • 06/04/2023

Copia una entrada del registro en una ubicación especificada del equipo local o remoto.

Sintaxis

reg copy <keyname1> <keyname2> [/s] [/f]

Parámetros

Parámetro Descripción

<keyname1> Especifica la ruta de acceso completa de la subclave o entrada que se va a agregar.


Para especificar un equipo remoto, incluya el nombre del equipo (con el formato \\
<computername>\ ) como parte del nombre de clave. Si se omite \\<computername>\ , la
operación se realiza de forma predeterminada en el equipo local. El nombre de clave
debe incluir una clave raíz válida. Las claves raíz válidas para el equipo local son:
HKLM, HKCU, HKCR, HKU y HKCC. Si se especifica un equipo remoto, las claves raíz
válidas son: HKLM y HKU. Si el nombre de la clave del registro contiene un espacio,
escriba el nombre de la clave entre comillas.

<keyname2> Especifica la ruta de acceso completa de la segunda subclave que se va a comparar.


Para especificar un equipo remoto, incluya el nombre del equipo (con el formato \\
<computername>\ ) como parte del nombre de clave. Si se omite \\<computername>\ , la
operación se realiza de forma predeterminada en el equipo local. El nombre de clave
debe incluir una clave raíz válida. Las claves raíz válidas para el equipo local son:
HKLM, HKCU, HKCR, HKU y HKCC. Si se especifica un equipo remoto, las claves raíz
válidas son: HKLM y HKU. Si el nombre de la clave del registro contiene un espacio,
escriba el nombre de la clave entre comillas.

/s Copia todas las subclaves y entradas en la subclave especificada.

/f Copia la subclave sin pedir confirmación.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Este comando no solicita confirmación al copiar una subclave.
Los valores devueltos por la operación reg compare son:

Valor Descripción

0 Correcto

1 Error

Ejemplos
Para copiar todas las subclaves y valores bajo la clave MyApp a la clave SaveMyApp,
escriba:

reg copy HKLM\Software\MyCo\MyApp HKLM\Software\MyCo\SaveMyApp /s

Para copiar todos los valores bajo la clave MyCo en el equipo llamado ZODIAC a la clave
MyCo1 en el equipo actual, escriba:

reg copy \\ZODIAC\HKLM\Software\MyCo HKLM\Software\MyCo1

Vínculos relacionados
Clave de sintaxis de línea de comandos
reg delete
Artículo • 05/10/2023

Elimina una subclave o entradas del Registro.

Sintaxis

reg delete <keyname> [{/v valuename | /ve | /va}] [/f]

Parámetros

Parámetro Descripción

<keyname1> Especifica la ruta de acceso completa de la subclave o la entrada que se va a


eliminar. Para especificar un equipo remoto, incluya el nombre del equipo (con el
formato \\<computername>\ ) como parte del parámetro keyname. Si se omite \\
<computername>\ , la operación se realiza de forma predeterminada en el equipo
local. El nombre de clave debe incluir una clave raíz válida. Las claves raíz válidas
para el equipo local son: HKLM, HKCU, HKCR, HKU y HKCC. Si se especifica un
equipo remoto, las claves raíz válidas son: HKLM y HKU. Si el nombre de la clave
del registro contiene un espacio, escriba el nombre de la clave entre comillas.

/v Elimina una entrada específica en la subclave. Si no se especifica ninguna entrada,


<valuename> se eliminarán todas las entradas y subclaves de la subclave.

/ve Especifica que solo se eliminarán las entradas que no tengan ningún valor.

/va Elimina todas las entradas dentro de la clave especificada. Las entradas de
subclave que residen dentro de la clave especificada no se eliminan.

/f Elimina la subclave o entrada del Registro existente sin pedir confirmación.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Los valores devueltos para la operación reg delete son:

Value Descripción

0 Correcto
Value Descripción

1 Error

Ejemplos
Para eliminar el tiempo de espera de la clave del Registro y sus subclaves y valores,
escriba:

reg delete HKLM\Software\MyCo\MyApp\Timeout

Para eliminar el valor del Registro MTU en HKLM\Software\MyCo en el equipo


denominado ZODIAC, escriba:

reg delete \\ZODIAC\HKLM\Software\MyCo /v MTU

Vínculos relacionados
Clave de sintaxis de línea de comandos
reg export
Artículo • 06/04/2023

Copia las subclaves, entradas y valores especificados del equipo local en un archivo para
su transferencia a otros servidores.

Sintaxis

reg export <keyname> <filename> [/y]

Parámetros

Parámetro Descripción

<keyname> Especifica la ruta de acceso completa de la subclave. La operación de exportación


solo funciona con el equipo local. El nombre de clave debe incluir una clave raíz
válida. Las claves raíz válidas para el equipo local son: HKLM, HKCU, HKCR, HKU y
HKCC. Si el nombre de la clave del registro contiene un espacio, escriba el nombre
de la clave entre comillas.

<filename> Especifica el nombre y la ruta de acceso del archivo que se va a crear durante la
operación. El archivo debe tener la extensión .reg.

/y Sobrescribe cualquier archivo existente con el nombre filename sin pedir


confirmación.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Los valores devueltos para la operación reg export son:

Valor Descripción

0 Correcto

1 Error

Ejemplos
Para exportar el contenido de todas las subclaves y valores de la clave MyApp al archivo
AppBkUp.reg, escriba:

reg export HKLM\Software\MyCo\MyApp AppBkUp.reg

Vínculos relacionados
Clave de sintaxis de línea de comandos
reg import
Artículo • 17/04/2023

Copia el contenido de un archivo que contiene subclaves, entradas y valores del


Registro exportados en el Registro del equipo local.

Sintaxis

reg import <filename>

Parámetros

Parámetro Descripción

<filename> Especifica el nombre y la ruta de acceso del archivo que tiene contenido que se va a
copiar en el Registro del equipo local. Este archivo debe crearse de antemano
mediante reg export.

/reg:32 Especifica que se debe acceder a la clave mediante la vista de registro de 32 bits.

/reg:64 Especifica que se debe acceder a la clave mediante la vista de registro de 64 bits.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Los valores devueltos para la operación reg import son:

Value Descripción

0 Correcto

1 Error

Ejemplos
Para importar entradas del Registro desde el archivo denominado AppBkUp.reg, escriba:
reg import AppBkUp.reg

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando reg export


reg load
Artículo • 06/04/2023

Escribe las subclaves y entradas guardadas en una subclave diferente del registro. Este
comando está diseñado para su uso con archivos temporales que se usan para
solucionar problemas o editar entradas del registro.

Sintaxis

reg load <keyname> <filename>

Parámetros

Parámetro Descripción

<keyname> Especifica la ruta de acceso completa de la subclave que se va a cargar. Para


especificar un equipo remoto, incluya el nombre del equipo (con el formato \\
<computername>\ ) como parte del nombre de clave. Si se omite \\<computername>\ , la
operación se realiza de forma predeterminada en el equipo local. El nombre de clave
debe incluir una clave raíz válida. Las claves raíz válidas para el equipo local son:
HKLM, HKCU, HKCR, HKU y HKCC. Si se especifica un equipo remoto, las claves raíz
válidas son: HKLM y HKU. Si el nombre de la clave del registro contiene un espacio,
escriba el nombre de la clave entre comillas.

<filename> Especifica el nombre y la ruta de acceso del archivo que se va a cargar. Este archivo
se debe crear de antemano mediante el comando reg save y debe tener una
extensión .hiv.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Los valores devueltos para la operación reg load son:

Value Descripción

0 Correcto

1 Error
Ejemplos
Para cargar el archivo denominado TempHive.hiv en la clave HKLM\TempHive, escriba:

reg load HKLM\TempHive TempHive.hiv

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando reg save


reg query
Artículo • 12/04/2023

Devuelve una lista del siguiente nivel de subclaves y entradas que se encuentran en una
subclave especificada en el registro.

Sintaxis

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 Descripción

<keyname> Especifica la ruta de acceso completa de la subclave. Para especificar un equipo


remoto, incluya el nombre del equipo (con el formato \\<computername>\ ) como
parte del parámetro keyname. Si se omite \\<computername>\ , la operación se
realiza de forma predeterminada en el equipo local. El parámetro keyname debe
incluir una clave raíz válida. Las claves raíz válidas para el equipo local son: HKLM,
HKCU, HKCR, HKU y HKCC. Si se especifica un equipo remoto, las claves raíz
válidas son: HKLM y HKU. Si el nombre de la clave del registro contiene un
espacio, escriba el nombre de la clave entre comillas.

/v Especifica el nombre del valor del registro que se va a consultar. Si se omite, se


<valuename> devuelven todos los nombres de valor para el parámetro keyname. Valuename
para este parámetro es opcional si también se usa la opción /f.

/ve Ejecuta una consulta para los nombres de valor que están vacíos.

/s Especifica que se consulten todas las subclaves y nombres de valor de forma


recurrente.

/se Especifica el separador de valor único que se va a buscar en el tipo de nombre de


<separator> valor REG_MULTI_SZ. Si no se especifica el separador, se usa \0.

/f <data> Especifica los datos o el patrón que se va a buscar. Use comillas dobles si una
cadena contiene espacios. Si no se especifica, se usa un carácter comodín (*) como
patrón de búsqueda.

/k Especifica que solo se buscarán en nombres de clave. Debe usarse con /f.

/d Especifica que solo se busque en datos.


Parámetro Descripción

/C Especifica que la consulta distingue mayúsculas de minúsculas. De forma


predeterminada, las consultas no distinguen mayúsculas de minúsculas.

/e Especifica que solo se devuelvan coincidencias exactas. De forma predeterminada,


se devuelven todas las coincidencias.

/t <Type> Especifica los tipos de registro que se van a buscar. Los tipos válidos son: REG_SZ,
REG_MULTI_SZ, REG_EXPAND_SZ, REG_DWORD, REG_BINARY, REG_NONE. Si no
se especifica, se buscarán todos los tipos.

/z Especifica que se debe incluir el equivalente numérico para el tipo de registro en


los resultados de búsqueda.

/reg:32 Especifica que se debe acceder a la clave mediante la vista de registro de 32 bits.

/reg:64 Especifica que se debe acceder a la clave mediante la vista de registro de 64 bits.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Los valores devueltos para la operación reg query son:

Value Descripción

0 Correcto

1 Error

Ejemplos
Para mostrar el valor del nombre Versión de la clave HKLM\Software\Microsoft\ResKit,
escriba:

reg query HKLM\Software\Microsoft\ResKit /v Version

Para mostrar todas las subclaves y valores de la clave


HKLM\Software\Microsoft\ResKit\Nt\Setup en un equipo remoto denominado ABC,
escriba:
reg query \\ABC\HKLM\Software\Microsoft\ResKit\Nt\Setup /s

Para mostrar todas las subclaves y valores del tipo REG_MULTI_SZ usando # como
separador, escriba:

reg query HKLM\Software\Microsoft\ResKit\Nt\Setup /se #

Para mostrar la clave, el valor y los datos para las coincidencias exactas y que distinguen
mayúsculas de minúsculas de SYSTEM en la raíz HKLM del tipo de datos REG_SZ,
escriba:

reg query HKLM /f SYSTEM /t REG_SZ /c /e

Para mostrar la clave, el valor y los datos que coinciden con 0F en los datos en la clave
raíz HKCU del tipo de datos REG_BINARY, escriba:

reg query HKCU /f 0F /d /t REG_BINARY

Para mostrar las claves, los valores y los datos que coinciden con asp.net en la clave
HKLM\SOFTWARE\Microsoft y todas las subclaves, escriba:

reg query HKLM\SOFTWARE\Microsoft /s /f asp.net

Para mostrar solo las claves que coinciden con asp.net en la clave
HKLM\SOFTWARE\Microsoft y todas las subclaves, escriba:

reg query HKLM\SOFTWARE\Microsoft /s /f asp.net /k

Para mostrar el valor y los datos de los nombres de valor null (valor predeterminado) en
HKLM\SOFTWARE, escriba:
reg query HKLM\SOFTWARE /ve

Vínculos relacionados
Clave de sintaxis de línea de comandos
reg restore
Artículo • 14/04/2023

Escribe las subclaves guardadas y las entradas en el registro.

Sintaxis

reg restore <keyname> <filename>

Parámetros

Parámetro Descripción

<keyname> Especifica la ruta de acceso completa de la subclave que se va a restaurar. La


operación de restauración solo funciona con el equipo local. El nombre de clave
debe incluir una clave raíz válida. Las claves raíz válidas para el equipo local son:
HKLM, HKCU, HKCR, HKU y HKCC. Si el nombre de la clave del registro contiene un
espacio, escriba el nombre de la clave entre comillas.

<filename> Especifica el nombre y la ruta de acceso del archivo con contenido que se va a
escribir en el registro. Este archivo se debe crear de antemano mediante el
comando reg save y debe tener una extensión .hiv.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Antes de editar cualquier entrada del registro, debe guardar la subclave principal
usando el comando reg save. Si la edición falla, puede restaurar la subclave
original usando la operación reg restore.

Los valores devueltos por la operación reg restore son:

Value Descripción

0 Correcto

1 Error

Ejemplos
Para restaurar el archivo denominado NTRKBkUp.hiv en la clave
HKLM\Software\Microsoft\ResKit y sobrescribir el contenido existente de la clave,
escriba:

reg restore HKLM\Software\Microsoft\ResKit NTRKBkUp.hiv

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando reg save


reg save
Artículo • 06/04/2023

Guarda una copia de las subclaves, entradas y valores especificados del registro en un
archivo especificado.

Sintaxis

reg save <keyname> <filename> [/y]

Parámetros

Parámetro Descripción

<keyname> Especifica la ruta de acceso completa de la subclave. Para especificar un equipo


remoto, incluya el nombre del equipo (con el formato \\<computername>\ ) como
parte del nombre de clave. Si se omite \\<computername>\ , la operación se realiza de
forma predeterminada en el equipo local. El nombre de clave debe incluir una clave
raíz válida. Las claves raíz válidas para el equipo local son: HKLM, HKCU, HKCR, HKU
y HKCC. Si se especifica un equipo remoto, las claves raíz válidas son: HKLM y HKU.
Si el nombre de la clave del registro contiene un espacio, escriba el nombre de la
clave entre comillas.

<filename> Especifica el nombre y la ruta de acceso del archivo creado. Si no se especifica


ninguna ruta de acceso, se usará la ruta actual.

/y Sobrescribe un archivo existente con el nombre filename sin pedir confirmación.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Antes de editar cualquier entrada del registro, debe guardar la subclave principal
usando el comando reg save. Si la edición falla, puede restaurar la subclave
original usando la operación reg restore.

Los valores devueltos para la operación reg save son:

Valor Descripción
Valor Descripción

0 Correcto

1 Error

Ejemplos
Para guardar la colmena MyApp en la carpeta actual como un archivo llamado
AppBkUp.hiv, escriba:

reg save HKLM\Software\MyCo\MyApp AppBkUp.hiv

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando reg restore


reg unload
Artículo • 06/04/2023

Elimina una sección del registro que se cargó usando la operación reg load.

Sintaxis

reg unload <keyname>

Parámetros

Parámetro Descripción

<keyname> Especifica la ruta de acceso completa de la subclave. Para especificar un equipo


remoto, incluya el nombre del equipo (con el formato \\<computername>\ ) como
parte del nombre de clave. Si se omite \\<computername>\ , la operación se realiza de
forma predeterminada en el equipo local. El nombre de clave debe incluir una clave
raíz válida. Las claves raíz válidas para el equipo local son: HKLM, HKCU, HKCR, HKU
y HKCC. Si se especifica un equipo remoto, las claves raíz válidas son: HKLM y HKU.
Si el nombre de la clave del registro contiene un espacio, escriba el nombre de la
clave entre comillas.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Los valores devueltos para la operación reg unload son:

Valor Descripción

0 Correcto

1 Error

Ejemplos
Para descargar la colmena TempHive en el archivo HKLM, escriba:
reg unload HKLM\TempHive

U Precaución

No edite el registro directamente a menos que no tenga otra alternativa. El editor


del registro omite las protecciones estándar, permitiendo parámetros que pueden
degradar el rendimiento, dañar su sistema o incluso obligarle a reinstalar Windows.
Puede modificar con seguridad la mayor parte de la configuración del registro
usando los programas del Panel de control o Microsoft Management Console
(MMC). Si debe editar el registro directamente, haga una copia de seguridad
primero.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando reg load


regini
Artículo • 06/04/2023

Modifica el registro desde la línea de comandos o un script, y aplica los cambios


preestablecidos en uno o varios archivos de texto. Puede crear, modificar o eliminar
claves del registro, además de modificar los permisos de las mismas.

Para obtener más información sobre el formato y el contenido del archivo de script de
texto que regini.exe usa para realizar cambios en el registro, consulte Cómo cambiar los
valores o permisos del registro desde una línea de comandos o un script .

Sintaxis

regini [-m \\machinename | -h hivefile hiveroot][-i n] [-o outputwidth][-b]


textfiles...

Parámetros

Parámetro Descripción

-m Especifica el nombre del equipo remoto con un registro que se va a


<\\computername> modificar. Use el formato \ComputerName.

-h <hivefile Especifica el subárbol del registro local que se va a modificar. Debe


hiveroot> especificar el nombre del archivo de subárbol y la raíz del subárbol con el
formato archivosubárbol raízsubárbol.

-i <n> Especifica el nivel de sangría que se va a usar para indicar la estructura de


árbol de las claves del registro en la salida del comando. La herramienta
regdmp.exe (que obtiene los permisos actuales de una clave del registro en
formato binario) usa sangría en múltiplos de cuatro, por lo que el valor
predeterminado es 4.

-o <outputwidth> Especifica el ancho de la salida del comando, en caracteres. Si la salida


aparecerá en la ventana de comandos, el valor predeterminado es el ancho
de la ventana. Si la salida se dirige a un archivo, el valor predeterminado es
de 240 caracteres.

-b Especifica que la salida de regini.exe es compatible con versiones anteriores


de regini.exe.
Parámetro Descripción

textfiles Especifica el nombre de uno o varios archivos de texto que contienen datos
del registro. Se puede enumerar cualquier número de archivos de texto ANSI
o Unicode.

Comentarios
Las siguientes directrices se aplican principalmente al contenido de los archivos de texto
que contienen datos del registro que se aplican mediante regini.exe.

Use el punto y coma como carácter de comentario de fin de línea. Debe ser el
primer carácter que no esté en blanco en una línea.

Use la barra diagonal inversa para indicar la continuación de una línea. El comando
ignorará todos los caracteres desde la barra invertida hasta (pero sin incluir) el
primer carácter que no esté en blanco de la línea siguiente. Si incluye más de un
espacio antes de la barra diagonal inversa, se reemplaza por un solo espacio.

Use caracteres de tabulación para controlar la sangría. Esta sangría indica la


estructura de árbol de las claves del registro; sin embargo, estos caracteres se
convierten en un único espacio independientemente de su posición.

Vínculos relacionados
Clave de sintaxis de línea de comandos
regsvr32
Artículo • 14/04/2023

Registra archivos .dll como componentes de comandos en el registro.

Sintaxis

regsvr32 [/u] [/s] [/n] [/i[:cmdline]] <Dllname>

Parámetros

Parámetro Descripción

/U Anula el registro del servidor.

/s Impide mostrar mensajes.

/n Impide realizar la llamada a DllRegisterServer. Este parámetro requiere que


también use el parámetro /i.

/i: <cmdline> Pasa una cadena de línea de comandos opcional (cmdline) a DllInstall. Si usa este
parámetro con el parámetro /u, realiza la llamada a DllUninstall.

<Dllname> Nombre del archivo .dll que va a registrar.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para registrar el .dll para el esquema de Active Directory, escriba:

regsvr32 schmmgmt.dll

Vínculos relacionados
Clave de sintaxis de línea de comandos
relog
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Extrae contadores de rendimiento de los registros de contadores de rendimiento en


otros formatos, como texto-TSV (para texto delimitado por tabulaciones), texto-CSV
(para texto delimitado por comas), binario-BIN o SQL.

7 Nota

Para más información sobre cómo incorporar relog a sus scripts de Instrumental de
administración de Windows (WMI), consulte el blog de scripting .

Sintaxis

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 Descripción

filename [filename Especifica la ruta de un registro de contador de rendimiento existente.


...] Puede especificar varios archivos de entrada.

-a Anexa el archivo de salida en lugar de sobrescribir. Esta opción no se


aplica al formato SQL, en el que el valor predeterminado es siempre
anexar.

-c path [path ...] Especifica la ruta de acceso del contador de rendimiento que se va a
registrar. Para especificar varias rutas de acceso al contador, sepárelas
con un espacio y coloque las rutas de acceso al contador entre comillas
(por ejemplo, "path1 path2" ).
Parámetro Descripción

-cf filename Especifica la ruta del archivo de texto que enumera los contadores de
rendimiento que se incluirán en un archivo relog. Use esta opción para
enumerar las rutas de acceso de contador en un archivo de entrada, una
por línea. La configuración predeterminada es que se vuelvan a registrar
todos los contadores del archivo de registro original.

-f {bin | csv | tsv | Especifica la ruta del formato del archivo de salida. El formato
SQL} predeterminado es bin. Para una base de datos SQL, el archivo de salida
especifica el DSN!CounterLog . Puede especificar la ubicación de la base de
datos usando el administrador de ODBC para configurar el DSN (nombre
del sistema de base de datos).

-t value Especifica los intervalos de muestreo en n registros. Incluye cada enésimo


punto de datos en el archivo relog. El valor predeterminado es cada
punto de datos.

-o {Outputfile | Especifica el nombre de ruta de acceso del archivo de salida o la base de


SQL:DSN!Counter_Log} datos SQL donde se escribirán los contadores.
Nota: Para las versiones de 64 y 32 bits de relog.exe, debe definir un DSN
en el origen de datos ODBC (64 y 32 bits respectivamente) del sistema.
Use el controlador de ODBC "SQL Server" para definir un DSN.

-b <M/D/YYYY> Especifica la hora de inicio para copiar el primer registro del archivo de
[[<HH>:]<MM>:]<SS>] entrada. La fecha y hora deben tener este formato exacto
M/D/AAAAHH:MM:SS.

-e <M/D/YYYY> Especifica la hora de finalización para copiar el último registro del archivo
[[<HH>:]<MM>:]<SS>] de entrada. La fecha y hora deben tener este formato exacto
M/D/AAAAHH:MM:SS.

-config {filename | Especifica el nombre de ruta de acceso del archivo de configuración que
i} contiene parámetros de línea de comandos. Si usa un archivo de
configuración, puede usar -i como marcador de posición para una lista de
archivos de entrada que se pueden colocar en la línea de comandos. Si
usa la línea de comandos, no use -i. También puede usar caracteres
comodín, como *.blg , para especificar varios nombres de archivo de
entrada a la vez.

-q Muestra los contadores de rendimiento y los intervalos de tiempo de los


archivos de registro especificados en el archivo de entrada.

-y Omite las solicitudes respondiendo "sí" a todas las preguntas.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
El formato general de las rutas de acceso de contador es el siguiente: [\
<computer>] \<object>[<parent>\<instance#index>] \<counter>] donde los
componentes primarios, de instancia, de índice y contador del formato pueden
contener un nombre válido o un carácter comodín. Los componentes de equipo,
primario, instancia e índice no son necesarios para todos los contadores.

Usted determina las rutas de acceso al contador que debe usar en función del
propio contador. Por ejemplo, el objeto LogicalDisk tiene una instancia de
<index> , por lo que debe proporcionar el <#index> o un comodín. Por lo tanto,

puede usar el siguiente formato: \LogicalDisk(*/*#*)\\* .

En comparación, el objeto Process no requiere una instancia de <index> . Por lo


tanto, puede usar el siguiente formato: \Process(*)\ID Process .

Si se especifica un carácter comodín en el nombre de Parent, se devolverán todas


las instancias del objeto especificado que coincidan con los campos de instancia y
contador especificados.

Si se especifica un carácter comodín en el nombre de Instance, se devolverán


todas las instancias del objeto especificado y del objeto primario si todos los
nombres de instancia correspondientes al índice especificado coinciden con el
carácter comodín.

Si se especifica un carácter comodín en el nombre de Counter, se devuelven todos


los contadores del objeto especificado.

Las coincidencias parciales de cadenas de ruta de acceso al contador (por ejemplo,


pro*) no son compatibles.

Los archivos de contador son archivos de texto que enumeran uno o varios de los
contadores de rendimiento del registro existente. Copie el nombre del contador
completo del registro o la salida /q en formato <computer>\<object>\<instance>\
<counter> . Enumere una ruta de acceso al contador en cada línea.

Cuando se ejecuta, el comando relog copia los contadores especificados de cada


registro del archivo de entrada, convirtiendo el formato si es necesario. Las rutas
de acceso con caracteres comodín se permiten en el archivo de contador.

Use el parámetro /t para especificar que los archivos de entrada se insertan en


archivos de salida a intervalos de cada nth registros. De manera predeterminada,
se vuelven a registrar los datos de cada registro.

Puede especificar que sus registros de salida incluyan registros anteriores a la hora
de inicio (es decir, /b) para proporcionar datos a los contadores que requieren
valores de proceso del valor con formato. El archivo de salida tendrá los últimos
registros de los archivos de entrada con marcas de tiempo inferiores al parámetro
/e (es decir, la hora de finalización).

El contenido del archivo de configuración usado con la opción /config debe tener
el siguiente formato: <commandoption>\<value> , donde <commandoption> es una
opción de línea de comandos y <value> especifica su valor.

Ejemplos de ##Q#

Para volver a muestrear los registros de seguimiento existentes a intervalos fijos de 30,
enumerar las rutas de acceso a los contadores, los archivos de salida y los formatos,
escriba:

relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o


c:\perflogs\reduced_log.csv /t 30 /f csv

Para volver a muestrear los registros de seguimiento existentes a intervalos fijos de 30,
enumerar las rutas de acceso a los contadores y el archivo de salida, escriba:

relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o


c:\perflogs\reduced_log.blg /t 30

Para volver a muestrear los registros de seguimiento existentes en una base de datos,
escriba:

relog "c:\perflogs\daily_trace_log.blg" -f sql -o


"SQL:sql2016x64odbc!counter_log"

Vínculos relacionados
Clave de sintaxis de línea de comandos
rem
Artículo • 08/04/2023

Registra comentarios en un archivo config.sys, de script o por lotes. Si no se especifica


ningún comentario, rem agrega espaciado vertical.

7 Nota

Este comando es interno para el intérprete de línea de comandos, cmd.exe.

Sintaxis

rem [<comment>]

Parámetros

Parámetro Descripción

<comment> Especifica una cadena de caracteres que se va a incluir como comentario.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

El comando rem no muestra comentarios en la pantalla. Para mostrar comentarios


en pantalla, debe incluir el comando echo on en el archivo.

No se puede usar un carácter de redireccionamiento ( < o > ) ni una barra vertical


( | ) en un comentario de archivo por lotes.

Aunque puede usar rem sin un comentario para agregar espaciado vertical a un
archivo por lotes, también puede usar líneas en blanco. Las líneas en blanco se
omiten cuando se procesa un programa por lotes.

Ejemplos
Para agregar espaciado vertical a través de comentarios de archivo por lotes, escriba:
@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 un comentario explicativo antes del comando prompt en un archivo


config.sys, escriba:

rem Set prompt to indicate current directory


prompt $p$g

Para proporcionar un comentario sobre lo que hace un script, escriba:

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 comentarios de varias líneas, use la ejecución 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. ^)
)

Vínculos relacionados
Clave de sintaxis de línea de comandos
remove
Artículo • 06/04/2023

Quita una letra de unidad o un punto de montaje del volumen que tiene el foco. Si se
utiliza el parámetro all, se quitan todas las letras de unidad y puntos de montaje
actuales. Si no se especifica ninguna letra de unidad o punto de montaje, DiskPart
quitará la primera letra de unidad o punto de montaje que encuentre.

Puede utilizar el comando remove para cambiar la letra de unidad asociada con una
unidad extraíble. No es posible quitar las letras de unidad de los volúmenes de sistema,
de arranque ni de paginación. Además, no puede quitar la letra de unidad de las
particiones OEM, de las particiones GPT con un GUID no reconocido, ni de ninguna de
las particiones GPT especiales (no de datos), tales como la partición de sistema EFI.

7 Nota

Se debe seleccionar un volumen para que el comando remove funcione


correctamente. Use el comando seleccionar volumen para seleccionar un disco y
desplazar el foco a él.

Sintaxis

remove [{letter=<drive> | mount=<path> [all]}] [noerr]

Parámetros

Parámetro Descripción

letter= <drive> La letra de unidad que quiere quitar.

mount= <path> La ruta de acceso al punto de montaje que quiere quitar.

all Quita todas las letras de unidad y puntos de montaje actuales.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace
que DiskPart salga con un código de error.
Ejemplos
Para quitar la unidad d:\, escriba:

remove letter=d

Vínculos relacionados
Clave de sintaxis de línea de comandos
ren
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el nombre de los archivos o directorios.

7 Nota

Este comando es el mismo que el comando rename.

Sintaxis

ren [<drive>:][<path>]<filename1> <filename2>

Parámetros

Parámetro Descripción

[<drive>:] Especifica la ubicación y el nombre del archivo o conjunto de archivos cuyo


[<path>] nombre desea cambiar. Filename1 puede incluir caracteres comodín (* y ?).
<filename1>

<filename2> Especifica el nuevo nombre del archivo. Puede usar caracteres comodín para
especificar nombres nuevos para varios archivos.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

No se puede especificar una nueva unidad o ruta de acceso al cambiar el nombre


de los archivos. Tampoco puede usar este comando para cambiar el nombre de los
archivos entre unidades o mover archivos a otro directorio.

Los caracteres representados por caracteres comodín en filename2 serán idénticos


a los caracteres correspondientes en filename1.
Filename2 debe ser un nombre de archivo único. Si filename2 coincide con un
nombre de archivo existente, aparece el siguiente mensaje: Duplicate file name
or file not found .

Ejemplos
Para cambiar todas las extensiones de nombre de archivo .txt en el directorio actual a
extensiones .doc, escriba:

ren *.txt *.doc

Para cambiar el nombre de un directorio de Chap10 a Part10, escriba:

ren chap10 part10

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando rename
rename
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el nombre de archivos o directorios.

7 Nota

Este comando es el mismo que el comando ren.

Sintaxis

rename [<drive>:][<path>]<filename1> <filename2>

Parámetros

Parámetro Descripción

[<drive>:] Especifica la ubicación y el nombre del archivo o conjunto de archivos cuyo


[<path>] nombre desea cambiar. Filename1 puede incluir caracteres comodín (* y ?).
<filename1>

<filename2> Especifica el nuevo nombre del archivo. Puede usar caracteres comodín para
especificar nombres nuevos para varios archivos.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

No se puede especificar una nueva unidad o ruta de acceso al cambiar el nombre


de los archivos. Tampoco puede usar este comando para cambiar el nombre de los
archivos entre unidades o mover archivos a otro directorio.

Los caracteres representados por caracteres comodín en filename2 serán idénticos


a los caracteres correspondientes en filename1.
Filename2 debe ser un nombre de archivo único. Si filename2 coincide con un
nombre de archivo existente, aparece el siguiente mensaje: Duplicate file name
or file not found .

Ejemplos
Para cambiar todas las extensiones de nombre de archivo .txt en el directorio actual a
extensiones .doc, escriba:

rename *.txt *.doc

Para cambiar el nombre de un directorio de Chap10 a Part10, escriba:

rename chap10 part10

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando ren
reparación
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Repara el volumen RAID-5 con el foco sustituyendo la región del disco que ha fallado
por el disco dinámico especificado.

Debe seleccionarse un volumen en una matriz RAID-5 para que esta operación se realice
correctamente. Use el comando select volume para seleccionar un volumen y desplazar
el foco a él.

Sintaxis

repair disk=<n> [align=<n>] [noerr]

Parámetros

Parámetro Descripción

disk= <n> Especifica el disco dinámico que reemplazará la región de disco con errores. Donde
n debe tener espacio libre mayor o igual que el tamaño total de la región del disco
con errores en el volumen RAID-5.

align= <n> Alinea todos los volúmenes o extensiones de partición al límite de alineación más
cercano. Donde n es el número de kilobytes (KB) desde el principio del disco hasta
el límite de alineación más cercano.

noerr solo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace que
DiskPart salga con un código de error.

Ejemplos
Para reemplazar el volumen con el foco sustituyéndolo por el disco dinámico 4, escriba:
repair disk=4

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando select volume


repair-bde
Artículo • 14/04/2023

Intenta reconstruir partes críticas de una unidad gravemente dañada y recuperar datos
recuperables si la unidad se cifró mediante BitLocker y si tiene una contraseña de
recuperación válida o una clave de recuperación para el descifrado.

) Importante

Si los metadatos de BitLocker en la unidad se han dañado, debe poder


proporcionar un paquete de claves de copia de seguridad además de la contraseña
de recuperación o la clave de recuperación. Si usó la configuración de copia de
seguridad de la clave predeterminada para Active Directory Domain Services, se
realiza una copia de seguridad del paquete de claves allí. Puede utilizar el
BitLocker: Usar el visor de contraseñas de recuperación de BitLocker para obtener
este paquete de claves desde AD DS.

Con este paquete de claves y la contraseña de recuperación o la clave de


recuperación puede descifrar partes de una unidad protegida con BitLocker incluso
si el disco se daña. Cada paquete de claves funciona solo para una unidad que
tenga el identificador de unidad correspondiente.

Sintaxis

repair-bde <inputvolume> <outputvolumeorimage> [-rk] [–rp] [-pw] [–kp] [–lf]


[-f] [{-?|/?}]

2 Advertencia

El contenido del volumen de salida se eliminará por completo y se sobrescribirá


con el contenido descifrado de la unidad BitLocker dañada. Si desea guardar los
datos existentes en la unidad de destino seleccionada, mueva primero los datos
existentes a otros medios de copia de seguridad fiables antes de ejecutar el
comando repair-bde .

Parámetros
Parámetro Descripción

<inputvolume> Identifica la letra de unidad de la unidad cifrada con BitLocker que se


desea reparar. La letra de unidad debe incluir dos puntos; por ejemplo:
C:. Si no se especifica la ruta de acceso a un paquete de claves, este
comando busca en la unidad un paquete de claves. En caso de que el
disco duro esté dañado, es posible que este comando no pueda
encontrar el paquete y le pedirá que proporcione la ruta de acceso.

<outputvolumeorimage> Identifica la unidad en la que se va a almacenar el contenido de la


unidad reparada. Se sobrescribirá toda la información sobre esta unidad
de salida.

-rk Identifica la ubicación de la clave de recuperación que se debe usar para


desbloquear el volumen. Este comando también se puede especificar
como -recoverykey.

-rp Identifica la contraseña de recuperación numérica que se debe usar para


desbloquear el volumen. Este comando también se puede especificar
como -recoverypassword.

-pw Identifica la contraseña que se debe usar para desbloquear el volumen.


Este comando también se puede especificar como -password

-kp Identifica el paquete de claves de recuperación que se puede usar para


desbloquear el volumen. Este comando también se puede especificar
como -keypackage.

-lf Especifica la ruta de acceso al archivo que almacenará mensajes de


información, advertencia y error de Repair-bde. Este comando también
se puede especificar como -logfile.

-f Fuerza que se desmonte un volumen aunque no se pueda bloquear.


Este comando también se puede especificar como -force.

-? o /? Muestra la Ayuda en el símbolo del sistema.

Limitaciones
Existen las siguientes limitaciones para este comando:

El comando no puede reparar una unidad que sufre un error durante el proceso de
cifrado o de descifrado.

El comando supone que si la unidad tiene una parte cifrada, esto significa que se
ha cifrado totalmente.

Ejemplos
Para intentar reparar la unidad C:, para escribir el contenido de la unidad C: en la unidad
D: mediante el archivo de clave de recuperación (RecoveryKey.bek) almacenado en la
unidad F:, y para escribir los resultados de este intento en el archivo de registro (log.txt)
en la unidad Z:, escriba:

repair-bde C: D: -rk F:\RecoveryKey.bek –lf Z:\log.txt

Para intentar reparar la unidad C: y escribir el contenido de la unidad C: en la unidad D:


mediante la contraseña de recuperación de 48 dígitos especificada, escriba:

repair-bde C: D: -rp 111111-222222-333333-444444-555555-666666-777777-888888

7 Nota

La contraseña de recuperación debe escribirse en ocho bloques de seis dígitos con


un guion que separa cada bloque.

Para forzar que la unidad C: se desmonte, intentar reparar la unidad C:, y, a


continuación, copiar el contenido de la unidad C: en la unidad D: mediante el paquete
de claves de recuperación y el archivo de clave de recuperación (RecoveryKey.bek)
almacenados en la unidad F:, escriba:

repair-bde C: D: -kp F:\RecoveryKeyPackage -rk F:\RecoveryKey.bek -f

Para intentar reparar la unidad C: y escribir el contenido de la unidad C: en la unidad D:,


donde debe escribir una contraseña para desbloquear la unidad C: (cuando se le
solicite), escriba:

repair-bde C: D: -pw

Vínculos relacionados
Clave de sintaxis de línea de comandos
replace
Artículo • 08/04/2023

Reemplace los archivos existentes en un directorio. Si se usa con la opción /a, este
comando agrega nuevos archivos a un directorio en lugar de reemplazar los archivos
existentes.

Sintaxis

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 Descripción

[<drive1>:] Especifica la ubicación y el nombre del archivo de origen o del conjunto de


[<path1>] archivos. La opción filename es obligatoria y puede incluir caracteres comodín (* y
<filename> ?).

[<drive2>:] Especifica la ubicación del archivo de destino. No se puede especificar un nombre


[<path2>] de archivo para los archivos que reemplace. Si no especifica una unidad o ruta de
acceso, este comando usa la unidad y el directorio actuales como destino.

/a Agrega nuevos archivos al directorio de destino en lugar de reemplazar los


archivos existentes. No puede usar esta opción de línea de comandos con la
opción de línea de comandos /s o /u.

/p Le pide confirmación antes de reemplazar un archivo de destino o agregar un


archivo de origen.

/r Reemplaza los archivos de solo lectura y desprotegidos. Si intenta reemplazar un


archivo de solo lectura, pero no especifica /r, se produce un error y se detiene la
operación de reemplazo.

/w Espera a que inserte un disco antes de que comience la búsqueda de archivos de


origen. Si no especifica /w, este comando comienza a reemplazar o agregar
archivos inmediatamente después de presionar ENTRAR.
Parámetro Descripción

/s Busca en todos los subdirectorios del directorio de destino y reemplaza los


archivos coincidentes. No se puede usar /s con la opción de línea de comandos /a.
El comando no busca subdirectorios especificados en Path1.

/U Reemplaza solo los archivos del directorio de destino que son anteriores a los del
directorio de origen. No se puede usar /u con la opción de línea de comandos /a.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
A medida que este comando agrega o reemplaza archivos, los nombres de archivo
aparecen en la pantalla. Una vez finalizado este comando, se muestra una línea de
resumen en uno de los siguientes formatos:

nnn files added


nnn files replaced
no file added
no file replaced

Si usa disquetes y necesita cambiar los discos mientras ejecuta este comando,
puede especificar la opción de línea de comandos /w para que este comando
espere a que cambie los discos.

No puede usar este comando para actualizar archivos ocultos o archivos del
sistema.

En la tabla siguiente se muestran los códigos de salida y una breve descripción de


su significado:

Código de salida Descripción

0 Este comando reemplazó o agregó correctamente los archivos.

1 Este comando encontró una versión incorrecta de MS-DOS.

2 Este comando no pudo encontrar los archivos de origen.

3 Este comando no pudo encontrar la ruta de acceso de origen o destino.

5 El usuario no tiene acceso a los archivos que desea reemplazar.

8 No hay memoria del sistema suficiente para llevar a cabo el comando.


Código de salida Descripción

11 El usuario usó la sintaxis incorrecta en la línea de comandos.

7 Nota

Puede usar el parámetro ERRORLEVEL en la línea de comandos if de un programa


por lotes para procesar los códigos de salida devueltos por este comando.

Ejemplos
Para actualizar todas las versiones de un archivo denominado Phones.cli (que aparecen
en varios directorios en la unidad C:), con la versión más reciente del archivo Phones.cli
desde un disquete en la unidad A:, escriba:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos
volver a examinar
Artículo • 06/04/2023

Con el intérprete de comandos diskpart, puede buscar nuevos discos agregados al


equipo.

Sintaxis

rescan

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando Diskpart
reset
Artículo • 14/04/2023

Restablece DiskShadow.exe al estado predeterminado. Este comando es especialmente


útil para separar las operaciones compuestas DiskShadow, como create, import, backup
o restore.

[IMPORTANTE Después de ejecutar este comando, perderá la información de estado


de los comandos, como add, set, load o writer. Este comando también libera
interfaces IVssBackupComponent y pierde instantáneas no persistentes.

Sintaxis

reset

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando create

Comando import

Comando backup

Comando restore

Comando add

Comando set

Comando load

Comando writer
reset session
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Permite restablecer (eliminar) una sesión en un servidor host de sesión de Escritorio


remoto. Debe restablecer una sesión sólo si no funciona correctamente o ha dejado de
responder.

7 Nota

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de Escritorio remoto en Windows Server.

Sintaxis

reset session {<sessionname> | <sessionID>} [/server:<servername>] [/v]

Parámetros

Parámetro Descripción

<sessionname> Especifica el nombre de la configuración de sesión que quiere restablecer.


Para determinar el nombre de la sesión, use el comando query session.

<sessionID> Especifica el identificador de la sesión que se va a restablecer.

/server: <servername> Especifica el servidor de terminal que contiene la sesión que quiere
restablecer. De lo contrario, usa el servidor host de sesión de Escritorio
remoto actual. Este parámetro es necesario solo si usa este comando
desde un servidor remoto.

/v Muestra información sobre las acciones que se realizan.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Siempre puede restablecer sus propias sesiones, pero debe tener permiso de
acceso de Control total para restablecer la sesión de otro usuario. Tenga en cuenta
que restablecer la sesión de un usuario sin avisarle puede provocar la pérdida de
los datos de la sesión.

Ejemplos
Para restablecer la sesión designada rdp-tcp#6, escriba:

reset session rdp-tcp#6

Para restablecer la sesión que usa el identificador de sesión 3, escriba:

reset session 3

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos de Servicios de Escritorio remoto


retain
Artículo • 06/04/2023

Prepara un volumen dinámico simple existente para usarlo como volumen de arranque
o de sistema. Si usa un disco dinámico con registro de arranque maestro (MBR), este
comando crea una entrada de partición en el registro de arranque maestro. Si usa un
disco dinámico con tabla de particiones GUID (GPT), este comando crea una entrada de
partición en la tabla de particiones GUID.

Sintaxis

retain

Vínculos relacionados
Clave de sintaxis de línea de comandos
revert
Artículo • 06/04/2023

Revierte un volumen a una instantánea especificada. Esto solo se admite para


instantáneas en el contexto CLIENTACCESSIBLE. Estas instantáneas son persistentes y
solo pueden ser realizadas por el proveedor del sistema. Si se usa sin parámetros, revert
muestra la ayuda en el símbolo del sistema.

Sintaxis

revert <shadowcopyID>

Parámetros

Parámetro Descripción

<shadowcopyID> Especifica el identificador de instantánea al que revertir el volumen. Si no usa


este parámetro, el comando muestra ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
rexec
Artículo • 06/04/2023

Ejecuta un comando especificado en un host remoto. El host remoto debe ejecutar un


servicio rexecd (o demonio) para que rexec se conecte.

) Importante

El comando rexec está en desuso y no se garantiza que se admita en Windows.


risetup
Artículo • 05/10/2023

Crea una imagen del sistema operativo extrayendo los archivos del CD original de
Windows Server 2003 o de una carpeta de distribución personalizada que contenga
estos archivos.

) Importante

El comando rexec está en desuso y no se garantiza que se admita en Windows.


rmdir
Artículo • 14/04/2023

Elimina un directorio.

El comando rmdir también se puede ejecutar desde la Consola de recuperación de


Windows mediante distintos parámetros. Para obtener más información, consulte
Entorno de recuperación de Windows (WinRE).

7 Nota

Este comando es el mismo que el comando rd.

Sintaxis

rmdir [<drive>:]<path> [/s [/q]]

Parámetros

Parámetro Descripción

[<drive>:] Especifica la ubicación y el nombre del directorio que desea eliminar. La ruta de
<path> acceso es obligatoria. Si incluye una barra diagonal inversa () al principio de la ruta
de acceso especificada. A continuación, la ruta de acceso comienza en el directorio
raíz (independientemente del directorio actual).

/s Elimina un árbol de directorios (el directorio especificado y todos sus subdirectorios,


incluidos todos los archivos).

/q Especifica el modo silencioso. No solicita confirmación al eliminar un árbol de


directorios. El parámetro /q solo funciona si también se especifica /s.

PRECAUCIÓN: Cuando se ejecuta en modo silencioso, se elimina todo el árbol de


directorios sin confirmación. Asegúrese de que los archivos importantes se mueven
o se realiza una copia de seguridad antes de usar la opción de línea de comandos
/q.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
No se puede eliminar un directorio que contenga archivos, incluidos los archivos
ocultos o del sistema. Si intenta hacerlo, aparece el siguiente mensaje:

The directory is not empty

Use el comando dir /a para enumerar todos los archivos (incluidos los archivos
ocultos y del sistema). A continuación, use el comando attrib con -h para quitar
atributos de archivo ocultos, -s para quitar atributos de archivo del sistema o -h -s
para quitar los atributos de archivo ocultos y del sistema. Después de quitar los
atributos ocultos y de archivo, puede eliminar los archivos.

No puede usar el comando rmdir para eliminar el directorio actual. Si intenta


eliminar el directorio actual, aparece el siguiente mensaje de error:

The process can't access the file because it is being used by another

process.

Si recibe este mensaje de error, debe cambiar a otro directorio (no a un


subdirectorio del directorio actual) e intentarlo de nuevo.

Ejemplos
Para cambiar al directorio primario y poder quitar de forma segura el directorio
deseado, escriba:

cd ..

Para quitar un directorio denominado test (y todos sus subdirectorios y archivos) del
directorio actual, escriba:

rmdir /s test

Para ejecutar el ejemplo anterior en modo silencioso, escriba:

rmdir /s /q test
Vínculos relacionados
Clave de sintaxis de línea de comandos
robocopy
Artículo • 11/11/2023

Copia los datos de archivo de una ubicación a otra.

Sintaxis
Símbolo del sistema de Windows

robocopy <source> <destination> [<file>[ ...]] [<options>]

Por ejemplo, para copiar un archivo denominado yearly-report.mov de c:\reports a un


recurso compartido de archivos \\marketing\videos mientras se habilita el multiproceso
para un mayor rendimiento (con el parámetro /mt ) y la capacidad de reiniciar la
transferencia en caso de que se interrumpa (con el parámetro /z ), escriba:

Símbolo del sistema de Windows

robocopy c:\reports "\\marketing\videos" yearly-report.mov /mt /z

) Importante

Si se copian datos de la raíz de un dispositivo, el directorio de destino adoptará el


atributo "oculto" durante el proceso de copia.

Parámetros

Parámetro Descripción

<source> Especifica la ruta de acceso del directorio de origen.

<destination> Especifica la ruta de acceso del directorio de destino.

<file> Especifica el archivo o los archivos que se van a copiar. Se admiten caracteres
comodín (* o ?). Si no especifica este parámetro, *.* se usa como valor
predeterminado.

<options> Especifica las opciones a usar con el comando robocopy, incluyendo las
opciones de copia, archivo, reintento, registro y trabajo.
Opciones de copia

Opción Descripción

/s Copia los subdirectorios. Esta opción excluye automáticamente los directorios


vacíos.

/e Copia los subdirectorios. Esta opción incluye automáticamente directorios


vacíos.

/lev: <n> Copia solo los n niveles superiores del árbol de directorios de origen.

/z Copia los archivos en modo de reinicio. En el modo reiniciable, si se interrumpe


la copia de un archivo, robocopy puede retomarla donde la dejó en lugar de
volver a copiar todo el archivo.

/b Copia los archivos en modo de copia de seguridad. En el modo de copia de


seguridad, robocopy invalida la configuración de permisos de archivos y
carpetas (ACL), lo que podría bloquear el acceso.

/zb Copia los archivos en modo de reinicio. Si se deniega el acceso a archivos,


cambia al modo de copia de seguridad.

/j Copia mediante E/S sin búfer (recomendado para archivos grandes).

/efsraw Copia todos los archivos cifrados en el modo sin procesar de EFS.

/copy: Especifica qué propiedades de archivo se van a copiar. Los valores válidos para
<copyflags> esta opción son:
D: datos
A: atributos
T: marcas de tiempo
X: omitir flujos de datos alternativos
S: lista de control de acceso (ACL) de NTFS
O: información del propietario
U: información de auditoría

El valor predeterminado de la opción /COPY es DAT (datos, atributos y marcas


de tiempo). La marca X se omite si se usa /B o /ZB.

/dcopy: Especifica qué copiar en directorios. Los valores válidos para esta opción son:
<copyflags> D: datos
A: atributos
T: marcas de tiempo
E: atributo extendido
X: omitir flujos de datos alternativos

El valor predeterminado de esta opción es DA (datos y atributos).

/s Copia archivos con seguridad (equivalente a /copy:DATS).


Opción Descripción

/copyall Copia toda la información del archivo (equivalente a /copy:DATSOU).

/nocopy No copia información de archivo (útil con /purge).

/secfix Corrige la seguridad de los archivos en todos los archivos, incluso los omitidos.

/timfix Corrige los tiempos de todos los archivos, incluso los omitidos.

/purge Elimina los archivos y directorios de destino que ya no existen en el origen. Si


usa esta opción con la opción /e y un directorio de destino, permite que la
configuración de seguridad del directorio de destino no se sobrescriba.

/mir Refleja un árbol de directorios (equivalente a /e más /purge). El uso de esta


opción con la opción /e y un directorio de destino sobrescribe la configuración
de seguridad del directorio de destino.

/mov Mueve los archivos y los elimina del origen después de copiarlos.

/move Mueve archivos y directorios y los elimina del origen después de copiarlos.

/a+: Agrega los atributos especificados a los archivos copiados. Los valores válidos
[RASHCNET] para esta opción son:
R: Solo lectura
A: Archivo
S: Sistema
H: Oculto
C: Comprimido
N: Contenido no indexado
E: Cifrado
T: Temporal

/a-: Quita los atributos especificados de los archivos copiados. Los valores válidos
[RASHCNETO] para esta opción son:
R: Solo lectura
A: Archivo
S: Sistema
H: Oculto
C: Comprimido
N: Contenido no indexado
E: Cifrado
T: Temporal
O: sin conexión

/create Crea un árbol de directorios y solo archivos de longitud cero.

/fat Crea archivos de destino usando solo nombres de archivo FAT de longitud de
caracteres de 8,3.
Opción Descripción

/256 Desactiva la compatibilidad con rutas de acceso de más de 256 caracteres.

/mon: <n> Supervisa el origen y se ejecuta de nuevo cuando se detectan más de n


cambios.

/mot: <m> Supervisa el origen y se ejecuta de nuevo en m minutos si se detectan cambios.

/rh:hhmm- Especifique los tiempos de ejecución en los que se pueden iniciar nuevas
hhmm copias.

/pf Comprueba los tiempos de ejecución por archivo (no por pase).

/ipg: <n> Especifica el espacio entre paquetes para liberar ancho de banda en las líneas
lentas.

/sj Copia los cruces (vínculos simbólicos) en la ruta de acceso de destino en lugar
de los objetivos de los vínculos.

/sl No seguir los vínculos simbólicos y, en su lugar, crear una copia del vínculo.

/mt: <n> Crea copias multiproceso con n subprocesos. n debe ser un número entero
entre 1 y 128. El valor predeterminado para n es 8. Para mejorar el rendimiento,
redirija la salida mediante la opción /log.

El parámetro /mt no se puede usar con los parámetros /ipg y /efsraw.

/nodcopy No copia ninguna información de directorio (se hace de manera


predeterminada /dcopy:DA).

/nooffload Copia archivos sin usar el mecanismo de descarga de copia de Windows.

/compress Solicita la compresión de red durante la transferencia de archivos, si procede.

/sparse Permite conservar el estado disperso de los archivos durante la copia.

) Importante

Al usar la opción de copia /secfix, especifique el tipo de información de seguridad


que quiere copiar, usando una de estas opciones de copia adicionales:

/copyall
/copy:o
/copy:s
/copy:u
/sec
7 Nota

El parámetro /mt se introdujo en Windows Server 2008 R2 y su funcionalidad se


aplica a las versiones actuales de Windows Server.

Copiar opciones de limitación de archivos

Opción Descripción

/iomaxsize: <n> Tamaño máximo de E/S solicitado por ciclo de lectura y escritura en
[kmg] nkilobytes, megabytes o gigabytes.

/iorate: <n> [kmg] Tasa de e/S solicitada en nkilobytes megabytes o gigabytes por segundo.

/threshold: <n> Umbral de tamaño de archivo para la limitación en nkilobytes, megabytes o


[kmg] gigabytes (vea Comentarios).

Opciones de selección de archivos

Opción Descripción

/a Copia solo los archivos para los que se establece el atributo Archive.

/m Copia solo los archivos para los que se establece el atributo Archive y
restablece el atributo Archive.

/ia: [RASHCNETO] Incluye solo los archivos para los que se establece cualquiera de los atributos
especificados. Los valores válidos para esta opción son:
R: Solo lectura
A: Archivo
S: Sistema
H: Oculto
C: Comprimido
N: Contenido no indexado
E: Cifrado
T: Temporal
O: sin conexión

/xa: Excluye archivos que tienen cualquiera de los atributos especificados


[RASHCNETO] establecidos. Los valores válidos para esta opción son:
R: Solo lectura
A: Archivo
S: Sistema
H: Oculto
C: Comprimido
Opción Descripción

N: Contenido no indexado
E: Cifrado
T: Temporal
O: sin conexión

/xf <filename>[ Excluye los archivos que coinciden con los nombres o rutas de acceso
...] especificados. Se admiten caracteres comodín (* y ?).

/xd Excluye los directorios que coinciden con los nombres y rutas de acceso
<directory>[ especificados.
...]

/xc Excluye los archivos existentes con la misma marca de tiempo, pero tamaños de
archivo diferentes.

/xn Los archivos de directorio de origen más recientes que el destino se excluyen
de la copia.

/xo Los archivos de directorio de origen anteriores al destino se excluyen de la


copia.

/xx Excluye archivos y directorios adicionales presentes en el destino, pero no en el


origen. La exclusión de archivos adicionales no eliminará los archivos del
destino.

/xl Excluye los archivos y directorios "solitarios" presentes en el origen, pero no en


el destino. Excluir archivos solitarios impide que se agreguen nuevos archivos al
destino.

/im Incluir archivos modificados (tiempos de cambio diferentes).

/is Incluye los mismos archivos. Los mismos archivos son idénticos en nombre,
tamaño, tiempos y todos los atributos.

/it Incluye archivos "retocados". Los archivos retocados tienen el mismo nombre,
tamaño y tiempos, pero atributos diferentes.

/max: <n> Especifica el tamaño máximo de archivo (para excluir archivos mayores que n
bytes).

/min: <n> Especifica el tamaño mínimo del archivo (para excluir archivos menores que n
bytes).

/maxage: <n> Especifica la antigüedad máxima de los archivos (para excluir los archivos de
más de n días o anteriores a una fecha).

/minage: <n> Especifica la antigüedad mínima del archivo (para excluir los archivos de menos
de n días o posteriores a una fecha).
Opción Descripción

/maxlad: <n> Especifica la fecha máxima de último acceso (excluye los archivos sin usar
desde n).

/minlad: <n> Especifica la fecha mínima de último acceso (excluye los archivos usados desde
n) Si n es menor que 1 900, n especifica el número de días. De lo contrario, n
especifica una fecha con el formato AAAAMMDD.

/xj Excluye los puntos de unión, que normalmente se incluyen de forma


predeterminada.

/fft Se da por supuesto que se trata de tiempos de archivos FAT (precisión de dos
segundos).

/dst Compensa las diferencias horarias DST de una hora.

/xjd Excluye los puntos de unión de los directorios.

/xjf Excluye los puntos de unión de los archivos.

Opciones de reintento

Opción Descripción

/r: <n> Especifica el número de reintentos en las copias con errores. El valor
predeterminado de n es 1 000 000 (un millón de reintentos).

/w: <n> Especifica el tiempo de espera entre reintentos, en segundos. El valor


predeterminado de n es 30 (tiempo de espera de 30 segundos).

/reg Guarda los valores especificados en las opciones /r y /w como valores


predeterminados en el registro.

/tbd Especifica que el sistema espera a que se definan los nombres de los recursos
compartidos (error de reintento 67).

/lfsm Operar en modo de poco espacio disponible, que permite copiar, pausar y
reanudar (consulte Comentarios).

/lfsm: <n> Especifica el tamaño de "floor" en nkilobytes, megabytes o gigabytes.


[kmg]

Opciones de registro
Opción Descripción

/l Especifica que solo se enumerarán los archivos (y no se copiarán, eliminarán ni


se les pondrá una marca de tiempo).

/x Notifica todos los archivos adicionales, no solo los seleccionados.

/v Genera una salida detallada y muestra todos los archivos omitidos.

/ts Incluye marcas de tiempo de archivo de origen en la salida.

/fp Incluye los nombres de ruta de acceso completos de los archivos en la salida.

/bytes Imprime tamaños como bytes.

/ns Especifica que los tamaños de archivo no se van a registrar.

/nc Especifica que las clases de archivo no se van a registrar.

/nfl Especifica que los nombres de archivo no se van a registrar.

/ndl Especifica que los nombres de directorio no se van a registrar.

/np Especifica que no se mostrará el progreso de la operación de copia (el número


de archivos o directorios copiados hasta el momento).

/eta Muestra el tiempo estimado de llegada (ETA) de los archivos copiados.

/log: <logfile> Escribe la salida del estado en el archivo de registro (sobrescribe el archivo de
registro existente).

/log+: Escribe la salida del estado en el archivo de registro (sobrescribe el archivo de


<logfile> registro existente).

/unilog: Escribe la salida de estado en el archivo de registro como texto Unicode


<logfile> (sobrescribe el archivo de registro existente).

/unilog+: Escribe la salida de estado en el archivo de registro como texto Unicode (anexa
<logfile> la salida al archivo de registro existente).

/tee Escribe la salida de estado en la ventana de la consola y en el archivo de


registro.

/njh Especifica que no hay ningún encabezado de trabajo.

/njs Especifica que no hay ningún resumen del trabajo.

/unicode Muestra la salida de estado como texto Unicode.

Opciones del trabajo


Opción Descripción

/job: Especifica que los parámetros se van a derivar del archivo de trabajo con nombre.
<jobname> Para ejecutar /job:jobname , primero debe ejecutar el parámetro /save:jobname
para crear el archivo de trabajo.

/save: Especifica que los parámetros se guardarán en el archivo de trabajo con nombre.
<jobname> Debe ejecutarse antes de ejecutar /job:jobname . Todas las opciones de copia,
reintento y registro deben especificarse antes de este parámetro.

/quit Sale después de procesar la línea de comandos (para ver los parámetros).

/nosd Indica que no se ha especificado ningún directorio de origen.

/nodd Indica que no se ha especificado ningún directorio de destino.

/if Incluye los archivos especificados.

Comentarios
El uso de /PURGE o /MIR en el directorio raíz del volumen anteriormente
provocaba que robocopy aplicara la operación solicitada también en los archivos
dentro del directorio de Información del volumen del sistema. Esto ya no es así, ya
que si se especifica cualquiera de los dos, robocopy omitirá cualquier archivo o
directorio con ese nombre en los directorios de origen y destino de nivel superior
de la sesión de copia.

La clasificación de archivos modificados solo se aplica cuando los sistemas de


archivos de origen y destino son compatibles con las marcas de tiempo de cambio,
como NTFS, y los archivos de origen y destino tienen tiempos de cambio
diferentes pero, por lo demás, son iguales. Estos archivos no se copian de forma
predeterminada. Especifique /IM para incluirlos.

La marca /DCOPY:E solicita que se deba intentar la copia extendida de atributos


para los directorios. Robocopy continuará si no se pudieron copiar las entidades
de certificación de un directorio. Esta marca no se incluye en /COPYALL.

Si se especifica /IoMaxSize o /IoRate, robocopy activará la limitación de archivos


de copia para reducir la carga del sistema. Ambos se pueden ajustar a valores
óptimos y parámetros de copia, pero el sistema y robocopy pueden ajustarlos a los
valores permitidos según sea necesario.

Si se usa /Threshold, especifica un tamaño mínimo de archivo para activar la


limitación. Los archivos de menor tamaño no se limitarán. Los valores de los tres
parámetros pueden ir seguidos de un carácter de sufijo opcional, como [KMG]
(kilo, mega, giga).

El uso de /LFSM solicita que la robocopia funcione en "modo de poco espacio


disponible". En este modo, robocopy se pondrá en pausa siempre que una copia
de archivo haga que el espacio disponible del volumen de destino se sitúe por
debajo de un valor 'floor'. Este valor puede especificarse explícitamente usando la
marca /LFSM:n[KMG].

Si /LFSM se especifica sin ningún valor floor explícito, floor se establece en el 10 %


del tamaño del volumen de destino. El modo de poco espacio disponible es
incompatible con /MT y /EFSRAW.

Códigos de salida (retorno)

Valor Descripción

0 No se copiaron archivos. No se encontró ningún error. No hay archivos que no coincidan.


Los archivos ya existen en el directorio de destino; por lo tanto, se omitió la operación de
copia.

1 Todos los archivos se copiaron correctamente.

2 Hay algunos archivos adicionales en el directorio de destino que no están presentes en el


directorio de origen. No se copiaron archivos.

3 Se copiaron algunos archivos. Existían archivos adicionales. No se encontró ningún error.

5 Se copiaron algunos archivos. Algunos archivos no coincidían. No se encontró ningún


error.

6 Existen archivos adicionales y archivos que no coinciden. No se copiaron archivos y no se


encontraron errores, lo que significa que los archivos ya existen en el directorio de
destino.

7 Los archivos se copiaron, había un error de coincidencia de archivo y había archivos


adicionales presentes.

8 Varios archivos no se copiaron.

7 Nota

Cualquier valor igual o mayor que 8 indica que hubo al menos un error durante la
operación de copia.
Ejemplos
Se recomienda encarecidamente al ejecutar el comando robocopy para crear un archivo
de registro que se pueda ver una vez que el proceso haya completado la comprobación
de su integridad. En los ejemplos siguientes, todos usan el parámetro /LOG: . Para
anexar cualquier información de registro al mismo archivo de registro, use el parámetro
/LOG+: en su lugar.

Para copiar todos los archivos y subdirectorios, incluidos los directorios vacíos, de la
carpeta "Registros" a la carpeta "Copia de seguridad" de la unidad "D", escriba lo
siguiente:

Símbolo del sistema de Windows

robocopy C:\Users\Admin\Records D:\Backup /E /ZB /LOG:C:\Logs\Backup.log

Para reflejar el contenido de la carpeta "Registros" en la carpeta "Copia de seguridad"


de la unidad "D", elimine los archivos del destino que no existan en el origen con dos
reintentos y esperando cinco segundos entre cada reintento, escriba lo siguiente:

Símbolo del sistema de Windows

robocopy C:\Users\Admin\Records D:\Backup /MIR /R:2 /W:5


/LOG:C:\Logs\Backup.log

Para copiar todos los archivos y subdirectorios que no están vacíos de la carpeta
"Registros" en la carpeta "Copia de seguridad" de la unidad "D", conservando los datos
de archivo, los atributos y las marcas de tiempo con 16 operaciones de copia
multiproceso, escriba lo siguiente:

Símbolo del sistema de Windows

robocopy C:\Users\Admin\Records D:\Backup /S /E /COPY:DAT /MT:16


/LOG:C:\Logs\Backup.log

Para mover archivos y subdirectorios, excepto los directorios vacíos, de la carpeta


"Records" a la carpeta "Copia de seguridad" de la unidad "D" y excluir los archivos de
más de siete días, escriba lo siguiente:

Símbolo del sistema de Windows

robocopy C:\Users\Admin\Records D:\Backup /S /MAXAGE:7 /MOV


/LOG:C:\Logs\Backup.log

Para copiar todos los archivos y subdirectorios, incluidos los directorios vacíos, de la
carpeta "Registros" a la carpeta "Copia de seguridad" de la unidad "D" que muestre el
tiempo estimado para cada archivo y elimine los archivos y directorios del destino que
no existen desde el origen, escriba lo siguiente:

Símbolo del sistema de Windows

robocopy C:\Users\Admin\Records D:\Backup /ETA /PURGE


/LOG:C:\Logs\Backup.log

Vínculos relacionados
Clave de sintaxis de línea de comandos
route
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra y modifica las entradas de la tabla de enrutamiento de IP local. Si se usa sin parámetros,
route muestra la ayuda en el símbolo del sistema.

) Importante

Este comando solo está disponible si el Protocolo de Internet (TCP/IP) está instalado como
componente en las propiedades de un adaptador de red en Conexiones de red.

Sintaxis
Símbolo del sistema de Windows

route [/f] [/p] [<command> [<destination>] [mask <netmask>] [<gateway>] [metric


<metric>]] [if <interface>]]

Parámetros

Parámetro Descripción

/f Borra de la tabla de enrutamiento todas las entradas que no son rutas host (rutas con una máscara
de red de 255.255.255.255), la ruta de red de bucle invertido (rutas con un destino de 127.0.0.0.0 y
una máscara de red de 255.0.0.0) o una ruta de multidifusión (rutas con un destino de 224.0.0.0 y
una máscara de red de 240.0.0.0.0). Si se usa junto con uno de los comandos (como add, change o
delete), la tabla se borra antes de ejecutar el comando.

/p Cuando se usa con el comando add, la ruta especificada se agrega al registro y se usa para
inicializar la tabla de enrutamiento de IP siempre que se inicia el protocolo TCP/IP. De forma
predeterminada, las rutas agregadas no se conservan cuando se inicia el protocolo TCP/IP. Cuando
se usa con el comando print, se muestra la lista de rutas persistentes. Este parámetro se omite para
todos los demás comandos. Las rutas persistentes se almacenan en la ubicación del registro
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters\PersistentRoutes.

<command> Especifica el comando que desea ejecutar. Los comandos válidos incluyen:
add: agrega una ruta.
change: modifica una ruta existente.
delete:: elimina una o varias rutas.
print: imprime una o varias rutas.
Parámetro Descripción

<destination> Especifica el destino de red de la ruta. El destino puede ser una dirección de red IP (donde los bits
de la dirección de red se establecen en 0), una dirección IP para una ruta de host, o 0.0.0.0 para la
ruta predeterminada.

<mask> Especifica el parámetro siguiente para el valor "netmask".

<netmask> Especifica la máscara de subred de destino de red. Si no se especifica, el valor predeterminado es


255.255.255.255.

<gateway> Especifica la dirección IP de reenvío o del próximo salto a través de la cual se puede obtener acceso
al conjunto de direcciones definido por el destino de la red y la máscara de subred. Para las rutas
de subred conectadas localmente, la dirección de puerta de enlace es la dirección IP asignada a la
interfaz que está conectada a la subred. Para rutas remotas, disponibles a través de uno o más
enrutadores, la dirección de puerta de enlace es una dirección IP accesible directamente y asignada
a un enrutador adyacente.

metric Especifica una métrica de costo de enteros (entre 1 a 9999) para la ruta, que se utiliza cuando se
<metric> selecciona entre varias rutas de la tabla de enrutamiento de mayor coincidencia con la dirección de
destino de un paquete que se está reenviando. Se elige la ruta con la métrica mas baja. La métrica
puede reflejar el número de saltos, la velocidad, confiabilidad y rendimiento de la ruta de acceso, o
las propiedades administrativas.

if <interface> Especifica el índice de interfaz para la interfaz a través de la que se obtiene acceso al destino. Para
obtener una lista de interfaces y los correspondientes índices de interfaz, utilice los resultados de la
ejecución del comando route print. En el índice de interfaz puede usar valores decimales o
hexadecimales. Para valores hexadecimales, el número hexadecimal debe estar precedido por 0x.
Cuando se omite el parámetro if, la interfaz se determina mediante la dirección de la puerta de
enlace.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Los valores grandes de la columna metric de la tabla de enrutamiento son el resultado de


permitir que TCP/IP determine automáticamente la métrica de las rutas de la tabla de
enrutamiento en función de la configuración de la dirección IP, la máscara de subred y la
puerta de enlace predeterminada para cada interfaz LAN. La determinación automática de la
métrica de interfaz, habilitada de forma predeterminada, determina la velocidad de cada
interfaz y ajusta las métricas de las rutas para cada interfaz para que la más rápida cree las
rutas con la métrica más baja. Para quitar las métricas grandes, deshabilite la determinación
automática de la métrica de interfaz de las propiedades avanzadas del protocolo TCP/IP para
cada conexión LAN.

Los nombres se pueden usar para destination si existe una entrada adecuada en el archivo
localNetworks, almacenado en la carpeta systemroot\System32\Drivers\\ . Los nombres se
pueden usar para la puerta de enlace siempre que se puedan resolver en una dirección IP a
través de técnicas de resolución de nombres de host estándar, como las consultas del
Sistema de nombres de dominio (DNS), el uso del archivo hosts local almacenado en la
carpeta y la systemroot\system32\drivers\\ resolución de nombres NetBIOS.
Si el comando es print o delete, se puede omitir el parámetro gateway y usar caracteres
comodín para el destino y la puerta de enlace. El valor de destination puede ser un valor
comodín especificado por un asterisco (*) . Si el destino especificado contiene un asterisco
(*) o un signo de interrogación (?), se trata como un carácter comodín y solo se imprimen
o eliminan las rutas de destino coincidentes. El asterisco coincide con cualquier cadena y el
signo de interrogación con cualquier carácter. Por ejemplo, 10.\*.1, 192.168.\* , 127.\* y
\*224\* son usos válidos del carácter comodín asterisco.

El uso de una combinación no admitida de un valor de destino y máscara de subred


(netmask) muestra el mensaje de error "Route: bad gateway address netmask". Este mensaje
de error aparece cuando el destino contiene uno o varios bits establecidos en 1 en
ubicaciones de bits en las que el bit de máscara de subred correspondiente está establecido
en 0. Para probar esta condición, exprese el destino y la máscara de subred mediante
notación binaria. La máscara de subred en notación binaria consta de una serie de bits 1,
que representa la parte de dirección de red del destino y una serie de bits 0, que representa
la parte de dirección del host del destino. Compruebe si hay bits en el destino que se
establecen en 1 para la parte del destino que es la dirección de host (tal y como se define en
la máscara de subred).

Ejemplos
Para mostrar todo el contenido de la tabla de enrutamiento de IP, escriba:

Símbolo del sistema de Windows

route print

Para mostrar las rutas en la tabla de enrutamiento de IP que comienza por 10, escriba:

Símbolo del sistema de Windows

route print 10.*

Para agregar una ruta predeterminada con la dirección de puerta de enlace predeterminada
192.168.12.1, escriba:

Símbolo del sistema de Windows

route add 0.0.0.0 mask 0.0.0.0 192.168.12.1

Para agregar una ruta al destino 10.41.0.0 con la máscara de subred 255.255.0.0 y la dirección del
próximo salto 10.27.0.1, escriba:

Símbolo del sistema de Windows

route add 10.41.0.0 mask 255.255.0.0 10.27.0.1


Para agregar una ruta persistente al destino 10.41.0.0 con la máscara de subred 255.255.0.0 y la
dirección del próximo salto 10.27.0.1, escriba:

Símbolo del sistema de Windows

route /p add 10.41.0.0 mask 255.255.0.0 10.27.0.1

Para agregar una ruta al destino 10.41.0.0 con la máscara de subred 255.255.0.0, la dirección del
próximo salto 10.27.0.1 y la métrica de coste 7, escriba:

Símbolo del sistema de Windows

route add 10.41.0.0 mask 255.255.0.0 10.27.0.1 metric 7

Para agregar una ruta al destino 10.41.0.0 con la máscara de subred 255.255.0.0, la dirección del
próximo salto 10.27.0.1 y el uso del índice de interfaz 0x3, escriba:

Símbolo del sistema de Windows

route add 10.41.0.0 mask 255.255.0.0 10.27.0.1 if 0x3

Para eliminar la ruta al destino 10.41.0.0 con la máscara de subred 255.255.0.0, escriba:

Símbolo del sistema de Windows

route delete 10.41.0.0 mask 255.255.0.0

Para eliminar todas las rutas de la tabla de enrutamiento de IP que comienzan por 10, escriba:

Símbolo del sistema de Windows

route delete 10.*

Para cambiar la dirección del próximo salto de la ruta con el destino 10.41.0.0 y la máscara de
subred 255.255.0.0 de 10.27.0.1 a 10.27.0.25, escriba:

Símbolo del sistema de Windows

route change 10.41.0.0 mask 255.255.0.0 10.27.0.25

Vínculos relacionados
Clave de sintaxis de línea de comandos
rpcinfo
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Enumera programas en equipos remotos. La utilidad de línea de comandos rpcinfo


realiza una llamada a procedimiento remoto (RPC) a un servidor RPC e informa de lo
que encuentra.

Sintaxis

rpcinfo [/p [<node>]] [/b <program version>] [/t <node program> [<version>]]
[/u <node program> [<version>]]

Parámetros

Parámetro Descripción

/p enumera todos los programas registrados con el asignador de puertos en el host


[<node>] especificado. Si no especifica un nombre de nodo (equipo), el programa consulta al
asignador de puertos en el host local.

/b Solicita una respuesta de todos los nodos de red que tienen el programa y la
<program versión especificados registrados con el asignador de puertos. Debe especificar un
version> nombre o un número de programa y un número de versión.

/t <node Usa el protocolo de transporte TCP para llamar al programa especificado. Debe
program> especificar un nombre de nodo (equipo) y un nombre de programa. Si no especifica
[\ una versión, el programa llama a todas las versiones.
<version>]

/u <node Usa el protocolo de transporte UDP para llamar al programa especificado. Debe
program> especificar un nombre de nodo (equipo) y un nombre de programa. Si no especifica
[\ una versión, el programa llama a todas las versiones.
<version>]

/? Muestra la ayuda en el símbolo del sistema.


Ejemplos
Para enumerar todos los programas registrados con el asignador de puertos, escriba:

rpcinfo /p [<node>]

Para solicitar una respuesta de los nodos de red que tienen un programa especificado,
escriba:

rpcinfo /b <program version>

Para usar el Protocolo de control de transmisión (TCP) para llamar a un programa,


escriba:

rpcinfo /t <node program> [<version>]

Usar el Protocolo de datagramas de usuario (UDP) para llamar a un programa:

rpcinfo /u <node program> [<version>]

Vínculos relacionados
Clave de sintaxis de línea de comandos
rpcping
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Confirma la conectividad RPC entre el equipo que ejecuta Microsoft Exchange Server y
cualquiera de las estaciones de trabajo cliente Microsoft Exchange compatibles en la
red. Esta utilidad se puede usar para comprobar si los servicios de Microsoft Exchange
Server responden a las solicitudes RPC de las estaciones de trabajo cliente a través de la
red.

Sintaxis

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 Descripción

/t <protseq> Especifica la secuencia de protocolo que se va a usar. Puede ser


una de las secuencias de protocolo RPC estándar: ncacn_ip_tcp,
ncacn_np o ncacn_http.
Si no se especifica, el valor predeterminado es ncacn_ip_tcp.

/s <server_addr> Especifica la dirección del servidor. Si no se especifica, se hará


ping a la máquina local.
Parámetro Descripción

/e <endpoint> Especifica el punto de conexión al que se va a hacer ping. Si no


se especifica ninguno, se hará ping al asignador de puntos de
conexión en la máquina de destino.
Esta opción es mutuamente excluyente con la opción de interfaz
(/f).

/o <binding_options> Especifica las opciones de enlace para el ping RPC.

/f <interface UUID> Especifica la interfaz para el ping. Esta opción es mutuamente


[,Majorver] excluyente con la opción de punto de conexión. La interfaz se
especifica como UUID.
Si no se especifica majorver, se buscará la versión 1 de la interfaz.

Cuando se especifica la interfaz, rpcping consultará al asignador


de puntos de conexión en la máquina de destino para recuperar
el punto de conexión de la interfaz especificada. El asignador de
puntos de conexión se consultará con las opciones especificadas
en la línea de comandos.

/O <object UUID> Especifica el UUID del objeto si la interfaz registró uno.

/i <#_iterations> Especifica el número de llamadas que se van a realizar. El valor


predeterminado es 1. Esta opción es útil para medir la latencia
de conexión si se especifican varias iteraciones.

/u <security_package_id> Especifica el RPC del paquete de seguridad (proveedor de


seguridad) que usará para realizar la llamada. El paquete de
seguridad se identifica como un número o un nombre. Si se usa
un número, es el mismo que en la API RpcBindingSetAuthInfoEx.
Si especifica esta opción, debe especificar un nivel de
autenticación distinto de ninguno. No hay ningún valor
predeterminado para esta opción. Si no se especifica, RPC no
usará la seguridad para el ping. En la lista siguiente se muestran
los nombres y números. Los nombres no distinguen mayúsculas
de minúsculas:

Negotiate / 9 o uno de nego, snego o negotiate


NTLM/ 10 o NTLM
SChannel/ 14 o SChannel
Kerberos/ 16 o Kerberos
Kernel/ 20 o Kernel
Parámetro Descripción

/a <authn_level> Especifica el nivel de autenticación que se va a usar. Si se


especifica esta opción, también se debe especificar el
identificador de paquete de seguridad (/u). Si no se especifica
esta opción, RPC no usará la seguridad para el ping. No hay
ningún valor predeterminado para esta opción. Los valores
posibles son:

conectar
llamada
pkt
integridad
privacy

/N <server_princ_name> Especifica un nombre principal del servidor.


Este campo solo se puede usar cuando se selecciona el nivel de
autenticación y el paquete de seguridad.

/I <auth_identity> Permite especificar una identidad alternativa para conectarse al


servidor. La identidad se expresa en forma de usuario, dominio,
contraseña. Si el nombre de usuario, el dominio o la contraseña
tienen caracteres especiales que el shell puede interpretar,
incluya la identidad entre comillas dobles. Puede especificar \*
en lugar de la contraseña y RPC le pedirá que escriba la
contraseña sin volver a reproducirla en la pantalla. Si no se
especifica este campo, se usará la identidad del usuario que ha
iniciado sesión.

Este campo solo se puede usar cuando se selecciona el nivel de


autenticación y el paquete de seguridad.

/C <capabilities> Especifica una máscara de bits hexadecimal de marcas. Este


campo solo se puede usar cuando se selecciona el nivel de
autenticación y el paquete de seguridad.

/T <identity_tracking> Especifica si es estática o dinámica. Si no se especifica, el valor


predeterminado es dinámica.
Este campo solo se puede usar cuando se selecciona el nivel de
autenticación y el paquete de seguridad.

/M <impersonation_type> Especifica si se es anónimo, identificar, suplantar o delegar. El


valor predeterminado es suplantar.
Este campo solo se puede usar cuando se selecciona el nivel de
autenticación y el paquete de seguridad.

/S <server_sid> Especifica el SID esperado del servidor.


Este campo solo se puede usar cuando se selecciona el nivel de
autenticación y el paquete de seguridad.
Parámetro Descripción

/P <proxy_auth_identity> Especifica la identidad con la que autenticarse en el proxy


RPC/HTTP. Tiene el mismo formato que para la opción /I. Debe
especificar el paquete de seguridad (/u), el nivel de autenticación
(/a) y los esquemas de autenticación (/H) para poder usar esta
opción.

/F <RPCHTTP_flags> Especifica las marcas que se van a pasar para la autenticación de


front end RPC/HTTP. Las marcas se pueden especificar como
números o nombres. Las marcas reconocidas actualmente son:
Usar SSL/ 1 o ssl o use_ssl
Usar primer esquema de autenticación / 2 o first o use_first

Debe especificar el paquete de seguridad (/u) y el nivel de


autenticación (/a) para usar esta opción.

/H <RPC/HTTP_authn_schemes> Especifica los esquemas de autenticación que se van a usar para


la autenticación de front end RPC/HTTP. Esta opción es una lista
de valores numéricos o nombres separados por coma. Ejemplo:
Basic,NTLM. Los valores reconocidos son (los nombres no
distinguen mayúsculas de minúsculas):
Basic / 1 o Basic
NTLM / 2 o NTLM
Certificate / 65536 o Cert

Debe especificar el paquete de seguridad (/u) y el nivel de


autenticación (/a) para poder usar esta opción.

/B Especifica el asunto del certificado de servidor. Debe usar SSL


<server_certificate_subject> para que esta opción funcione.
Debe especificar el paquete de seguridad (/u) y el nivel de
autenticación (/a) para poder usar esta opción.

/b Recupera el asunto del certificado de servidor del certificado


enviado por el servidor y lo imprime en una pantalla o un
archivo de registro. Válido solo cuando se especifica únicamente
la opción Proxy echo (/E) y las opciones de uso SSL.
Debe especificar el paquete de seguridad (/u) y el nivel de
autenticación (/a) para poder usar esta opción.

/R Especifica el proxy HTTP. Si se especifica none, se usa el proxy


RPC. El valor default implica que se va a usar la configuración de
IE en el equipo cliente. Cualquier otro valor se tratará como el
proxy HTTP explícito. Si no especifica esta marca, se asume el
valor predeterminado, es decir, se comprueba la configuración
de IE. Esta marca solo es válida cuando la marca /E (solo echo)
está habilitada.
Parámetro Descripción

/E Restringe el ping solo al proxy RPC/HTTP. El ping no llega al


servidor. Resulta útil al intentar establecer si se puede acceder al
proxy RPC/HTTP. Para especificar un proxy HTTP, use la marca
/R. Si se especifica un proxy HTTP en la marca /o, se omitirá esta
opción.
Debe especificar el paquete de seguridad (/u) y el nivel de
autenticación (/a) para poder usar esta opción.

/q Especifica el modo silencioso. No emite ninguna solicitud


excepto las contraseñas. Da por hecho que la respuesta es Y a
todas las consultas. Use esta opción con cuidado.

/C Use el certificado de tarjeta inteligente. rpcping pedirá al usuario


que elija la tarjeta inteligente.

/A Especifica la identidad con la que se autenticará en el proxy


HTTP. Tiene el mismo formato que para la opción /I.
Debe especificar esquemas de autenticación (/U), paquete de
seguridad (/u) y nivel de autenticación (/a) para poder usar esta
opción.

/U Especifica los esquemas de autenticación que se van a usar para


la autenticación de proxy HTTP. Esta opción es una lista de
valores numéricos o nombres separados por coma. Ejemplo:
Basic,NTLM. Los valores reconocidos son (los nombres no
distinguen mayúsculas de minúsculas):
Basic / 1 o Basic
NTLM / 2 o NTLM

Debe especificar el paquete de seguridad (/u) y el nivel de


autenticación (/a) para poder usar esta opción.

/r Si se especifican varias iteraciones, esta opción hará que rpcping


muestre las estadísticas de ejecución actuales periódicamente
después de la última llamada. El intervalo del informe se da en
segundos. El valor predeterminado es 15.

/v Indica a rpcping cómo se debe realizar el resultado detallado. El


valor predeterminado es 1. 2 y 3 proporcionan más rendimiento
del rpcping.

/d Inicia la interfaz de usuario de diagnóstico de red RPC.

/p Especifica cómo solicitar credenciales si se produce un error en la


autenticación.

/? Muestra la ayuda en el símbolo del sistema.


Ejemplos
Para averiguar si el servidor Exchange al que se conecta a través de RPC/HTTP es
accesible, escriba:

rpcping /t ncacn_http /s exchange_server /o RpcProxy=front_end_proxy /P


username,domain,* /H Basic /u NTLM /a connect /F 3

Vínculos relacionados
Clave de sintaxis de línea de comandos
rsh
Artículo • 14/04/2023

Ejecuta comandos en equipos remotos que ejecutan el servicio o demonio de RSH.

) Importante

El comando rexec está en desuso y no se garantiza que se admita en Windows.

Después de instalar el subsistema para aplicaciones basadas en UNIX, puede abrir una
ventana de comandos de Shell de C o Korn Shell y ejecutar rsh. Para obtener más
información, escriba man rsh en el símbolo C Shell o Korn Shell.
rundll32
Artículo • 14/04/2023

Carga y ejecuta bibliotecas de vínculos dinámicos (DLL) de 32 bits. No hay ninguna


configuración configurable para Rundll32. La información de ayuda se proporciona para
un archivo DLL específico que se ejecuta con el comando rundll32.

Debe ejecutar el comando rundll32 desde un símbolo del sistema con privilegios
elevados. Para abrir una ventana de símbolo del sistema con privilegios elevados, haga
clic en Inicio, haga clic con el botón secundario en Símbolo del sistema y, a
continuación, haga clic en Ejecutar como administrador.

Sintaxis

rundll32 <DLLname>

Parámetros

Parámetro Descripción

Rundll32 printui.dll,PrintUIEntry Muestra la interfaz de usuario de la impresora.

Comentarios
Rundll32 solo puede llamar a funciones desde un archivo DLL escrito explícitamente
para ser llamado por Rundll32.

Vínculos relacionados
Clave de sintaxis de línea de comandos
rundll32 printui.dll,PrintUIEntry
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Automatiza muchas tareas de configuración de impresora. printui.dll es el archivo


ejecutable que contiene las funciones que usan los cuadros de diálogo de configuración
de la impresora. También se puede llamar a estas funciones desde un script o un archivo
por lotes de línea de comandos, o bien se pueden ejecutar de forma interactiva desde el
símbolo del sistema.

Sintaxis

rundll32 printui.dll PrintUIEntry [baseparameter] [modificationparameter1]


[modificationparameter2] [modificationparameterN]

También puede usar las siguientes sintaxis alternativas, aunque los ejemplos de este
tema usan la sintaxis 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
Hay dos tipos de parámetros: parámetros base y parámetros de modificación. Los
parámetros base especifican la función que el comando va a realizar. Solo uno de estos
parámetros puede aparecer en una línea de comandos determinada. A continuación,
puede modificar el parámetro base mediante uno o varios de los parámetros de
modificación si son aplicables al parámetro base (no todos los parámetros de
modificación son compatibles con todos los parámetros base).

Parámetros Descripción
base

/dl Elimina la impresora local.

/dn Elimina una conexión de impresora de red.

/dd Elimina un controlador de impresora.

/e Muestra las preferencias de impresión de una impresora determinada.

/ga agrega una conexión de impresora por equipo (la conexión está disponible para
cualquier usuario de ese equipo cuando inicia sesión).

/ge Muestra las conexiones de impresora por equipo en un equipo.

/gd Elimina una conexión de impresora por equipo (la conexión se elimina la próxima
vez que un usuario inicie sesión).

/ia Instala un controlador de impresora mediante un archivo .inf.

/id Instala un controlador de impresora mediante el Asistente para agregar


controladores de impresora.

/if Instala una impresora mediante un archivo .inf.

/ii Instala una impresora mediante el Asistente para agregar impresoras con un
archivo .inf.

/il Instala una impresora mediante el Asistente para agregar impresoras.

/in Se conecta a una impresora de red remota.

/ip Instala una impresora mediante el Asistente para la instalación de impresoras de


red (disponible en la interfaz de usuario de la administración de impresión).

/k imprime una página de prueba en una impresora.

/o Muestra la cola de una impresora.

/p Muestra las propiedades de una impresora. Cuando use este parámetro, deberá
especificar también un valor para el parámetro de modificación /n[name].
Parámetros Descripción
base

/s Muestra las propiedades de un servidor de impresión. Si quiere ver el servidor de


impresión local, no necesita usar un parámetro de modificación. Sin embargo, si
quiere ver un servidor de impresión remoto, debe especificar el parámetro de
modificación /c[name].

/Ss Especifica qué tipo de información se almacenará para una impresora. Si no se


especifica ninguno de los valores de /Ss, el comportamiento predeterminado es
como si se especificaran todos ellos. Use este parámetro base con los siguientes
valores colocados al final de la línea de comandos:

2: almacena la información contenida en la estructura printER_INFO_2 de la


impresora. Esta estructura contiene la información básica sobre la impresora,
como su nombre, el nombre del servidor, el nombre del puerto y el nombre
del recurso compartido.
7: se usa para almacenar la información del servicio de directorio incluida en
la estructura de printER_INFO_7.
c: almacena la información del perfil de color para una impresora.
d: almacena datos específicos de la impresora, como el identificador de
hardware de la impresora.
s: almacena el descriptor de seguridad de la impresora.
g: almacena la información en la estructura global de DEVmode de la
impresora.
m: almacena la configuración mínima para la impresora. Esto equivale a
especificar 2d y g.
u: almacena la información en la estructura DEVmode de la impresora por
usuario.
Parámetros Descripción
base

/Sr Especifica qué información sobre una impresora se restaura y cómo se controlan
los conflictos en la configuración. Se usa con los siguientes valores colocados al
final de la línea de comandos:
2: restaura la información contenida en la estructura printER_INFO_2 de la
impresora. Esta estructura contiene la información básica sobre la impresora,
como su nombre, el nombre del servidor, el nombre del puerto y el nombre
del recurso compartido.
7: restaura la información del servicio de directorio incluida en la estructura
de printER_INFO_7.
c: restaura la información del perfil de color para una impresora.
d: restaura datos específicos de la impresora, como el identificador de
hardware de la impresora.
s: restaura el descriptor de seguridad de la impresora.
g: restaura la información en la estructura global de DEVmode de la
impresora.
m: restaura la configuración mínima de la impresora. Esto equivale a
especificar 2, d y g.
u: restaura la información en la estructura DEVmode de la impresora por
usuario.
r: si el nombre de la impresora almacenado en el archivo es diferente del
nombre de la impresora que se va a restaurar, use el nombre de la impresora
actual. No se puede especificar con f. Si no se especifica r ni f y los nombres
no coinciden, la restauración de la configuración falla.
f: si el nombre de la impresora almacenado en el archivo es diferente del
nombre de la impresora en la que se va a restaurar, use el nombre de la
impresora en el archivo. No se puede especificar con r. Si no se especifica r ni
f y los nombres no coinciden, la restauración de la configuración falla.
p: si el nombre del puerto del archivo que se va a restaurar no coincide con
el nombre de puerto actual de la impresora a la que se va a restaurar, se usa
el nombre de puerto actual de la impresora.
h: si la impresora a la que se está restaurando no se puede compartir usando
el nombre de recurso compartido del archivo de configuración guardado, se
intentará compartir la impresora con el nombre de recurso compartido
actual o con un nuevo nombre de recurso compartido generado. Si no se
especifica H ni h y la impresora a la que se está restaurando no se puede
compartir con el nombre de recurso compartido guardado, la restauración
fallará.
h: si la impresora que se está restaurando no se puede compartir con el
nombre compartido guardado, no comparta la impresora. Si no se especifica
H ni h y la impresora a la que se está restaurando no puede compartirse con
el nombre de recurso compartido guardado, la restauración fallará.
i: si el controlador del archivo de configuración guardado no coincide con el
controlador de la impresora que se está restaurando, la restauración falla.

/Xg Recupera la configuración de una impresora.


Parámetros Descripción
base

/Xs Establece la configuración de una impresora.

/y Establece la impresora que se va a instalar como impresora predeterminada.

/? Muestra la ayuda en el producto para el comando y sus parámetros asociados.

@[file] Especifica un archivo de argumentos de línea de comandos e inserta directamente


el texto de ese archivo en la línea de comandos.

Parámetros Descripción
de
modificación

/a[file] Especifica el nombre de archivo binario.

/b[name] Especifica el nombre de la impresora base.

/c[name] Especifica el nombre del equipo si la acción que se va a realizar está en un


equipo remoto.

/f[file] Especifica la ruta de acceso de la Convención de nomenclatura universal (UNC)


y el nombre del archivo .inf o el nombre del archivo de salida, en función de la
tarea que esté realizando. Use /F[file] para especificar un archivo .inf
dependiente.

/F[file] Especifica la ruta de acceso UNC y el nombre de un archivo .inf del que
depende el archivo .inf especificado con /f[file].

/h[architecture] Especifica la arquitectura del controlador. Use una de las siguientes opciones:
x86, x64 o Itanium.

/j[provider] Especifica el nombre del proveedor de impresión.

/l[path] Especifica la ruta de acceso UNC donde se encuentran los archivos de


controlador de impresora que está usando.

/m[model] Especifica el nombre del modelo de controlador. (Este valor se puede


especificar en el archivo .inf).

/n[name] Especifica el nombre de la impresora.

/q Ejecuta el comando sin notificaciones al usuario.

/r[port] Especifica el nombre del puerto.

/U Especifica el uso del controlador de impresora existente si ya está instalado.

/t[#] Especifica la página de índice de base cero en la que se iniciará.


Parámetros Descripción
de
modificación

/v[version] Especifica la versión del controlador. Si no especifica también un valor para /K,
deberá especificar uno de los siguientes valores: type 2 - Kernel mode o type 3
- User mode.

/w solicita al usuario un controlador si el controlador no se encuentra en el archivo


.inf especificado por /f.

/Y Especifica que los nombres de impresora no se deben generar


automáticamente.

/z Especifica que no comparta automáticamente la impresora que se está


instalando.

/K cambia el significado del parámetro /h[architecture] para aceptar 2 en lugar de


x86, 3 en lugar de x64 o 4 en lugar de Itanium. También cambia el valor del
parámetro /v[version] para aceptar 2 en el lugar de type 2 - Kernel mode y 3
en lugar de type 3 - User mode.

/Z Comparte la impresora que se está instalando. Usar solo con el parámetro /if.

/Mw[message] Muestra un mensaje de advertencia al usuario antes de confirmar los cambios


especificados en la línea de comandos.

/Mq[message] Muestra un mensaje de confirmación al usuario antes de confirmar los cambios


especificados en la línea de comandos.

/W[flags] Especifica cualquier parámetro u opción para el Asistente para agregar


impresoras, el Asistente para agregar controladores de impresora y el Asistente
para la instalación de impresoras de red.
r: permite que los asistentes se reinicien desde la última página.

/G[flags] Especifica los parámetros y opciones globales que quiere usar.


w: suprime las advertencias del controlador de configuración al usuario.

Comentarios
La palabra clave PrintUIEntry distingue entre mayúsculas y minúsculas y debe
escribir la sintaxis de este comando con las mayúsculas exactas que se muestran
en los ejemplos de este tema.

Para más ejemplos, en un símbolo del sistema, escriba: rundll32


printui.dll,PrintUIEntry /?

Ejemplos
Para agregar una nueva impresora remota, printer1, para un equipo, Client1, que sea
visible para la cuenta de usuario en la que se ejecuta este comando, escriba:

rundll32 printui.dll PrintUIEntry /in /n\\client1\printer1

Para agregar una impresora usando el Asistente para agregar impresoras y usando un
archivo .inf, InfFile.inf, ubicado en la unidad c: en Infpath, escriba:

rundll32 printui.dll PrintUIEntry /ii /f c:\Infpath\InfFile.inf

Para eliminar una impresora existente, printer1, en un equipo, Client1, escriba:

rundll32 printui.dll PrintUIEntry /dn /n\\client1\printer1

Para agregar una conexión de impresora por equipo, printer2, para todos los usuarios
de un equipo, Client2, escriba (la conexión se aplicará cuando un usuario inicie sesión):

rundll32 printui.dll PrintUIEntry /ga /n\\client2\printer2

Para eliminar una conexión de impresora por equipo, printer2, para todos los usuarios
de un equipo, Client2, escriba (la conexión se eliminará cuando un usuario inicie sesión):

rundll32 printui.dll PrintUIEntry /gd /n\\client2\printer2

Para ver las propiedades del servidor de impresión, printServer1, escriba:

rundll32 printui.dll PrintUIEntry /s /t1 /c\\printserver1

Para ver las propiedades de una impresora, printer3, escriba:


rundll32 printui.dll PrintUIEntry /p /n\\printer3

Vínculos relacionados
rundll32

Referencia del comando print


rwinsta
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Restablece (elimina) una sesión en un servidor host de sesión de Escritorio remoto.

7 Nota

Este comando es el mismo que el comando reset session.

7 Nota

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de Escritorio remoto en Windows Server.

Vínculos relacionados
reset session

Clave de sintaxis de línea de comandos

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


san
Artículo • 05/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra o establece la directiva de red de área de almacenamiento (san) para el sistema


operativo. Si se usa sin parámetros, se muestra la directiva san actual.

Sintaxis

san [policy={onlineAll | offlineAll | offlineShared}] [noerr]

Parámetros

Parámetro Descripción

policy= Establece la directiva san para el sistema operativo


{onlineAll|offlineAll|offlineShared}] actualmente arrancado. La directiva san determina si un
disco recién detectado se pone en línea o permanece sin
conexión, y si se convierte en lectura y escritura o permanece
en solo lectura. Cuando un disco está sin conexión, se puede
leer la distribución del disco, pero no se muestra ningún
dispositivo de volumen a través de Plug and Play. Cuando
está sin conexión significa que no se puede montar ningún
sistema de archivos en el disco. Cuando un disco está en
línea, se instalan uno o varios dispositivos de volumen para
el disco. Se puede establecer el parámetro siguiente:
onlineAll. Especifica que todos los discos recién
detectados están en línea y pasan a ser de lectura y
escritura. IMPORTANTE: Especificar onlineAll en un
servidor que comparte discos podría provocar daños
en los datos. Por lo tanto, no debe establecer esta
directiva si los discos se comparten entre servidores, a
menos que el servidor forme parte de un clúster.
offlineAll. Especifica que todos los discos recién
detectados excepto el disco de inicio están sin
conexión y serán de solo lectura de forma
predeterminada.
offlineShared. Especifica que todos los discos recién
detectados que no residen en un bus compartido
Parámetro Descripción

(como SCSI e iSCSI) se conectan y pasan a ser de


lectura y escritura. Los discos que se dejan sin
conexión son de solo lectura de forma
predeterminada.

Para obtener más información, consulte Enumeración


VDS_san_POLICY.

noerr Se usa solo para scripting. Cuando se detecta un error,


DiskPart sigue procesando los comandos como si no hubiera
ningún error. Sin este parámetro, un error hace que DiskPart
salga con un código de error.

Ejemplos
Para ver la directiva actual, escriba:

san

Para convertir todos los discos recién detectados, excepto el disco de inicio, estén en sin
conexión y sean de solo lectura de forma predeterminada, escriba:

san policy=offlineAll

Vínculos relacionados
Clave de sintaxis de línea de comandos
sc.exe config
Artículo • 14/04/2023

Modifica el valor de las entradas de un servicio en el registro y en la base de datos del


Administrador de control de servicios.

Sintaxis

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 Descripción

<servername> Especifica el nombre del servidor remoto en el que se encuentra el servicio.


El nombre debe usar el formato de convención de nomenclatura universal
(UNC) (por ejemplo, \myserver). Para ejecutar SC.exe localmente, no use este
parámetro.

<servicename> Especifica el nombre del servicio devuelto por la operación getkeyname.


Parámetro Descripción

type= {own | Especifica el tipo de servicio. Entre estas opciones se incluyen:


share | kernel | own: especifica un servicio que se ejecuta en su propio proceso. No
filesys | rec | comparte un archivo ejecutable con otros servicios. Este es el valor
adapt | interact predeterminado.
type= {own | share: especifica un servicio que se ejecuta como un proceso
share}} compartido. Comparte un archivo ejecutable con otros servicios.
kernel: especifica un controlador.
filesys: especifica un controlador del sistema de archivos.
rec: especifica un controlador reconocido por el sistema de archivos
que identifica los sistemas de archivos usados en el equipo.
adapt: especifica un controlador de adaptador que identifica
dispositivos de hardware como teclados, ratones y unidades de disco.
interact: especifica un servicio que puede interactuar con el escritorio
y recibir entradas de los usuarios. Los servicios interactivos deben
ejecutarse en la cuenta LocalSystem. Este tipo se debe usar junto con
type= own o type= shared (por ejemplo, type= interacttype= own).
El uso de type= interact por sí mismo generará un error.

start= {boot | Especifica el tipo de inicio para el servicio. Entre estas opciones se incluyen:
system | auto | boot: especifica un controlador de dispositivo cargado por el cargador
demand | disabled de arranque.
| delayed-auto} system: especifica un controlador de dispositivo que se inicia durante
la inicialización del kernel.
auto: especifica un servicio que se inicia automáticamente cada vez
que se reinicia el equipo y se ejecuta incluso si nadie inicia sesión en el
equipo.
demand: especifica un servicio que se debe iniciar manualmente. Este
es el valor predeterminado si no se especifica start=.
disabled: especifica un servicio que no se puede iniciar. Para iniciar un
servicio deshabilitado, cambie el tipo de inicio a otro valor.
delayed-auto: especifica un servicio que se inicia automáticamente
poco después de iniciar otros servicios automáticos.
Parámetro Descripción

error= {normal | Especifica la gravedad del error si el servicio no se inicia cuando se inicia el
severe | critical equipo. Entre estas opciones se incluyen:
| ignore} normal: especifica que se registra el error y se muestra un cuadro de
mensaje, informando al usuario de que un servicio no se ha podido
iniciar. El inicio continuará. Esta es la configuración predeterminada.
severe: especifica que se registra el error (si es posible). El equipo
intenta reiniciarse con la última configuración correcta conocida. Esto
podría dar lugar a que el equipo pueda reiniciarse, pero es posible que
el servicio todavía no se pueda ejecutar.
critical: especifica que se registra el error (si es posible). El equipo
intenta reiniciarse con la última configuración correcta conocida. Si se
produce un error en la última configuración correcta conocida,
también se produce un error de arranque y el proceso se detendrá con
un error Stop.
ignore: especifica que el error se registra y continúa el inicio. No se
notifica al usuario más allá de registrar el error en el registro de
sucesos.

binpath= Especifica una ruta de acceso al archivo binario del servicio. No hay ningún
<binarypathname> valor predeterminado para binpath=, y se debe proporcionar esta cadena.

Además, ntsd -d se puede especificar delante de la cadena para la


depuración. Para obtener más información, consulte Depuración mediante
CDB y NTSD.

group= Especifica el nombre del grupo del al que pertenece este servicio. La lista de
<loadordergroup> grupos se almacena en el registro, en la subclave
HKLM\System\CurrentControlSet\Control\ServiceGroupOrder. El valor
predeterminado es null.

tag= {yes | no} Especifica si se va a obtener o no un TagID de la llamada CreateService. Las


etiquetas solo se usan para los controladores de arranque y de inicio del
sistema.

depend= Especifica los nombres de los servicios o grupos que deben iniciarse antes
<dependencies> de este servicio. Los nombres están separados por barras diagonales (/).

obj= Especifica un nombre de una cuenta en la que se ejecutará un servicio o


{<accountname> | especifica un nombre del objeto de controlador de Windows en el que se
<objectname>} ejecutará el controlador. La opción predeterminada es LocalSystem.

displayname= Especifica un nombre descriptivo para identificar el servicio en programas de


<displayname> interfaz de usuario. Por ejemplo, el nombre de subclave de un servicio
determinado es wuauserv, que tiene un nombre para mostrar más
descriptivo de Actualizaciones automáticas.
Parámetro Descripción

password= Especifica una contraseña. Esto es necesario si se usa una cuenta distinta de
<password> la cuenta LocalSystem.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Cada opción de línea de comandos (parámetro) debe incluir el signo igual como
parte del nombre de la opción.

Se requiere un espacio entre una opción y su valor (por ejemplo, type= own). Si se
omite el espacio, se produce un error en la operación.

Ejemplos
Para especificar una ruta de acceso binaria para el servicio NewService, escriba:

sc.exe config NewService binpath= c:\windows\system32\NewServ.exe

Vínculos relacionados
Clave de sintaxis de línea de comandos
sc.exe create
Artículo • 29/09/2023

Crea una subclave y entradas para un servicio en el Registro y en la base de datos del
Administrador de control de servicios.

Sintaxis

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 Descripción

<servername> Especifica el nombre del servidor remoto en el que se encuentra el servicio.


El nombre debe usar el formato de convención de nomenclatura universal
(UNC) (por ejemplo, \myserver). Para ejecutar SC.exe localmente, no use
este parámetro.

<servicename> Especifica el nombre del servicio devuelto por la operación getkeyname.

type= {own | share Especifica el tipo de servicio. Entre estas opciones se incluyen:
| kernel | filesys own: especifica un servicio que se ejecuta en su propio proceso. No
| rec | interact comparte un archivo ejecutable con otros servicios. Este es el valor
type= {own | predeterminado.
share}} share: especifica un servicio que se ejecuta como un proceso
compartido. Comparte un archivo ejecutable con otros servicios.
kernel: especifica un controlador.
filesys: especifica un controlador del sistema de archivos.
rec: especifica un controlador reconocido por el sistema de archivos
que identifica los sistemas de archivos usados en el equipo.
interact: especifica un servicio que puede interactuar con el escritorio
y recibir entradas de los usuarios. Los servicios interactivos deben
ejecutarse en la cuenta LocalSystem. Este tipo se debe usar junto con
type= own o type= shared (por ejemplo, type= interacttype= own).
El uso de type= interact por sí mismo generará un error.
Parámetro Descripción

start= {boot | Especifica el tipo de inicio para el servicio. Entre estas opciones se incluyen:
system | auto | boot: especifica un controlador de dispositivo cargado por el
demand | disabled cargador de arranque.
| delayed-auto} system: especifica un controlador de dispositivo que se inicia durante
la inicialización del kernel.
auto: especifica un servicio que se inicia automáticamente cada vez
que se reinicia el equipo y se ejecuta incluso si nadie inicia sesión en
el equipo.
demand: especifica un servicio que se debe iniciar manualmente.
Este es el valor predeterminado si no se especifica start=.
disabled: especifica un servicio que no se puede iniciar. Para iniciar
un servicio deshabilitado, cambie el tipo de inicio a otro valor.
delayed-auto: especifica un servicio que se inicia automáticamente
poco después de iniciar otros servicios automáticos.

error= {normal | Especifica la gravedad del error si el servicio no se inicia cuando se inicia el
severe | critical equipo. Entre estas opciones se incluyen:
| ignore} normal: especifica que se registra el error y se muestra un cuadro de
mensaje, informando al usuario de que un servicio no se ha podido
iniciar. El inicio continuará. Esta es la configuración predeterminada.
severe: especifica que se registra el error (si es posible). El equipo
intenta reiniciarse con la última configuración correcta conocida. Esto
podría dar lugar a que el equipo pueda reiniciarse, pero es posible
que el servicio todavía no se pueda ejecutar.
critical: especifica que se registra el error (si es posible). El equipo
intenta reiniciarse con la última configuración correcta conocida. Si
se produce un error en la última configuración correcta conocida,
también se produce un error de arranque y el proceso se detendrá
con un error Stop.
ignore: especifica que el error se registra y continúa el inicio. No se
notifica al usuario más allá de registrar el error en el registro de
sucesos.

binpath= Especifica una ruta de acceso al archivo binario del servicio. No hay ningún
<binarypathname> valor predeterminado para binpath=, y se debe proporcionar esta cadena.

group= Especifica el nombre del grupo del al que pertenece este servicio. La lista
<loadordergroup> de grupos se almacena en el registro, en la subclave
HKLM\System\CurrentControlSet\Control\ServiceGroupOrder. El valor
predeterminado es null.

tag= {yes | no} Especifica si se va a obtener o no un TagID de la llamada CreateService. Las


etiquetas solo se usan para los controladores de arranque y de inicio del
sistema.
Parámetro Descripción

depend= Especifica los nombres de los servicios o grupos que deben iniciarse antes
<dependencies> de este servicio. Los nombres están separados por barras diagonales (/).

obj= Especifica un nombre de una cuenta en la que se ejecutará un servicio o


{<accountname> | especifica un nombre del objeto de controlador de Windows en el que se
<objectname>} ejecutará el controlador. La opción predeterminada es LocalSystem.

displayname= Especifica un nombre descriptivo para identificar el servicio en programas


<displayname> de interfaz de usuario. Por ejemplo, el nombre de subclave de un servicio
determinado es wuauserv, que tiene un nombre para mostrar más
descriptivo de Actualizaciones automáticas.

password= Especifica una contraseña. Esto es necesario si se usa una cuenta distinta de
<password> la cuenta LocalSystem.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Cada opción de línea de comandos (parámetro) debe incluir el signo igual como
parte del nombre de la opción.

Se requiere un espacio entre una opción y su valor (por ejemplo, type= own). Si se
omite el espacio, se produce un error en la operación.

Ejemplos
Para crear y registrar una nueva ruta de acceso binaria para el servicio NewService,
escriba:

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 más información sobre el comando sc.exe , consulte Comandos SC.


Vínculos relacionados
Clave de sintaxis de línea de comandos
sc.exe delete
Artículo • 14/04/2023

Elimina una subclave de servicio del registro. Si el servicio se está ejecutando o si otro
proceso tiene un identificador abierto para el servicio, el servicio se marca para su
eliminación.

7 Nota

No se recomienda usar este comando para eliminar servicios de sistema operativo


integrados, como DHCP, DNS o Internet Information Services. Para instalar, quitar o
volver a configurar roles de sistema operativo, servicios y componentes, consulte
Instalar o desinstalar roles, servicios de rol o características

Sintaxis

sc.exe [<servername>] delete [<servicename>]

Parámetros

Parámetro Descripción

<servername> Especifica el nombre del servidor remoto en el que se encuentra el servicio. El


nombre debe usar el formato de convención de nomenclatura universal (UNC)
(por ejemplo, \myserver). Para ejecutar SC.exe localmente, no use este
parámetro.

<servicename> Especifica el nombre del servicio devuelto por la operación getkeyname.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para eliminar la subclave de servicio NewServ del registro en el equipo local, escriba:

sc.exe delete NewServ


Vínculos relacionados
Clave de sintaxis de línea de comandos
Consulta de Sc.exe
Artículo • 14/04/2023

Obtiene y muestra información sobre el servicio, el controlador, el tipo de servicio o el


tipo de controlador especificados.

Sintaxis

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 Descripción

<servername> Especifica el nombre del servidor remoto en el que se encuentra el servicio. El


nombre debe usar el formato de convención de nomenclatura universal (UNC)
(por ejemplo, \myserver). Para ejecutar SC.exe localmente, no use este
parámetro.

<servicename> Especifica el nombre del servicio devuelto por la operación getkeyname. Este
parámetro query no se usa junto con otros parámetros query (excepto
servername).

type= {driver Especifica qué enumerar. Entre estas opciones se incluyen:


| service | driver: especifica que solo se enumeran los controladores.
all} service: especifica que solo se enumeran los servicios. Este es el valor
predeterminado.
all: especifica que se enumeran los controladores y los servicios.
Parámetro Descripción

type= {own | Especifica el tipo de servicios o el tipo de controladores que se van a enumerar.
share | Entre estas opciones se incluyen:
interact | own: especifica un servicio que se ejecuta en su propio proceso. No
kernel | comparte un archivo ejecutable con otros servicios. Este es el valor
filesys | rec predeterminado.
| adapt} share: especifica un servicio que se ejecuta como un proceso compartido.
Comparte un archivo ejecutable con otros servicios.
kernel: especifica un controlador.
filesys: especifica un controlador del sistema de archivos.
rec: especifica un controlador reconocido por el sistema de archivos que
identifica los sistemas de archivos usados en el equipo.
interact: especifica un servicio que puede interactuar con el escritorio y
recibir entradas de los usuarios. Los servicios interactivos deben ejecutarse
en la cuenta LocalSystem. Este tipo se debe usar junto con type= own o
type= shared (por ejemplo, type= interacttype= own). El uso de type=
interact por sí mismo generará un error.

state= Especifica el estado iniciado del servicio que se va a enumerar. Entre estas
{active | opciones se incluyen:
inactive | active: especifica todos los servicios activos. Este es el valor
all} predeterminado.
inactive: especifica todos los servicios en pausa o detenidos.
all: especifica todos los servicios.

bufsize= Especifica el tamaño (en bytes) del búfer de enumeración. El tamaño de búfer
<Buffersize> predeterminado es 1,024 bytes. Debe aumentar el tamaño del búfer cuando la
presentación resultante de una consulta supere los 1024 bytes.

ri= Especifica el número de índice en el que se va a iniciar o reanudar la


<Resumeindex> enumeración. El valor predeterminado es 0 (cero). Si se devuelve más
información que lo que puede mostrar el búfer predeterminado, use este
parámetro con el parámetro bufsize= .

group= Especifica el grupo de servicios que se va a enumerar. De forma predeterminada,


<Groupname> se enumeran todos los grupos. De forma predeterminada, se enumeran todos
los grupos (**group= **).

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Cada opción de línea de comandos (parámetro) debe incluir el signo igual como
parte del nombre de la opción.
Se requiere un espacio entre una opción y su valor (por ejemplo, type= own). Si se
omite el espacio, se produce un error en la operación.

La operación query muestra la siguiente información sobre un servicio:


SERVICE_NAME (nombre de subclave del registro del servicio), TYPE, STATE (así
como los estados que no están disponibles), WIN32_EXIT_B, SERVICE_EXIT_B,
CHECKPOINT y WAIT_HINT.

El parámetro type= se puede usar dos veces en algunos casos. La primera


apariencia del parámetro type= especifica si se deben consultar servicios,
controladores o ambos (todos). La segunda apariencia del parámetro type=
especifica un tipo de la operación create para restringir aún más el ámbito de una
consulta.

Cuando los resultados de la presentación de un comando query superan el


tamaño del búfer de enumeración, se muestra un mensaje similar al siguiente:

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

Ejemplos
Para mostrar información solo para los servicios activos, escriba cualquiera de los
siguientes comandos:

sc.exe query
sc.exe query type= service

Para mostrar información de los servicios activos y especificar un tamaño de búfer de


2000 bytes, escriba:

sc.exe query type= all bufsize= 2000


Para mostrar información para el servicio wuauserv, escriba:

sc.exe query wuauserv

Para mostrar información de todos los servicios (activos e inactivos), escriba:

sc.exe query state= all

Para mostrar información de todos los servicios (activos e inactivos), a partir de la línea
56, escriba:

sc.exe query state= all ri= 56

Para mostrar información de los servicios interactivos, escriba:

sc.exe query type= service type= interact

Para mostrar información solo para controladores, escriba:

sc.exe query type= driver

Para mostrar información de los controladores en el grupo Especificación de interfaz de


controlador de red (NDIS), escriba:

sc.exe query type= driver group= NDIS

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comandos schtasks
Artículo • 14/04/2023

Programa comandos y programas para que se ejecuten periódicamente o en un


momento específico, agrega y quita tareas de la programación, inicia y detiene las
tareas a petición y muestra y cambia las tareas programadas.

7 Nota

La herramienta schtasks.exe realiza las mismas operaciones que las tareas


programadas en el panel de control. Puede usar estas herramientas conjunta e
indistintamente.

Permisos necesarios
Para programar, ver y cambiar todas las tareas del equipo local, debe ser miembro
del grupo Administradores.

Para programar, ver y cambiar todas las tareas del equipo remoto, debe ser
miembro del grupo Administradores en el equipo remoto, o bien debe usar el
parámetro /u para proporcionar las credenciales de un administrador del equipo
remoto.

Puede usar el parámetro /u en una operación /create o /change si los equipos


local y remoto están en el mismo dominio, o si el equipo local está en un dominio
en el que confía el dominio del equipo remoto. De lo contrario, el equipo remoto
no puede autenticar la cuenta de usuario especificada y no puede comprobar que
la cuenta sea miembro del grupo Administradores.

La tarea que tiene previsto ejecutar debe tener el permiso adecuado; estos
permisos varían según la tarea. De forma predeterminada, las tareas se ejecutan
con los permisos del usuario actual del equipo local o con los permisos del usuario
especificado por el parámetro /u, si se incluye uno. Para ejecutar una tarea con
permisos de una cuenta de usuario diferente o con permisos del sistema, use el
parámetro /ru.

Sintaxis
schtasks /change
schtasks /create
schtasks /delete
schtasks /end
schtasks /query
schtasks /run

Parámetros

Parámetro Descripción

schtasks Cambia una o varias de las siguientes propiedades de una tarea:


change Programa que la tarea ejecuta (/tr)
Cuenta de usuario con la que se ejecuta la tarea (/ru)
Contraseña de la cuenta de usuario (/rp)
Agrega la propiedad interactive-only a la tarea (/it)

schtasks Programa una nueva tarea.


create

schtasks Elimina una tarea programada.


delete

schtasks Detiene un programa iniciado por una tarea.


end

schtasks Muestra las tareas programadas para ejecutarse en el equipo.


query

schtasks Inicia inmediatamente una tarea programada. La operación run omite la


run programación, pero usa la ubicación del archivo de programa, la cuenta de usuario
y la contraseña guardadas en la tarea para ejecutar la tarea inmediatamente.

Vínculos relacionados
Clave de sintaxis de línea de comandos
schtasks change
Artículo • 17/04/2023

Cambia una o varias de las siguientes propiedades de una tarea:

Programa que la tarea ejecuta (/tr)

Cuenta de usuario con la que se ejecuta la tarea (/ru)

Contraseña de la cuenta de usuario (/rp)

Agrega la propiedad interactive-only a la tarea (/it)

Permisos necesarios
Para programar, ver y cambiar todas las tareas del equipo local, debe ser miembro
del grupo Administradores.

Para programar, ver y cambiar todas las tareas del equipo remoto, debe ser
miembro del grupo Administradores en el equipo remoto, o bien debe usar el
parámetro /u para proporcionar las credenciales de un administrador del equipo
remoto.

Puede usar el parámetro /u en una operación /create o /change si los equipos


local y remoto están en el mismo dominio, o si el equipo local está en un dominio
en el que confía el dominio del equipo remoto. De lo contrario, el equipo remoto
no puede autenticar la cuenta de usuario especificada y no puede comprobar que
la cuenta sea miembro del grupo Administradores.

La tarea que tiene previsto ejecutar debe tener el permiso adecuado; estos
permisos varían según la tarea. De forma predeterminada, las tareas se ejecutan
con los permisos del usuario actual del equipo local o con los permisos del usuario
especificado por el parámetro /u, si se incluye uno. Para ejecutar una tarea con
permisos de una cuenta de usuario diferente o con permisos del sistema, use el
parámetro /ru.

Sintaxis

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 Descripción

/tn Identifica la tarea que se va a cambiar. Escriba el nombre de la tarea (Nota: Los
<Taskname> nombres de tarea que tienen un espacio en su nombre deben encerrarse entre
comillas dobles).

/s Especifica el nombre o la dirección IP de un equipo remoto (con o sin barras


<computer> diagonales inversas). La opción predeterminada es el equipo local.

/u Ejecuta este comando con los permisos de la cuenta de usuario especificada. De


[<domain>] forma predeterminada, el comando se ejecuta con los permisos del usuario actual
del equipo local. La cuenta de usuario especificada debe ser miembro del grupo
Administradores en el equipo remoto. Los parámetros /u y /p son válidos solo
cuando se usa /s.

/p Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u. Si


<password> usa el parámetro /u sin el parámetro /p o el argumento password, schtasks le
pedirá una contraseña. Los parámetros /u y /p son válidos solo cuando se usa /s.

/ru Cambia el nombre de usuario con el que se debe ejecutar la tarea programada.
<username> Para la cuenta del sistema, los valores válidos son "", "NT AUTHORITY\SYSTEM" o
"SYSTEM".

/rp Especifica una nueva contraseña para la cuenta de usuario existente o la cuenta de
<password> usuario especificada por el parámetro /ru. Este parámetro se omite cuando se usa
con la cuenta del sistema local.

/tr Cambia el programa que la tarea ejecuta. Escriba la ruta de acceso completa y el
<Taskrun> nombre de archivo de un archivo ejecutable, un archivo de script o un archivo por
lotes. Si no agrega la ruta de acceso, schtasks asume que el archivo está en el
directorio <systemroot>\System32 . El programa especificado reemplaza el
programa original ejecutado por la tarea.

/st Especifica la hora de inicio de la tarea, para lo que se utiliza el formato de hora de
<Starttime> 24 horas, HH:mm. Por ejemplo, un valor de 14:30 equivale a la hora 2:30 p. m. con
el formato de 12 horas.

/ri Especifica el intervalo de repetición de la tarea programada, en minutos. El


<interval> intervalo válido es de 1 a 599940 (599940 minutos = 9999 horas). Si se especifican
los parámetros /et o /du, el valor predeterminado es 10 minutos.
Parámetro Descripción

/rl <level> Especifica el nivel de ejecución del trabajo. Los valores aceptables son LIMITED (las
tareas programadas se ejecutarán con el menor nivel de privilegios, como las
cuentas de usuario estándar) y HIGHEST (las tareas programadas se ejecutarán con
el nivel más alto de privilegios, como las cuentas de superusuario). (Nota: LIMITED
es el valor predeterminado).

/et Especifica la hora de finalización de la tarea, para lo que se utiliza el formato de


<Endtime> hora de 24 horas, HH:mm. Por ejemplo, un valor de 14:30 equivale a la hora 2:30
p. m. con el formato de 12 horas.

/du Un valor que especifica la duración de la ejecución de la tarea. El formato de hora


<duration> es HH:mm (formato de 24 horas). Por ejemplo, un valor de 14:30 equivale a la hora
2:30 p. m. con el formato de 12 horas.

/k Detiene el programa que la tarea ejecuta en el momento especificado por /et o


/du. Sin /k, schtasks no vuelve a iniciar el programa después de alcanzar la hora
especificada por /et o /du, ni lo detiene si aún se está ejecutando. Este parámetro
es opcional y válido solo con una programación de tipo MINUTE u HOURLY.

/sd Especifica la primera fecha en la que se debe ejecutar la tarea. El formato de la


<Startdate> fecha es MM/DD/YYYY.

/ed Especifica la última fecha en la que se debe ejecutar la tarea. El formato es


<Enddate> MM/DD/AAAA.

/ENABLE Especifica que se habilite la tarea programada.

/DISABLE Especifica que se deshabilite la tarea programada.

/it Especifica que se ejecute la tarea programada solo cuando Ejecutar como usuario
(la cuenta de usuario en la que se ejecuta la tarea) haya iniciado sesión en el
equipo. Este parámetro no tiene ningún efecto en las tareas que se ejecutan con
permisos del sistema o en las tareas que ya tienen establecida la propiedad
interactive-only. No se puede usar un comando change para quitar la propiedad
interactive-only de una tarea. De forma predeterminada, ejecutar como usuario es
el usuario actual del equipo local cuando la tarea se programa o la cuenta se
especifica mediante el parámetro /u, si se usa uno. Sin embargo, si el comando
incluye el parámetro /ru, Ejecutar como usuario es la cuenta especificada por el
parámetro /ru.

/z Especifica la eliminación de la tarea tras la finalización de su programación.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Los parámetros /tn y /s identifican la tarea. Los parámetros /tr, /ru y /rp
especifican las propiedades de la tarea que puede cambiar.

Los parámetros /ru y /rp especifican los permisos con los que se ejecuta la tarea.
Los parámetros /u y /p especifican los permisos usados para cambiar la tarea.

Para cambiar las tareas en un equipo remoto, el usuario debe iniciar sesión en el
equipo local con una cuenta que sea miembro del grupo Administradores en el
equipo remoto.

Para ejecutar un comando /change con los permisos de un usuario diferente (/u,
/p), el equipo local debe estar en el mismo dominio que el equipo remoto o en un
dominio en el que confíe el dominio del equipo remoto.

La cuenta System no tiene derechos de inicio de sesión interactivo. Los usuarios no


ven los programas que se ejecutan con permisos del sistema y no pueden
interactuar con ellos. Para identificar las tareas con la propiedad /it, use una
consulta detallada (/query /v). En una visualización de consulta detallada de una
tarea con /it, el campo Modo de inicio de sesión tiene un valor de Solo interactivo.

Ejemplos
Para cambiar el programa que la tarea Virus Check ejecuta de VirusCheck.exe a
VirusCheck2.exe, escriba:

schtasks /change /tn Virus Check /tr C:\VirusCheck2.exe

Este comando usa el parámetro /tn para identificar la tarea y el parámetro /tr para
especificar el nuevo programa para la tarea. (No se puede cambiar el nombre de la
tarea).

Para cambiar la contraseña de la cuenta de usuario de la tarea RemindMe en el equipo


remoto, Svr01, escriba:

schtasks /change /tn RemindMe /s Svr01 /rp p@ssWord3

Este procedimiento es necesario siempre que la contraseña de una cuenta de usuario


expire o cambie. Si la contraseña guardada en una tarea ya no es válida, la tarea no se
ejecuta. El comando usa el parámetro /tn para identificar la tarea y el parámetro /s para
especificar el equipo remoto. Usa el parámetro /rp para especificar la nueva contraseña,
p@ssWord3.

Para cambiar la tarea ChkNews, que inicia Notepad.exe cada mañana a las 9:00 a. m.,
para que inicie Internet Explorer en su lugar, escriba:

schtasks /change /tn ChkNews /tr c:\program files\Internet


Explorer\iexplore.exe /ru DomainX\Admin01

El comando usa el parámetro /tn para identificar la tarea. Usa el parámetro /tr para
cambiar el programa que la tarea ejecuta y el parámetro /ru para cambiar la cuenta de
usuario en la que se ejecuta la tarea. Los parámetros /ru y /rp, que proporcionan la
contraseña de la cuenta de usuario, no se usan. Debe proporcionar una contraseña para
la cuenta, pero puede usar el parámetro /ru y /rp y escribir la contraseña en texto no
cifrado, o esperar a que SchTasks.exe le pida una contraseña y, a continuación, escribir la
contraseña en texto oculto.

Para cambiar la tarea SecurityScript para que se ejecute con permisos de la cuenta del
sistema, escriba:

schtasks /change /tn SecurityScript /ru

El comando usa el parámetro /ru para indicar la cuenta del sistema. Dado que las tareas
se ejecutan con permisos de cuenta del sistema no requieren una contraseña,
SchTasks.exe no solicita una.

Para agregar la propiedad interactive-only a MyApp, una tarea existente, escriba:

schtasks /change /tn MyApp /it

Esta propiedad garantiza que la tarea se ejecuta solo cuando la ejecución como usuario,
es decir, la cuenta de usuario con la que se ejecuta la tarea, haya iniciado sesión en el
equipo. El comando usa el parámetro /tn para identificar la tarea y el parámetro /it para
agregar la propiedad interactive-only a dicha tarea. Dado que la tarea ya se ejecuta con
los permisos de mi cuenta de usuario, no es necesario cambiar el parámetro /ru de la
tarea.
Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando schtasks create

Comando schtasks delete

Comando schtasks end

Comando schtasks query

Comando schtasks run


schtasks create
Artículo • 10/10/2023

Programa una tarea.

Sintaxis

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>]
[{/et <endtime> | /du <duration>} [/k]] [/sd <startdate>] [/ed <enddate>]
[/it] [/np] [/z] [/xml <xmlfile>] [/v1] [/f] [/rl <level>] [/delay
<delaytime>] [/hresult]

Parámetros

Parámetro Descripción

/sc <scheduletype> Especifica el tipo de programación. Los valores válidos incluyen:


MINUTE: especifica el número de minutos antes de que se ejecute la
tarea.
HOURLY: especifica el número de horas antes de que se ejecute la
tarea.
DAILY: especifica el número de días antes de que se ejecute la tarea.
WEEKLY: especifica el número de semanas antes de que se ejecute la
tarea.
MONTHLY: especifica el número de meses antes de que se ejecute
la tarea.
ONCE: especifica que esa tarea se ejecuta una vez en una fecha y
hora especificadas.
ONSTART: especifica que la tarea se ejecuta cada vez que se inicia el
sistema. Puede especificar una fecha de inicio o ejecutar la tarea la
próxima vez que se inicie el sistema.
ONLOGON: especifica que la tarea se ejecuta cada vez que un
usuario (cualquier usuario) inicia sesión. Puede especificar una fecha
o ejecutar la tarea la próxima vez que el usuario inicie sesión.
ONIDLE: especifica que la tarea se ejecuta cada vez que el sistema
permanece inactivo durante un período de tiempo especificado.
Puede especificar una fecha o ejecutar la tarea la próxima vez que el
sistema se quede inactivo.
ONEVENT: especifica que la tarea se ejecuta en función de un
evento que coincide con la información del registro de eventos del
Parámetro Descripción

sistema, incluido EventID.

/tn <taskname> Especifica un nombre para la tarea. Cada tarea del sistema debe tener un
nombre único y debe cumplir las reglas para los nombres de archivo, sin
superar los 238 caracteres. Use comillas para incluir nombres que incluyan
espacios. Para almacenar la tarea programada en otra carpeta, ejecute
/tn <folder name\task name> .

/tr <Taskrun> Especifica el programa o comando que ejecuta la tarea. Escriba la ruta de
acceso completa y el nombre de archivo de un archivo ejecutable, un
archivo de script o un archivo por lotes. El nombre de la ruta de acceso no
debe superar los 262 caracteres. Si no agrega la ruta de acceso, schtasks
asume que el archivo está en el directorio <systemroot>\System32 .

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (con o sin


barras diagonales inversas). La opción predeterminada es el equipo local.

/u [<domain>] Ejecuta este comando con los permisos de la cuenta de usuario


especificada. El valor predeterminado corresponde a los permisos del
usuario actual del equipo local. Los parámetros /u y /p son válidos solo
cuando se usa /s. Los permisos de la cuenta especificada se usan para
programar y ejecutar la tarea. Para ejecutar la tarea con los permisos de un
usuario diferente, use el parámetro /ru. La cuenta de usuario debe ser
miembro del grupo Administradores en el equipo remoto. Además, el
equipo local debe estar en el mismo dominio que el equipo remoto o
debe estar en un dominio de confianza para el dominio de equipo remoto.

/p <password> Especifica la contraseña de la cuenta de usuario especificada en el


parámetro /u. Si usa el parámetro /u sin el parámetro /p o el argumento
password, schtasks le pedirá una contraseña. Los parámetros /u y /p son
válidos solo cuando se usa /s.

/ru {[ <domain> ] Ejecuta la tarea con permisos de la cuenta de usuario especificada. De


<user> | system} forma predeterminada, la tarea se ejecuta con los permisos del usuario
actual del equipo local o con los permisos del usuario especificado por el
parámetro /u, si se incluye uno. El parámetro /ru es válido al programar
tareas en equipos locales o remotos. Las opciones válidas incluyen:

Domain: especifica una cuenta de usuario alternativa.


System: especifica la cuenta del sistema local, una cuenta con
privilegios elevados que el sistema operativo y los servicios del
sistema usan.

/rp <password> Especifica la contraseña para la cuenta de usuario existente o la cuenta de


usuario especificada por el parámetro /ru. Si no usa este parámetro al
especificar una cuenta de usuario, SchTasks.exe le pedirá la contraseña la
próxima vez que inicie sesión. No use el parámetro /rp para las tareas que
Parámetro Descripción

se ejecutan con credenciales de cuenta del sistema (/ru System). La cuenta


del sistema no tiene una contraseña y SchTasks.exe no solicita una.

/mo <modifiers> Especifica la frecuencia con la que se ejecuta la tarea dentro de su tipo de
programación. Las opciones válidas incluyen:
MINUTE: especifica que la tarea se ejecuta cada <n> minutos.
Puede usar cualquier valor entre 1 y 1439 minutos. De forma
predeterminada, es 1 minuto.
HOURLY: especifica que la tarea se ejecuta cada <n> horas. Puede
usar cualquier valor entre 1 y 23 minutos. De forma predeterminada,
es 1 hora.
DAILY: especifica que la tarea se ejecuta cada <n> días. Puede usar
cualquier valor entre 1 y 365 días. De forma predeterminada, es 1
día.
WEEKLY: especifica que la tarea se ejecuta cada <n> semanas.
Puede usar cualquier valor entre 1 y 52 días. De forma
predeterminada, es 1 semana.
MONTHLY: especifica que la tarea se ejecuta cada <n> meses.
Puede usar cualquiera de los valores siguientes:
Un número entre 1 y 12 meses
LASTDAY: para ejecutar la tarea el último día del mes
FIRST, SECOND, THIRD o FOURTH junto con el parámetro /d
<day> : especifica la semana y el día concretos para ejecutar la
tarea. Por ejemplo, el tercer miércoles del mes.
ONCE: especifica que la tarea se ejecuta una vez.
ONSTART: especifica que la tarea se ejecuta en el inicio.
ONLOGON: especifica que la tarea se ejecuta cuando el usuario
especificado por el parámetro /ru inicia sesión.
ONIDLE: especifica que la tarea se ejecuta después de que el
sistema se quede inactivo durante el número de minutos
especificado por el parámetro /i.

/d DAY[,DAY...] Especifica la frecuencia con la que se ejecuta la tarea dentro de su tipo de


programación. Las opciones válidas incluyen:
WEEKLY: especifica que la tarea se ejecuta semanalmente
proporcionando un valor entre 1 y 52 semanas. Opcionalmente,
también puede agregar un día específico de la semana agregando
un valor de MON a SUN o un intervalo de [MON a SUN...].
MONTHLY: especifica que la tarea se ejecuta semanalmente cada
mes proporcionando un valor entre FIRST, SECOND, THIRD, FOURTH
y LAST. Opcionalmente, también puede agregar un día específico de
la semana agregando un valor de MON a SUN o proporcionando un
número entre 1 y 12 meses. Si usa esta opción, también puede
agregar un día específico del mes proporcionando un número entre
1 y 31.
Parámetro Descripción

NOTA: el valor de fecha de 1 a 31 solo es válido sin el parámetro


/mo o si el parámetro /mo es mensual (de 1 a 12). El valor
predeterminado es el día 1 (el primer día del mes).

/m Especifica un mes o meses del año durante el cual se debe ejecutar la


MONTH[,MONTH...] tarea programada. Las opciones válidas incluyen JAN - DEC y * (cada
mes). El parámetro /m solo es válido con una programación de tipo
MONTHLY. Es necesario cuando se usa el modificador LASTDAY. De lo
contrario, es opcional y el valor predeterminado es * (cada mes).

/i <Idletime> Especifica cuántos minutos está inactivo el equipo antes de que se inicie la
tarea. Un valor válido es un número entero de 1 a 999. Este parámetro solo
es válido con una programación de tipo ONIDLE y, a continuación, es
necesario.

/st <Starttime> Especifica la hora de inicio de la tarea, para lo que se utiliza el formato de
hora de 24 horas, HH:mm. El valor predeterminado es la hora actual del
equipo local. El parámetro /st es válido con las programaciones MINUTE,
HOURLY, DAILY, WEEKLY, MONTHLY y ONCE. Es necesario para una
programación ONCE.

/ri <interval> Especifica el intervalo de repetición de la tarea programada, en minutos.


Esto no es aplicable para los tipos de programación MINUTE, HOURLY,
ONSTART, ONLOGON,ONIDLE y ONEVENT. El intervalo válido es de 1 a
599940 (599940 minutos = 9999 horas). Si se especifican los parámetros
/et o /du, el valor predeterminado es 10 minutos.

/et <endtime> Especifica la hora del día a la que finaliza una programación de tareas por
minuto u hora en formato de 24 horas <HH:MM>. Después de la hora de
finalización especificada, schtasks no vuelve a iniciar la tarea hasta que se
repite la hora de inicio. De forma predeterminada, las programaciones de
tareas no tienen ninguna hora de finalización. Este parámetro es opcional
y válido solo con una programación de tipo MINUTE u HOURLY.

/du <duration> Especifica un período máximo de tiempo durante una programación por
minuto o por hora en formato de 24 horas <HHHH:MM>. Una vez
transcurrida la hora especificada, schtasks no vuelve a iniciar la tarea hasta
que se repite la hora de inicio. De forma predeterminada, las
programaciones de tareas no tienen duración máxima. Este parámetro es
opcional y válido solo con una programación de tipo MINUTE u HOURLY.

/k Detiene el programa que la tarea ejecuta en el momento especificado por


/et o /du. Sin /k, schtasks no vuelve a iniciar el programa después de
alcanzar la hora especificada por /et o /du, ni lo detiene si aún se está
ejecutando. Este parámetro es opcional y válido solo con una
programación de tipo MINUTE u HOURLY.
Parámetro Descripción

/sd <Startdate> Especifica la fecha en la que se inicia la programación de la tarea. El valor


predeterminado es la fecha actual del equipo local. El formato de
Startdate varía con la configuración regional seleccionada para el equipo
local en Configuración regional y de idioma. Solo un formato es válido
para cada configuración regional. Los formatos de fecha válidos incluyen
(asegúrese de elegir el formato más similar al formato seleccionado para
Fecha corta en Configuración regional y de idioma en el equipo local):

<MM>// : especifica el uso para formatos de mes primero, como


inglés (Estados Unidos) y español (Panamá).
<DD>// : especifica el uso para formatos de día primero, como
búlgaro y neerlandés (Países Bajos).
<YYYY>// : especifica el uso para formatos de año primero, como
sueco y francés (Canadá).

/ed <Enddate> Especifica la fecha en la que finaliza la programación. Este parámetro es


opcional. No es válido en una programación de tipo ONCE, ONSTART,
ONLOGON, ONIDLE u ONEVENT. De forma predeterminada, las
programaciones no tienen fecha de finalización. El valor predeterminado
es la fecha actual del equipo local. El formato de Enddate varía con la
configuración regional seleccionada para el equipo local en Configuración
regional y de idioma. Solo un formato es válido para cada configuración
regional. Los formatos de fecha válidos incluyen (asegúrese de elegir el
formato más similar al formato seleccionado para Fecha corta en
Configuración regional y de idioma en el equipo local):

<MM>// : especifica el uso para formatos de mes primero, como


inglés (Estados Unidos) y español (Panamá).
<DD>// : especifica el uso para formatos de día primero, como
búlgaro y neerlandés (Países Bajos).
<YYYY>// : especifica el uso para formatos de año primero, como
sueco y francés (Canadá).

/ec <channelname> Especifica el nombre del canal de eventos desencadenado por el tipo de
programación ONEVENT que coincide con los criterios de un registro de
eventos del sistema.

/it Especifica que se ejecute la tarea programada solo cuando Ejecutar como
usuario (la cuenta de usuario en la que se ejecuta la tarea) haya iniciado
sesión en el equipo. Este parámetro no tiene ningún efecto en las tareas
que se ejecutan con permisos del sistema o en las tareas que ya tienen
establecida la propiedad interactive-only. No se puede usar un comando
change para quitar la propiedad interactive-only de una tarea. De forma
predeterminada, Ejecutar como usuario es el usuario actual del equipo
local cuando la tarea se programa o la cuenta se especifica mediante el
parámetro /u, si se usa uno. Sin embargo, si el comando incluye el
Parámetro Descripción

parámetro /ru, Ejecutar como usuario es la cuenta especificada por el


parámetro /ru.

/np No se almacena ninguna contraseña. La tarea se ejecuta de forma no


interactiva como el usuario especificado. Solo están disponibles los
recursos locales.

/z Especifica la eliminación de la tarea tras la finalización de su programación.

/xml <xmlfile> Crea una tarea especificada en el archivo XML. Se puede combinar con los
parámetros /ru y /rp, o bien con el parámetro /rp por sí solo si el archivo
XML ya contiene la información de la cuenta de usuario.

/v1 Crea una tarea visible para los sistemas operativos anteriores a Vista. Esto
no es compatible con el parámetro /XML.

/f Especifica la creación de la tarea y la supresión de las advertencias si la


tarea especificada ya existe.

/rl <level> Especifica el nivel de ejecución del trabajo. Los valores aceptables son
LIMITED (las tareas programadas se ejecutarán con el menor nivel de
privilegios, como las cuentas de usuario estándar) y HIGHEST (las tareas
programadas se ejecutarán con el nivel más alto de privilegios, como las
cuentas de superusuario). El valor predeterminado es Limited.

/delay <delaytime> Especifica el tiempo de espera para retrasar la ejecución de la tarea


después de desencadenarse en formato mmmm:ss. Esto solo es válido
para los tipos de programación ONSTART, ONLOGON y ONEVENT.

/hresult Especifica que el código de salida del proceso esté en formato HRESULT.

/? Muestra la ayuda en el símbolo del sistema.

Programación de una tarea para que se ejecute


cada <n> minutos
En una programación de minutos, se requiere el parámetro /sc minute. El parámetro
/mo (modificador) es opcional y especifica el número de minutos entre cada ejecución
de la tarea. El valor predeterminado para /mo es 1 (cada minuto). Los parámetros /et
(hora de finalización) y /du (duración) son opcionales y se pueden usar con o sin el
parámetro (tarea final) /k.

Ejemplos
Para programar un script de seguridad, Sec.vbs, para que se ejecute cada 20
minutos, escriba:

schtasks /create /sc minute /mo 20 /tn "Security Script" /tr


\\central\data\scripts\sec.vbs

Dado que en este ejemplo no se incluye una fecha u hora de inicio, la tarea se
inicia 20 minutos después de que se complete el comando y se ejecuta cada 20
minutos después de que se ejecute el sistema. Observe que el archivo de origen
del script de seguridad se encuentra en un equipo remoto, pero que la tarea está
programada y se ejecuta en el equipo local.

Para programar un script de seguridad, Sec.vbs, para que se ejecute en el equipo


local cada 100 minutos entre las 5:00 p. m. y las 7:59 a. m. cada día, escriba:

schtasks /create /tn "Security Script" /tr sec.vbs /sc minute /mo 100
/st 17:00 /et 08:00 /k

En este ejemplo se usa el parámetro /sc para especificar una programación de


minutos y el parámetro /mo para especificar un intervalo de 100 minutos. Usa los
parámetros /st y /et para especificar la hora de inicio y la hora de finalización de la
programación de cada día. También usa el parámetro /k para detener el script si
sigue ejecutándose a las 7:59 a. m. Sin /k, schtasks no iniciaría el script después de
las 7:59 a. m., pero si la instancia iniciada a las 6:20 a. m. todavía estaba en
ejecución, no la detendría.

Programación de una tarea para que se ejecute


cada <n> horas
En una programación por hora, se requiere el parámetro /sc hourly. El parámetro /mo
(modificador) es opcional y especifica el número de horas entre cada ejecución de la
tarea. El valor predeterminado para /mo es 1 (cada hora). El parámetro /k (tarea de
finalización) es opcional y se puede usar con /et (finalizar a la hora especificada) o /du
(finalizar después del intervalo especificado).

Ejemplos
Para programar el programa MyApp para que se ejecute cada cinco horas, a partir
del primer día de marzo de 2002, escriba:

schtasks /create /sc hourly /mo 5 /sd 03/01/2002 /tn MyApp /tr
c:\apps\myapp.exe

En este ejemplo, el equipo local usa la opción Inglés (Zimbabwe) en


Configuración regional y de idioma, por lo que el formato de la fecha de inicio es
MM/DD/AAAA (03/01/2002).

Para programar la aplicación MyApp se ejecute cada hora, a partir de cinco


minutos pasada la medianoche, escriba:

schtasks /create /sc hourly /st 00:05 /tn MyApp /tr c:\apps\myapp.exe

Para programar la aplicación MyApp para que se ejecute cada 3 horas, durante un
total de 10 horas, escriba:

schtasks /create /tn MyApp /tr MyApp.exe /sc hourly /mo 3 /st 00:00 /du
0010:00

En este ejemplo, la tarea se ejecuta a las 12:00 a. m., 3:00 a. m., 6:00 a. m. y
9:00 a. m. Dado que la duración es de 10 horas, la tarea no se vuelve a ejecutar a
las 12:00 p. m. En su lugar, comienza de nuevo a las 12:00 a. m. el día siguiente.
Además, dado que el programa se ejecuta durante unos minutos, el parámetro /k,
que detiene el programa si todavía se está ejecutando cuando expira la duración,
no es necesario.

Programación de una tarea que se ejecute cada


<n> días
En una programación diaria, se requiere el parámetro /sc daily. El parámetro /mo
(modificador) es opcional y especifica el número de días entre cada ejecución de la
tarea. El valor predeterminado para /mo es 1 (cada día).
Ejemplos
Para programar la aplicación MyApp para que se ejecute una vez al día, todos los
días, a las 8:00 a. m. hasta el 31 de diciembre de 2021, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc daily /st 08:00
/ed 31/12/2021

En este ejemplo, el sistema de equipo local se establece en la opción Inglés (Reino


Unido) en Configuración regional y de idioma, por lo que el formato de la fecha
de finalización es DD/MM/AAAA (31/12/2021). Además, dado que en este ejemplo
no se incluye el parámetro /mo, se usa el intervalo predeterminado de 1 para
ejecutar el comando todos los días.

Para programar la aplicación MyApp para que se ejecute cada doce días a las
1:00 p. m. (13:00) a partir del 31 de diciembre de 2021, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc daily /mo 12 /sd
12/31/2002 /st 13:00

En este ejemplo, el sistema se establece en la opción Inglés (Zimbabwe) en


Configuración regional y de idioma, por lo que el formato de la fecha de
finalización es MM/DD/AAAA (12/31/2021).

Para programar un script de seguridad, Sec.vbs, para que se ejecute cada 70 días,
escriba:

schtasks /create /tn "Security Script" /tr sec.vbs /sc daily /mo 70 /it

En este ejemplo, el parámetro /it se usa para especificar que la tarea se ejecuta
solo cuando el usuario en cuya cuenta se ejecuta la tarea inicia sesión en el equipo.
Dado que la tarea se ejecuta con los permisos de una cuenta de usuario específica,
esta tarea solo se ejecuta cuando ese usuario ha iniciado sesión.

7 Nota
Para identificar las tareas con la propiedad /it interactive-only, use una
consulta detallada (/query /v). En una visualización de consulta detallada de
una tarea con /it, el campo Modo de inicio de sesióntiene un valor de Solo
interactivo.

Programación de una tarea que se ejecute cada


<n> semanas
En una programación semanal, se requiere el parámetro /sc weekly. El parámetro /mo
(modificador) es opcional y especifica el número de semanas entre cada ejecución de la
tarea. El valor predeterminado para /mo es 1 (cada semana).

Las programaciones semanales también tienen un parámetro /d opcional para


programar la tarea para que se ejecute en días especificados de la semana o todos los
días (). El valor predeterminado es MON (lunes). La opción diaria () es equivalente a
programar una tarea diariamente.

Ejemplos
Para programar la aplicación MyApp para que se ejecute en un equipo remoto
cada seis semanas, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc weekly /mo 6 /s


Server16 /u Admin01

Dado que en este ejemplo se deja fuera el parámetro /d, la tarea se ejecuta los
lunes. En este ejemplo también se usa el parámetro /s para especificar el equipo
remoto y el parámetro /u para ejecutar el comando con los permisos de la cuenta
de administrador del usuario. Además, dado que el parámetro /p se deja fuera,
SchTasks.exe solicita al usuario la contraseña de la cuenta de administrador y,
debido a que el comando se ejecuta de forma remota, todas las rutas de acceso de
dicho comando, incluida la ruta de acceso a MyApp.exe, hacen referencia a rutas
de acceso en el equipo remoto.

Para programar una tarea que se ejecute cada dos viernes, escriba:
schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc weekly /mo 2 /d
FRI

En este ejemplo se usa el parámetro /mo para especificar el intervalo de dos


semanas y el parámetro /d para especificar el día de la semana. Para programar
una tarea que se ejecuta cada viernes, deje el parámetro /mo o establézcalo en 1.

Programación de una tarea para que se ejecute


cada <n> meses
En este tipo de programación, se requiere el parámetro /sc monthly. El parámetro /mo
(modificador), que especifica el número de meses entre cada ejecución de la tarea, es
opcional y el valor predeterminado es 1 (cada mes). Este tipo de programación también
tiene un parámetro /d opcional para programar la tarea que se va a ejecutar en una
fecha especificada del mes. El valor predeterminado 1 (el primer día del mes).

Ejemplos
Para programar la aplicación MyApp para que se ejecute el primer día de cada
mes, escriba:

schtasks /create /tn MyApp /tr myapp.exe /sc monthly

El valor predeterminado para el parámetro /mo (modificador) y el parámetro /d


(día) es 1, por lo que no es necesario usar ninguno de esos parámetros para este
ejemplo.

Para programar la aplicación MyApp para que se ejecute cada tres meses, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /mo 3

En este ejemplo se usa el parámetro /mo para especificar un intervalo de 3 meses.

Para programar la aplicación MyApp para que se ejecute cada dos meses el día 21
del mes a medianoche durante un año, desde el 2 de julio de 2002 hasta el 30 de
junio de 2003, escriba:
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

En este ejemplo se usa el parámetro /mo para especificar el intervalo mensual


(cada dos meses), el parámetro /d para especificar la fecha, el parámetro /st para
especificar la hora y los parámetros /sd y /ed para especificar la fecha de inicio y la
fecha de finalización, respectivamente. También en este ejemplo, el equipo local se
establece en la opción Inglés (Sudáfrica) en Configuración regional y de idioma,
por lo que las fechas se especifican en el formato local, AAAA/MM/DD.

Programación de una tarea para que se ejecute


en un día específico de la semana
El día de la programación de la semana es una variación de la programación semanal.
En una programación semanal, se requiere el parámetro /sc weekly. El parámetro /mo
(modificador) es opcional y especifica el número de semanas entre cada ejecución de la
tarea. El valor predeterminado para /mo es 1 (cada semana). El parámetro /d, que es
opcional, programa la tarea para que se ejecute en días especificados de la semana o
todos los días (*). El valor predeterminado es MON (lunes). La opción diaria (/d *) es
equivalente a programar una tarea diariamente.

Ejemplos
Para programar la aplicación MyApp para que se ejecute cada semana el
miércoles, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc weekly /d WED

En este ejemplo se usa el parámetro /d para especificar el día de la semana. Dado


que el comando deja fuera el parámetro /mo, la tarea se ejecuta cada semana.

Para programar una tarea para que se ejecute el lunes y el viernes de cada octava
semana, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc weekly /mo 8 /d


MON,FRI

En este ejemplo se usa el parámetro /d para especificar los días y el parámetro


/mo para especificar el intervalo de ocho semanas.

Programación de una tarea para que se ejecute


en una semana específica del mes
En este tipo de programación, se requieren los parámetros /sc mensual, /mo
(modificador) y /d (día). El parámetro /mo (modificador) especifica la semana en la que
se ejecuta la tarea. El parámetro /d especifica el día de la semana. Solo puede
especificar un día de la semana para este tipo de programación. Esta programación
también tiene un parámetro /m (mes) opcional que le permite programar la tarea para
meses concretos o para cada mes (*). El valor predeterminado para el parámetro /m es
cada mes (*).

Ejemplos
Para programar la aplicación MyApp para que se ejecute el segundo domingo de
cada mes, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /mo SECOND
/d SUN

En este ejemplo se usa el parámetro /mo para especificar la segunda semana del
mes y el parámetro /d para especificar el día.

Para programar la aplciación MyApp para que se ejecute el primer lunes de marzo
y septiembre, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /mo FIRST
/d MON /m MAR,SEP

En este ejemplo se usa el parámetro /mo para especificar la primera semana del
mes y el parámetro /d para especificar el día. Usa el parámetro /m para especificar
el mes, separando los argumentos de los meses con una coma.
Programación de una tarea para que se ejecute
en un día específico cada mes
En este tipo de programación, se requieren los parámetros /sc monthly y /d (día). El
parámetro /d especifica una fecha del mes (1 a 31), no un día de la semana y solo se
puede especificar un día en la programación. El parámetro /m (mes) es opcional, siendo
el valor predeterminado cada mes (), mientras que el parámetro /mo (modificador) no
es válido con este tipo de programación.

Schtasks.exe no le permitirá programar una tarea para una fecha que no esté en un mes
especificado por el parámetro /m. Por ejemplo, intentando programar el día 31 de
febrero. Sin embargo, si no usa el parámetro /m y programa una tarea para una fecha
que no aparece en cada mes, la tarea no se ejecutará en los meses más cortos. Para
programar una tarea para el último día del mes, use el tipo de programación del último
día.

Ejemplos
Para programar la aplicación MyApp para que se ejecute el primer día de cada
mes, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly

Dado que el modificador predeterminado es none (ningún modificador), este


comando usa el día predeterminado de 1 y el mes predeterminado de cada mes,
sin necesidad de parámetros adicionales.

Para programar la aplicación MyApp para que se ejecute el 15 de mayo y el 15 de


junio a las 3:00 p. m. (15:00), escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /d 15 /m


MAY,JUN /st 15:00

En este ejemplo se usa el parámetro /d para especificar la fecha y el parámetro /m


para especificar los meses. También se usa el parámetro /st para especificar la hora
de inicio.
Programación de una tarea para que se ejecute
el último día de un mes
En el tipo de programación de último día, se requieren los parámetros /sc monthly, /mo
LASTDAY (modificador) y /m (mes). El parámetro /d (día) no es válido.

Ejemplos
Para programar la aplicación MyApp para que se ejecute el último día de cada
mes, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /mo


lastday /m *

En este ejemplo se usa el parámetro /mo para especificar el último día y el


parámetro /m con el carácter comodín (*) para indicar que el programa se ejecute
cada mes.

Para programar la aplicación MyApp para que se ejecute el último día de febrero y
el último día de marzo a las 6:00 p. m., escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /mo


lastday /m FEB,MAR /st 18:00

En este ejemplo se usa el parámetro /mo para especificar el último día, el


parámetro /m para especificar los meses y el parámetro /st para especificar la hora
de inicio.

Programación para una sola ejecución


En el tipo de programación de una sola ejecución, se requiere el parámetro /sc once. El
parámetro /st, que especifica la hora en que se ejecuta la tarea, es necesario. El
parámetro /sd, que especifica la fecha en la que se ejecuta la tarea, es opcional,
mientras que los parámetros /mo (modificador) y /ed (fecha de finalización) no son
válidos.

Schtasks no le permitirá programar una tarea para que se ejecute una vez si la fecha y
hora especificadas son pasadas, para lo cual se utiliza la hora del equipo local como
referencia. Para programar una tarea para que se ejecute una vez en un equipo remoto
en una zona horaria diferente, debe programarla antes de que se produzca esa fecha y
hora en dicho equipo.

Ejemplo
Para programar la aplicación MyApp para que se ejecute a medianoche el 1 de
enero de 2003, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc once /sd


01/01/2003 /st 00:00

En este ejemplo se usa el parámetro /sc para especificar el tipo de programación y


los parámetros /sd y /st para especificar la fecha y hora. También en este ejemplo,
el equipo local usa la opción Inglés (Estados Unidos) en Configuración regional y
de idioma, por lo que el formato de la fecha de inicio es MM/DD/AAAA.

Programación de una tarea que se ejecute cada


vez que se inicie el sistema
En el tipo de programación para el inicio, se requiere el parámetro /sc onstart. El
parámetro /sd (fecha de inicio) es opcional y el valor predeterminado es la fecha actual.

Ejemplo
Para programar la aplicación MyApp para que se ejecute cada vez que se inicie el
sistema, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc onstart

En este ejemplo, el equipo local usa la opción Inglés (Estados Unidos) en


Configuración regional y de idioma, por lo que el formato de la fecha de inicio es
MM/DD/AAAA.
Programación de una tarea para que se ejecute
cuando un usuario inicia sesión
El tipo de programación para el inicio de sesión programa una tarea que se ejecuta cada
vez que cualquier usuario inicia sesión en el equipo. En el tipo de programación para el
inicio de sesión, se requiere el parámetro /sc onlogon. El parámetro /sd (fecha de inicio)
es opcional y el valor predeterminado es la fecha actual.

Ejemplo
Para programar una tarea para que se ejecute cuando un usuario inicia sesión en
un equipo remoto, escriba:

schtasks /create /tn "Start Web Site" /tr c:\myiis\webstart.bat /sc


onlogon /s Server23

En este ejemplo se programa un archivo por lotes para que se ejecute cada vez
que un usuario (cualquier usuario) inicia sesión en el equipo remoto. Usa el
parámetro /s para identificar el equipo remoto. Dado que el comando es remoto,
todas sus rutas de acceso, incluida la ruta de acceso al archivo por lotes, hacen
referencia a una ruta de acceso en el equipo remoto.

Programación de una tarea para que se ejecute


cuando el sistema está inactivo
El tipo de programación para cuando hay inactividad programa una tarea que se ejecuta
siempre que no haya ninguna actividad de usuario durante el tiempo especificado por el
parámetro /i. En el tipo de programación de inactividad, se requieren los parámetros /sc
onidle y /i. /sd (fecha de inicio) es opcional y el valor predeterminado es la fecha actual.

Ejemplo
Para programar la aplicación MyApp para que se ejecute siempre que el equipo
esté inactivo, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc onidle /i 10


En este ejemplo se usa el parámetro /i necesario para especificar que el equipo
debe permanecer inactivo durante diez minutos antes de que se inicie la tarea.

Programación de una tarea para que se ejecute


ahora
Schtasks no tiene una opción Ejecutar ahora, pero puede simular esa opción mediante la
creación de una tarea que se ejecuta una vez y se inicia en unos minutos.

Ejemplo
Para programar una tarea que se ejecute una vez, el 13 de noviembre de 2020 a las
2:18 p. m., hora local, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc once /st 14:18 /sd
11/13/2002

En este ejemplo, el equipo local usa la opción Inglés (Estados Unidos) en


Configuración regional y de idioma, por lo que el formato de la fecha de inicio es
MM/DD/AAAA.

Programación de una tarea para que se ejecute


con permisos diferentes
Puede programar tareas de todos los tipos para que se ejecuten con permisos de una
cuenta alternativa tanto en el equipo local como en el remoto. Además de los
parámetros necesarios para el tipo de programación determinado, se requiere el
parámetro /ru y el parámetro /rp es opcional.

Ejemplos
Para ejecutar la aplciación MyApp en el equipo local, escriba:

schtasks /create /tn MyApp /tr myapp.exe /sc weekly /d TUE /ru Admin06
En este ejemplo se usa el parámetro /ru para especificar que la tarea se debe
ejecutar con los permisos de la cuenta de administrador del usuario (Admin06).
También en este ejemplo la tarea se programa para ejecutarse todos los martes,
pero se puede usar cualquier tipo de programación para una ejecución de la tarea
con permisos alternativos.

En respuesta, SchTasks.exe solicita la contraseña para ejecutar como para la cuenta


Admin06 y, a continuación, muestra un mensaje de operación correcta:

Please enter the run as password for Admin06: ********


SUCCESS: The scheduled task MyApp has successfully been created.

Para ejecutar la aplicación MyApp en el equipo Marketing cada cuatro días, escriba:

schtasks /create /tn MyApp /tr myapp.exe /sc daily /mo 4 /s Marketing
/u Marketing\Admin01 /ru Reskits\User01

En este ejemplo se usa el parámetro /sc para especificar una programación diaria y
el parámetro /mo para especificar un intervalo de cuatro días. Además, en este
ejemplo se usa el parámetro /s para proporcionar el nombre del equipo remoto y
el parámetro /u para especificar una cuenta con permiso para programar una tarea
en dicho equipo (Admin01 en el equipo Marketing). Por último, en este ejemplo se
usa el parámetro /ru para especificar que la tarea se debe ejecutar con los
permisos de la cuenta de no administrador del usuario (User01 en el dominio
Reskits). Sin el parámetro /ru, la tarea se ejecutaría con los permisos de la cuenta
especificada por /u.

Al ejecutar este ejemplo, Schtasks solicita primero la contraseña del usuario


denominado por el parámetro /u (para ejecutar el comando) y, a continuación,
solicita la contraseña del usuario denominado por el parámetro /ru (para ejecutar
la tarea). Después de autenticar las contraseñas, schtasks muestra un mensaje que
indica que la tarea está programada:

Type the password for Marketing\Admin01:********


Please enter the run as password for Reskits\User01: ********
SUCCESS: The scheduled task MyApp has successfully been created.
Para ejecutar el programa AdminCheck.exe para que se ejecute en el equipo Public
todos los viernes a las 4:00 a. m., pero solo si el administrador del equipo ha
iniciado sesión, escriba:

schtasks /create /tn "Check Admin" /tr AdminCheck.exe /sc weekly /d FRI
/st 04:00 /s Public /u Domain3\Admin06 /ru Public\Admin01 /it

En este ejemplo se usa el parámetro /sc para especificar una programación


semanal, el parámetro /d para especificar el día y el parámetro /st para especificar
la hora de inicio. También usa el parámetro /s para proporcionar el nombre del
equipo remoto, el parámetro /u para especificar una cuenta con permiso para
programar una tarea en dicho equipo, el parámetro /ru para configurar la tarea
para que se ejecute con los permisos del administrador del equipo Public
(Public\Admin01) y el parámetro /it para indicar que la tarea se ejecute solamente
cuando se inicia sesión en la cuenta Public\Admin01.

7 Nota

Para identificar las tareas con la propiedad /it interactive-only, use una
consulta detallada ( /query /v ). En una visualización de consulta detallada de
una tarea con /it, el campo Modo de inicio de sesión tiene un valor de Solo
interactivo.

Programación de una tarea para que se ejecute


con permisos del sistema
Las tareas de todos los tipos se pueden ejecutar con permisos de la cuenta System
tanto en el equipo local como en el equipo remoto. Además de los parámetros
necesarios para el tipo de programación determinado, se requiere el parámetro /ru
system (o /ru), mientras que el parámetro /rp no es válido.

) Importante

La cuenta System no tiene derechos de inicio de sesión interactivo. Los usuarios no


pueden ver programas o tareas que se ejecutan con permisos del sistema ni
interactuar con dichos programas o tareas. El parámetro /ru determina los
permisos con los que se ejecuta la tarea, no los permisos usados para programarla.
Solo los administradores pueden programar tareas, independientemente del valor
del parámetro /ru.

Para identificar las tareas que se ejecutan con permisos del sistema, use una
consulta detallada ( /query /v ). En una visualización de consulta detallada de una
tarea de ejecución del sistema, el campo Ejecutar como usuario tiene un valor de
NT AUTHORITY\SYSTEM y el campo Modo de inicio de sesión tiene un valor de
Solo en segundo plano.

Ejemplos
Para programar la aplicación MyApp para que se ejecute en el equipo local con
permisos de la cuenta System, escriba:

schtasks /create /tn MyApp /tr c:\apps\myapp.exe /sc monthly /d 15 /ru


System

En este ejemplo, la tarea está programada para ejecutarse en el decimoquinto día


de cada mes, pero puede usar cualquier tipo de programación para una ejecución
de tareas con permisos del sistema. Además, en este ejemplo se usa el parámetro
/ru System para especificar el contexto de seguridad del sistema. Dado que las
tareas del sistema no usan una contraseña, el parámetro /rp se deja fuera.

En respuesta, SchTasks.exe muestra un mensaje informativo y un mensaje de


operación correcta, sin solicitar una contraseña:

INFO: The task will be created under user name (NT AUTHORITY\SYSTEM).
SUCCESS: The Scheduled task MyApp has successfully been created.

Para programar la aplicación MyApp para que se ejecute en el equipo Finance01


cada mañana a las 4:00 a. m., con permisos del sistema, escriba:

schtasks /create /tn MyApp /tr myapp.exe /sc daily /st 04:00 /s
Finance01 /u Admin01 /ru System
En este ejemplo se usa el parámetro /tn para asignar un nombre a la tarea y el
parámetro /tr para especificar la copia remota del programa MyApp, el parámetro
/sc para especificar una programación diaria, pero deja fuera el parámetro /mo
porque 1 (todos los días) es el valor predeterminado. En este ejemplo también se
usa el parámetro /st para especificar la hora de inicio, que también es la hora a la
que se ejecutará la tarea cada día, el parámetro /s para proporcionar el nombre del
equipo remoto, el parámetro /u para especificar una cuenta con permiso para
programar una tarea en el equipo remoto y el parámetro /ru para especificar que
la tarea debe ejecutarse en la cuenta System. Sin el parámetro /ru, la tarea se
ejecutaría con los permisos de la cuenta especificada por el parámetro /u.

Schtasks.exe solicita la contraseña del usuario denominado por el parámetro /u y,


después de autenticar dicha contraseña, muestra un mensaje que indica que se
crea la tarea y que se ejecutará con permisos de la cuenta System:

Type the password for Admin01:**********

INFO: The Schedule Task MyApp will be created under user name (NT
AUTHORITY\
SYSTEM).
SUCCESS: The scheduled task MyApp has successfully been created.

Programación de una tarea para que ejecute


más de un programa
Cada tarea ejecuta solo un programa. Sin embargo, puede crear un archivo por lotes
que ejecute varios programas y, a continuación, programar una tarea para ejecutar
dicho archivo.

1. Con un editor de texto, como Bloc de notas, cree un archivo por lotes que incluya
el nombre y la ruta de acceso completa al archivo .exe necesario para iniciar los
programas Visor de eventos (Eventvwr.exe) y Monitor de sistema (Perfmon.exe).

C:\Windows\System32\Eventvwr.exe
C:\Windows\System32\Perfmon.exe

2. Guarde el archivo como MyApps.bat, abra schtasks.exe y, a continuación, cree una


tarea para ejecutar MyApps.bat; para ello, escriba:
schtasks /create /tn Monitor /tr C:\MyApps.bat /sc onlogon /ru
Reskit\Administrator

Este comando crea la tarea Monitor, que se ejecuta cada vez que alguien inicia
sesión. Usa el parámetro /tn para asignar un nombre a la tarea, el parámetro /tr
para ejecutar MyApps.bat, el parámetro /sc para indicar el tipo de programación
OnLogon y el parámetro /ru para ejecutar la tarea con los permisos de la cuenta
de administrador del usuario.

El resultado de este comando es que, cada vez que un usuario inicia sesión en el
equipo, la tarea se inicia tanto en Visor de eventos como en Monitor de sistema.

Programación de una tarea para que se ejecute


en un equipo remoto
Para programar una tarea para que se ejecute en un equipo remoto, debe agregarla a la
programación de dicho equipo. Las tareas de todos los tipos se pueden programar en
un equipo remoto, pero se deben cumplir las condiciones siguientes:

Debe tener permiso para programar la tarea. Como tal, debe iniciar sesión en el
equipo local con una cuenta que sea miembro del grupo Administradores en el
equipo remoto, o bien debe usar el parámetro /u para proporcionar las
credenciales de un administrador de este último equipo.

Puede usar el parámetro /u solamente cuando los equipos local y remoto están en
el mismo dominio, o si el equipo local está en un dominio en el que el dominio del
equipo remoto confía. De lo contrario, el equipo remoto no puede autenticar la
cuenta de usuario especificada y no puede comprobar que la cuenta sea miembro
del grupo Administradores.

La tarea debe tener permisos suficientes para ejecutarse en el equipo remoto. Los
permisos necesarios varían con la tarea. De forma predeterminada, la tarea se
ejecuta con el permiso del usuario actual del equipo local o, si se usa el parámetro
/u, dicha tarea se ejecuta con el permiso de la cuenta especificada por el
parámetro /u. Sin embargo, puede usar el parámetro /ru para ejecutar la tarea con
permisos de una cuenta de usuario diferente o con permisos del sistema.

Ejemplos
Para programar la aplicación MyApp (como administrador) para que se ejecute en
el equipo remoto SRV01 cada diez días y que empiece inmediatamente, escriba:

schtasks /create /s SRV01 /tn MyApp /tr c:\program


files\corpapps\myapp.exe /sc daily /mo 10

En este ejemplo se usa el parámetro /s para proporcionar el nombre del equipo


remoto. Dado que el usuario actual local es un administrador del equipo remoto,
el parámetro /u, que proporciona permisos alternativos para programar la tarea,
no es necesario.

7 Nota

Al programar tareas en un equipo remoto, todos los parámetros hacen


referencia a él. Por lo tanto, el archivo especificado por el parámetro /tr hace
referencia a la copia de MyApp.exe en el equipo remoto.

Para programar la aplicación MyApp (como usuario) para que se ejecute en el


equipo remoto SRV06 cada tres horas, escriba:

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

Dado que los permisos de administrador son necesarios para programar una tarea,
el comando usa los parámetros /u y /p para proporcionar las credenciales de la
cuenta de administrador del usuario (Admin01 en el dominio Reskits). De forma
predeterminada, estos permisos también se usan para ejecutar la tarea. Sin
embargo, dado que la tarea no necesita permisos de administrador para
ejecutarse, el comando incluye los parámetros /u y /rp para invalidar el valor
predeterminado y ejecutar la tarea con permiso de la cuenta que no es
administrador del usuario en el equipo remoto.

Para programar la aplicación MyApp (como usuario) para que se ejecute en el


equipo remoto SRV02 el último día de cada mes.
schtasks /create /s SRV02 /tn MyApp /tr c:\program
files\corpapps\myapp.exe /sc monthly /mo LASTDAY /m * /u
reskits\admin01

Dado que el usuario actual local (user03) no es un administrador del equipo


remoto, el comando usa el parámetro /u para proporcionar las credenciales de la
cuenta de administrador del usuario (Admin01 en el dominio Reskits). Los permisos
de la cuenta de administrador se usarán para programar y ejecutar la tarea.

Dado que el comando no incluía el parámetro /p (contraseña), schtasks solicita la


contraseña. A continuación, muestra un mensaje de operación correcta y, en este
caso, una advertencia:

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.

Esta advertencia indica que el dominio remoto no pudo autenticar la cuenta


especificada por el parámetro /u. En este caso, el dominio remoto no pudo
autenticar la cuenta de usuario porque el equipo local no es miembro de un
dominio en el que el dominio del equipo remoto confía. Cuando esto ocurre, el
trabajo de tarea aparece en la lista de tareas programadas, pero la tarea está
realmente vacía y no se ejecutará.

La siguiente visualización de una consulta detallada expone el problema con la


tarea. En la visualización, tenga en cuenta que el valor de Hora próxima ejecución
es Nunca y que el valor de Ejecutar como usuario es No se pudo obtener de la
base de datos del programador de tareas.

Si este equipo hubiera sido miembro del mismo dominio o de un dominio de


confianza, la tarea se habría programado correctamente y se habría ejecutado
según lo 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

Comentarios
Para ejecutar el comando /create con los permisos de un usuario diferente, use el
parámetro /u. El parámetro /u solo es válido para programar tareas en equipos
remotos.

Para ver más ejemplos de schtasks /create , escriba schtasks /create /? en un


símbolo del sistema.

Para programar una tarea para que se ejecute con permisos de otro usuario, use el
parámetro /ru. El parámetro /ru es válido para las tareas en equipos locales y
remotos.

Para usar el parámetro /u, el equipo local debe estar en el mismo dominio que el
equipo remoto o debe estar en un dominio en el que el dominio del equipo
remoto confía. De lo contrario, la tarea no se crea o el trabajo de la tarea está vacío
y la tarea no se ejecuta.

Schtasks siempre solicita una contraseña a menos que proporcione una, incluso
cuando programe una tarea en el equipo local mediante la cuenta de usuario
actual. Se trata de un comportamiento normal para schtasks.
Schtasks no comprueba las ubicaciones de los archivos de programa ni las
contraseñas de las cuentas de usuario. Si no escribe la ubicación de archivo
correcta o la contraseña correcta para la cuenta de usuario, la tarea se crea, pero
no se ejecutará. Además, si la contraseña de una cuenta cambia o expira y no se
cambia la contraseña guardada en la tarea, la tarea no se ejecutará.

La cuenta System no tiene derechos de inicio de sesión interactivo. Los usuarios no


ven los programas que se ejecutan con permisos del sistema y no pueden
interactuar con ellos.

Cada tarea ejecuta solo un programa. Sin embargo, puede crear un archivo por
lotes que inicie varias tareas y, a continuación, programar una tarea para ejecutar
dicho archivo.

Puede probar una tarea tan pronto como la cree. Use la operación de ejecución
para probar la tarea y, a continuación, compruebe el archivo SchedLgU.txt
(SystemRoot\SchedLgU.txt) para ver si hay errores.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando schtasks change

Comando schtasks delete

Comando schtasks end

Comando schtasks query

Comando schtasks run


schtasks delete
Artículo • 06/04/2023

Elimina una tarea programada de la programación. Este comando no elimina el


programa que la tarea ejecuta o interrumpe un programa en ejecución.

Sintaxis

schtasks /delete /tn {<taskname> | *} [/f] [/s <computer> [/u [<domain>\]


<user> [/p <password>]]]

Parámetros

Parámetro Descripción

/tn Identifica la tarea que se va a eliminar. Si usa el * , este comando elimina todas las
{<taskname> tareas programadas para el equipo, no sólo las tareas programadas por el usuario
| *} actual.

/f Suprime el mensaje de confirmación. La tarea se elimina sin advertencia.

/s Especifica el nombre o la dirección IP de un equipo remoto (con o sin barras


<computer> diagonales inversas). La opción predeterminada es el equipo local.

/u Ejecuta este comando con los permisos de la cuenta de usuario especificada. De


[<domain>] forma predeterminada, el comando se ejecuta con los permisos del usuario actual
del equipo local. La cuenta de usuario especificada debe ser miembro del grupo
Administradores en el equipo remoto. Los parámetros /u y /p son válidos solo
cuando se usa /s.

/p Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u. Si


<password> usa el parámetro /u sin el parámetro /p o el argumento password, schtasks le
pedirá una contraseña. Los parámetros /u y /p son válidos solo cuando se usa /s.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para eliminar la tarea Iniciar correo de la programación de un equipo remoto.
schtasks /delete /tn Start Mail /s Svr16

Este comando usa el parámetro /s para identificar el equipo remoto.

Para eliminar todas las tareas de la programación del equipo local, incluidas las tareas
programadas por otros usuarios.

schtasks /delete /tn * /f

Este comando usa el parámetro /tn * para representar todas las tareas del equipo y el
parámetro /f para suprimir el mensaje de confirmación.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando schtasks change

Comando schtasks create

Comando schtasks end

Comando schtasks query

Comando schtasks run


schtasks end
Artículo • 06/10/2023

Detiene solo las instancias de un programa iniciado por una tarea programada. Para
detener otros procesos, debe usar el comando TaskKill.

Sintaxis

schtasks /end /tn <taskname> [/s <computer> [/u [<domain>\]<user> [/p


<password>]]]

Parámetros

Parámetro Descripción

/tn Identifica la tarea que inició el programa. Este parámetro es obligatorio.


<taskname>

/s Especifica el nombre o la dirección IP de un equipo remoto (con o sin barras


<computer> diagonales inversas). La opción predeterminada es el equipo local.

/u Ejecuta este comando con los permisos de la cuenta de usuario especificada. De


[<domain>] forma predeterminada, el comando se ejecuta con los permisos del usuario actual
del equipo local. La cuenta de usuario especificada debe ser de un miembro del
grupo Administradores en el equipo remoto. Los parámetros /u y /p solo son
válidos cuando se usa /s.

/p Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u. Si


<password> usa el parámetro /u sin el parámetro /p o el argumento password, schtasks le
pedirá una contraseña. Los parámetros /u y /p solo son válidos cuando se usa /s.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para detener la instancia de Notepad.exe iniciada por la tarea My Notepad, escriba:

schtasks /end /tn "My Notepad"


Para detener la instancia de Internet Explorer iniciada por la tarea InternetOn en el
equipo remoto, Svr01, escriba:

schtasks /end /tn InternetOn /s Svr01

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando schtasks change

Comando schtasks create

Comando schtasks delete

Comando schtasks query

Comando schtasks run


schtasks query
Artículo • 14/10/2023

Enumera todas las tareas programadas para ejecutarse en el equipo.

Sintaxis

schtasks [/query] [/fo {TABLE | LIST | CSV}] [/nh] [/v] [/s <computer> [/u
[<domain>\]<user> [/p <password>]]] [/tn <taskname>] [/xml] [/hresult]

Parámetros

Parámetro Descripción

/query Opcionalmente, especifica el nombre de la operación. Al usarse esta consulta sin


ningún parámetro, se realiza una consulta de todas las tareas en el sistema.

/fo Especifica el formato de salida. Los valores válidos son TABLE, LIST o CSV.
<format>

/nh Quita los encabezados de columna de la presentación de la tabla. Este parámetro


es válido con los formatos de salida TABLE o CSV.

/v Agrega las propiedades avanzadas de la tarea a la presentación. Este parámetro es


válido con los formatos de salida LIST o CSV.

/s Especifica el nombre o la dirección IP de un equipo remoto (con o sin barras


<computer> diagonales inversas). La opción predeterminada es el equipo local.

/u Ejecuta este comando con los permisos de la cuenta de usuario especificada. De


[<domain>] forma predeterminada, el comando se ejecuta con los permisos del usuario actual
del equipo local. La cuenta de usuario especificada debe ser de un miembro del
grupo Administradores en el equipo remoto. Los parámetros /u y /p solo son
válidos cuando se usa /s.

/p Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u. Si


<password> usa el parámetro /u sin el parámetro /p o el argumento password, schtasks le
pedirá una contraseña. Los parámetros /u y /p solo son válidos cuando se usa /s.

/tn Consulta una tarea específica por ruta de acceso y nombre. No puede estar en
<taskname> blanco.

/xml Genera todas las definiciones de tarea en el sistema en formato XML. Si se


especifica /tn, genera el nombre de la tarea específica en formato XML. Se deben
usar la ruta de acceso completa y el nombre.
Parámetro Descripción

/hresult Especifica que el código de salida del proceso esté en formato HRESULT.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para enumerar todas las tareas programadas para el equipo local, escriba:

schtasks
schtasks /query

Estos comandos producen el mismo resultado y pueden usarse indistintamente.

Para solicitar una presentación detallada de las tareas en el equipo local, escriba:

schtasks /query /fo LIST /v

Este comando usa el parámetro /v para solicitar una presentación detallada (verbose) y
el parámetro /fo LIST para dar formato a la presentación como una lista para facilitar la
lectura. Puede usar este comando para verificar que una tarea que ha creado tiene el
patrón de periodicidad previsto.

Para solicitar una lista de tareas programadas para un equipo remoto y agregar las
tareas a un archivo de registro separado por comas en el equipo local, escriba:

schtasks /query /s Reskit16 /fo csv /nh >> \\svr01\data\tasklogs\p0102.csv

Puede usar este formato de comando para recopilar y realizar un seguimiento de las
tareas programadas para varios equipos. Este comando usa el parámetro /s para
identificar el equipo remoto, Reskit16, el parámetro /fo para especificar el formato y el
parámetro /nh para suprimir los encabezados de columna. El símbolo de anexión >>
redirige la salida al registro de tareas, p0102.csv, en el equipo local, Svr01. Dado que el
comando se ejecuta en el equipo remoto, la ruta de acceso al equipo local debe estar
completamente cualificada.
Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando schtasks change

Comando schtasks create

Comando schtasks delete

Comando schtasks end

Comando schtasks run


schtasks run
Artículo • 14/04/2023

Inicia inmediatamente una tarea programada. La operación run omite la programación,


pero usa la ubicación del archivo de programa, la cuenta de usuario y la contraseña
guardadas en la tarea para ejecutar la tarea inmediatamente. La ejecución de una tarea
no afecta a la programación de la tarea y no cambia la siguiente hora de ejecución
programada para la tarea.

Sintaxis

schtasks /run /tn <taskname> [/s <computer> [/u [<domain>\]<user> [/p


<password>]]]

Parámetros

Parámetro Descripción

/tn Identifica la tarea que se va a iniciar. Este parámetro es obligatorio.


<taskname>

/s Especifica el nombre o la dirección IP de un equipo remoto (con o sin barras


<computer> diagonales inversas). La opción predeterminada es el equipo local.

/u Ejecuta este comando con los permisos de la cuenta de usuario especificada. De


[<domain>] forma predeterminada, el comando se ejecuta con los permisos del usuario actual
del equipo local. La cuenta de usuario especificada debe ser de un miembro del
grupo Administradores en el equipo remoto. Los parámetros /u y /p solo son
válidos cuando se usa /s.

/p Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u. Si


<password> usa el parámetro /u sin el parámetro /p o el argumento password, schtasks le
pedirá una contraseña. Los parámetros /u y /p solo son válidos cuando se usa /s.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Use esta operación para probar las tareas. Si no se ejecuta una tarea, compruebe el
registro de transacciones del servicio de programador de tareas
<Systemroot>\SchedLgU.txt para comprobar si hay errores.

Para ejecutar una tarea de forma remota, la tarea debe programarse en el equipo
remoto. Al ejecutar la tarea, solo se ejecuta en el equipo remoto. Para comprobar
que una tarea se ejecuta en un equipo remoto, use el Administrador de tareas o el
registro de transacciones del servicio de programador de tareas,
<Systemroot>\SchedLgU.txt .

Ejemplos
Para iniciar la tarea Script de seguridad, escriba:

schtasks /run /tn Security Script

Para iniciar la tarea Actualizar en un equipo remoto, Svr01, escriba:

schtasks /run /tn Update /s Svr01

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando schtasks change

Comando schtasks create

Comando schtasks delete

Comando schtasks end

Comando schtasks query


scwcmd
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2 y
Windows Server 2012

La herramienta de línea de comandos Scwcmd.exe incluida con el Asistente de


configuración de seguridad (SCW) puede usarse para realizar las siguientes tareas:

Analizar uno o varios servidores con una directiva generada por SCW.

Configurar uno o varios servidores con una directiva generada por SCW.

Registrar una extensión de la Base de datos de configuración de seguridad con


SCW.

Revertir las directivas del SCW.

Transformar una directiva generada por SCW en archivos nativos compatibles con
la directiva de grupo.

Ver los resultados del análisis en formato HTML.

7 Nota

Si usa scwcmd para configurar, analizar o revertir una directiva en un servidor


remoto, SCW debe instalarse en el servidor remoto.

Sintaxis

scwcmd analyze
scwcmd configure
scwcmd register
scwcmd rollback
scwcmd transform
scwcmd view

Parámetros
Parámetro Descripción

scwcmd Determina si un equipo cumple una directiva.


analyze

scwcmd Aplica una directiva de seguridad generada por el SCW a un equipo.


configure

scwcmd Amplía o personaliza la base de datos de configuración de seguridad del SCW


register registrando un archivo de base de datos de configuración de seguridad que
contenga definiciones de roles, tareas, servicios o puertos.

scwcmd Aplica la directiva de reversión más reciente disponible y después elimina esa
rollback directiva de reversión.

scwcmd Transforma un archivo de directivas de seguridad generado mediante el uso de SCW


transform en un nuevo objeto de directiva de grupo (GPO) en Active Directory Domain
Services.

scwcmd Representa un archivo .xml mediante una transformación .xsl especificada.


view

Vínculos relacionados
Clave de sintaxis de línea de comandos
scwcmd analyze
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2 y
Windows Server 2012

Determina si un equipo cumple una directiva. Los resultados se devuelven en un archivo


.xml.

Este comando también acepta una lista de nombres de equipo como entrada. Para ver
los resultados en el explorador, use la vista scwcmd y especifique
%windir%\security\msscw\TransformFiles\scwanalysis.xsl como transformación .xsl.

Sintaxis

scwcmd analyze [[[/m:<computername> | /ou:<OuName>] /p:<policy>] | /i:


<computerlist>] [/o:<resultdir>] [/u:<username>] [/pw:<password>] [/t:
<threads>] [/l] [/e]

Parámetros

Parámetro Descripción

/m: <computername> Especifica el nombre NetBIOS, el nombre DNS o la dirección IP del equipo
que se va a analizar. Si se especifica el parámetro /m, se debe especificar
también el parámetro /p.

/ou: <OuName> Especifica el nombre de dominio completo (FQDN) de una unidad


organizativa (OU) en Active Directory Domain Services. Si se especifica el
parámetro /ou, se debe especificar también el parámetro /p. Todos los
equipos de la unidad organizativa se analizarán con la directiva especificada.

/p: <policy> Especifica la ruta de acceso y el nombre del archivo de directiva .xml que se
usará para realizar el análisis.

/i: <computerlist> Especifica la ruta de acceso y el nombre de archivo de un archivo .xml que
contiene una lista de equipos junto con sus archivos de directiva esperados.
Todos los equipos del archivo .xml se analizarán con respecto a sus archivos
de directiva correspondientes. Un archivo .xml de ejemplo es
%windir%\security\SampleMachineList.xml .
Parámetro Descripción

/o: <resultdir> Especifica la ruta de acceso y el directorio donde se deben guardar los
archivos de resultados del análisis. El valor predeterminado es el directorio
actual.

/u: <username> Especifica una credencial de usuario alternativa que se usará al realizar el
análisis en un equipo remoto. El valor predeterminado es el usuario que ha
iniciado sesión.

/pw: <password> Especifica una credencial de usuario alternativa que se usará al realizar el
análisis en un equipo remoto. El valor predeterminado es la contraseña del
usuario que ha iniciado sesión.

/t: <threads> Especifica el número de operaciones de análisis pendientes simultáneas que


se deben mantener durante el análisis. El intervalo de valores es de 1 a 1000,
con un valor predeterminado de 40.

/l Hace que se registre el proceso de análisis. Se generará un archivo de


registro para cada equipo que se va a analizar. Los archivos de registro se
almacenarán en el mismo directorio que los archivos de resultados. Use la
opción /o para especificar el directorio de los archivos de resultados.

/e Registre un evento en el registro de eventos de aplicación si se encuentra un


error de coincidencia.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para analizar una directiva de seguridad con respecto al archivo webpolicy.xml, escriba:

scwcmd analyze /p:webpolicy.xml

Para analizar una directiva de seguridad en el equipo denominado webserver con


respecto al archivo webpolicy.xml mediante las credenciales de la cuenta webadmin,
escriba:

scwcmd analyze /m:webserver /p:webpolicy.xml /u:webadmin

Para analizar una directiva de seguridad con respecto al archivo webpolicy.xml, con un
máximo de 100 subprocesos y generar los resultados en un archivo denominado results
en el recurso compartido resultserver, escriba:

scwcmd analyze /i:webpolicy.xml /t:100 /o:\\resultserver\results

Para analizar una directiva de seguridad para la unidad organizativa WebServers con
respecto al archivo webpolicy.xml mediante las credenciales DomainAdmin, escriba:

scwcmd analyze /ou:OU=WebServers,DC=Marketing,DC=ABCCompany,DC=com


/p:webpolicy.xml /u:DomainAdmin

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando scwcmd configure

Comando scwcmd register

Comando scwcmd rollback

Comando scwcmd transform

Comando scwcmd view


scwcmd configure
Artículo • 17/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2 y
Windows Server 2012

Aplica una directiva de seguridad generada por el Asistente para configuración de


seguridad (SCW) a un equipo. Esta herramienta de línea de comandos también acepta
una lista de nombres de equipo como entrada.

Sintaxis

scwcmd configure [[[/m:<computername> | /ou:<OuName>] /p:<policy>] | /i:


<computerlist>] [/u:<username>] [/pw:<password>] [/t:<threads>]

Parámetros

Parámetro Descripción

/m: <computername> Especifica el nombre NetBIOS, el nombre DNS o la dirección IP del equipo
que se va a configurar. Si se especifica el parámetro /m, se debe especificar
también el parámetro /p.

/ou: <OuName> Especifica el nombre de dominio completo (FQDN) de una unidad


organizativa (UO) en Active Directory Domain Services. Si se especifica el
parámetro /ou, se debe especificar también el parámetro /p. Todos los
equipos de la unidad organizativa se configurarán con respecto a la directiva
especificada.

/p: <policy> Especifica la ruta de acceso y el nombre de archivo del archivo de directiva
de .xml que se va a usar para realizar la configuración.

/i: <computerlist> Especifica la ruta de acceso y el nombre de archivo de un archivo .xml que
contiene una lista de equipos junto con sus archivos de directiva esperados.
Todos los equipos del archivo .xml se analizarán con respecto a sus archivos
de directiva correspondientes. Un archivo .xml de ejemplo es
%windir%\security\SampleMachineList.xml .

/u: <username> Especifica una credencial de usuario alternativa que se usará al realizar la
configuración en un equipo remoto. El valor predeterminado es el usuario
que ha iniciado sesión.
Parámetro Descripción

/pw: <password> Especifica una credencial de usuario alternativa que se usará al realizar la
configuración en un equipo remoto. El valor predeterminado es la
contraseña del usuario que ha iniciado sesión.

/t: <threads> Especifica el número de operaciones de configuración pendientes


simultáneas que se deben mantener durante el análisis. El intervalo de
valores es de 1 a 1000, con un valor predeterminado de 40.

/l Hace que se registre el proceso de análisis. Se generará un archivo de


registro para cada equipo que se va a analizar. Los archivos de registro se
almacenarán en el mismo directorio que los archivos de resultados. Use la
opción /o para especificar el directorio de los archivos de resultados.

/e Registre un evento en el registro de eventos de aplicación si se encuentra un


error de coincidencia.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para configurar una directiva de seguridad con respecto al archivo webpolicy.xml,
escriba:

scwcmd configure /p:webpolicy.xml

Para configurar una directiva de seguridad para el equipo en 172.16.0.0 con respecto al
archivo webpolicy.xml mediante las credenciales de la cuenta webadmin, escriba:

scwcmd configure /m:172.16.0.0 /p:webpolicy.xml /u:webadmin

Para configurar una directiva de seguridad en todos los equipos de la lista


campusmachines.xml con un máximo de 100 subprocesos, escriba:

scwcmd configure /i:campusmachines.xml /t:100

Para configurar una directiva de seguridad para la unidad organizativa WebServers con
respecto al archivo webpolicy.xml mediante las credenciales DomainAdmin, escriba:
scwcmd configure /ou:OU=WebServers,DC=Marketing,DC=ABCCompany,DC=com
/p:webpolicy.xml /u:DomainAdmin

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando scwcmd analyze

Comando scwcmd register

Comando scwcmd rollback

Comando scwcmd transform

Comando scwcmd view


scwcmd register
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2 y
Windows Server 2012

Extiende o personaliza la base de datos de configuración de seguridad del Asistente


para configuración de seguridad (SCW) registrando un archivo de base de datos de
configuración de seguridad que contiene definiciones de rol, tarea, servicio o puerto.

Sintaxis

scwcmd register /kbname:<MyApp> [/kbfile:<kb.xml>] [/kb:<path>] [/d]

Parámetros

Parámetro Descripción

/kbname: <MyApp> Especifica el nombre con el que se registrará la extensión base de datos de
configuración de seguridad. Debe especificarse este parámetro.

/kbfile: <kb.xml> Especifica la ruta de acceso y el nombre de archivo del archivo de base de
datos de configuración de seguridad que se usa para extender o personalizar
la base de datos de configuración de seguridad. Para validar que el archivo de
base de datos de configuración de seguridad es compatible con el esquema
SCW, use el archivo de definición de esquema
%windir%\security\KBRegistrationInfo.xsd . Esta opción debe proporcionarse
a menos que se especifique el parámetro /d.

/kb: <path> Especifica la ruta de acceso al directorio que contiene los archivos de base de
datos de configuración de seguridad de SCW que se van a actualizar. Si no se
especifica esta opción, se usa %windir%\security\msscw\kbs .

/d Anula el registro de una extensión de base de datos de configuración de


seguridad de la base de datos de configuración de seguridad. La extensión
para anular el registro se especifica mediante el parámetro /kbname. (No se
debe especificar el parámetro /kbfile). La base de datos de configuración de
seguridad de la que se va a anular el registro de la extensión se especifica
mediante el parámetro /kb.

/? Muestra la ayuda en el símbolo del sistema.


Ejemplos
Para registrar el archivo de base de datos de configuración de seguridad denominado
SCWKBForMyApp.xml bajo el nombre MyApp en la ubicación \\kbserver\kb , escriba:

scwcmd register /kbfile:d:\SCWKBForMyApp.xml /kbname:MyApp /kb:\\kbserver\kb

Para anular el registro de la base de datos de configuración de seguridad MyApp,


ubicada en \\kbserver\kb , escriba:

scwcmd register /d /kbname:MyApp /kb:\\kbserver\kb

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando scwcmd analyze

Comando scwcmd configure

Comando scwcmd rollback

Comando scwcmd transform

Comando scwcmd view


scwcmd rollback
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2 y
Windows Server 2012

Aplica la directiva de reversión más reciente disponible y, a continuación, elimina esa


directiva de reversión.

Sintaxis

scwcmd rollback /m:<computername> [/u:<username>] [/pw:<password>]

Parámetros

Parámetro Descripción

/m: <computername> Especifica el nombre NetBIOS, el nombre DNS o la dirección IP de un equipo


donde se debe realizar la operación de reversión.

/u: <username> Especifica una cuenta de usuario alternativa que se usará al realizar una
reversión remota. El valor predeterminado es el usuario que ha iniciado
sesión.

/pw: <password> Especifica una credencial de usuario alternativa que se usará al realizar una
reversión remota. El valor predeterminado es el usuario que ha iniciado
sesión.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para revertir la directiva de seguridad en un equipo en la dirección IP 172.16.0.0, escriba:

scwcmd rollback /m:172.16.0.0


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando scwcmd analyze

Comando scwcmd configure

Comando scwcmd register

Comando scwcmd transform

Comando scwcmd view


scwcmd transform
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2 y
Windows Server 2012

Transforma un archivo de directivas de seguridad generado usando el Asistente de


configuración de seguridad (SCW) en un nuevo Objeto de directiva de grupo (GPO) en
Active Directory Domain Services. La operación de transformación no cambia ninguna
configuración en el servidor donde se realiza. Una vez completada la operación de
transformación, un administrador debe vincular el GPO a las unidades organizativas
deseadas para implementar la directiva en los servidores.

) Importante

Se necesitan credenciales de administrador de dominio para completar la


operación de transformación.

La configuración de la directiva de seguridad de Internet Information Services (IIS)


no se puede implementar mediante directiva de grupo.

Las directivas de firewall que enumeran las aplicaciones aprobadas no deben


implementarse en los servidores a menos que el servicio de Firewall de Windows se
haya iniciado automáticamente la última vez que se arrancó el servidor.

Sintaxis

scwcmd transform /p:<policyfile.xml> /g:<GPOdisplayname>

Parámetros

Parámetro Descripción

/p: <policyfile.xml> Especifica la ruta de acceso y el nombre del archivo de directiva de .xml
que se deben aplicar. Este parámetro debe especificarse.
Parámetro Descripción

/g: <GPOdisplayname> Especifica el nombre para mostrar del GPO. Este parámetro debe
especificarse.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para crear un GPO denominado FileServerSecurity a partir de un archivo denominado
FileServerPolicy.xml, escriba:

scwcmd transform /p:FileServerPolicy.xml /g:FileServerSecurity

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando scwcmd analyze

Comando scwcmd configure

Comando scwcmd register

Comando scwcmd rollback

Comando scwcmd view


scwcmd view
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2012 R2 y
Windows Server 2012

Representa un archivo .xml mediante una transformación .xsl especificada. Este


comando puede ser útil para mostrar archivos .xml del Asistente para configuración de
seguridad (SCW) mediante diferentes vistas.

Sintaxis

scwcmd view /x:<Xmlfile.xml> [/s:<Xslfile.xsl>]

Parámetros

Parámetro Descripción

/x: <Xmlfile.xml> Especifica el archivo .xml que se va a ver. Este parámetro debe especificarse.

/s: <Xslfile.xsl> Especifica la transformación .xsl que se va a aplicar al archivo .xml como parte
del proceso de representación. Este parámetro es opcional para los archivos
.xml de SCW. Cuando el comando view se usa para representar un archivo
.xml de SCW, intentará cargar automáticamente la transformación
predeterminada correcta para el archivo .xml especificado. Si se especifica una
transformación .xsl, dicha transformación debe escribirse bajo la suposición de
que el archivo .xml se encuentra en el mismo directorio que la transformación
.xsl.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplo
Para ver Policyfile.xml mediante la transformación Policyview.xsl, escriba:

scwcmd view /x:C:\policies\Policyfile.xml /s:C:\viewers\Policyview.xsl


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando scwcmd analyze

Comando scwcmd configure

Comando scwcmd register

Comando scwcmd rollback

Comando scwcmd transform


Comandos secedit
Artículo • 08/04/2023

Configura y analiza la seguridad del sistema comparando su configuración de seguridad


actual con las plantillas de seguridad especificadas.

7 Nota

Microsoft Management Console (MMC) y el complemento Configuración y análisis


de seguridad no están disponibles en Server Core.

Sintaxis

secedit /analyze
secedit /configure
secedit /export
secedit /generaterollback
secedit /import
secedit /validate

Parámetros

Parámetro Descripción

secedit /analyze Le permite analizar la configuración actual de los sistemas comparándola con
la configuración de referencia almacenada en una base de datos. Los
resultados del análisis se almacenan en un área independiente de la base de
datos y se pueden ver en el complemento Configuración y análisis de
seguridad.

secedit Permite configurar un sistema con valores de seguridad almacenados en una


/configure base de datos.

secedit /export Permite exportar la configuración de seguridad almacenada en una base de


datos.

secedit Permite generar una plantilla de reversión con respecto a una plantilla de
/generaterollback configuración.
Parámetro Descripción

secedit /import Permite importar una plantilla de seguridad en una base de datos para que la
configuración especificada en la plantilla se pueda aplicar a un sistema o
analizarla en un sistema.

secedit /validate Permite validar la sintaxis de una plantilla de seguridad.

Comentarios
Si no se especifica ninguna ruta de acceso de archivo, todos los nombres de
archivo tendrán como valor predeterminado el directorio actual.

Los resultados del análisis se almacenan en un área independiente de la base de


datos y se pueden ver en el complemento Configuración y análisis de seguridad en
MMC.

Si las plantillas de seguridad se crean mediante el complemento Plantilla de


seguridad y, si ejecuta el complemento Configuración y análisis de seguridad en
esas plantillas, se crean los siguientes archivos:

Archivo Descripción

scesrv.log Ubicación: %windir%\security\logs


Creado por: Sistema operativo
Tipo de archivo: Texto
Frecuencia de actualización: Se sobrescribe cuando se ejecuta
secedit analyze , secedit configure , secedit export o secedit
import .
Contenido: Contiene los resultados del análisis agrupado por tipo de
directiva.

nombre- Ubicación: %windir%\<user account>\Documents\Security\Database


seleccionado- Creado por: Ejecución del complemento Configuración y análisis de
por-el- seguridad
usuario.sdb Tipo de archivo: Propietario
Frecuencia de actualización: Se actualiza cada vez que se crea una
nueva plantilla de seguridad.
Contenido: Directivas de seguridad locales y plantillas de seguridad
creadas por el usuario.
Archivo Descripción

nombre- Ubicación: Definido por el usuario, pero tiene como valor


seleccionado- predeterminado %windir%\<user account>\Documents\Security\Logs
por-el- Creado por: Ejecución de los comandos secedit analyze o secedit
usuario.log configure , o usando el complemento Configuración y análisis de
seguridad.
Tipo de archivo: Texto
Frecuencia de actualización: Se sobrescribe al ejecutar secedit
analyze o secedit configure , o al usar el complemento
Configuración y análisis de seguridad.
Contenido: Nombre del archivo de registro, fecha y hora, y los
resultados del análisis o la investigación.

nombre- Ubicación: %windir%\*<user account>\Documents\Security\Templates


seleccionado- Creado por: Ejecución del complemento Plantilla de seguridad.
por-el- Tipo de archivo: Texto
usuario.inf Frecuencia de actualización: Se sobrescribe cada vez que se actualiza
la plantilla de seguridad.
Contenido: Contiene la información de configuración de la plantilla
para cada directiva seleccionada mediante el complemento.

Vínculos relacionados
Clave de sintaxis de línea de comandos
secedit /analyze
Artículo • 06/04/2023

Le permite analizar la configuración actual de los sistemas comparándola con la


configuración de referencia almacenada en una base de datos.

Sintaxis

secedit /analyze /db <database file name> [/cfg <configuration file name>]
[/overwrite] [/log <log file name>] [/quiet}]

Parámetros

Parámetro Descripción

/db Necesario. Especifica la ruta de acceso y el nombre del archivo de la base de datos
que contiene la configuración almacenada con la que se realiza el análisis. Si el
nombre de archivo especifica una base de datos que no tiene una plantilla de
seguridad (representada por el archivo de configuración) asociada, también se debe
especificar la opción /cfg <configuration file name> .

/cfg Especifica la ruta de acceso y el nombre de archivo de la plantilla de seguridad que


se importarán en la base de datos para su análisis. Esta opción solo es válida si se
usa con el parámetro /db <database file name> . Si no se especifica este parámetro,
el análisis se realiza en cualquier configuración ya almacenada en la base de datos.

/overwrite Especifica si la plantilla de seguridad del parámetro /cfg debe sobrescribir cualquier
plantilla o plantilla compuesta que esté almacenada en la base de datos, en lugar de
anexar los resultados a la plantilla almacenada. Esta opción solo es válida si también
se usa el parámetro /cfg <configuration file name> . Si no se especifica también
este parámetro, la plantilla del parámetro /cfg se anexa a la plantilla almacenada.

/log Especifica la ruta de acceso y el nombre del archivo de registro que se van a usar en
el proceso. Si no especifica una ubicación para el archivo, se usará el archivo de
registro predeterminado, <systemroot>\Documents and Settings\<UserAccount>\My
Documents\Security\Logs\<databasename>.log .

/quiet Suprime la salida de la pantalla. Puede seguir viendo los resultados del análisis
usando el complemento Configuración y análisis de seguridad de Microsoft
Management Console (MMC).
Ejemplos
Para realizar el análisis de los parámetros de seguridad en la base de datos de
seguridad, SecDbContoso.sdb, y después dirigir la salida al archivo
SecAnalysisContosoFY11, incluyendo indicaciones para verificar que el comando se
ejecutó correctamente, escriba:

secedit /analyze /db C:\Security\FY11\SecDbContoso.sdb /log


C:\Security\FY11\SecAnalysisContosoFY11.log

Para incorporar los cambios requeridos por el proceso de análisis en el archivo


SecContoso.inf y después dirigir la salida al archivo existente, SecAnalysisContosoFY11,
sin preguntar, escriba:

secedit /analyze /db C:\Security\FY11\SecDbContoso.sdb /cfg SecContoso.inf


/overwrite /log C:\Security\FY11\SecAnalysisContosoFY11.xml /quiet

Vínculos relacionados
Clave de sintaxis de línea de comandos

secedit /configure

secedit /export

secedit /generaterollback

secedit /import

secedit /validate
secedit /configure
Artículo • 06/04/2023

Permite configurar las opciones del sistema actuales mediante la configuración de


seguridad almacenada en una base de datos.

Sintaxis

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 Descripción

/db Necesario. Especifica la ruta de acceso y el nombre de archivo de la base de datos


que contiene la configuración almacenada. Si el nombre de archivo especifica una
base de datos que no tiene una plantilla de seguridad (representada por el archivo
de configuración) asociada, también se debe especificar la opción /cfg
<configuration file name> .

/cfg Especifica la ruta de acceso y el nombre de archivo de la plantilla de seguridad que


se importarán en la base de datos para su análisis. Esta opción solo es válida si se
usa con el parámetro /db <database file name> . Si no se especifica este parámetro,
el análisis se realiza en cualquier configuración ya almacenada en la base de datos.

/overwrite Especifica si la plantilla de seguridad del parámetro /cfg debe sobrescribir cualquier
plantilla o plantilla compuesta que esté almacenada en la base de datos, en lugar de
anexar los resultados a la plantilla almacenada. Esta opción solo es válida si también
se usa el parámetro /cfg <configuration file name> . Si no se especifica también
este parámetro, la plantilla del parámetro /cfg se anexa a la plantilla almacenada.
Parámetro Descripción

/areas Especifica las áreas de seguridad que se aplicarán al sistema. Si no se especifica este
parámetro, todas las opciones de seguridad definidas en la base de datos se aplican
al sistema. Para configurar varias áreas, separe cada área por un espacio. Se admiten
las siguientes áreas de seguridad:
securitypolicy: Directiva local y directiva de dominio para el sistema, incluidas
las directivas de cuentas, las directivas de auditoría, las opciones de
seguridad, etc.
group_mgmt: Configuración de grupo restringido para los grupos
especificados en la plantilla de seguridad.
user_rights: Derechos de inicio de sesión de usuario y concesión de
privilegios.
regkeys: Seguridad en las claves del Registro local.
filestore: Seguridad en el almacenamiento de archivos local.
services: Seguridad para todos los servicios definidos.

/log Especifica la ruta de acceso y el nombre del archivo de registro que se van a usar en
el proceso. Si no especifica una ubicación para el archivo, se usará el archivo de
registro predeterminado, <systemroot>\Documents and Settings\<UserAccount>\My
Documents\Security\Logs\<databasename>.log .

/quiet Suprime la salida de la pantalla y del registro. Puede seguir viendo los resultados del
análisis usando el complemento Configuración y análisis de seguridad de Microsoft
Management Console (MMC).

Ejemplos
Para realizar el análisis de los parámetros de seguridad en la base de datos de
seguridad, SecDbContoso.sdb, y después dirigir la salida al archivo
SecAnalysisContosoFY11, incluyendo indicaciones para verificar que el comando se
ejecutó correctamente, escriba:

secedit /analyze /db C:\Security\FY11\SecDbContoso.sdb /log


C:\Security\FY11\SecAnalysisContosoFY11.log

Para incorporar los cambios requeridos por el proceso de análisis en el archivo


SecContoso.inf y después dirigir la salida al archivo existente, SecAnalysisContosoFY11,
sin preguntar, escriba:
secedit /configure /db C:\Security\FY11\SecDbContoso.sdb /cfg SecContoso.inf
/overwrite /log C:\Security\FY11\SecAnalysisContosoFY11.xml /quiet

Vínculos relacionados
Clave de sintaxis de línea de comandos

secedit /analyze

secedit /export

secedit /generaterollback

secedit /import

secedit /validate
secedit /export
Artículo • 14/04/2023

Exporta la configuración de seguridad almacenada en una base de datos configurada


con plantillas de seguridad. Puede usar este comando para realizar una copia de
seguridad de las directivas de seguridad en un equipo local, además de importar la
configuración a otro equipo.

Sintaxis

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 Descripción

/db Necesario. Especifica la ruta de acceso y el nombre de archivo de la base de


datos que contiene la configuración almacenada en la que se realiza la
exportación. Si el nombre de archivo especifica una base de datos que no tiene
una plantilla de seguridad (representada por el archivo de configuración)
asociada, también se debe especificar la opción /cfg <configuration file
name> .

/mergedpolicy Combina y exporta la configuración de seguridad de dominio y directiva local.

/cfg Necesario. Especifica la ruta de acceso y el nombre de archivo de la plantilla de


seguridad que se importarán en la base de datos para su análisis. Esta opción
solo es válida si se usa con el parámetro /db <database file name> . Si no se
especifica este parámetro, el análisis se realiza en cualquier configuración ya
almacenada en la base de datos.
Parámetro Descripción

/areas Especifica las áreas de seguridad que se aplicarán al sistema. Si no se especifica


este parámetro, todas las opciones de seguridad definidas en la base de datos se
aplican al sistema. Para configurar varias áreas, separe cada área por un espacio.
Se admiten las siguientes áreas de seguridad:
securitypolicy: Directiva local y directiva de dominio para el sistema,
incluidas las directivas de cuentas, las directivas de auditoría, las opciones
de seguridad, etc.
group_mgmt: Configuración de grupo restringido para los grupos
especificados en la plantilla de seguridad.
user_rights: Derechos de inicio de sesión de usuario y concesión de
privilegios.
regkeys: Seguridad en las claves del Registro local.
filestore: Seguridad en el almacenamiento de archivos local.
services: Seguridad para todos los servicios definidos.

/log Especifica la ruta de acceso y el nombre del archivo de registro que se van a usar
en el proceso. Si no especifica una ubicación para el archivo, se usará el archivo
de registro predeterminado, <systemroot>\Documents and Settings\
<UserAccount>\My Documents\Security\Logs\<databasename>.log .

/quiet Suprime la salida de la pantalla y del registro. Puede seguir viendo los resultados
del análisis usando el complemento Configuración y análisis de seguridad de
Microsoft Management Console (MMC).

Ejemplos
Para exportar la base de datos de seguridad y las directivas de seguridad del dominio a
un archivo .inf, y después importar ese archivo a una base de datos diferente para
replicar la configuración de las directivas de seguridad en otro equipo, escriba:

secedit /export /db C:\Security\FY11\SecDbContoso.sdb /mergedpolicy /cfg


SecContoso.inf /log C:\Security\FY11\SecAnalysisContosoFY11.log /quiet

Para importar el archivo de ejemplo a una base de datos diferente en otro equipo,
escriba:

secedit /import /db C:\Security\FY12\SecDbContoso.sdb /cfg SecContoso.inf


/log C:\Security\FY11\SecAnalysisContosoFY12.log /quiet
Vínculos relacionados
Clave de sintaxis de línea de comandos

secedit /analyze

secedit /configure

secedit /generaterollback

secedit /import

secedit /validate
secedit /generaterollback
Artículo • 06/04/2023

Permite generar una plantilla de reversión para una plantilla de configuración


especificada. Si existe una plantilla de reversión existente, al volver a ejecutar este
comando, se sobrescribirá la información existente.

La ejecución correcta de este comando registra las discrepancias entre la plantilla de


seguridad especificada y la configuración de directiva de seguridad en el archivo
scesrv.log.

Sintaxis

secedit /generaterollback /db <database file name> /cfg <configuration file


name> /rbk <rollback template file name> [/log <log file name>] [/quiet]

Parámetros

Parámetro Descripción

/db Necesario. Especifica la ruta de acceso y el nombre del archivo de la base de datos
que contiene la configuración almacenada con la que se realiza el análisis. Si el
nombre de archivo especifica una base de datos que no tiene una plantilla de
seguridad (representada por el archivo de configuración) asociada, también se debe
especificar la opción /cfg <configuration file name> .

/cfg Necesario. Especifica la ruta de acceso y el nombre de archivo de la plantilla de


seguridad que se importarán en la base de datos para su análisis. Esta opción solo
es válida si se usa con el parámetro /db <database file name> . Si no se especifica
este parámetro, el análisis se realiza en cualquier configuración ya almacenada en la
base de datos.

/rbk Necesario. Especifica una plantilla de seguridad en la que se escribe la información


de reversión. Las plantillas de seguridad se crean mediante el complemento
Plantillas de seguridad. Los archivos de reversión se pueden crear con este
comando.

/log Especifica la ruta de acceso y el nombre del archivo de registro que se van a usar en
el proceso. Si no especifica una ubicación para el archivo, se usará el archivo de
registro predeterminado, <systemroot>\Documents and Settings\<UserAccount>\My
Documents\Security\Logs\<databasename>.log .
Parámetro Descripción

/quiet Suprime la salida de la pantalla y del registro. Puede seguir viendo los resultados del
análisis usando el complemento Configuración y análisis de seguridad de Microsoft
Management Console (MMC).

Ejemplos
Para crear el archivo de configuración de reversión para el archivo SecTmplContoso.inf
creado anteriormente, mientras guarda la configuración original, y después escribir la
acción en el archivo de registro SecAnalysisContosoFY11, escriba:

secedit /generaterollback /db C:\Security\FY11\SecDbContoso.sdb /cfg


sectmplcontoso.inf /rbk sectmplcontosoRBK.inf /log
C:\Security\FY11\SecAnalysisContosoFY11.log

Vínculos relacionados
Clave de sintaxis de línea de comandos

secedit /analyze

secedit /configure

secedit /export

secedit /import

secedit /validate
secedit /import
Artículo • 06/04/2023

Importa la configuración de seguridad (archivo .inf), exportada previamente desde la


base de datos configurada con plantillas de seguridad.

) Importante

Antes de importar un archivo .inf a otro equipo, debe ejecutar el comando secedit
/generaterollback en la base de datos en la que se realizará la importación.

También debe ejecutar el comando secedit /validate en el archivo de importación


para verificar su integridad.

Sintaxis

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 Descripción

/db Necesario. Especifica la ruta de acceso y el nombre de archivo de la base de datos


que contiene la configuración almacenada con la que se realiza la importación. Si el
nombre de archivo especifica una base de datos que no tiene una plantilla de
seguridad (representada por el archivo de configuración) asociada, también se debe
especificar la opción /cfg <configuration file name> .

/overwrite Especifica si la plantilla de seguridad del parámetro /cfg debe sobrescribir cualquier
plantilla o plantilla compuesta que esté almacenada en la base de datos, en lugar de
anexar los resultados a la plantilla almacenada. Esta opción solo es válida si también
se usa el parámetro /cfg <configuration file name> . Si no se especifica también
este parámetro, la plantilla del parámetro /cfg se anexa a la plantilla almacenada.
Parámetro Descripción

/cfg Necesario. Especifica la ruta de acceso y el nombre de archivo de la plantilla de


seguridad que se importarán en la base de datos para su análisis. Esta opción solo
es válida si se usa con el parámetro /db <database file name> . Si no se especifica
este parámetro, el análisis se realiza en cualquier configuración ya almacenada en la
base de datos.

/areas Especifica las áreas de seguridad que se aplicarán al sistema. Si no se especifica este
parámetro, todas las opciones de seguridad definidas en la base de datos se aplican
al sistema. Para configurar varias áreas, separe cada área por un espacio. Se admiten
las siguientes áreas de seguridad:
securitypolicy: Directiva local y directiva de dominio para el sistema, incluidas
las directivas de cuentas, las directivas de auditoría, las opciones de
seguridad, etc.
group_mgmt: Configuración de grupo restringido para los grupos
especificados en la plantilla de seguridad.
user_rights: Derechos de inicio de sesión de usuario y concesión de
privilegios.
regkeys: Seguridad en las claves del Registro local.
filestore: Seguridad en el almacenamiento de archivos local.
services: Seguridad para todos los servicios definidos.

/log Especifica la ruta de acceso y el nombre del archivo de registro que se van a usar en
el proceso. Si no especifica una ubicación para el archivo, se usará el archivo de
registro predeterminado, <systemroot>\Documents and Settings\<UserAccount>\My
Documents\Security\Logs\<databasename>.log .

/quiet Suprime la salida de la pantalla y del registro. Puede seguir viendo los resultados del
análisis usando el complemento Configuración y análisis de seguridad de Microsoft
Management Console (MMC).

Ejemplos
Para exportar la base de datos de seguridad y las directivas de seguridad del dominio a
un archivo .inf, y después importar ese archivo a una base de datos diferente para
replicar la configuración de las directivas en otro equipo, escriba:

secedit /export /db C:\Security\FY11\SecDbContoso.sdb /mergedpolicy /cfg


NetworkShare\Policies\SecContoso.inf /log
C:\Security\FY11\SecAnalysisContosoFY11.log /quiet

Para importar solo la parte de directivas de seguridad del archivo a una base de datos
diferente en otro equipo, escriba:
secedit /import /db C:\Security\FY12\SecDbContoso.sdb /cfg
NetworkShare\Policies\SecContoso.inf /areas securitypolicy /log
C:\Security\FY11\SecAnalysisContosoFY12.log /quiet

Vínculos relacionados
Clave de sintaxis de línea de comandos

secedit /analyze

secedit /configure

secedit /export

secedit /generaterollback

secedit /validate
secedit /validate
Artículo • 14/04/2023

Valida la configuración de seguridad almacenada en una plantilla de seguridad (archivo


.inf). La validación de plantillas de seguridad puede ayudarle a determinar si una está
dañada o establecida de forma inapropiada. No se aplican plantillas de seguridad
dañadas o establecidas incorrectamente.

Sintaxis

secedit /validate <configuration file name>

Parámetros

Parámetro Descripción

<configuration Necesario. Especifica la ruta de acceso y el nombre de archivo de la plantilla de


file name> seguridad que se validará. Este comando no actualiza los archivos de registro.

Ejemplos
Para comprobar que el archivo .inf de reversión, secRBKcontoso.inf, sigue siendo válido
después de la reversión, escriba:

secedit /validate secRBKcontoso.inf

Vínculos relacionados
Clave de sintaxis de línea de comandos

secedit /analyze

secedit /configure

secedit /export
secedit /generaterollback

secedit /import
Comandos select
Artículo • 06/04/2023

Desplaza el foco a un disco, partición, volumen o disco duro virtual (VHD).

Sintaxis

select disk
select partition
select vdisk
select volume

Parámetros

Parámetro Descripción

Select disk Desplaza el foco a un disco.

Select partition Desplaza el foco a una partición.

Select vdisk Desplaza el foco a un VHD.

Select volume Desplaza el foco a un volumen.

Comentarios
Si se selecciona un volumen con una partición correspondiente, la partición se
seleccionará automáticamente.

Si se selecciona una partición con un volumen correspondiente, el volumen se


seleccionará automáticamente.

Vínculos relacionados
Clave de sintaxis de línea de comandos
select disk
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Selecciona el disco especificado y cambia el foco a ese disco.

Sintaxis

select disk={<n>|<disk path>|system|next}

Parámetros

Parámetro Descripción

<n> Especifica el número del disco que va a recibir el foco. Puede ver los números de
todos los discos del equipo mediante el comando list disk en DiskPart.

NOTA:
Al configurar sistemas con varios discos, no use select disk=0 para especificar el
disco del sistema. El equipo puede reasignar números de disco al reiniciar y los
distintos equipos con la misma configuración de disco pueden tener números de
disco diferentes.

<disk Especifica la ubicación del disco que va a recibir el foco, por ejemplo,
path> PCIROOT(0)#PCI(0F02)#atA(C00T00L00) . Para ver la ruta de acceso de ubicación de un
disco, selecciónela y escriba detail disk.

sistema En los equipos BIOS, esta opción especifica que el disco 0 recibe el foco. En los
equipos EFI, el disco que contiene la partición del sistema EFI (ESP), que se usa para
el arranque actual, recibe el foco. En los equipos EFI, se producirá un error en el
comando si no hay ESP, si hay más de un ESP o si el equipo se inicia desde el
Entorno de preinstalación de Windows (Windows PE).

Siguiente Una vez seleccionado un disco, esta opción recorre en iteración todos los discos de
la lista de discos. Al ejecutar esta opción, el siguiente disco de la lista recibe el foco.

Ejemplos
Para cambiar el foco al disco 1, escriba:

select disk=1

Para seleccionar un disco mediante su ruta de acceso de ubicación, escriba:

select disk=PCIROOT(0)#PCI(0100)#atA(C00T00L01)

Para desplazar el foco al disco del sistema, escriba:

select disk=system

Para desplazar el foco al siguiente disco del equipo, escriba:

select disk=next

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando select partition

Comando select vdisk

Comando select volume


select partition
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Selecciona la partición especificada y desplaza el foco hacia ella. Este comando también
se puede usar para mostrar la partición que actualmente tiene el foco en el disco
seleccionado.

Sintaxis

select partition=<n>

Parámetros

Parámetro Descripción

partition= <n> El número de la partición que debe recibir el foco. Puede ver los números de
todas las particiones del disco seleccionadas actualmente usando el comando list
partition en DiskPart.

Comentarios

Para poder seleccionar una partición, primero debe seleccionar un disco mediante
el comando select disk.

Si no se especifica ningún número de partición, esta opción muestra la partición


que actualmente tiene el foco en el disco seleccionado.

Si se selecciona un volumen con una partición correspondiente, la partición se


selecciona automáticamente.

Si se selecciona una partición con un volumen correspondiente, el volumen se


selecciona automáticamente.

Ejemplos
Para cambiar el foco a la partición 3, escriba:

select partitition=3

Para mostrar la partición que actualmente tiene el foco en el disco seleccionado, escriba:

select partition

Vínculos relacionados
Clave de sintaxis de línea de comandos

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
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Selecciona el disco duro virtual (VHD) especificado y desplaza el foco hacia él.

Sintaxis

select vdisk file=<full path> [noerr]

Parámetros

Parámetro Descripción

file= <full Especifica la ruta de acceso completa y el nombre de archivo de un archivo VHD
path> existente.

noerr Se usa solo para el scripting. Cuando se detecta un error, DiskPart sigue
procesando los comandos como si no hubiera ningún error. Sin este parámetro,
un error hace que DiskPart salga con un código de error.

Ejemplos
Para desplazar el foco al VHD denominado c:\test\test.vhd, escriba:

select vdisk file=c:\test\test.vhd

Vínculos relacionados
Clave de sintaxis de línea de comandos

attach vdisk
compact vdisk

detach vdisk

detail vdisk

expand vdisk

merge vdisk

list

Comando select disk

Comando select partition

Comando select volume


select volume
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Selecciona el volumen especificado y cambia el foco a ese volumen. Este comando


también se puede usar para mostrar el volumen que actualmente tiene el foco en el
disco seleccionado.

Sintaxis

select volume={<n>|<d>}

Parámetros

Parámetro Descripción

<n> El número del volumen que va a recibir el foco. Puede ver los números de todos los
volúmenes del disco seleccionado actualmente mediante el comando list volume de
DiskPart.

<d> La letra de unidad o ruta de acceso al punto de montaje del volumen que recibirá el
foco.

Comentarios
Si no se especifica ningún volumen, este comando muestra el volumen que
actualmente tiene el foco en el disco seleccionado.

En un disco básico, la selección de un volumen también pone el foco en la


partición correspondiente.

Si se selecciona un volumen con una partición correspondiente, la partición se


seleccionará automáticamente.

Si se selecciona una partición con un volumen correspondiente, el volumen se


seleccionará automáticamente.
Ejemplos
Para cambiar el foco al volumen 2, escriba:

select volume=2

Para cambiar el foco a Unidad C, escriba:

select volume=c

Para desplazar el foco al volumen montado en una carpeta denominada c:\mountpath,


escriba:

select volume=c:\mountpath

Para mostrar el volumen que actualmente tiene el foco en el disco seleccionado, escriba:

select volume

Vínculos relacionados
Clave de sintaxis de línea de comandos

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 onine volume

Comando select disk

Comando select partition

Comando select vdisk


serverceipoptin
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Participar en el Programa para la mejora de la experiencia del usuario (CEIP)

Sintaxis

serverceipoptin [/query] [/enable] [/disable]

Parámetros

Parámetro Descripción

/query Comprueba la configuración actual.

/enable Activa la participación en CEIP.

/disable Desactiva la participación en CEIP.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para comprobar la configuración actual, escriba:

serverceipoptin /query

Para activar la participación, escriba:

serverceipoptin /enable
Para desactivar la participación, escriba:

serverceipoptin /disable

Vínculos relacionados
Clave de sintaxis de línea de comandos
servermanagercmd
Artículo • 17/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Instala y quita roles, servicios de rol y características. También muestra la lista de todos
los roles, servicios de rol y características disponibles, y muestra los que están instalados
en este equipo.

) Importante

Este comando, servermanagercmd, está en desuso y no se puede garantizar la


compatibilidad con próximas versiones de Windows. En su lugar, se recomienda
usar los cmdlets de Windows PowerShell que están disponibles para Administrador
del servidor. Para obtener más información, consulta el tema sobre la instalación o
desinstalación de roles, servicios de rol o características.

Sintaxis

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 Descripción
Parámetro Descripción

-query Muestra una lista de todos los roles, servicios de rol o las características
[[[<drive>:] instalados y disponibles para su instalación en el servidor. También puede usar la
<path>] forma abreviada de este parámetro, -q. Si desea guardar los resultados de la
<query.xml>] consulta en un archivo XML, especifique un archivo XML para reemplazar
<query.xml> .

-inputpath Instala o quita los roles, los servicios de rol o las características especificados en
[[[<drive>:] un archivo de respuesta XML representado por <answer.xml> . También puede
<path>] usar la forma abreviada del parámetro, -p.
<answer.xml>]

-install <id> Instala el rol, el servicio de rol o la característica especificados por <id> . Los
identificadores no distinguen mayúsculas de minúsculas. Varios roles, servicios de
rol y características se deben separar mediante espacios. Se usan los siguientes
parámetros opcionales con el parámetro -install:

-setting <SettingName>=<SettingValue> : especifica la configuración


necesaria para la instalación.
-allSubFeatures: especifica la instalación de todos los servicios y
características subordinados junto con el rol, servicio de rol o característica
primarios mencionados en el valor <id> .

NOTA:
Algunos contenedores de funciones no tienen con un identificador de
línea de comandos para permitir la instalación de todos los servicios de rol.
Esto sucede, por ejemplo, cuando no pueden instalarse servicios de
función en la misma instancia del comando del Administrador del servidor.
Por ejemplo, el servicio de rol Servicio de federación de los Servicios de
federación de Active Directory y el servicio de rol Proxy de Servicio de
federación no pueden instalarse mediante la misma instancia de comando
de Administrador del servidor.
-resultpath <result.xml> : guarda los resultados de la instalación en el
archivo XML representado por <result.xml> . También puede usar la forma
abreviada del parámetro, -r.

NOTA:
No se puede ejecutar servermanagercmd con los parámetros -resultpath y
-whatif especificados.
-restart: reinicia el equipo automáticamente cuando se completa la
instalación (si los roles o características instalados lo requieren).
-whatif: muestra todas las operaciones especificadas para el comando -
install. También puede usar la forma abreviada del parámetro, -whatif, -w.
No se puede ejecutar servermanagercmd con los parámetros -resultpath
y -whatif especificados.
-logpath <[[<drive>:]<path>]<log.txt>> : especifica un nombre y una
ubicación para el archivo de registro, que no sea el predeterminado,
%windir%\temp\servermanager.log .
Parámetro Descripción

-remove <id> Quita el rol, el servicio de rol o la característica que <id> especifica. Los
identificadores no distinguen mayúsculas de minúsculas. Varios roles, servicios de
rol y características se deben separar mediante espacios. Con el parámetro -
remove se usan los siguientes parámetros opcionales:

-resultpath <[[<drive>:]<path>]result.xml> : guarda los resultados de la


desinstalación en el archivo XML representado por <result.xml> . También
puede usar la forma abreviada del parámetro, -r.

NOTA:
No se puede ejecutar servermanagercmd con los parámetros -resultpath y
-whatif especificados.
-restart: reinicia el equipo automáticamente cuando se completa la
desinstalación (si los roles o las características que permanecen requieren
reinicio).
-whatif: muestra todas las operaciones especificadas para el comando -
remove. También puede usar la forma abreviada del parámetro, -whatif, -w.
No se puede ejecutar servermanagercmd con los parámetros -resultpath y
-whatif especificados.
-logpath <[[<Drive>:]<path>]<log.txt>> : especifica un nombre y una
ubicación para el archivo de registro, que no sea el predeterminado,
%windir%\temp\servermanager.log .

-version Muestra el número de versión del Administrador del servidor. También puede
usar la forma abreviada, -v.

-help Muestra la ayuda en la ventana del símbolo del sistema. También puede usar la
forma abreviada, -?.

Ejemplos
Para mostrar una lista de todos los roles, servicios de rol y características disponibles, y
qué roles, servicios de rol y características están instalados en el equipo, escriba:

servermanagercmd -query

Para instalar el rol Servidor web (IIS) y guardar los resultados de la instalación en un
archivo XML representado por installResult.xml, escriba:

servermanagercmd -install Web-Server -resultpath installResult.xml


Para mostrar información detallada sobre los roles, los servicios de rol y las
características que se instalarían o quitarían, en función de las instrucciones
especificadas en un archivo de respuesta XML representado por install.xml, escriba:

servermanagercmd -inputpath install.xml -whatif

Vínculos relacionados
Clave de sintaxis de línea de comandos

Información general de Administrador del servidor


serverweroptin
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Permite activar los informes de errores.

Sintaxis

serverweroptin [/query] [/detailed] [/summary]

Parámetros

Parámetro Descripción

/query Comprueba la configuración actual.

/detailed Especifica que se envíen informes detallados automáticamente.

/summary Especifica que se envían informes de resumen automáticamente.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para comprobar la configuración actual, escriba:

serverweroptin /query

Para enviar automáticamente informes detallados, escriba:

serverweroptin /detailed
Para enviar automáticamente informes de resumen, escriba:

serverweroptin /summary

Vínculos relacionados
Clave de sintaxis de línea de comandos
Servicios para herramientas de línea de
comandos de Network File System
Artículo • 08/04/2023

Servicios para Network File System (NFS) es una solución para compartir archivos que
permite transferir archivos entre equipos con sistemas operativos Windows y UNIX
mediante el protocolo NFS.

Información y vínculos a cada una de las herramientas de línea de comandos de NFS


asociadas:

Get-Help Descripción

mapadmin Administración de la asignación de nombres de usuario para servicios de Microsoft


para Network File System.

mount Montaje de recursos compartidos de red del Network File System (NFS).

nfsadmin Administración del servidor para NFS y el cliente para NFS.

nfsshare Control de recursos compartidos de Network File System (NFS).

nfsstat Visualización o restablecimiento de los recuentos de llamadas realizadas al servidor


para NFS.

rpcinfo Enumeración de programas en equipos remotos.

showmount Visualización de directorios montados.

Vínculos relacionados
Clave de sintaxis de línea de comandos
set (variable de entorno)
Artículo • 06/10/2023

Muestra, establece o elimina variables de entorno de cmd.exe. Si se usa sin parámetros,


set muestra la configuración actual de la variable de entorno.

7 Nota

Este comando requiere extensiones de comando, que están habilitadas de forma


predeterminada.

El comando set también se puede ejecutar desde la Consola de recuperación de


Windows mediante parámetros diferentes. Para obtener más información, consulte
Entorno de recuperación de Windows (WinRE).

Sintaxis

set [<variable>=[<string>]]
set [/p] <variable>=[<promptString>]
set /a <variable>=<expression>

Parámetros

Parámetro Descripción

<variable> Especifica la variable de entorno que se va a establecer o modificar.

<string> Especifica la cadena que se va a asociar a la variable de entorno especificada.

/p Establece el valor de <variable> en una línea de entrada especificada por el


usuario.

<promptstring> Especifica un mensaje para solicitar al usuario la entrada. Este parámetro debe
utilizarse con el parámetro /p.

/a Establece <string> en una expresión numérica que se evalúa.

<expression> Especifica una expresión numérica.

/? Muestra la ayuda en el símbolo del sistema.


Comentarios
Si las extensiones de comandos están habilitadas (el valor predeterminado) y se
ejecuta set con un valor, se muestran todas las variables que comienzan con ese
valor.

Los caracteres < , > , | , & y ^ son caracteres especiales del shell de comandos y
deben ir precedidos del carácter de escape ( ^ ) o entre comillas cuando se usan en
<string> (por ejemplo, "StringContaining&Symbol"). Si usa comillas para incluir

una cadena que contenga uno de los caracteres especiales, las comillas se
establecerán como parte del valor de la variable de entorno.

Use variables de entorno para controlar el comportamiento de algunos archivos


por lotes y programas y para controlar la apariencia y el funcionamiento de
Windows y del subsistema MS-DOS. El comando set se usa a menudo en el archivo
Autoexec.nt para establecer variables de entorno.

Si usa el comando set sin parámetros, se mostrará la configuración actual del


entorno. Estas opciones de configuración suelen incluir las variables de entorno
COMSPEC y PATH, que se usan para ayudar a buscar programas en el disco. Otras
dos variables de entorno usadas por Windows son PROMPT y DIRCMD.

Si especifica valores para <variable> y <string> , el valor <variable> especificado


se agrega al entorno y <string> se asocia a esa variable. Si la variable ya existe en
el entorno, el nuevo valor de cadena reemplaza el valor de cadena anterior.

Si especifica solo una variable y un signo igual (sin <string> ) para el comando set,
el valor <string> asociado a la variable se borra (como si la variable no existiera).

Si usa el parámetro /a, se admiten los operadores siguientes, en orden


descendente de precedencia:

Operador Operación realizada

( ) Agrupar

! ~ - Unario

* / % Aritméticos

+ - Aritméticos

<< >> Desplazamiento lógico

& AND bit a bit


Operador Operación realizada

^ OR exclusivo bit a bit

= *= /= %= += -= &= ^= = <<= >>=

, Separador de expresiones

Si usa operadores lógicos ( && o || ) o de módulo (%), coloque la cadena de


expresión entre comillas. Las cadenas no numéricas de la expresión se consideran
nombres de variables de entorno y sus valores se convierten en números antes de
que se procesen. Si especifica un nombre de variable de entorno que no está
definido en el entorno actual, se asigna un valor de cero, lo que permite realizar
una aritmética con valores de variable de entorno sin usar el % para recuperar un
valor.

Si ejecuta set /a desde la línea de comandos fuera de un script de comandos,


muestra el valor final de la expresión.

Los valores numéricos son números decimales a menos que lleven el prefijo 0×
para números hexadecimales o 0 para números octales. Por lo tanto, 0×12 es igual
que 18, que es igual que 022.

La compatibilidad con la expansión de variables de entorno retrasadas está


deshabilitada de forma predeterminada, pero puede habilitarla o deshabilitarla
mediante cmd /v.

Al crear archivos por lotes, puede usar set para crear variables y, a continuación,
usarlos de la misma manera que usaría las variables numeradas %0 a %9. También
puede usar las variables %0 a %9 como entrada para set.

Si llama a un valor de variable de un archivo por lotes, incluya el valor con signos
de porcentaje (%). Por ejemplo, si el programa por lotes crea una variable de
entorno denominada BAUD, puede usar la cadena asociada a BAUD como
parámetro reemplazable escribiendo %baud% en el símbolo del sistema.

Ejemplos
Para establecer el valor TEST^1 para la variable de entorno denominada testVar ,
escriba:
set testVar=TEST^^1

El comando set asigna todo lo que sigue al signo igual (=) al valor de la variable. Por lo
tanto, si escribe set testVar=TEST^1 , obtendrá el siguiente resultado, testVar=TEST1 .

Para establecer el valor TEST&1 para la variable de entorno testVar , escriba:

set testVar=TEST^&1

Para establecer una variable de entorno llamada include de modo que se le asocie la
cadena c:\directory, escriba:

set include=c:\directory

Después, puede usar la cadena c:\directory en los archivos por lotes si incluye el nombre
include con signos de porcentaje (%). Por ejemplo, puede usar dir %include% en un
archivo por lotes para mostrar el contenido del directorio asociado a la variable de
entorno include. Una vez procesado este comando, la cadena c:\directory sustituye a
%include%}.

El uso del comando set en un programa por lotes para agregar un nuevo directorio a la
variable de entorno path, escriba:

@echo off
rem ADDPATH.BAT adds a new directory
rem to the path environment variable.
set path=%1;%path%
set

Para mostrar una lista de todas las variables de entorno que comienzan por la letra p,
escriba:

set p

Para mostrar una lista de todas las variables de entorno en el dispositivo actual, escriba:
set

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comandos set (creación de
instantáneas)
Artículo • 06/04/2023

Establece el contexto, las opciones, el modo detallado y el archivo de metadatos para la


creación de instantáneas. Si se usa sin parámetros, set enumera todas las
configuraciones actuales.

Sintaxis

set
set context
set option
set verbose
set metadata

Parámetros

Parámetros Descripción

set context Establece el contexto para la creación de instantáneas.

set Establece el nombre y la ubicación del archivo de metadatos de creación de


metadata instantáneas.

set option Establece las opciones para la creación de instantáneas.

set verbose Activa o desactiva el modo de salida detallado.

/? Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
Set context
Artículo • 06/04/2023

Establece el contexto para la creación de instantáneas. Si se usa sin parámetros, set


context muestra la ayuda en la línea de comandos.

Sintaxis

set context {clientaccessible | persistent [nowriters] | volatile


[nowriters]}

Parámetros

Parámetro Descripción

clientaccessible Especifica que la instantánea puede ser utilizada por las versiones cliente de
Windows. Este contexto es persistente de forma predeterminada.

persistent Especifica que la instantánea persiste en la salida, el restablecimiento o el


reinicio del programa.

volatile Elimina la instantánea al salir o restablecer.

nowriters Especifica que se excluyen todos los escritores.

Ejemplos
Para evitar que las instantáneas se eliminen al salir de DiskShadow, escriba:

set context persistent

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando set metadata


Comando set option

Comando set verbose


set id (Diskpart)
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia el campo de tipo de partición de la partición con el foco. Este comando no


funciona en discos dinámicos ni en particiones reservadas de Microsoft.

) Importante

Este comando está diseñado solo para ser utilizado por fabricantes de equipos
originales (OEM). La modificación de campos de tipo de partición con este
parámetro puede provocar que el equipo experimente errores o no se pueda
iniciar. A menos que sea un OEM o tenga experiencia con discos gpt, no debería
cambiar los campos de tipo de partición en discos gpt usando este parámetro. En
su lugar, use siempre el comando create partition efi para crear particiones del
sistema EFI, el comando create partition msr para crear particiones reservadas de
Microsoft y el comando create partition primary sin el parámetro de id. para crear
particiones primarias en discos gpt.

Sintaxis

set id={ <byte> | <GUID> } [override] [noerr]

Parámetros

Parámetro Descripción

<byte> En el caso de los discos de registro de arranque maestro (MBR), especifica el nuevo
valor para el campo de tipo, en formato hexadecimal, para la partición. Con este
parámetro se puede especificar cualquier tipo de partición byte excepto el tipo
0x42, que especifica una partición LDM. Tenga en cuenta que el 0x inicial se omite al
especificar el tipo de partición hexadecimal.
Parámetro Descripción

<GUID> En el caso de los discos de tabla de particiones GUID (gpt), especifica el nuevo valor
GUID para el campo de tipo para la partición. Los GUID reconocidos incluyen:
Partición del sistema EFI: c12a7328-f81f-11d2-ba4b-00a0c93ec93b
Partición de datos básicos: ebd0a0a2-b9e5-4433-87c0-68b6b72699c7

Con este parámetro se puede especificar cualquier GUID de tipo de partición


excepto los siguientes:

Partición reservada de Microsoft: e3c9e316-0b5c-4db8-817d-f92df00215ae


Partición de metadatos LDM en un disco dinámico: 5808c8aa-7e8f-42e0-
85d2-e1e90434cfb3
Partición de datos LDM en un disco dinámico: af9b60a0-1431-4f62-bc68-
3311714a69ad
Partición de metadatos del clúster: db97dba9-0840-4bae-97f0-ffb9a327c7e1

override obliga al sistema de archivos en el volumen a desmontar antes de cambiar el tipo


de partición. Al ejecutar el comando set id, DiskPart intenta bloquear y desmontar el
sistema de archivos en el volumen. Si no se especifica override, y la llamada para
bloquear el sistema de archivos falla (por ejemplo, porque hay un controlador
abierto), la operación falla. Si se especifica override, DiskPart fuerza el desmontaje
incluso si falla la llamada para bloquear el sistema de archivos, y cualquier
controlador abierto para el volumen dejará de ser válido.

noerr Se usa solo para el scripting. Cuando se detecta un error, DiskPart sigue procesando
los comandos como si no hubiera ningún error. Sin este parámetro, un error hace
que DiskPart salga con un código de error.

Comentarios
Aparte de las limitaciones mencionadas anteriormente, DiskPart no comprueba la
validez del valor especificado (excepto para asegurarse de que es un byte en
formato hexadecimal o GUID).

Ejemplos
Para establecer el campo de tipo en 0x07 y forzar al sistema de archivos a desmontar,
escriba:

set id=0x07 override

Para establecer el campo de tipo en una partición de datos básica, escriba:


set id=ebd0a0a2-b9e5-4433-87c0-68b6b72699c7

Vínculos relacionados
Clave de sintaxis de línea de comandos
set metadata
Artículo • 08/04/2023

Establece el nombre y la ubicación del archivo de metadatos de creación de


instantáneas usado para transferir instantáneas de un equipo a otro. Si se usa sin
parámetros, set metadata muestra ayuda en el símbolo del sistema.

Sintaxis

set metadata [<drive>:][<path>]<metadata.cab>

Parámetros

Parámetro Descripción

[<drive>:] Especifica la ubicación para crear el archivo de metadatos.


[<path>]

<metadata.cab> Especifica el nombre del archivo cab para almacenar metadatos de creación de
instantáneas.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando set context

Comando set option

Comando set verbose


set option
Artículo • 12/04/2023

Establece las opciones para la creación de instantáneas. Si se usa sin parámetros, set
option muestra la ayuda en la línea de comandos.

Sintaxis

set option {[differential | plex] [transportable] [[rollbackrecover]


[txfrecover] | [noautorecover]]}

Parámetros

Parámetro Descripción

[differential] Especifica para crear una instantánea puntual de los volúmenes especificados.

[plex] Especifica la creación de una copia de clonación puntual de los datos en un


volumen especificado.

[transportable] Especifica que la instantánea aún no se va a importar. El archivo .cab de


metadatos se puede usar más adelante para importar la instantánea al mismo
equipo o a otro.

[rollbackrecover] Indica a los escritores que usen autorecover durante el evento PostSnapshot.
Esto resulta útil si la instantánea se va a usar para la reversión (por ejemplo,
con minería de datos).

[txfrecover] Solicita a VSS que la instantánea sea coherente transaccionalmente durante la


creación.

[noautorecover] Impide que los escritores y el sistema de archivos realicen cambios de


recuperación en la instantánea en un estado transaccionalmente coherente.
Noautorecover no se puede usar con txfrecover o rollbackrecover.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando set context


Comando set metadata

Comando set verbose


Establecer nivel de detalle
Artículo • 14/04/2023

Especifica si se proporciona una salida detallada durante la creación de instantáneas. Si


se usa sin parámetros, set verbose muestra ayuda en el símbolo del sistema.

Sintaxis

set verbose {on | off}

Parámetros

Parámetro Descripción

en Activa el registro de salida detallado durante el proceso de creación de


instantáneas. Si el modo detallado está activado, set proporciona detalles de
inclusión o exclusión del escritor y detalles de la compresión y extracción de
metadatos.

apagado Desactiva el registro de salida detallado durante el proceso de creación de


instantáneas.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando set context

Comando set metadata

Comando set option


setx
Artículo • 14/04/2023

Crea o modifica variables de entorno en el entorno de usuario o sistema sin necesidad


de programación ni scripting. El comando Setx también recupera los valores de las
claves del registro y los escribe en archivos de texto.

7 Nota

Este comando proporciona la única forma de línea de comandos o de


programación para establecer de forma directa y permanente los valores de
entorno del sistema. Las variables de entorno del sistema se pueden configurar
manualmente a través del panel de control o a través de un editor del registro. El
comando set, que es interno para el intérprete de comandos (Cmd.exe), establece
solo variables de entorno de usuario para la ventana de consola actual.

Sintaxis

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 Descripción

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto. No use barras diagonales


inversas. El valor predeterminado es el equipo local.

/u Ejecuta el script con las credenciales de la cuenta de usuario especificada. El valor


[<domain>\] predeterminado son los permisos del sistema.
<user name>

/p Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u.


[ <password> ]
Parámetro Descripción

<variable> Especifica el nombre de la variable de entorno que desea establecer.

<value> Especifica el valor al que desea establecer la variable de entorno.

/k <path> Especifica que la variable se establece en función de la información de una clave del
registro. La ruta de acceso usa la siguiente sintaxis: \\<HIVE>\<KEY>\...\<Value> . Por
ejemplo, puede especificar la siguiente ruta de acceso:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName

/f <filename> Especifica el archivo que desea usar.

/a <X>,<Y> Especifica coordenadas absolutas y desplazamiento como parámetros de búsqueda.

/r <X>,<Y> Especifica las coordenadas relativas y el desplazamiento de String como parámetros de


<String> búsqueda.

/m Especifica cómo establecer la variable en el entorno del sistema. La configuración


predeterminada es el entorno local.

/x Muestra las coordenadas de archivo, e ignora las opciones de línea de comandos /a, /r y
/d.

/d Especifica delimitadores como , o \ que se usarán además de los cuatro delimitadores


<delimiters> integrados: SPACE, TAB, ENTER y LINEFEED. Los delimitadores válidos incluyen cualquier
carácter ASCII. El número máximo de delimitadores es 15, incluidos los delimitadores
integrados.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Este comando es similar a la utilidad SETENV de UNIX.

Puede usar este comando para establecer valores para variables de entorno de
usuario y sistema de uno de tres orígenes (modos): modo de línea de comandos,
modo de registro o modo de archivo.

Este comando escribe variables en el entorno maestro del registro. Las variables
establecidas con variables setx solo están disponibles en las ventanas de
comandos futuras, no en la ventana de comandos actual.

HKEY_CURRENT_USER y HKEY_LOCAL_MACHINE son los únicos subárboles


admitidos. REG_DWORD, REG_EXPAND_SZ, REG_SZ y REG_MULTI_SZ son los tipos
de datos RegKey válidos.
Si obtiene acceso a valores del registro REG_MULTI_SZ, solo se extrae y usa el
primer elemento.

No puede usar este comando para quitar los valores agregados a los entornos
locales o del sistema. Puede usar este comando con un nombre de variable y
ningún valor para quitar un valor correspondiente del entorno local.

Los valores del registro REG_DWORD se extraen y se usan en modo hexadecimal.

El modo de archivo solo admite el análisis de archivos de texto de retorno de carro


y avance de línea (CRLF).

Al ejecutar este comando en una variable existente, se quitan las referencias de


variable y se usan valores expandidos.

Por ejemplo, si la variable %PATH% tiene una referencia a %JAVADIR%, y %PATH%


se manipula mediante setx, %JAVADIR% se expande y su valor se asigna
directamente a la variable de destino %PATH%. Esto significa que las
actualizaciones futuras de %JAVADIR% no se reflejarán en la variable %PATH%.

Tenga en cuenta que hay un límite de 1024 caracteres al asignar contenido a una
variable mediante setx.

Esto significa que el contenido se recorta si supera los 1024 caracteres y que el
texto recortado es lo que se aplica a la variable de destino. Si este texto recortado
se aplica a una variable existente, puede provocar la pérdida de datos mantenidos
anteriormente por la variable de destino.

Ejemplos
Para establecer la variable de entorno MACHINE en el entorno local en el valor Brand1,
escriba:

setx MACHINE Brand1

Para establecer la variable de entorno MACHINE en el entorno del sistema en el valor


Brand1 Computer, escriba:

setx MACHINE Brand1 Computer /m


Para establecer la variable de entorno MYPATH en el entorno local para usar la ruta de
acceso de búsqueda definida en la variable de entorno PATH, escriba:

setx MYPATH %PATH%

Para establecer la variable de entorno MYPATH en el entorno local para usar la ruta de
acceso de búsqueda definida en la variable de entorno PATH después de reemplazar ~
por %, escriba:

setx MYPATH ~PATH~

Para establecer la variable de entorno MACHINE en el entorno local en Brand1 en un


equipo remoto denominado computer1, escriba:

setx /s computer1 /u maindom\hiropln /p p@ssW23 MACHINE Brand1

Para establecer la variable de entorno MYPATH en el entorno local para usar la ruta de
acceso de búsqueda definida en la variable de entorno PATH en un equipo remoto
denominado computer1, escriba:

setx /s computer1 /u maindom\hiropln /p p@ssW23 MYPATH %PATH%

Para establecer la variable de entorno TZONE en el entorno local en el valor que se


encuentra en la clave del registro
deHKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\
StandardName, escriba:

setx TZONE /k
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\Stan
dardName

Para establecer la variable de entorno TZONE en el entorno local de un equipo remoto


denominado computer1 en el valor que se encuentra en la clave del registro
deHKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\
StandardName, escriba:

setx /s computer1 /u maindom\hiropln /p p@ssW23 TZONE /k


HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\Stan
dardName

Para establecer la variable de entorno BUILD en el entorno del sistema en el valor que se
encuentra en la clave del registro
deHKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentB
uildNumber, escriba:

setx BUILD /k
HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildN
umber /m

Para establecer la variable de entorno BUILD en el entorno del sistema de un equipo


remoto denominado Computer1 en el valor que se encuentra en la clave del registro
deHKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentB
uildNumber, escriba:

setx /s computer1 /u maindom\hiropln /p p@ssW23 BUILD /k


HKEY_LOCAL_MACHINE\Software\Microsoft\Windows
NT\CurrentVersion\CurrentBuildNumber /m

Para mostrar el contenido de un archivo denominado Ipconfig.out, junto con las


coordenadas correspondientes del contenido, escriba:

setx /f ipconfig.out /x

Para establecer la variable de entorno IPADDR en el entorno local en el valor que se


encuentra en la coordenada 5,11 del archivo Ipconfig.out, escriba:

setx IPADDR /f ipconfig.out /a 5,11


Para establecer la variable de entorno OCTET1 en el entorno local en el valor que se
encuentra en la coordenada 5,3 del archivo Ipconfig.out con delimitadores #$*., escriba:

setx OCTET1 /f ipconfig.out /a 5,3 /d #$*.

Para establecer la variable de entorno IPGATEWAY en el entorno local en el valor que se


encuentra en la coordenada 0,7 con respecto a la coordenada de Puerta de enlace en el
archivo Ipconfig.out, escriba:

setx IPGATEWAY /f ipconfig.out /r 0,7 Gateway

Para mostrar el contenido del archivo Ipconfig.out, junto con las coordenadas
correspondientes del contenido, en un equipo denominado computer1, escriba:

setx /s computer1 /u maindom\hiropln /p p@ssW23 /f ipconfig.out /x

Vínculos relacionados
Clave de sintaxis de línea de comandos
sfc
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Examina y comprueba la integridad de todos los archivos del sistema protegidos y


reemplaza las versiones incorrectas por versiones correctas. Si este comando detecta
que se ha sobrescrito un archivo protegido, recupera la versión correcta del archivo de
la carpeta systemroot\ y, a continuación, reemplaza el archivo incorrecto.

) Importante

Para ejecutar este comando, debe haber iniciado la sesión como miembro del
grupo Administradores.

Sintaxis

sfc [/scannow] [/verifyonly] [/scanfile=<file>] [/verifyfile=<file>]


[/offwindir=<offline windows directory> /offbootdir=<offline boot directory>
/offlogfile=<log file path>]

Parámetros

Parámetro Descripción

/scannow Examina la integridad de todos los archivos protegidos del sistema y repara
archivos que tienen problemas siempre que sea posible.

/verifyonly Examina la integridad de todos los archivos del sistema protegidos, sin
realizar reparaciones.

/scanfile <file> Examina la integridad del archivo especificado (ruta de acceso completa y
nombre de archivo) e intenta reparar todos los problemas en caso de que se
detecten.

/verifyfile <file> Comprueba la integridad del archivo especificado (ruta de acceso completa y
nombre de archivo), sin realizar reparaciones.
Parámetro Descripción

/offwindir Especifica la ubicación del directorio de Windows sin conexión para la


<offline windows reparación sin conexión.
directory>

/offbootdir Especifica la ubicación del directorio de arranque sin conexión para la


<offline boot reparación sin conexión.
directory>

/offlogfile= <log Especifica una ubicación para almacenar el archivo de registro distinto del
file path> predeterminado.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para comprobar el archivo kernel32.dll, escriba:

sfc /verifyfile=c:\windows\system32\kernel32.dll

Para configurar la reparación sin conexión del archivo kernel32.dll con un directorio de
arranque sin conexión establecido en D: y un directorio de Windows sin conexión
establecido en D:\Windows, escriba:

sfc /scanfile=D:\windows\system32\kernel32.dll /offbootdir=D:\


/offwindir=d:\windows

Vínculos relacionados
Clave de sintaxis de línea de comandos
shadow
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Permite controlar de forma remota una sesión activa de otro usuario en un servidor host
de sesión de escritorio remoto.

Sintaxis

shadow {<sessionname> | <sessionID>} [/server:<servername>] [/v]

Parámetros

Parámetro Descripción

<sessionname> Especifica el nombre de la sesión que quiere controlar de forma remota.

<sessionID> Especifica el id. de la sesión que quiere controlar de forma remota. Use el
usuario de consulta para mostrar la lista de sesiones y sus id. de sesión.

/server: <servername> Especifica el servidor host de sesión de escritorio remoto que contiene la
sesión que quiere controlar de forma remota. De forma predeterminada,
se usa el servidor Host4 de sesión de escritorio remoto actual.

/v Muestra información sobre las acciones que se realizan.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Puede ver o controlar activamente la sesión. Si opta por controlar activamente una
sesión de usuario, puede especificar acciones de teclado y mouse de entrada para
la sesión.

Siempre puede controlar de forma remota sus propias sesiones (excepto la sesión
actual), pero debe tener permiso de control total o permiso de acceso especial de
control remoto para controlar de forma remota otra sesión.
También puede iniciar el control remoto mediante el Administrador de servicios de
escritorio remoto.

Antes de que comience la supervisión, el servidor advierte al usuario de que la


sesión está a punto de controlarse remotamente, a menos que está advertencia
esté deshabilitada. Es posible que la sesión parezca detenida durante unos
segundos mientras espera una respuesta del usuario. Para configurar el control
remoto para usuarios y sesiones, use la herramienta Configuración de servicios de
escritorio remoto o las extensiones de servicios de escritorio remoto para usuarios
y grupos locales y usuarios y equipos de Active Directory.

Si la sesión no es compatible con la resolución de vídeo usada en la sesión que


está controlando remotamente, la operación no se realiza correctamente.

La sesión de consola no puede controlar de forma remota otra sesión ni


controlarse de forma remota por otra sesión.

Si desea finalizar el control remoto, presione CTRL+ * (usando * solo desde el


teclado numérico).

Ejemplos
Para sombrear la sesión 93, escriba:

shadow 93

Para sombrear la sesión ACCTG01, escriba:

shadow ACCTG01

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


desplazamiento
Artículo • 14/04/2023

Cambia la posición de los parámetros por lotes en un archivo por lotes.

Sintaxis

shift [/n <N>]

Parámetros

Parámetro Descripción

/n <N> Especifica que se inicie el cambio en el argumento N, donde N es cualquier valor


entre 0 y 8. Requiere extensiones de comando, que están habilitadas de forma
predeterminada.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
El comando shift cambia los valores de los parámetros por lotes %0 a %9
copiando cada parámetro en el anterior; el valor de %1 se copia en %0, el valor de
%2 se copia en %1, y así sucesivamente. Esto resulta útil para escribir un archivo
por lotes que realice la misma operación en cualquier número de parámetros.

Si las extensiones de comandos están habilitadas, el comando shift admite la


opción de línea de comandos /n. La opción /n especifica que empiece el cambio
en el argumento número N, donde N es cualquier valor entre 0 y 8. Por ejemplo,
SHIFT/2 cambiaría %3 a %2, %4 a %3, etc., y dejaría %0 y %1 sin cambios. Las
extensiones del comando están habilitadas de manera predeterminada.

Puede usar el comando shift para crear un archivo por lotes que pueda aceptar
más de 10 parámetros de lote. Si especifica más de 10 parámetros en la línea de
comandos, los que aparecen después del décimo (%9) se desplazarán uno a uno al
%9.

El comando shift no tiene ningún efecto en el parámetro por lotes %*.


No hay ningún comando shift que funcione hacia atrás. Después de implementar
el comando shift, no se puede recuperar el parámetro por lotes (%0) que existía
antes del cambio.

Ejemplos
Para usar un archivo por lotes, denominado Mycopy.bat, para copiar una lista de archivos
en un directorio específico, escriba:

@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

Vínculos relacionados
Clave de sintaxis de línea de comandos
showmount
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Puede usar showmount para mostrar información sobre los sistemas de archivos
montados exportados por el servidor para NFS en un equipo especificado. Si no
especifica un servidor, este comando muestra información sobre el equipo en el que se
ejecuta el comando showmount.

Sintaxis

showmount {-e|-a|-d} <server>

Parámetros

Parámetro Descripción

-E Muestra todos los sistemas de archivos exportados en el servidor.

-a Muestra todos los clientes del sistema de archivos de red (NFS) y los directorios del
servidor que cada uno ha montado.

-d Muestra todos los directorios del servidor montados actualmente por los clientes
NFS.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Servicios de referencia de comandos de sistema de archivos de red


shrink
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

El comando Diskpart shrink reduce el tamaño del volumen seleccionado según la


cantidad que especifique. Este comando pone a disposición espacio libre en disco a
partir del espacio no usado del volumen.

Se debe seleccionar un volumen para que esta operación se realice correctamente. Use
el comando select volume para seleccionar un volumen y desplazar el foco a él.

7 Nota

Este comando funciona en volúmenes básicos y en volúmenes dinámicos simples o


distribuidos. No funciona en particiones de fabricante de equipos originales (OEM),
particiones del sistema Extensible Firmware Interface (EFI) ni particiones de
recuperación.

Sintaxis

shrink [desired=<n>] [minimum=<n>] [nowait] [noerr]


shrink querymax [noerr]

Parámetros

Parámetro Descripción

desired= <n> Especifica el espacio en megabytes (MB) que se desea reducir en el volumen.

minimum= <n> Especifica el espacio mínimo en megabytes (MB) que se desea reducir en el
volumen.

querymax Devuelve la cantidad máxima de espacio en MB por el que se puede reducir el


volumen. Este valor puede cambiar si hay aplicaciones que están obteniendo
acceso al volumen.
Parámetro Descripción

nowait Fuerza la vuelta inmediata del comando mientras se está realizando la


reducción.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando los
comandos como si no hubiera ningún error. Sin este parámetro, un error hace
que DiskPart salga con un código de error.

Comentarios

El tamaño de un volumen sólo se puede reducir si se ha formateado mediante el


sistema de archivos NTFS o si no contiene un sistema de archivos.

Si no se especifica una cantidad deseada, el volumen se reduce en la cantidad


mínima (si se especifica).

Si no se especifica una cantidad mínima, el volumen se reduce en la cantidad


deseada (si se especifica).

Si no se especifica una cantidad mínima ni una cantidad deseada, el volumen se


reduce tanto como sea posible.

Si se especifica una cantidad mínima, pero no hay suficiente espacio libre


disponible, el comando fallará.

Ejemplos
Para reducir el tamaño del volumen seleccionado en la mayor cantidad posible entre
250 y 500 megabytes, escriba:

shrink desired=500 minimum=250

Para mostrar el número máximo de MB en el que se puede reducir el volumen, escriba:

shrink querymax

Vínculos relacionados
Clave de sintaxis de línea de comandos

Resize-Partition
shutdown
Artículo • 09/10/2023

Permite apagar o reiniciar los equipos locales o remotos de uno en uno.

Sintaxis

shutdown [/i | /l | /s | /sg | /r | /g | /a | /p | /h | /e | /o] [/hybrid]


[/soft] [/fw] [/f] [/m \\computer][/t xxx][/d [p|u:]xx:yy [/c "comment"]]

Parámetros

Parámetro Descripción

/i Muestra el cuadro Apagado remoto. La opción /i debe ser el primer


parámetro que sigue al comando. Si se especifica /i, se omiten todas las
demás opciones.

/l Cierra la sesión del usuario actual inmediatamente, sin tiempo de espera. No


se puede usar /l con /m o /t.

/s Apaga el equipo.

/sg Apaga el equipo. En el siguiente arranque, si el inicio de sesión de reinicio


automático está habilitado, el dispositivo inicia sesión automáticamente y se
bloquea en función del último usuario interactivo. Después de iniciar sesión,
reinicia las aplicaciones registradas.

/r Reinicia el equipo después de apagarse.

/g Cierra completamente y reinicia el equipo. En reinicio, si el inicio de sesión de


reinicio automático está habilitado, el dispositivo inicia sesión
automáticamente y se bloquea en función del último usuario interactivo.
Después de iniciar sesión, reinicia las aplicaciones registradas.

/a Anula el apagado del sistema. Solo se puede usar durante el período de


tiempo de espera. Combine con /fw para borrar los arranques pendientes en
el firmware.

/p Desactiva el equipo local solo (no un equipo remoto) sin tiempo de espera ni
advertencia. Solo puede usar /p con /d o /f. Si el equipo no admite la
funcionalidad de apagado, se apaga al usar /p, pero la alimentación del
equipo permanecerá encendida.
Parámetro Descripción

/h Pone al equipo local en hibernación, si la hibernación está habilitada. El


modificador /f se puede usar con el modificador /h.

/hybrid Apaga el dispositivo y lo prepara para el inicio rápido. Esta opción debe usarse
con la opción /s.

/soft Permite que los procesos y las aplicaciones en ejecución se cierren


correctamente en lugar de terminar de forma forzada.

/fw La combinación de esta opción con una opción de apagado hace que el
siguiente reinicio vaya a la interfaz de usuario de firmware.

/e Permite documentar el motivo de un apagado inesperado de un equipo en el


Rastreador de eventos de apagado.

/o Abre el menú Opciones de arranque avanzadas y reinicia el dispositivo. Esta


opción debe usarse con la opción /r.

/f Fuerza que las aplicaciones en ejecución se cierren sin avisar a los usuarios.
Precaución: El uso de la opción /f podría provocar la pérdida de datos no
guardados.

/m \\ Especifica el equipo de destino. No se puede usar con la opción /l.


<computername>

/t <xxx> Establece el período de tiempo de espera antes del apagado a xxx segundos.
El intervalo válido es 0-315360000 (10 años) con un valor predeterminado de
30. Si el período de tiempo de espera es mayor que 0, el parámetro /f está
implícito.

/d [p \| u:] Muestra el motivo del reinicio o apagado del sistema. Los valores de
<xx>:<yy> parámetro admitidos son:

P: indica que el reinicio o apagado está planeado.


U: indica que el motivo está definido por el usuario.
Si no se especifica p o u, el reinicio o apagado no está planeado.

xx: especifica el número de motivo principal (un entero positivo menor


que 256).
yy: especifica el número de motivo secundario (un entero positivo
menor que 65536).

/c <comment> Permite crear un motivo personalizado para el apagado o reinicio del sistema,
que debe incluirse entre comillas dobles. Puede utilizar 512 caracteres como
máximo. También se puede utilizar con el parámetro /d.

/? Muestra ayuda en el símbolo del sistema, incluida una lista de los motivos
principales y menores definidos en el equipo local.
Comentarios
A los usuarios se les debe asignar el derecho de usuario Apagar el sistema para
apagar un equipo local o administrado de forma remota que use el comando
shutdown.

Los usuarios deben ser miembros del grupo Administradores para anotar un
apagado inesperado de un equipo local o administrado de forma remota. Si el
equipo de destino está unido a un dominio, los miembros del grupo
Administradores de dominio podrían llevar a cabo este procedimiento. Para más
información, consulte:

Grupos locales predeterminados

Grupos predeterminados

Si desea apagar más de un equipo a la vez, puede llamar al apagado de cada


equipo mediante un script, o bien puede usar shutdown/i para mostrar el cuadro
Apagado remoto.

Si especifica códigos de motivo principales y secundarios, primero debe definir


estos códigos de motivo en cada equipo en el que planee usar los motivos. Si los
códigos de motivo no están definidos en el equipo de destino, el Rastreador de
eventos de apagado no puede registrar el texto del motivo correcto.

Recuerde indicar que un apagado está planeado mediante el parámetro p. Si no se


usa el parámetro p, esto indica que el apagado no estaba planeado.

Con el parámetro p, junto con el código de motivo de un apagado no planeado,


se produce un error en el apagado.

No se usa el parámetro p y solo se proporciona el código de motivo para un


apagado planeado, lo que también hace que se produzca un error en el
apagado.

Los motivos de apagado o reinicio usan la siguiente leyenda:

E: Previsto - Parada o reinicio previsto que se planifica y comunica con antelación.


U: Inesperado - Se produce un apagado o reinicio inesperado cuando el sistema
deja de funcionar debido a un error, como un bloqueo del sistema, un error de
alimentación u otro.
P: Planeado: apagado o reinicio planeado y programado con antelación, como
mantenimiento del sistema, instalación de software u otros.
C: Definido por el cliente: especifique un motivo personalizado para el apagado o
reinicio del sistema.
Tipo de motivo Principal Minor Descripción

U 0 0 Otro (no planeado)

E 0 0 Otro (no planeado)

EoP 0 0 Otro (planeado)

U 0 5 Otro error: el sistema no responde

E 1 1 Hardware: mantenimiento (no planeado)

EoP 1 1 Hardware: mantenimiento (planeado)

E 1 2 Hardware: instalación (planeada)

EoP 1 2 Hardware: instalación (planeada)

E 2 2 Sistema operativo: recuperación (no planeada)

EoP 2 2 Sistema operativo: recuperación (planeada)

P 2 3 Sistema operativo: actualización (planeada)

E 2 4 Sistema operativo: reconfiguración (no planeada)

EoP 2 4 Sistema operativo: reconfiguración (planeada)

P 2 16 Sistema operativo: Service Pack (planeado)

2 17 Sistema operativo: revisión (no planeada)

P 2 17 Sistema operativo: revisión (planeada)

2 18 Sistema operativo: revisión de seguridad (no planeada)

P 2 18 Sistema operativo: revisión de seguridad (planeada)

E 4 1 Aplicación: mantenimiento (no planeado)

EoP 4 1 Aplicación: mantenimiento (planeado)

EoP 4 2 Aplicación: instalación (planeada)

E 4 5 Aplicación: sin respuesta

E 4 6 Aplicación: inestable

U 5 15 Error del sistema: error de detención

U 5 19 Problema de seguridad (no planeado)

E 5 19 Problema de seguridad (no planeado)


Tipo de motivo Principal Minor Descripción

EoP 5 19 Problema de seguridad (planeado)

E 5 20 Pérdida de conectividad de red (no planeada)

U 6 11 Error de alimentación: cable desconectado

U 6 12 Error de alimentación: entorno

P 7 0 Apagado de la API heredada

Ejemplos
Para forzar que las aplicaciones se cierren y reinicien el equipo local después de un
retraso de un minuto, con el motivo Aplicación: mantenimiento (planeado) y el
comentario “Reconfiguring myapp.exe”, escriba:

shutdown /r /t 60 /c "Reconfiguring myapp.exe" /f /d p:4:1

Para reiniciar el equipo remoto myremoteserver con los mismos parámetros que el
ejemplo anterior, escriba:

shutdown /r /m \\myremoteserver /t 60 /c "Reconfiguring myapp.exe" /f /d


p:4:1

Para reiniciar el equipo remoto myremoteserver en 5 minutos debido a una actualización


de seguridad e incluir un motivo personalizado en el seguimiento de eventos de
apagado, escriba:

shutdown /r /t 300 /e /c "Security Update" /m \\myremoteserver

Vínculos relacionados
Clave de sintaxis de línea de comandos
Simulate restore
Artículo • 14/04/2023

Comprueba si la participación del escritor en las sesiones de restauración se realizará


correctamente en el equipo sin emitir eventos PreRestore o PostRestore a los escritores.

7 Nota

Se debe seleccionar un archivo de metadatos DiskShadow para que el comando


simulate restore se realice correctamente. Use el comando load metadata para
cargar los escritores y componentes seleccionados para la restauración.

Sintaxis

simulate restore

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando load metadata


sort
Artículo • 06/04/2023

Lee la entrada, ordena los datos y escribe los resultados en la pantalla, en un archivo o
en otro dispositivo.

Sintaxis

sort [/r] [/+<N>] [/m <kilobytes>] [/l <locale>] [/rec <characters>]


[[<drive1>:][<path1>]<filename1>] [/t [<drive2>:][<path2>]] [/o [<drive3>:]
[<path3>]<filename3>]

Parámetros

Parámetro Descripción

/r Invierte el criterio de ordenación (es decir, se ordena de Z a A y de 9 a 0).

/+<N> Especifica el número de posición del carácter donde sort comenzará cada
comparación. N puede ser cualquier entero válido.

/m Especifica la cantidad de memoria principal que se va a usar para la ordenación


<kilobytes> en kilobytes (KB).

/l <locale> Invalida el criterio de ordenación de los caracteres que están definidos por la
configuración regional predeterminada del sistema (es decir, el idioma y el
País/Región seleccionados durante la instalación).

/rec Especifica el número máximo de caracteres de un registro o una línea del archivo
<characters> de entrada (el valor predeterminado es 4 096 y el máximo 65 535).

[<drive1>:] Especifica el archivo que se va a ordenar. Si no se especifica ningún nombre de


[<path1>] archivo, se ordena la entrada estándar. Especificar el archivo de entrada es más
<filename1> rápido que redirigir el mismo archivo como entrada estándar.

/t Especifica la ruta de acceso del directorio que contendrá el almacenamiento de


[<drive2>:] trabajo del comando sort si los datos no caben en la memoria principal. De forma
[<path2>] predeterminada, se usa el directorio temporal del sistema.

/o Especifica el archivo donde se va a almacenar la entrada ordenada. Si no se


[<drive3>:] especifica, los datos se escriben en la salida estándar. Especificar el archivo de
[<path3>] salida es más rápido que redirigir la salida estándar al mismo archivo.
<filename3>
Parámetro Descripción

/unique Solo devuelve resultados únicos.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

De forma predeterminada, las comparaciones comienzan en el primer carácter de


cada línea. La opción /+ de la línea de comandos inicia las comparaciones en el
carácter especificado por N. Por ejemplo, /+3 indica que cada comparación debe
comenzar en el tercer carácter de cada línea. Las líneas con menos de N caracteres
se intercalan antes que las demás líneas.

La memoria usada siempre es de 160 KB como mínimo. Si se especifica el tamaño


de la memoria, se usará la cantidad exacta especificada para la ordenación (debe
ser de al menos 160 KB), independientemente de cuánta memoria principal haya
disponible.

El tamaño máximo de memoria predeterminado cuando no se especifica ningún


tamaño es el 90 % de la memoria principal disponible, si tanto la entrada como la
salida son archivos, o el 45 % de la memoria principal en caso contrario.
Normalmente, la configuración predeterminada proporciona el mejor rendimiento.

Actualmente, la única alternativa a la configuración regional predeterminada es la


configuración regional de C, que es más rápida que la ordenación del lenguaje
natural (ordena los caracteres según sus codificaciones binarias).

Puede usar el símbolo de barra vertical ( | ) para dirigir los datos de entrada al
comando sort desde otro comando o para dirigir la salida ordenada a otro
comando. Puede especificar los archivos de entrada y salida usando símbolos de
redirección ( < o > ). Puede ser más rápido y eficaz (especialmente con archivos de
gran tamaño) especificar directamente el archivo de entrada (definido por
filename1 en la sintaxis del comando), y después especificar el archivo de salida
usando el parámetro /o.

El comando sort no distingue entre mayúsculas y minúsculas y no tiene ningún


límite en el tamaño del archivo.

El programa de clasificación usa la tabla de secuencias de cotejo que corresponde


al código País/Región y a la configuración de la página de códigos. Los caracteres
superiores al código ASCII 127 se clasifican según la información del archivo
Country.sys o de un archivo alternativo especificado por el comando country de su
archivo Config.nt.

Si la ordenación se ajusta al tamaño máximo de memoria (según lo establecido de


forma predeterminada o según lo especificado por el parámetro /m), la
ordenación se realiza en una sola pasada. De lo contrario, la ordenación se realiza
en dos pasadas separadas de ordenación y combinación, y las cantidades de
memoria usadas para ambas pasadas son iguales. Cuando se realizan dos pasadas,
los datos parcialmente ordenados se almacenan en un archivo temporal en el
disco. Si no hay memoria suficiente para realizar la ordenación en dos pasadas, se
emite un error en tiempo de ejecución. Si se usa la opción de línea de comandos
/m para especificar más memoria de la realmente disponible, puede producirse
una degradación del rendimiento o un error en tiempo de ejecución.

Ejemplos
Para ordenar y mostrar, en orden inverso, las líneas de un archivo denominado
expenses.txt, escriba:

sort /r expenses.txt

Para buscar en un archivo grande llamado maillist.txt el texto Jones, y ordenar los
resultados de la búsqueda usando la barra vertical ( | ) para dirigir la salida de un
comando find al comando sort, escriba:

find Jones maillist.txt | sort

El comando genera una lista ordenada de líneas que contienen el texto


especificado.

Para ordenar las entradas del teclado y mostrar los resultados alfabéticamente en
la pantalla, puede usar primero el comando sort sin parámetros, escribiendo:

sort
Después, escriba el texto que quiera ordenar y pulse ENTRAR al final de cada línea.
Cuando haya terminado de escribir texto, presione CTRL+Z y presione ENTRAR. El
comando sort muestra el texto que ha escrito, ordenado alfabéticamente.

Vínculos relacionados
Clave de sintaxis de línea de comandos
start
Artículo • 08/10/2023

Inicia una ventana independiente del símbolo del sistema para ejecutar un programa o
comando especificados.

Sintaxis

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 Nota

El parámetro machine está actualmente en VERSIÓN PRELIMINAR solo para


Windows 11. El parámetro está disponible a partir de la compilación preliminar
22557 de Windows 11 Insider . Esta información está relacionada con un
producto en versión preliminar que puede modificarse considerablemente antes de
su lanzamiento. Microsoft no ofrece ninguna garantía, expresa o implícita, con
respecto a la información que se ofrece aquí.

Parámetros

Parámetro Descripción

"title" Especifica el título que se va a mostrar en la barra de título de la


ventana Símbolo del sistema.

/d <path> Especifica el directorio de inicio.

/i Pasa el entorno de inicio de Cmd.exe a la nueva ventana Símbolo del


sistema. Si /i no se especifica, se usa el entorno actual.

{/min | /max} Especifica minimizar ( /min ) o maximizar ( /max ) la nueva ventana


Símbolo del sistema.

{/separate | /shared} Inicia programas de 16 bits en un espacio de memoria independiente


( /separate ) o en un espacio de memoria compartido (/shared). Estas
Parámetro Descripción

opciones no se admiten en plataformas de 64 bits.

{/low | /normal | Inicia una aplicación en la clase de prioridad especificada.


/high | /realtime |
/abovenormal |
/belownormal}

/node <NUMA node> Aprovecha la localidad de la memoria en nodos NUMA (arquitectura de


memoria no uniforme) como un entero decimal. Dos procesos que se
comunican entre sí a través de memoria compartida en el nodo NUMA
de preferencia pueden minimizar la latencia de memoria al asignar
memoria desde el mismo nodo NUMA siempre que sea posible. Son
libres de ejecutarse en procesadores fuera del nodo especificado.

/affinity <hexaffinity> Aplica la máscara de afinidad de procesador especificada (expresada


como un número hexadecimal) a la nueva aplicación. Dos programas
pueden ejecutarse en núcleos de procesador específicos dentro del
mismo nodo NUMA. Este número se puede cambiar a la cantidad
admitida específica del procesador sin tener que cambiar la máscara de
afinidad.

/wait Inicia una aplicación y espera a que finalice.

/b Inicia una aplicación sin abrir una nueva ventana Símbolo del sistema.
El control de CTRL+C se omite a menos que la aplicación habilite el
procesamiento CTRL+C. Use CTRL+INTER para interrumpir la
aplicación.

/machine <x86 | amd64 Especifica la arquitectura de la máquina del proceso de aplicación.


| arm | arm64>

[<command> Especifica el comando o programa que se va a iniciar.


[<parameter>... ] |
<program>
[<parameter>... ]]

<parameter> Especifica los parámetros que se van a pasar al comando o al


programa.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Puede ejecutar archivos no ejecutables a través de su asociación de archivos


escribiendo el nombre del archivo como un comando.
Si ejecuta un comando que contiene la cadena CMD como primer token sin un
calificador de extensión o ruta de acceso, CMD se reemplaza por el valor de la
variable COMSPEC. Esto evita que los usuarios recojan cmd del directorio actual.

Si ejecuta una aplicación de interfaz gráfica de usuario (GUI) de 32 bits, cmd no


espera a que la aplicación se cierre antes de volver al símbolo del sistema. Este
comportamiento no se produce si ejecuta la aplicación desde un script de
comandos.

Si se ejecuta en una plataforma de 64 bits, no se admiten los parámetros


/separate y /shared .

Si ejecuta un comando que usa un primer token que no es un comando o la ruta


de acceso del archivo a un archivo existente con una extensión, Cmd.exe usa el
valor de la variable de entorno PATHEXT para determinar qué extensiones buscar y
en qué orden. El valor predeterminado de la variable PATHEXT es
.COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH;.MSC .

Tenga en cuenta que la sintaxis es la misma que la variable PATH, donde se utilizan
puntos y coma (;) para separar cada extensión.

start busca un archivo ejecutable especificado y, si lo encuentra, el ejecutable se


inicia independientemente del directorio de trabajo actual. Al buscar un archivo
ejecutable, si no hay ninguna coincidencia en ninguna extensión, start comprueba
si el nombre coincide con un nombre de directorio. Si es así, start abre
Explorer.exe en esa ruta de acceso.

Ejemplos
Para iniciar el programa Myapp en el símbolo del sistema y conservar el uso de la
ventana Símbolo del sistema actual, escriba:

Símbolo del sistema de Windows

start Myapp

Para ver la información de ayuda de la línea de comandos para start en otra ventana del
símbolo del sistema maximizada, escriba:

Símbolo del sistema de Windows

start /max start /?


Vínculos relacionados
Clave de sintaxis de línea de comandos
subst
Artículo • 14/04/2023

Asocia una ruta de acceso a una letra de unidad. Si se usa sin parámetros, subst muestra
los nombres de las unidades virtuales activas.

Sintaxis

subst [<drive1>: [<drive2>:]<path>]


subst <drive1>: /d

Parámetros

Parámetro Descripción

<drive1>: Especifica la unidad virtual a la que desea asignar una ruta de acceso.

[<drive2>:] Especifica la unidad física y la ruta de acceso que desea asignar a una unidad
<path> virtual.

/d Elimina una unidad (virtual) sustituida.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Los siguientes comandos no funcionan y no se deben usar en unidades
especificadas en el comando subst:

Comando chkdsk

Comando diskcomp

Comando diskcopy

Comando format

Comando label

Comando recover
El parámetro <drive1> debe estar dentro del intervalo especificado por el
comando lastdrive. Si no es así, subst muestra el siguiente mensaje de error:
Invalid parameter - drive1:

Ejemplos
Para crear una unidad virtual z para la ruta de acceso b:\user\betty\forms, escriba:

subst z: b:\user\betty\forms

En lugar de escribir la ruta de acceso completa, puede acceder a este directorio


escribiendo la letra de la unidad virtual seguida de dos puntos como se indica a
continuación:

z:

Vínculos relacionados
Clave de sintaxis de línea de comandos
sxstrace
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Diagnostica problemas en paralelo.

Sintaxis

sxstrace [{[trace -logfile:<filename> [-nostop]|[parse -logfile:<filename> -


outfile:<parsedfile> [-filter:<appname>]}]

Parámetros

Parámetro Descripción

seguimiento Habilita el seguimiento en paralelo.

-logfile Especifica el archivo de registro sin procesar.

<filename> Guarda el registro de seguimiento en <filename .

-nostop Especifica que no debe recibir un mensaje para detener el seguimiento.

parse Traduce el archivo de seguimiento sin procesar.

-outfile Especifica el nombre del archivo de salida.

<parsedfile> Especifica el nombre de archivo del archivo analizado.

-filter Permite filtrar la salida.

<appname> Especifica el nombre de la aplicación.

stoptrace Detiene el seguimiento, si no se detuvo antes.

-? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para habilitar el seguimiento y guardar el archivo de seguimiento en sxstrace.etl, escriba:

sxstrace trace -logfile:sxstrace.etl

Para convertir el archivo de seguimiento sin procesar en un formato legible y guardar el


resultado en sxstrace.txt, escriba:

sxstrace parse -logfile:sxstrace.etl -outfile:sxstrace.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos
sysocmgr
Artículo • 06/04/2023

El comando sysocmger está en desuso y no se garantiza que se admita en futuras


versiones de Windows.
systeminfo
Artículo • 06/04/2023

Muestra información de configuración detallada sobre un equipo y su sistema


operativo, incluida la configuración del sistema operativo, información de seguridad, id.
del producto y propiedades del hardware (como RAM, espacio en disco y tarjetas de
red).

Sintaxis

systeminfo [/s <computer> [/u <domain>\<username> [/p <password>]]] [/fo


{TABLE | LIST | CSV}] [/nh]

Parámetros

Parámetro Descripción

/s Especifica el nombre o la dirección IP de un equipo remoto (no se pueden usar


<computer> barras diagonales inversas). La opción predeterminada es el equipo local.

/u Ejecuta el comando con los permisos de la cuenta de usuario especificada. Si no se


<domain>\ especifica /u, este comando usa los permisos del usuario que está conectado en ese
<username> momento al equipo que emite el comando.

/p Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u.


<password>

/fo Especifica el formato de salida con uno de los valores siguientes:


<format> TABLE: muestra la salida en una tabla.
LIST: muestra la salida en una lista.
CSV: muestra la salida en formato de valores separados por comas (.csv).

/nh Suprime los encabezados de columna en la salida. Válido cuando el parámetro /fo
se establece en TABLE o CSV.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para ver la información de configuración de un equipo denominado Srvmain, escriba:
systeminfo /s srvmain

Para ver de forma remota la información de configuración de un equipo denominado


Srvmain2 que se encuentra en el dominio Maindom, escriba:

systeminfo /s srvmain2 /u maindom\hiropln

Para ver de forma remota la información de configuración (en formato de lista) de un


equipo denominado Srvmain2 que se encuentra en el dominio Maindom, escriba:

systeminfo /s srvmain2 /u maindom\hiropln /p p@ssW23 /fo list

Vínculos relacionados
Clave de sintaxis de línea de comandos
takeown
Artículo • 14/04/2023

Permite que un administrador recupere el acceso a un archivo que anteriormente le era


denegado, convirtiendo al administrador en el propietario del archivo. Este comando se
usa normalmente en archivos por lotes.

Sintaxis

takeown [/s <computer> [/u [<domain>\]<username> [/p [<password>]]]] /f


<filename> [/a] [/r [/d {Y|N}]]

Parámetros

Parámetro Descripción

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (no se pueden usar


barras diagonales inversas). El valor predeterminado es el nombre del equipo
local. Este parámetro se aplica a todos los archivos y carpetas especificados en el
comando.

/u El script se ejecuta con los permisos de la cuenta especificada. El valor


[<domain>\] predeterminado son los permisos del sistema.
<username>

/p Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u.


[<[password>]

/f <filename> Especifica el nombre de archivo o el patrón de nombre de directorio. Puede usar


el carácter comodín * al especificar el patrón. También puede usar la sintaxis
<sharename>\<filename> .

/a Concede la propiedad al grupo Administradores en lugar de al usuario actual. Si


no especifica esta opción, la propiedad del archivo se asigna al usuario que tiene
iniciada sesión actualmente en el equipo.

/r Realiza una operación recursiva en todos los archivos del directorio y


subdirectorios especificados.
Parámetro Descripción

/d {Y | N} Suprime el mensaje de confirmación que se muestra cuando el usuario actual no


tiene el permiso List Folder en un directorio especificado y, en su lugar, usa el
valor predeterminado especificado. Los valores válidos para la opción /d son:

Y: tomar posesión del directorio.


N: omitir el directorio.

NOTA:
Debe usar esta opción junto con la opción /r.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Los patrones mixtos que usan (? y *) no son compatibles con el comando takeown.

Después de eliminar el bloqueo con takeown, es posible que tenga que usar el
Explorador de Windows para concederle permisos completos a los archivos y
directorios antes de poder eliminarlos.

Ejemplos
Para tomar posesión de un archivo denominado Lostfile, escriba:

takeown /f lostfile

Vínculos relacionados
Clave de sintaxis de línea de comandos
tapicfg
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crean, eliminan o muestran una partición del directorio de aplicación TAPI, o establecen
una partición predeterminada del directorio de aplicación TAPI. Los clientes de TAPI 3.1
pueden usar la información de esta partición del directorio de la aplicación con el
servicio de localización del servicio de directorio para encontrar los directorios de TAPI y
comunicarse con ellos. También puede usar tapicfg para crear o eliminar puntos de
conexión de servicio, que permiten a los clientes de TAPI localizar eficazmente las
particiones del directorio de aplicación TAPI en un dominio.

Esta herramienta de línea de comandos se puede ejecutar en cualquier equipo que sea
miembro del dominio.

Sintaxis

tapicfg install
tapicfg remove
tapicfg publishscp
tapicfg removescp
tapicfg show
tapicfg makedefault

Parámetros

Parámetros Descripción

tapicfg install Crea una partición del directorio de aplicación TAPI.

tapicfg remove Quita una partición de directorio de aplicación de TAPI.

tapicfg Crea un punto de conexión de servicio para publicar una partición de directorio
publishscp de aplicación TAPI.

tapicfg Quita un punto de conexión de servicio para una partición de directorio de


removescp aplicación TAPI.
Parámetros Descripción

tapicfg show Muestra los nombres y ubicaciones de las particiones del directorio de
aplicación TAPI en el dominio.

tapicfg Establece la partición de directorio de aplicación TAPI predeterminada para el


makedefault dominio.

Comentarios
Debe ser miembro del grupo Administradores de empresa en Active Directory
para ejecutar tapicfg install (para crear una partición del directorio de aplicación
TAPI) o tapicfg remove (para eliminar una partición del directorio de aplicación
TAPI).

El texto proporcionado por el usuario (como los nombres de las particiones del
directorio de aplicaciones TAPI, servidores y dominios) con caracteres
internacionales o Unicode solo se muestra correctamente si se han instalado el
soporte de idioma y las fuentes adecuados.

Puede seguir usando servidores del Servicio de localización de Internet (ILS) en su


organización, si el ILS es necesario para admitir ciertas aplicaciones, porque los
clientes de TAPI que ejecutan Windows XP o un sistema operativo Windows Server
2003 pueden consultar los servidores ILS o las particiones del directorio de
aplicaciones TAPI.

Puede usar tapicfg para crear o quitar puntos de conexión de servicio. Si se cambia
el nombre de la partición del directorio de aplicaciones de TAPI por cualquier
motivo (por ejemplo, si se cambia el nombre del dominio en el que reside), deberá
eliminar el punto de conexión de servicio existente y crear uno nuevo que
contenga el nuevo nombre de DNS de la partición del directorio de aplicaciones
de TAPI que se va a publicar. De lo contrario, los clientes de TAPI no podrán
localizar la partición del directorio de aplicaciones de TAPI ni acceder a ella.
También puede eliminar un punto de conexión de servicio por motivos de
mantenimiento o seguridad (por ejemplo, si no quiere exponer datos de TAPI en
una partición específica del directorio de aplicaciones de TAPI).

Vínculos relacionados
Clave de sintaxis de línea de comandos

tapicfg install
tapicfg remove

tapicfg publishscp

tapicfg removescp

tapicfg show

tapicfg makedefault
tapicfg install
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea una partición de directorio de aplicación TAPI.

) Importante

Debe ser miembro del grupo Administradores de empresa en Active Directory para
ejecutar este comando.

Sintaxis

tapicfg install /directory:<partitionname> [/server:<DCname>]


[/forcedefault]

Parámetros

Parámetro Descripción

install Necesario. Especifica el nombre DNS de la partición del directorio de la


/directory: aplicación TAPI que se va a crear. Este nombre debe ser un nombre de dominio
<partitionname> completo.

/server: Especifica el nombre DNS del controlador de dominio en el que se crea la


<DCname> partición del directorio de la aplicación TAPI. Si no se especifica el nombre del
controlador de dominio, se usa el nombre del equipo local.

/forcedefault Especifica que este directorio es la partición del directorio de aplicación TAPI
predeterminada para el dominio. Puede haber varias particiones del directorio
de aplicación TAPI en un dominio.
Si este directorio es la primera partición de directorio de aplicación TAPI creada
en el dominio, se establece automáticamente como valor predeterminado,
independientemente de si usa la opción /forcedefault.

/? Muestra la ayuda en el símbolo del sistema.


Comentarios
Esta herramienta de línea de comandos se puede ejecutar en cualquier equipo que
sea miembro del dominio.

El texto proporcionado por el usuario (como los nombres de las particiones del
directorio de aplicaciones TAPI, los servidores y los dominios) con caracteres
internacionales o Unicode solo se muestra correctamente si se han instalado las
fuentes y el soporte de idioma adecuados.

Puede seguir usando servidores del Servicio de localización de Internet (ILS) en su


organización si el ILS es necesario para admitir ciertas aplicaciones porque los
clientes de TAPI que ejecutan Windows XP o un sistema operativo Windows Server
2003 pueden consultar los servidores ILS o las particiones del directorio de
aplicaciones TAPI.

Puede usar tapicfg para crear o quitar puntos de conexión de servicio. Si se cambia
el nombre de la partición del directorio de aplicaciones de TAPI por cualquier
motivo (por ejemplo, si se cambia el nombre del dominio en el que reside), deberá
eliminar el punto de conexión de servicio existente y crear uno nuevo que
contenga el nuevo nombre de DNS de la partición del directorio de aplicaciones
de TAPI que se va a publicar. De lo contrario, los clientes de TAPI no podrán
localizar la partición del directorio de aplicaciones de TAPI ni acceder a ella.
También puede eliminar un punto de conexión de servicio por motivos de
mantenimiento o seguridad (por ejemplo, si no quiere exponer datos de TAPI en
una partición específica del directorio de aplicaciones de TAPI).

Ejemplos
Para crear una partición de directorio de aplicación TAPI denominada
tapifiction.testdom.microsoft.com en un servidor denominado
testdc.testdom.microsoft.com y, a continuación, establecerlo como la partición de
directorio de la aplicación TAPI predeterminada para el nuevo dominio, escriba:

tapicfg install /directory:tapifiction.testdom.microsoft.com


/server:testdc.testdom.microsoft.com /forcedefault

Vínculos relacionados
Clave de sintaxis de línea de comandos
tapicfg remove

tapicfg publishscp

tapicfg removescp

tapicfg show

tapicfg makedefault
tapicfg remove
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Quita una partición de directorio de aplicación de TAPI.

) Importante

Debe ser miembro del grupo Administradores de empresa en Active Directory para
ejecutar este comando.

Sintaxis

tapicfg remove /directory:<partitionname>

Parámetros

Parámetro Descripción

quite Necesario. Especifica el nombre de DNS de la partición del directorio de


/directory: aplicaciones TAPI que se va a eliminar. Tenga en cuenta que este nombre debe
<partitionname> ser un nombre de dominio completo.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Esta herramienta de línea de comandos se puede ejecutar en cualquier equipo que
sea miembro del dominio.

El texto proporcionado por el usuario (como los nombres de las particiones del
directorio de aplicaciones TAPI, servidores y dominios) con caracteres
internacionales o Unicode solo se muestra correctamente si se han instalado el
soporte de idioma y las fuentes adecuados.
Puede seguir usando servidores del Servicio de localización de Internet (ILS) en su
organización, si el ILS es necesario para admitir ciertas aplicaciones, porque los
clientes de TAPI que ejecutan Windows XP o un sistema operativo Windows Server
2003 pueden consultar los servidores ILS o las particiones del directorio de
aplicaciones TAPI.

Puede usar tapicfg para crear o quitar puntos de conexión de servicio. Si se cambia
el nombre de la partición del directorio de aplicaciones de TAPI por cualquier
motivo (por ejemplo, si se cambia el nombre del dominio en el que reside), deberá
eliminar el punto de conexión de servicio existente y crear uno nuevo que
contenga el nuevo nombre de DNS de la partición del directorio de aplicaciones
de TAPI que se va a publicar. De lo contrario, los clientes de TAPI no podrán
localizar la partición del directorio de aplicaciones de TAPI ni acceder a ella.
También puede eliminar un punto de conexión de servicio por motivos de
mantenimiento o seguridad (por ejemplo, si no quiere exponer datos de TAPI en
una partición específica del directorio de aplicaciones de TAPI).

Vínculos relacionados
Clave de sintaxis de línea de comandos

tapicfg install

tapicfg publishscp

tapicfg removescp

tapicfg show

tapicfg makedefault
tapicfg publishscp
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea un punto de conexión de servicio para publicar una partición de directorio de


aplicación TAPI.

Sintaxis

tapicfg publishscp /directory:<partitionname> [/domain:<domainname>]


[/forcedefault]

Parámetros

Parámetro Descripción

publishscp Necesario. Especifica el nombre DNS de la partición del directorio de


/directory: aplicación TAPI que publicará el punto de conexión de servicio.
<partitionname>

/domain: Especifica el nombre DNS del dominio en el que se crea el punto de conexión
<domainname> de servicio. Si no se especifica el nombre del dominio, se usa el nombre del
dominio local.

/forcedefault Especifica que este directorio es la partición del directorio de aplicación TAPI
predeterminada para el dominio. Puede haber varias particiones del directorio
de aplicación TAPI en un dominio.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Esta herramienta de línea de comandos se puede ejecutar en cualquier equipo que
sea miembro del dominio.

El texto proporcionado por el usuario (como los nombres de las particiones del
directorio de aplicaciones TAPI, servidores y dominios) con caracteres
internacionales o Unicode solo se muestra correctamente si se han instalado el
soporte de idioma y las fuentes adecuados.

Puede seguir usando servidores del Servicio de localización de Internet (ILS) en su


organización, si el ILS es necesario para admitir ciertas aplicaciones, porque los
clientes de TAPI que ejecutan Windows XP o un sistema operativo Windows Server
2003 pueden consultar los servidores ILS o las particiones del directorio de
aplicaciones TAPI.

Puede usar tapicfg para crear o quitar puntos de conexión de servicio. Si se cambia
el nombre de la partición del directorio de aplicaciones de TAPI por cualquier
motivo (por ejemplo, si se cambia el nombre del dominio en el que reside), deberá
eliminar el punto de conexión de servicio existente y crear uno nuevo que
contenga el nuevo nombre de DNS de la partición del directorio de aplicaciones
de TAPI que se va a publicar. De lo contrario, los clientes de TAPI no podrán
localizar la partición del directorio de aplicaciones de TAPI ni acceder a ella.
También puede eliminar un punto de conexión de servicio por motivos de
mantenimiento o seguridad (por ejemplo, si no quiere exponer datos de TAPI en
una partición específica del directorio de aplicaciones de TAPI).

Vínculos relacionados
Clave de sintaxis de línea de comandos

tapicfg install

tapicfg remove

tapicfg removescp

tapicfg show

tapicfg makedefault
tapicfg removescp
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Quita un punto de conexión de servicio para una partición de directorio de aplicación


TAPI.

Sintaxis

tapicfg removescp /directory:<partitionname> [/domain:<domainname>]

Parámetros

Parámetro Descripción

removescp Necesario. Especifica el nombre DNS de la partición del directorio de la


/directory: aplicación TAPI para la que se quita un punto de conexión de servicio.
<partitionname>

/domain: Especifica el nombre DNS del dominio del que se quita el punto de conexión
<domainname> de servicio. Si no se especifica el nombre de dominio, se usa el nombre del
dominio local.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Esta herramienta de línea de comandos se puede ejecutar en cualquier equipo que
sea miembro del dominio.

El texto proporcionado por el usuario (como los nombres de las particiones del
directorio de aplicaciones TAPI, servidores y dominios) con caracteres
internacionales o Unicode solo se muestra correctamente si se han instalado el
soporte de idioma y las fuentes adecuados.

Puede seguir usando servidores del Servicio de localización de Internet (ILS) en su


organización, si el ILS es necesario para admitir ciertas aplicaciones, porque los
clientes de TAPI que ejecutan Windows XP o un sistema operativo Windows Server
2003 pueden consultar los servidores ILS o las particiones del directorio de
aplicaciones TAPI.

Puede usar tapicfg para crear o quitar puntos de conexión de servicio. Si se cambia
el nombre de la partición del directorio de aplicaciones de TAPI por cualquier
motivo (por ejemplo, si se cambia el nombre del dominio en el que reside), deberá
eliminar el punto de conexión de servicio existente y crear uno nuevo que
contenga el nuevo nombre de DNS de la partición del directorio de aplicaciones
de TAPI que se va a publicar. De lo contrario, los clientes de TAPI no podrán
localizar la partición del directorio de aplicaciones de TAPI ni acceder a ella.
También puede eliminar un punto de conexión de servicio por motivos de
mantenimiento o seguridad (por ejemplo, si no quiere exponer datos de TAPI en
una partición específica del directorio de aplicaciones de TAPI).

Vínculos relacionados
Clave de sintaxis de línea de comandos

tapicfg install

tapicfg remove

tapicfg publishscp

tapicfg show

tapicfg makedefault
tapicfg show
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra los nombres y ubicaciones de las particiones del directorio de aplicación TAPI
en el dominio.

Sintaxis

tapicfg show [/defaultonly] [/domain:<domainname>]

Parámetros

Parámetro Descripción

/default only Muestra los nombres y ubicaciones de solo la partición de directorio de la


aplicación TAPI predeterminada en el dominio.

/domain: Especifica el nombre DNS del dominio para el que se muestran las particiones del
<domainname> directorio de la aplicación TAPI. Si no se especifica el nombre de dominio, se usa
el nombre del dominio local.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Esta herramienta de línea de comandos se puede ejecutar en cualquier equipo que
sea miembro del dominio.

El texto proporcionado por el usuario (como los nombres de las particiones del
directorio de aplicaciones TAPI, los servidores y los dominios) con caracteres
internacionales o Unicode solo se muestra correctamente si se han instalado las
fuentes y el soporte de idioma adecuados.

Puede seguir usando servidores del Servicio de localización de Internet (ILS) en su


organización si el ILS es necesario para admitir ciertas aplicaciones porque los
clientes de TAPI que ejecutan Windows XP o un sistema operativo Windows Server
2003 pueden consultar los servidores ILS o las particiones del directorio de
aplicaciones TAPI.

Puede usar tapicfg para crear o quitar puntos de conexión de servicio. Si se cambia
el nombre de la partición del directorio de aplicaciones de TAPI por cualquier
motivo (por ejemplo, si se cambia el nombre del dominio en el que reside), deberá
eliminar el punto de conexión de servicio existente y crear uno nuevo que
contenga el nuevo nombre de DNS de la partición del directorio de aplicaciones
de TAPI que se va a publicar. De lo contrario, los clientes de TAPI no podrán
localizar la partición del directorio de aplicaciones de TAPI ni acceder a ella.
También puede eliminar un punto de conexión de servicio por motivos de
mantenimiento o seguridad (por ejemplo, si no quiere exponer datos de TAPI en
una partición específica del directorio de aplicaciones de TAPI).

Ejemplo
Para mostrar el nombre de la partición de directorio de aplicación TAPI predeterminada
para el nuevo dominio, escriba:

tapicfg show /defaultonly

Vínculos relacionados
Clave de sintaxis de línea de comandos

tapicfg install

tapicfg remove

tapicfg publishscp

tapicfg removescp

tapicfg makedefault
tapicfg makedefault
Artículo • 05/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Establece la partición de directorio de aplicación TAPI predeterminada para el dominio.

Sintaxis

tapicfg makedefault /directory:<partitionname> [/domain:<domainname>]

Parámetros

Parámetro Descripción

makedefault Necesario. Especifica el nombre DNS de la partición del directorio de


/directory: aplicación TAPI establecida como partición predeterminada para el
<partitionname> dominio. Este nombre debe ser un nombre de dominio completo.

/domain: <domainname> Especifica el nombre DNS del dominio para el que se establece como
predeterminada la partición del directorio de aplicación TAPI. Si no se
especifica el nombre del dominio, se usa el nombre del dominio local.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Esta herramienta de línea de comandos se puede ejecutar en cualquier equipo que
sea miembro del dominio.

El texto proporcionado por el usuario (como los nombres de las particiones del
directorio de aplicaciones TAPI, los servidores y los dominios) con caracteres
internacionales o Unicode solo se muestra correctamente si se han instalado las
fuentes y el soporte de idioma adecuados.

Puede seguir usando servidores del Servicio de localización de Internet (ILS) en su


organización, si el ILS es necesario para admitir ciertas aplicaciones, porque los
clientes de TAPI que ejecutan Windows XP o un sistema operativo Windows Server
2003 pueden consultar los servidores ILS o las particiones del directorio de
aplicaciones TAPI.

Puede usar tapicfg para crear o quitar puntos de conexión de servicio. Si se cambia
el nombre de la partición del directorio de aplicaciones de TAPI por cualquier
motivo (por ejemplo, si se cambia el nombre del dominio en el que reside), deberá
eliminar el punto de conexión de servicio existente y crear uno nuevo que
contenga el nuevo nombre de DNS de la partición del directorio de aplicaciones
de TAPI que se va a publicar. De lo contrario, los clientes de TAPI no podrán
localizar la partición del directorio de aplicaciones de TAPI ni acceder a ella.
También puede eliminar un punto de conexión de servicio por motivos de
mantenimiento o seguridad (por ejemplo, si no quiere exponer datos de TAPI en
una partición específica del directorio de aplicaciones de TAPI).

Vínculos relacionados
Clave de sintaxis de línea de comandos

tapicfg install

tapicfg remove

tapicfg publishscp

tapicfg removescp

tapicfg show
taskkill
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Finaliza uno o más procesos o tareas. Los procesos se pueden finalizar por el
identificador del proceso o el nombre de la imagen. Puede usar el comando tasklist para
determinar el id. de proceso (PID) del proceso que se va a finalizar.

7 Nota

Este comando reemplaza la herramienta kill.

Sintaxis

taskkill [/s <computer> [/u [<domain>\]<username> [/p [<password>]]]] {[/fi


<filter>] [...] [/pid <processID> | /im <imagename>]} [/f] [/t]

Parámetros

Parámetro Descripción

/s Especifica el nombre o la dirección IP de un equipo remoto (no se pueden usar


<computer> barras diagonales inversas). La opción predeterminada es el equipo local.

/u Ejecuta el comando con los permisos de cuenta del usuario especificado por
<domain>\ <username> o <domain>\<username> . El parámetro /u solo se puede especificar si
<username> también se especifica /s. El valor predeterminado es los permisos del usuario que
ha iniciado sesión en ese momento en el equipo que emite el comando.

/p Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u.


<password>

/fi <filter> Aplica un filtro para seleccionar un conjunto de tareas. Puede usar más de un filtro
o usar el carácter comodín ( * ) para especificar todas las tareas o nombres de
imagen. Los filtros válidos se enumeran en la sección Nombres, operadores y
valores de filtro de este artículo.
Parámetro Descripción

/pid Especifica el id. de proceso del proceso que se va a finalizar.


<processID>

/im Especifica el nombre de imagen del proceso que se va a finalizar. Use el carácter
<imagename> comodín ( * ) para especificar todos los nombres de imagen.

/f Especifica que los procesos se forzaron a finalizar. Este parámetro se omite para los
procesos remotos; todos los procesos remotos se fuerzan a finalizar.

/t Finaliza el proceso especificado y los procesos secundarios iniciados por él.

Nombres de filtro, operadores y valores

Nombre de Operadores Valor(es) válido(s)


filtro válidos

STATUS eq, ne RUNNING | NOT RESPONDING | UNKNOWN

IMAGENAME eq, ne Nombre de la imagen

PID eq, ne, gt, lt, Valor de PID


ge, le

SESSION eq, ne, gt, lt, Número de la sesión


ge, le

CPUtime eq, ne, gt, lt, Tiempo de CPU con el formato HH:MM:SS, donde MM y SS están
ge, le comprendidos entre 0 y 59 y HH es cualquier número sin signo

MEMUSAGE eq, ne, gt, lt, Uso de memoria en KB


ge, le

USERNAME eq, ne Cualquier nombre de usuario válido ( <user> o <domain\user> )

SERVICES eq, ne Nombre del servicio

WINDOWTITLE eq, ne Título de la ventana

MODULES eq, ne Nombre de DLL

Comentarios
Los filtros WINDOWTITLE y STATUS no se admiten cuando se especifica un
sistema remoto.
El carácter comodín ( * ) se acepta para la opción */im , solo cuando se aplica un
filtro.

Finalizar un proceso remoto siempre se lleva a cabo con fuerza,


independientemente de si se especifica la opción /f.

Si se proporciona un nombre de equipo al filtro de nombre de host, se apaga y se


detienen todos los procesos.

Ejemplos
Para finalizar los procesos con identificadores de proceso 1230, 1241 y 1253, escriba:

taskkill /pid 1230 /pid 1241 /pid 1253

Para finalizar con fuerza el proceso Notepad.exe si el sistema lo inició, escriba:

taskkill /f /fi "USERNAME eq NT AUTHORITY\SYSTEM" /im notepad.exe

Para finalizar todos los procesos en el equipo remoto Srvmain con un nombre de
imagen a partir de note, mientras usa las credenciales de la cuenta de usuario Hiropln,
escriba:

taskkill /s srvmain /u maindom\hiropln /p p@ssW23 /fi "IMAGENAME eq note*"


/im *

Para finalizar el proceso con el id. de proceso 2134 y los procesos secundarios que
inició, pero solo si esos procesos se iniciaron con la cuenta de administrador, escriba:

taskkill /pid 2134 /t /fi "username eq administrator"

Para finalizar todos los procesos que tienen un id. de proceso mayor o igual que 1000,
independientemente de sus nombres de imagen, escriba:
taskkill /f /fi "PID ge 1000" /im *

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando TaskList
tasklist
Artículo • 14/04/2023

Muestra una lista de procesos en ejecución actualmente en el equipo local o en un


equipo remoto. Tasklist sustituye a la herramienta tlist.

7 Nota

Este comando sustituye a la herramienta tlist.

Sintaxis

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 Descripción

/s Especifica el nombre o la dirección IP de un equipo remoto (no se pueden usar


<computer> barras diagonales inversas). La opción predeterminada es el equipo local.

/u Ejecuta el comando con los permisos de cuenta del usuario especificado por
<domain>\ <username> o por <domain>\<username> . El parámetro /u solo se puede especificar si
<username> también se especifica /s. El valor predeterminado son los permisos del usuario que
ha iniciado sesión actualmente en el equipo que emite el comando.

/p Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u.


<password>

/m Enumera todas las tareas con módulos DLL cargados que coinciden con el nombre
<module> de patrón especificado. Si no se especifica el nombre del módulo, esta opción
muestra todos los módulos cargados por cada tarea.

svc Enumera toda la información del servicio para cada proceso sin truncamiento.
Válido cuando el parámetro /fo se establece en table.

/v Muestra información detallada de la tarea en la salida. Para obtener una salida


detallada completa sin truncamiento, use /v y /svc juntos.
Parámetro Descripción

/fo {table Especifica el formato que se va a usar para la salida. Los valores válidos son table,
| list | lista y csv. El formato predeterminado para la salida es table.
csv}

/nh Suprime los encabezados de columna en la salida. Válido cuando el parámetro /fo
se establece en table o csv.

/fi Especifica los tipos de procesos que se van a incluir o excluir de la consulta. Puede
<filter> usar más de un filtro o usar el carácter comodín ( \ ) para especificar todas las tareas
o nombres de imagen. Los filtros válidos se enumeran en la sección Nombres,
operadores y valores de filtro de este artículo.

/? Muestra la ayuda en el símbolo del sistema.

Nombres de filtro, operadores y valores

Nombre de Operadores Valor(es) válido(s)


filtro válidos

STATUS eq, ne RUNNING | NOT RESPONDING | UNKNOWN . Este filtro no es compatible


si especifica un sistema remoto.

IMAGENAME eq, ne Nombre de la imagen

PID eq, ne, gt, lt, Valor de PID


ge, le

SESSION eq, ne, gt, lt, Número de la sesión


ge, le

SESSIONNAME eq, ne Nombre de sesión

CPUtime eq, ne, gt, lt, Tiempo de CPU con el formato HH:MM:SS, donde MM y SS están
ge, le comprendidos entre 0 y 59 y HH es cualquier número sin signo

MEMUSAGE eq, ne, gt, lt, Uso de memoria en KB


ge, le

USERNAME eq, ne Cualquier nombre de usuario válido ( <user> o <domain\user> )

SERVICES eq, ne Nombre del servicio

WINDOWTITLE eq, ne Título de ventana. Este filtro no es compatible si especifica un


sistema remoto.

MÓDULOS eq, ne Nombre de DLL


Ejemplos
Para enumerar todas las tareas con un identificador de proceso superior a 1000 y
mostrarlas en formato csv, escriba:

tasklist /v /fi "PID gt 1000" /fo csv

Para enumerar los procesos del sistema que se están ejecutando actualmente, escriba:

tasklist /fi "USERNAME ne NT AUTHORITY\SYSTEM" /fi "STATUS eq running"

Para enumerar información detallada de todos los procesos que se están ejecutando
actualmente, escriba:

tasklist /v /fi "STATUS eq running"

Para enumerar toda la información de servicio de los procesos en el srvmain del equipo
remoto, que tiene un nombre DLL que comienza por ntdll, escriba:

tasklist /s srvmain /svc /fi "MODULES eq ntdll*"

Para enumerar los procesos en el srvmain del equipo remoto usando las credenciales de
la cuenta de usuario con las que ha iniciado sesión actualmente, escriba:

tasklist /s srvmain

Para enumerar los procesos en el srvmain del equipo remoto usando las credenciales de
la cuenta de usuario Hiropln, escriba:

tasklist /s srvmain /u maindom\hiropln /p p@ssW23


Vínculos relacionados
Clave de sintaxis de línea de comandos
tcmsetup
Artículo • 14/04/2023

Configura o deshabilita el cliente TAPI. Para que TAPI funcione correctamente, debe
ejecutar este comando para especificar los servidores remotos que usarán los clientes
TAPI.

) Importante

Para utilizar este comando, debe ser miembro del grupo Administradores del
equipo local o tener delegada la autoridad adecuada. Si el equipo está unido a un
dominio, los miembros del grupo Administradores de dominio podrían llevar a
cabo este procedimiento. Como práctica de seguridad recomendada, piense en
usar Ejecutar como para llevar a cabo este procedimiento.

Sintaxis

tcmsetup [/q] [/x] /c <server1> [<server2> …]


tcmsetup [/q] /c /d

Parámetros

Parámetro Descripción

/q Impide que se muestren los cuadros de mensaje.

/x Especifica que se usarán devoluciones de llamada orientadas a la conexión en las


redes de tráfico intenso donde la pérdida de paquetes es elevada. Si se omite este
parámetro, se usarán devoluciones de llamada sin conexión.

/C Necesario. Especifica la configuración del cliente.

<server1> Necesario. Especifica el nombre del servidor remoto que contiene los proveedores
de servicios TAPI que usará el cliente. El cliente usará las líneas y teléfonos de los
proveedores de servicio. El cliente debe encontrarse en el mismo dominio que el
servidor o bien en un dominio que tenga una relación de confianza bidireccional
con el dominio que contiene el servidor.

<server2>… Especifica los servidores adicionales que estarán a disposición de este cliente. Si
especifica una lista de servidores, separe los nombres con un espacio.
Parámetro Descripción

/d Borra la lista de servidores remotos. Deshabilita el cliente TAPI, ya que le impide


usar los proveedores de servicios TAPI que se encuentran en los servidores remotos.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Para que un usuario del cliente pueda usar un teléfono o una línea en un servidor
TAPI, el administrador del servidor de telefonía debe asignar dicho usuario a ese
teléfono o línea.

La lista de servidores de telefonía creada con este comando reemplazará cualquier


lista existente que esté a disposición del cliente. Este comando no se puede usar
para agregar a la lista existente.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Introducción al shell de comandos

Especificación de los servidores de telefonía en un equipo cliente

Asignación de un usuario de telefonía a una línea o teléfono


telnet
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Se comunica con un equipo que ejecuta el servicio de servidor telnet. Al ejecutar este
comando sin parámetros, puede escribir el contexto de telnet como se indica en el
símbolo del sistema telnet (Microsoft telnet>). Desde el símbolo del sistema telnet,
puede usar comandos telnet para administrar el equipo que ejecuta el cliente telnet.

) Importante

Debe instalar el software cliente telnet para poder ejecutar este comando. Para
obtener más información, consulte Instalación de telnet.

Sintaxis

telnet [/a] [/e <escapechar>] [/f <filename>] [/l <username>] [/t {vt100 |
vt52 | ansi | vtnt}] [<host> [<port>]] [/?]

Parámetros

Parámetro Descripción

/a Intenta iniciar sesión automáticamente. Igual que la opción /l, salvo que usa el
nombre del usuario que ha iniciado sesión actualmente.

/e Especifica el carácter de escape utilizado para escribir el símbolo del sistema del
<escapechar> cliente telnet.

/f <filename> Especifica el nombre de archivo usado para el inicio de sesión de cliente.

/l <username> Especifica el nombre de usuario con el que iniciar sesión en el equipo remoto.

/t {vt100 | Especifica el tipo de terminal. Los tipos de terminal admitidos son vt100, vt52,
vt52 | ansi ansi y vtnt.
| vtnt}
Parámetro Descripción

<host> Especifica el nombre de host o la dirección IP del equipo remoto al que se va a


[<port>] conectar y, opcionalmente, el puerto TCP que se va a usar (el valor
predeterminado es el puerto TCP 23).

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para usar telnet para conectarse al equipo que ejecuta el servicio de servidor telnet en
telnet.microsoft.com, escriba:

telnet telnet.microsoft.com

Para usar telnet para conectarse al equipo que ejecuta el servicio de servidor telnet en
telnet.microsoft.com en el puerto TCP 44 y para registrar la actividad de sesión en un
archivo local denominado telnetlog.txt, escriba:

telnet /f telnetlog.txt telnet.microsoft.com 44

Vínculos relacionados
Clave de sintaxis de línea de comandos

Instalación de telnet

Referencia técnica de telnet


telnet: close
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cierra la conexión actual.

Sintaxis

c[lose]

Ejemplos
Para cerrar la conexión telnet actual, escriba:

Vínculos relacionados
Clave de sintaxis de línea de comandos
telnet: display
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra los parámetros operativos.

Sintaxis

d[isplay]

Ejemplos
Para mostrar los parámetros operativos, escriba:

Vínculos relacionados
Clave de sintaxis de línea de comandos
telnet: open
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Se conecta a un servidor telnet.

Sintaxis

o[pen] <hostname> [<port>]

Parámetros

Parámetro Descripción

<hostname> Especifica el nombre del equipo o la dirección IP.

[<port>] Especifica el puerto TCP en el que escucha el servidor telnet. El valor


predeterminado es el puerto TCP 23.

Ejemplos
Para conectarse a un servidor telnet en telnet.microsoft.com, escriba:

o telnet.microsoft.com

Vínculos relacionados
Clave de sintaxis de línea de comandos
telnet: quit
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Sale de telnet.

Sintaxis

q[uit]

Ejemplos
Para salir de telnet, escriba:

Vínculos relacionados
Clave de sintaxis de línea de comandos
telnet: send
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Envía comandos telnet al servidor telnet.

Sintaxis

sen {ao | ayt | brk | esc | ip | synch | <string>} [?]

Parámetros

Parámetro Descripción

ao Envía el comando telnet Abort Output.

ayt Envía el comando telnet Are You There?

brk Envía el comando telnet brk.

esc Envía el carácter de escape telnet actual.

ip Envía el comando telnet Interrupt Process.

sincronización Envía el comando telnet synch.

<string> Envía cualquier cadena que escriba al servidor telnet.

? Muestra la ayuda asociada a este comando.

Ejemplo
Para enviar el comando Are you there? al servidor telnet, escriba:

sen ayt
Vínculos relacionados
Clave de sintaxis de línea de comandos
telnet: set
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Establece opciones. Puede usar el comando telnet unset para desactivar una opción que
se estableció anteriormente.

Sintaxis

set [bsasdel] [crlf] [delasbs] [escape <char>] [localecho] [logfile


<filename>] [logging] [mode {console | stream}] [ntlm] [term {ansi | vt100 |
vt52 | vtnt}] [?]

Parámetros

Parámetro Descripción

bsasdel Envía retroceso como eliminar.

crlf Envía CR & LF (0x0D, 0x 0A) cuando se presiona la tecla Entrar. Conocido como
Modo de línea nueva.

delasbs Envía eliminar como retroceso.

escape Establece el carácter de escape utilizado para escribir el símbolo del sistema del
<character> cliente telnet. El carácter de escape puede ser un solo carácter o puede ser una
combinación de la tecla CTRL más un carácter. Para establecer una combinación de
Control y teclas, mantenga pulsada la tecla CTRL mientras escribe el carácter que
desea asignar.

localecho Activa el eco local.

logfile Registra la sesión de telnet actual en el archivo local. El registro se iniciará


<filename> automáticamente al establecer esta opción.

logging Activa el registro. Si no se establece ningún archivo de registro, se mostrará un


mensaje de error.
Parámetro Descripción

mode Establece el modo de operación.


{console |
stream}

ntlm Activa la autenticación NTLM.

term {ansi Establece el tipo de terminal.


| vt100 |
vt52 |
vtnt}

? Muestra ayuda para este comando.

Comentarios
En las versiones distintas a la inglesa de telnet, está disponible el codeset <option> .
Codeset <option> establece el conjunto de códigos actual en una opción, que
puede ser cualquiera de las siguientes: shift JIS, Japanese EUC, JIS Kanji, JIS Kanji
(78), DEC Kanji, NEC Kanji. Debe establecer el mismo conjunto de código en el
equipo remoto.

Ejemplo
Para establecer el archivo de registro y para comenzar el registro en el archivo local
tnlog.txt, escriba:

set logfile tnlog.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos
telnet: status
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información de estado.

Sintaxis

st[atus]

Ejemplo
Para mostrar la información de estado, escriba:

st

Vínculos relacionados
Clave de sintaxis de línea de comandos
telnet: unset
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Desactiva las opciones establecidas anteriormente.

Sintaxis

u {bsasdel | crlf | delasbs | escape | localecho | logging | ntlm} [?]

Parámetros

Parámetro Descripción

bsasdel Envía retroceso como retroceso.

crlf Envía la tecla Entrar como CR. También conocido como modo de avance de línea.

delasbs Envía eliminar como eliminar.

escape Quita la configuración del carácter de escape.

localecho Desactiva localecho.

logging Desactiva el registro.

ntlm Desactiva la autenticación NTLM.

? Muestra ayuda para este comando.

Ejemplo
Desactivación del registro.

u logging
Vínculos relacionados
Clave de sintaxis de línea de comandos
tftp
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Transfiere archivos hacia y desde un equipo remoto, normalmente un equipo que


ejecuta UNIX, que ejecuta el servicio Trivial File Transfer Protocol (tftp) o demonio. TFTP
lo usan principalmente los dispositivos o sistemas incrustados que recuperan firmware,
información de configuración o una imagen del sistema durante el proceso de arranque
desde un servidor TFTP.

[IMPORTANTE] El protocolo TFTP no admite ningún mecanismo de autenticación ni


cifrado, por lo que su presencia puede suponer un riesgo de seguridad. No se
recomienda instalar el cliente TFTP en sistemas conectados a Internet. Microsoft ya
no proporciona un servicio de servidor TFTP por motivos de seguridad.

Sintaxis

tftp [-i] [<host>] [{get | put}] <source> [<destination>]

Parámetros

Parámetro Descripción

-i Especifica el modo de transferencia de imágenes binarias (también denominado


modo octeto). En el modo de imagen binaria, el archivo se transfiere en
unidades de un byte. Use este modo al transferir archivos binarios. Si no usa la
opción -i, el archivo se transfiere en modo ASCII. Este es el modo de
transferencia predeterminado. Este modo convierte los caracteres de fin de línea
(EOL) en un formato adecuado para el equipo especificado. Use este modo al
transferir archivos de texto. Si una transferencia de archivos se realiza
correctamente, se muestra la velocidad de transferencia de datos.

<host> Especifica el equipo local o remoto.

get Transfiere el destino del archivo en el equipo remoto al origen del archivo en el
equipo local.
Parámetro Descripción

put Transfiere el origen del archivo en el equipo local al destino del archivo en el
equipo remoto. Dado que el protocolo TFTP no es compatible con la
autenticación de usuarios, el usuario debe haber iniciado sesión en el equipo
remoto y los archivos deben poder escribirse en el equipo remoto.

<source> Especifica el archivo que se va a transferir.

<destination> Especifica dónde transferir el archivo.

Ejemplos
Para copiar el archivo boot.img desde el equipo remoto Host1, escriba:

tftp -i Host1 get boot.img

Vínculos relacionados
Clave de sintaxis de línea de comandos
time
Artículo • 14/04/2023

Muestra o establece la hora del sistema. Si se usa sin parámetros, time muestra la hora
actual del sistema y le pide que escriba una nueva hora.

7 Nota

Debe ser administrador para cambiar la hora actual.

Sintaxis

time [/t | [<HH>[:<MM>[:<SS>]] [am|pm]]]

Parámetros

Parámetro Descripción

<HH>[:<MM> Establece la hora del sistema en la nueva hora especificada, donde HH está en horas
[:<SS>[. (obligatorio), MM está en minutos y SS está en segundos. NN se puede usar para
<NN>]]] especificar centésimas de segundo. Debe separar los valores de HH, MM y SS con
[am | pm] dos puntos (:). SS y NN se deben separar con un punto (.).

Si no se especifica am o pm, time usa el formato de 24 horas de forma


predeterminada.

/t Muestra la hora actual sin solicitarle una nueva hora.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Los valores válidos HH son los comprendidos entre 0 y 24.

Los valores válidos MM y SS van de 0 a 59.

Ejemplos
Si las extensiones de comandos están habilitadas, para mostrar la hora actual del
sistema, escriba:

time /t

Para cambiar la hora actual del sistema a las 5:30 p. m., escriba cualquiera de las
siguientes opciones:

time 17:30:00
time 5:30 pm

Para mostrar la hora actual del sistema, seguida de un mensaje para escribir una nueva
hora, escriba:

The current time is: 17:33:31.35


Enter the new time:

Para mantener la hora actual y volver al símbolo del sistema, presione ENTRAR. Para
cambiar la hora actual, escriba la nueva hora y presione ENTRAR.

Vínculos relacionados
Clave de sintaxis de línea de comandos
timeout
Artículo • 07/10/2023

Pausa el procesador de comandos durante el número de segundos especificado. Este


comando se usa normalmente en archivos por lotes.

Sintaxis

timeout /t <timeoutinseconds> [/nobreak]

Parámetros

Parámetro Descripción

/t Especifica el número decimal de segundos (entre -1 y 99999) que se


<timeoutinseconds> esperará antes de que el procesador de comandos continúe procesando. El
valor -1 hace que el equipo espere indefinidamente una pulsación de tecla.

/nobreak Especifica para pasar por alto los trazos de clave de usuario.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios

Una pulsación de tecla de usuario reanuda la ejecución del procesador de


comandos inmediatamente, incluso si el período de tiempo de espera no ha
expirado.

Cuando se usa junto con la herramienta suspensión del kit de recursos, el tiempo
de espera es similar al comando pausar.

Ejemplos
Para pausar el procesador de comandos durante diez segundos, escriba:

timeout /t 10
Para pausar el procesador de comandos durante 100 segundos y omitir cualquier
pulsación de tecla, escriba:

timeout /t 100 /nobreak

Para pausar el procesador de comandos indefinidamente hasta que se presione una


tecla, escriba:

timeout /t -1

Vínculos relacionados
Clave de sintaxis de línea de comandos
title
Artículo • 06/04/2023

Crea un título para la ventana del Símbolo del sistema.

Sintaxis

title [<string>]

Parámetros

Parámetro Descripción

<string> Especifica el texto que aparecerá como título de la ventana del Símbolo del sistema.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Para crear un título de ventana para programas por lotes, incluya el comando title
al principio de un programa por lotes.

Una vez establecido el título de una ventana, solo podrá restablecerlo usando el
comando title.

Ejemplos
Para cambiar el título de la ventana Símbolo del sistema a Actualización de archivos
mientras el archivo por lotes ejecuta el comando copy, y después para que el título
vuelva a Símbolo del sistema, escriba el script siguiente:

@echo off
title Updating Files
copy \\server\share\*.xls c:\users\common\*.xls
echo Files Updated.
title Command Prompt
Vínculos relacionados
Clave de sintaxis de línea de comandos
tlntadmn
Artículo • 17/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Administra un equipo local o remoto en el que se ejecuta el servicio telnet Server. Si se


usa sin parámetros, tlntadmn muestra la configuración actual del servidor.

Este comando requiere que inicie sesión en el equipo local con credenciales
administrativas. Para administrar un equipo remoto, también debe proporcionar
credenciales administrativas para el equipo remoto. Para ello, inicie sesión en el equipo
local con una cuenta que tenga credenciales administrativas para el equipo local y el
equipo remoto. Si no puede usar este método, puede usar los parámetros -u y -p para
proporcionar credenciales administrativas para el equipo remoto.

Sintaxis

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 Descripción

<computername> Especifica el nombre del servidor al que conectarse. La opción predeterminada


es el equipo local.

-u <username> Especifica las credenciales administrativas de un servidor remoto que desea


-p <password> administrar. Este parámetro es necesario si desea administrar un servidor
remoto en el que no ha iniciado sesión con credenciales administrativas.

start Inicia el servicio de servidor telnet.

stop Detiene el servicio de servidor telnet.

pause Pausa el servicio de servidor telnet. No se aceptarán nuevas conexiones.


Parámetro Descripción

continue Reanuda el servicio de servidor telnet.

-s {<sessionID> Muestra sesiones telnet activas.


| all}

-k Termina las sesiones telnet. Escriba el id. de sesión para finalizar una sesión
{<sessionID> | específica o escriba all para finalizar todas las sesiones.
all}

-m Envía un mensaje a una o más sesiones. Escriba el id. de sesión para enviar un
{<sessionID> | mensaje a una sesión específica o escriba all para enviar un mensaje a todas las
all} <message> sesiones. Escriba el mensaje que desea enviar entre comillas.

config dom = Configura el dominio predeterminado para el servidor.


<domain>

config Especifica si desea que el servidor telnet interprete CTRL+A como ALT. Escriba
ctrlakeymap = yes para asignar la tecla de método abreviado o escriba no para evitar la
{yes | no} asignación.

config timeout Establece el período de tiempo de espera en horas, minutos y segundos.


= <hh>:<mm>:
<ss>

config Habilita el tiempo de espera de la sesión inactiva.


timeoutactive
= {yes | no}

config maxfail Establece el número máximo de intentos de inicio de sesión erróneos antes de
= <attempts> la desconexión.

config Establece el número máximo de conexiones.


maxconn =
<connections>

config port = Establece el puerto telnet. Debe especificar el puerto con un entero menor que
<number> 1024.

config sec {+ | Especifica si desea usar NTLM, una contraseña, o ambos para autenticar los
-}NTLM {+ | intentos de inicio de sesión. Para usar un tipo determinado de autenticación,
-}passwd escriba un signo más (+) antes de ese tipo de autenticación. Para evitar usar un
tipo determinado de autenticación, escriba un signo menos (-) antes de ese
tipo de autenticación.

config mode = Especifica el modo de operación.


{console |
stream}

-? Muestra la ayuda en el símbolo del sistema.


Ejemplos
Para configurar el tiempo de espera de la sesión inactiva en 30 minutos, escriba:

tlntadmn config timeout=0:30:0

Para mostrar sesiones telnet activas, escriba:

tlntadmn -s

Vínculos relacionados
Clave de sintaxis de línea de comandos

Guía de operaciones telnet


tpmtool
Artículo • 08/04/2023

Esta utilidad se puede usar para obtener información sobre el módulo de plataforma
segura (TPM).

) Importante

Parte de la información puede referirse al producto en versión preliminar, que


puede modificarse sustancialmente antes de su lanzamiento comercial. Microsoft
no otorga ninguna garantía, explícita o implícita, con respecto a la información
proporcionada aquí.

Sintaxis

tpmtool /parameter [<arguments>]

Parámetros

Parámetro Descripción

getdeviceinformation Muestra la información básica del TPM. Consulte el artículo Parámetros


del método Win32_Tpm::IsReadyInformation para más información sobre
los valores de la marca de información.

gatherlogs [ruta de Recopila registros de TPM y los coloca en el directorio especificado. Si ese
acceso del directorio directorio no existe, se crea. De manera predeterminada, los archivos de
de salida] registro se colocan en el directorio actual. Los posibles archivos
generados son:
TpmEvents.evtx
TpmInformation.txt
SRTMBoot.dat
SRTMResume.dat
DRTMBoot.dat
DRTMResume.dat

drivertracing [start Inicia o detiene la recopilación de seguimientos del controlador de TPM.


| stop] El registro de seguimiento, TPMTRACE.etl, se crea y coloca en el directorio
actual.
Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para mostrar la información básica del TPM, escriba:

tpmtool getdeviceinformation

Para recopilar registros de TPM y colocarlos en el directorio actual, escriba:

tpmtool gatherlogs

Para recopilar registros de TPM y colocarlos en C:\Users\Public , escriba:

tpmtool gatherlogs C:\Users\Public

Para recopilar seguimientos del controlador de TPM, escriba:

tpmtool drivertracing start


# Run scenario
tpmtool drivertracing stop

Vínculos relacionados
Clave de sintaxis de línea de comandos

Códigos de error COM (TPM, PLA, FVE)


tpmvscmgr
Artículo • 09/04/2023

La herramienta de línea de comandos tpmvscmgr permite a los usuarios con


credenciales administrativas crear y eliminar tarjetas inteligentes virtuales de TPM en un
equipo.

Sintaxis

tpmvscmgr create [/name] [/adminkey DEFAULT | PROMPT | RANDOM] [/PIN DEFAULT


| PROMPT] [/PUK DEFAULT | PROMPT] [/generate] [/machine] [/?]

tpmvscmgr destroy [/instance <instanceID>] [/?]

Creación de parámetros
El comando Create configura nuevas tarjetas inteligentes virtuales en el sistema del
usuario. También devuelve el identificador de instancia de la tarjeta recién creada para
una referencia posterior, si se requiere eliminación. El identificador de instancia tiene el
formato ROOT\SMARTCARDREADER\000n, donde n comienza desde 0 y aumenta en 1
cada vez que se crea una nueva tarjeta inteligente virtual.

Parámetro Descripción

/name Necesario. Indica el nombre de la nueva tarjeta inteligente virtual.

/adminkey Indica la clave de administrador deseada que se puede usar para restablecer el PIN
de la tarjeta si el usuario olvida el PIN. Esto puede incluir:
DEFAULT: especifica el valor predeterminado de
010203040506070801020304050607080102030405060708.
PROMPT: solicita al usuario que escriba un valor para la clave de
administrador.
RANDOM: da como resultado una configuración aleatoria para la clave de
administrador de una tarjeta que no se devuelve al usuario. Esto crea una
tarjeta que podría no ser manejable mediante herramientas de administración
de tarjetas inteligentes. Al usar la opción RANDOM, la clave de administrador
debe escribirse como 48 caracteres hexadecimales.
Parámetro Descripción

/PIN Indica el valor deseado del PIN del usuario.


DEFAULT : especifica el PIN predeterminado de 12345678.
PROMPT: solicita al usuario que escriba un PIN en la línea de comandos. El
PIN debe tener un mínimo de ocho caracteres y puede contener números,
caracteres y caracteres especiales.

/PUK Indica el valor de clave de desbloqueo de PIN (PUK) deseado. El valor PUK debe
tener un mínimo de ocho caracteres y puede contener números, caracteres y
caracteres especiales. Si se omite el parámetro, la tarjeta se crea sin PUK. Entre estas
opciones se incluyen:
DEFAULT: especifica la PUK predeterminada de 12345678.
PROMPT: solicita al usuario que escriba una PUK en la línea de comandos.

/generate Genera los archivos en el almacenamiento necesarios para que funcione la tarjeta
inteligente virtual. Si no usa el parámetro /generate, es como si creara la tarjeta sin
el sistema de archivos subyacente. Una tarjeta sin un sistema de archivos solo se
puede administrar mediante un sistema de administración de tarjetas inteligentes,
como Microsoft Configuration Manager.

/machine Permite especificar el nombre de un equipo remoto en el que se puede crear la


tarjeta inteligente virtual. Esto solo se puede usar en un entorno de dominio y se
basa en DCOM. Para que el comando cree correctamente una tarjeta inteligente
virtual en otro equipo, el usuario que ejecuta este comando debe ser miembro del
grupo de administradores locales del equipo remoto.

/? Muestra ayuda para este comando.

Parámetros Destroy
El comando Destroy elimina de forma segura una tarjeta inteligente virtual del equipo
del usuario.

2 Advertencia

Si se elimina una tarjeta inteligente virtual, no se puede recuperar.

Parámetro Descripción

/instance Especifica el identificador de instancia de la tarjeta inteligente virtual que se va a


quitar. El identificador de instancia se generó como salida tpmvscmgr.exe cuando se
creó la tarjeta. El parámetro /instance es un campo obligatorio para el comando
Destroy.
Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Para las entradas alfanuméricas, se permite el juego ASCII completo de 127
caracteres.

Ejemplos
Para crear una tarjeta inteligente virtual que se pueda administrar posteriormente
mediante una herramienta de administración de tarjetas inteligentes iniciada desde otro
equipo, escriba:

tpmvscmgr.exe create /name VirtualSmartCardForCorpAccess /AdminKey DEFAULT


/PIN PROMPT

Como alternativa, en lugar de usar una clave de administrador predeterminada, puede


crear una clave de administrador en la línea de comandos. El siguiente comando
muestra cómo crear una clave de administrador.

tpmvscmgr.exe create /name VirtualSmartCardForCorpAccess /AdminKey PROMPT


/PIN PROMPT

Para crear una tarjeta inteligente virtual no administrada que se pueda usar para
inscribir certificados, escriba:

tpmvscmgr.exe create /name VirtualSmartCardForCorpAccess /AdminKey RANDOM


/PIN PROMPT /generate

Se crea una tarjeta inteligente virtual con una clave de administrador aleatoria. La clave
se descarta automáticamente después de crear la tarjeta. Esto significa que si el usuario
olvida el PIN o quiere cambiarlo, deberá eliminar la tarjeta y volver a crearla.

Para eliminar la tarjeta, escriba:


tpmvscmgr.exe destroy /instance <instance ID>

Donde <instanceID> es el valor impreso en la pantalla cuando el usuario creó la tarjeta.


En concreto, para la primera tarjeta creada, el identificador de instancia es
ROOT\SMARTCARDREADER\0000.

Vínculos relacionados
Clave de sintaxis de línea de comandos
tracerpt
Artículo • 08/04/2023

El comando tracerpt analiza los registros de seguimiento de eventos, los archivos de


registro generados por el Monitor de rendimiento y los proveedores de seguimiento de
eventos en tiempo real. También genera archivos de volcado, archivos de informe y
esquemas de informe.

Sintaxis

tracerpt <[-l] <value [value [...]]>|-rt <session_name [session_name


[...]]>> [options]

Parámetros

Parámetros Descripción

-config Especifica el archivo de configuración que se va a cargar, que incluye las


<filename> opciones de comando.

-y Especifica que responda sí a todas las preguntas, sin preguntar.

-f <XML | Especifica el formato de archivo de informe.


HTML>

-of <CSV | Especifica el formato de archivo de volcado. El valor predeterminado es *XML.


EVTX | XML>

-df <filename> Especifica la creación de un archivo de esquema de informes o recuento


específico de Microsoft.

-int <filename> Especifica el volcado de la estructura de eventos interpretados en el archivo


especificado.

-rts Especifica que se agregue la marca de tiempo sin procesar del informe en el
encabezado de seguimiento de eventos. Solo se puede usar con -o. No se
admite con -report o -summary.

-tmf Especifica qué archivo de definición de formato de mensaje de seguimiento se


<filename> va a usar.

-tp <value> Especifica la ruta de búsqueda de archivos TMF. Se pueden usar varias rutas de
acceso separadas por un punto y coma (;).
Parámetros Descripción

-i <value> Especifica la ruta de acceso de la imagen del proveedor. La PDB coincidente se


ubicará en el servidor de símbolos. Se pueden usar varias rutas de acceso
separadas por un punto y coma (;).

-pdb <value> Especifica la ruta de acceso del servidor de símbolos. Se pueden usar varias
rutas de acceso separadas por un punto y coma (;).

-gmt Especifica que se conviertan las marcas de tiempo de la carga útil WPP a la hora
del meridiano de Greenwich.

-rl <value> Especifica el nivel de informe del sistema de 1 a 5. El valor predeterminado es 1.

-summary Especifica que se cree un archivo de texto de informe de resumen. El nombre de


[filename] archivo, si no se especifica, es summary.txt.

-o [filename] Especifica que se cree un archivo de salida de texto. El nombre de archivo, si no


se especifica, es dumpfile.xml.

-report Especifica que se cree un archivo de informe de salida de texto. El nombre de


[filename] archivo, si no se especifica, es workload.xml.

-lr Especifica que sea menos restrictivo. Usa el mayor esfuerzo para los eventos
que no coinciden con el esquema de eventos.

-export Especifica que se cree un archivo de exportación de esquema de eventos. El


[filename] nombre de archivo, si no se especifica, es schema.man.

[-l] <value Especifica el archivo de registro de seguimiento de eventos que se va a


[value […]]> procesar.

-rt Especifica los orígenes de datos de la sesión de seguimiento de eventos en


<session_name tiempo real.
[session_name
[…]]>

-? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para crear un informe basado en los dos registros de eventos logfile1.etl y logfile2.etl, y
para crear el archivo de volcado de memoria logdump.xml en formato XML, escriba:

tracerpt logfile1.etl logfile2.etl -o logdump.xml -of XML


Para crear un informe basado en el archivo de registro de eventos logfile.etl, para crear
el archivo de volcado de memoria logdmp.xml en formato XML, para usar el mayor
esfuerzo para identificar eventos que no están en el esquema y para generar un archivo
de informe de resumen logdump.txt y un archivo de informe, logrpt.xml, escriba:

tracerpt logfile.etl -o logdmp.xml -of XML -lr -summary logdmp.txt -report


logrpt.xml

Para usar los dos registros de eventos logfile1.etl y logfile2.etl para generar un archivo de
volcado de memoria y para notificar el archivo con los nombres de archivo
predeterminados, escriba:

tracerpt logfile1.etl logfile2.etl -o -report

Para usar el registro de eventos logfile.etl y el registro de rendimiento counterfile.blg


para producir el archivo de informe logrpt.xml y el archivo de esquema XML específico
de Microsoft schema.xml, escriba:

tracerpt logfile.etl counterfile.blg -report logrpt.xml -df schema.xml

Para leer el registrador del kernel NT de la sesión de seguimiento de eventos en tiempo


real y producir el archivo de volcado logfile.csv en formato CSV, escriba:

tracerpt -rt NT Kernel Logger -o logfile.csv -of CSV

Vínculos relacionados
Clave de sintaxis de línea de comandos
tracert
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Esta herramienta de diagnóstico determina la ruta de acceso a un destino mediante el


envío de mensajes de solicitud de eco del Protocolo de mensajes de control de Internet
(ICMP) o ICMPv6 al destino con valores de campo de período de vida (TTL) cada vez
mayores. Cada enrutador a lo largo de la ruta de acceso debe disminuir el TTL de un
paquete IP en al menos 1 antes de reenviarlo. En la práctica, el TTL es un contador
máximo de vínculos. Cuando el TTL de un paquete alcanza 0, se espera que el enrutador
devuelva un mensaje ICMP time Exceeded al equipo de origen.

Este comando determina la ruta de acceso enviando el primer mensaje de solicitud de


eco con un TTL de 1 e incrementando el TTL en 1 en cada transmisión posterior hasta
que el destino responde o se alcanza el número máximo de saltos. El número máximo
de saltos es 30 de forma predeterminada y se puede especificar mediante el parámetro
/h.

La ruta de acceso se determina examinando los mensajes de ICMP time Exceeded


devueltos por los enrutadores intermedios y el mensaje de eco de respuesta devuelto
por el destino. Sin embargo, algunos enrutadores no devuelven mensajes de tiempo
excedido para paquetes con valores TTL vencidos y son invisibles para el comando
tracert. En este caso, se muestra una fila de asteriscos ( * ) para ese salto. La ruta de
acceso mostrada es la lista de interfaces de enrutador cercano/lateral de los enrutadores
en la ruta de acceso entre un host de origen y un destino. La interfaz cercana/lateral es
la interfaz del enrutador que está más cerca del host emisor en la ruta de acceso.

) Importante

Este comando solo está disponible si el protocolo de Internet (TCP / IP) está
instalado como componente en las propiedades de un adaptador de red en
conexiones de red.

El uso del comando pathping permite realizar un seguimiento de una ruta de


acceso y proporcionar la latencia de la red y la pérdida de paquetes de cada
enrutador y vínculo de la ruta.
Sintaxis

tracert [/d] [/h <maximumhops>] [/j <hostlist>] [/w <timeout>] [/R] [/S
<srcaddr>] [/4][/6] <targetname>

Parámetros

Parámetro Descripción

/d Detiene los intentos de resolver las direcciones IP de los enrutadores


intermedios en sus nombres. Esto puede acelerar la devolución de los
resultados.

/h Especifica el número máximo de saltos en la ruta de acceso para buscar el


<maximumhops> destino. El valor predeterminado es de 30 saltos.

/j <hostlist> Especifica que los mensajes de solicitud de eco usan la opción Ruta de origen
flexible en la cabecera IP con el conjunto de destinos intermedios especificados
en <hostlist> . Con el enrutamiento de origen flexible, los destinos intermedios
sucesivos se pueden separar por uno o varios enrutadores. El número máximo
de direcciones o nombres de la lista es 9. <hostlist> es una serie de direcciones
IP (en notación decimal con puntos) separadas por espacios. Use este parámetro
solo cuando realice el seguimiento de direcciones IPv4.

/w <timeout> Especifica la cantidad de tiempo en milisegundos que se debe esperar a que se


reciba el mensaje ICMP time Exceeded o de respuesta de eco correspondiente a
un mensaje de solicitud de eco dado. Si no se recibe dentro del tiempo de
espera, se muestra un asterisco ( * ). El tiempo de espera predeterminado es
4000 (4 segundos).

/R Especifica que el encabezado de extensión de enrutamiento IPv6 se usa para


enviar un mensaje de solicitud de eco al host local, usando el destino como
destino intermedio y probando la ruta inversa.

/S <srcaddr> Especifica la dirección de origen que se va a usar en los mensajes de solicitud de


eco. Use este parámetro solo cuando realice el seguimiento de direcciones IPv6.

/4 Especifica que tracert.exe solo puede usar IPv4 para este seguimiento.

/6 Especifica que tracert.exe solo puede usar IPv6 para este seguimiento.

<targetname> Especifica el destino, identificado por dirección IP o nombre de host.

/? Muestra la ayuda en el símbolo del sistema.


Ejemplos
Para realizar el seguimiento de la ruta de acceso al host denominado
www.microsoft.com , escriba:

tracert www.microsoft.com

Este es un ejemplo de salida:

Resultados

Tracing route to e13678.dscb.akamaiedge.net [23.216.93.114]


over a maximum of 30 hops:

1 1 ms 1 ms <1 ms <devicename>.mshome.net [172.26.96.1]


2 11 ms 13 ms 6 ms 192.168.191.20
3 20 ms 11 ms 18 ms 192.168.1.1
4 44 ms 41 ms 35 ms 10.228.0.1
5 32 ms 31 ms 46 ms 10.41.0.49
6 36 ms 39 ms 30 ms 10.41.0.221
7 35 ms 36 ms 39 ms 10.41.0.225
8 54 ms 45 ms 50 ms 204.111.0.147
9 50 ms 52 ms 47 ms ae-39.a02.atlnga05.us.bb.gin.ntt.net
[128.241.219.117]
10 53 ms 51 ms 61 ms ae-5.r24.atlnga05.us.bb.gin.ntt.net
[129.250.4.192]
11 64 ms 45 ms 44 ms ae-0.a03.atlnga05.us.bb.gin.ntt.net
[129.250.2.20]
12 49 ms 67 ms 46 ms ae-0.akamai-onnet.atlnga05.us.bb.gin.ntt.net
[128.241.1.122]
13 67 ms 287 ms *
ae20.r03.border101.atl02.fab.netarch.akamai.com [23.203.144.21]
14 * * * Request timed out.
15 * * * Request timed out.
16 * * * Request timed out.
17 204 ms 58 ms 51 ms a23-216-93-
114.deploy.static.akamaitechnologies.com [23.216.93.114]

Trace complete.

La columna inicial muestra el número de salto a partir del 1 y se incrementa con cada
salto a lo largo de la ruta desde el dispositivo hasta el destino. Cada salto representa un
dispositivo intermedio, como un enrutador, que el paquete pasa mientras viaja al
destino final.
Las tres columnas centrales muestran el tiempo de ida y vuelta en milisegundos (ms)
para que un paquete viaje desde el dispositivo hasta el enrutador, en ese salto
específico, y de vuelta al dispositivo. Se conoce como "tiempo de ping" o "latencia de
ping" y mide el retraso en milisegundos del recorrido de ida y vuelta de los datos al
enrutador. La latencia de red puede verse afectada por factores como la congestión de
la red, la calidad de los vínculos de red y la distancia entre saltos.

La columna final muestra la dirección IP o el nombre de host del enrutador o el


dispositivo intermedio en ese salto específico de la ruta de acceso de red. En la mayoría
de los casos, verá la dirección IP, pero si la búsqueda inversa de DNS se realiza
correctamente, muestra los nombres de host, que pueden ayudar a identificar
enrutadores por nombre.

Para realizar un seguimiento de la ruta de acceso al host denominado


www.microsoft.com e impedir la resolución de cada dirección IP en su nombre, escriba:

tracert /d www.microsoft.com

Para realizar un seguimiento de la ruta de acceso al host denominado


www.microsoft.com y usar la ruta de origen flexible 10.12.0.1/10.29.3.1/10.1.44.1, escriba:

tracert /j 10.12.0.1 10.29.3.1 10.1.44.1 www.microsoft.com

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando pathping
tree
Artículo • 14/04/2023

Muestra la estructura de directorios de una ruta de acceso o del disco en una unidad
gráficamente. La estructura mostrada por este comando depende de los parámetros
que especifique en el símbolo del sistema. Si no especifica una unidad o ruta de acceso,
este comando muestra la estructura de árbol que comienza con el directorio actual de la
unidad actual.

Sintaxis

tree [<drive>:][<path>] [/f] [/a]

Parámetros

Parámetro Descripción

<drive>: Especifica la unidad que contiene el disco para el que desea mostrar la estructura de
directorios.

<path> Especifica el directorio para el que desea mostrar la estructura de directorios.

/f Muestra los nombres de los archivos de cada directorio.

/a Especifica que se usen caracteres de texto en lugar de caracteres gráficos para


mostrar las líneas que vinculan subdirectorios.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para mostrar los nombres de todos los subdirectorios del disco en la unidad actual,
escriba:

tree \
Para mostrar, de pantalla en pantalla, los archivos de todos los directorios de la unidad
C, escriba:

tree c:\ /f | more

Para imprimir una lista de todos los directorios de la unidad C en un archivo, escriba:

tree c:\ /f > <driveletter>:\<filepath>\filename.txt

Vínculos relacionados
Clave de sintaxis de línea de comandos
tscon
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Se conecta a otra sesión en un servidor host de sesión de escritorio remoto.

) Importante

Debe tener permiso de acceso de control total o permiso de acceso especial de


conexión para conectarse a otra sesión.

7 Nota

Para conocer las novedades de la última versión, consulte Novedades de servicios


de escritorio remoto en Windows Server.

Sintaxis

tscon {<sessionID> | <sessionname>} [/dest:<sessionname>] [/password:<pw> |


/password:*] [/v]

Parámetros

Parámetro Descripción

<sessionID> Especifica el id. de la sesión a la que quiere conectarse. Si usa el parámetro


opcional /dest:<sessionname> , también puede especificar el nombre de la
sesión actual.

<sessionname> Especifica el id. de la sesión a la que quiere conectarse.

/dest: <sessionname> Especifica el nombre de la sesión actual. Esta sesión se desconectará


cuando se conecte a la nueva. También puede usar este parámetro para
conectar la sesión de otro usuario a una sesión diferente.
Parámetro Descripción

/password: <pw> Especifica la contraseña del usuario que posee la sesión a la que quiere
conectarse. Esta contraseña es necesaria cuando el usuario que se conecta
no posee la sesión.

/password: * Solicita la contraseña del usuario que posee la sesión a la que quiere
conectarse.

/v Muestra información sobre las acciones que se realizan.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Este comando produce un error si no especifica una contraseña en el parámetro
/password y la sesión de destino pertenece a un usuario distinto del actual.

No se puede conectar a la sesión de consola.

Ejemplos
Para conectarse a la sesión 12 en el servidor host de sesión de Servicios de Escritorio
remoto actual y desconectar la sesión actual, escriba:

tscon 12

Para conectarse a la sesión 23 en el servidor host de sesión de servicios de escritorio


remoto actual, con la contraseña mypass, y desconectar la sesión actual, escriba:

tscon 23 /password:mypass

Para conectar la sesión denominada TERM03 a la sesión denominada TERM05 y, a


continuación, desconectar la sesión TERM05, escriba:

tscon TERM03 /v /dest:TERM05


Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


tsdiscon
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Desconecta una sesión de un servidor host de sesión de Escritorio remoto. Si no


especifica un identificador de sesión o un nombre de sesión, este comando desconecta
la sesión actual.

) Importante

Debe tener permiso de Acceso de control total o permiso de Acceso especial de


desconexión para desconectar a otro usuario de una sesión.

7 Nota

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de Escritorio remoto en Windows Server.

Sintaxis

tsdiscon [<sessionID> | <sessionname>] [/server:<servername>] [/v]

Parámetros

Parámetro Descripción

<sessionID> Especifica el identificador de la sesión que se va a desconectar.

<sessionname> Especifica el nombre de la sesión que se va a desconectar.

/server: <servername> Especifica el servidor de terminal que contiene la sesión que quiere
desconectar. En caso contrario, se usará el servidor host de sesión de
Escritorio remoto actual. Este parámetro solo es necesario si ejecuta el
comando tsdiscon desde un servidor remoto.
Parámetro Descripción

/v Muestra información sobre las acciones que se realizan.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Cualquier aplicación que se estuviera ejecutando cuando desconectó la sesión se
ejecutará automáticamente cuando vuelva a conectarse a esa sesión sin pérdida de
datos. Puede usar el comando reset session para finalizar las aplicaciones en
ejecución de la sesión desconectada, pero esto puede provocar la pérdida de
datos en la sesión.

La sesión de consola no se puede desconectar.

Ejemplos
Para desconectar la sesión actual, escriba:

tsdiscon

Para desconectar la Sesión 10, escriba:

tsdiscon 10

Para desconectar la sesión denominada TERM04, escriba:

tsdiscon TERM04

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


Comando reset session
tsecimp
Artículo • 14/04/2023

TSecImp importa la información de asignaciones de líneas y teléfonos desde un archivo


de lenguaje de marcado extensible (XML) al archivo de seguridad del servidor de
telefonía (Tsec.ini). Además, puede usar este comando para ver la lista de proveedores
de TAPI, así como las líneas y los dispositivos asociados a cada uno de ellos, validar la
estructura del archivo XML sin importar el contenido y comprobar la pertenencia al
dominio.

Sintaxis

tsecimp /f <filename> [{/v | /u}]


tsecimp /d

Parámetros

Parámetro Descripción

/f Necesario. Especifica el nombre del archivo XML que contiene la información de


<filename> asignaciones que desea importar.

/v Valida la estructura del archivo XML sin importar la información al archivo Tsec.ini.

/U Comprueba si cada usuario pertenece al dominio especificado en el archivo XML. El


equipo donde use este parámetro deberá estar conectado a la red. Es posible que el
parámetro reduzca considerablemente el rendimiento si se procesa una gran
cantidad de información de asignaciones de usuarios.

/d Muestra una lista de los proveedores de telefonía instalados. Para cada proveedor
de telefonía, se enumeran los dispositivos de línea asociados, así como las
direcciones y los usuarios asociados a cada dispositivo de línea.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
El archivo XML desde el cual desea importar la información de asignaciones debe
respetar la estructura que se describe a continuación:
XML

<UserList>
<User>
<LineList>
<Line>

<Userlist element> : es el elemento superior del archivo XML.

<User element> : cada elemento contiene información acerca de un usuario que

pertenece a un dominio. Es posible asignar uno o varios dispositivos de línea a


cada usuario. Además, es posible que cada elemento de User contenga un atributo
denominado NoMerge. Cuando se especifica este atributo, se quitan todas las
asignaciones de dispositivos de línea del usuario antes de realizar nuevas
asignaciones. Puede usar este atributo para quitar fácilmente las asignaciones de
usuario no deseadas. De forma predeterminada, este atributo no está establecido.
El elemento User debe contener un solo elemento DomainUserName, que
especifica el dominio y el nombre del usuario. El elemento User también puede
contener un elemento FriendlyName, que especifica un nombre descriptivo para el
usuario. El elemento User puede contener un elemento LineList. Si el elemento
LineList no está presente, se quitan todos los dispositivos de línea de este usuario.

<LineList element> : contiene información acerca de cada línea o dispositivo que

podría asignarse al usuario. Cada elemento LineList puede contener más de una
línea.

<Line element> : especifica un dispositivo de línea. Se debe identificar cada

dispositivo de línea mediante la inclusión de un elemento Address o de un


elemento PermanentID en el elemento Line. En cada elemento Line, se puede
establecer el atributo Remove. Si se establece este atributo, el dispositivo de línea
deja de estar asignado al usuario. Si no se establece este atributo, el usuario
obtiene acceso a dicho dispositivo de línea. Si el dispositivo de línea no está
disponible para el usuario, no se recibe ningún mensaje de error.

Salida de ejemplo para el parámetro /d

Esta salida de ejemplo aparece después de ejecutar el parámetro /d para mostrar la


configuración actual de TAPI. Para cada proveedor de telefonía, se enumeran los
dispositivos de línea asociados, así como las direcciones y los usuarios asociados a cada
dispositivo de línea.
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

Ejemplos
Para quitar todos los dispositivos de línea asignados a User1, escriba:

XML

<UserList>
<User NoMerge=1>
<DomainUser>domain1\user1</DomainUser>
</User>
</UserList>

Para quitar todos los dispositivos de línea asignados a User1, antes de asignar una línea
con la dirección 99999, escriba:

XML

<UserList>
<User NoMerge=1>
<DomainUser>domain1\user1</DomainUser>
<FriendlyName>User1</FriendlyName>
<LineList>
<Line>
<Address>99999</Address>
</Line>
</LineList>
</User>
</UserList>

En este ejemplo, el User1 no tendrá asignados otros dispositivos de línea,


independientemente de que haya tenido dispositivos de línea asignados anteriormente.
Para agregar un dispositivo de línea para User1, sin eliminar ningún dispositivo de línea
asignado previamente, escriba:

XML

<UserList>
<User>
<DomainUser>domain1\user1</DomainUser>
<FriendlyName>User1</FriendlyName>
<LineList>
<Line>
<Address>99999</Address>
</Line>
</LineList>
</User>
</UserList>

Para agregar la dirección de línea 99999 y quitar la dirección de línea 88888 del acceso
de User1, escriba:

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 agregar el dispositivo permanente 1000 y quitar la línea 88888 del acceso de User1,
escriba:

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>

Vínculos relacionados
Clave de sintaxis de línea de comandos

Introducción al comando shell


tskill
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Finaliza un proceso que se ejecuta en una sesión en un servidor host de sesión de


escritorio remoto.

7 Nota

Puede usar este comando para finalizar solo los procesos que le pertenecen, a
menos que sea administrador. Los administradores tienen acceso total a todas las
funciones de tskill y pueden finalizar los procesos que se ejecutan en otras sesiones
de usuario.

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de escritorio remoto en Windows Server.

Sintaxis

tskill {<processID> | <processname>} [/server:<servername>] [/id:<sessionID>


| /a] [/v]

Parámetros

Parámetro Descripción

<processID> Especifica el id. del proceso que quiere finalizar.

<processname> Especifica el nombre del proceso que quiere finalizar. Este parámetro
puede incluir caracteres comodín.

/server: <servername> Especifica el servidor de terminal que contiene el proceso que quiere
finalizar. Si no se especifica /server, se usa el servidor host de sesión de
escritorio remoto actual.

/id: <sessionID> Finaliza el proceso que se ejecuta en la sesión especificada.


Parámetro Descripción

/a Finaliza el proceso que se ejecuta en todas las sesiones.

/v Muestra información sobre las acciones que se realizan.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si se terminan todos los procesos ejecutados en una sesión, la sesión también
termina.

Si usa los parámetros <processname> y /server:<servername> , también debe


especificar el parámetro /id:<sessionID> o /a.

Ejemplos
Para finalizar el proceso 6543, escriba:

tskill 6543

Para finalizar el explorador de procesos que se ejecuta en la sesión 5, escriba:

tskill explorer /id:5

Vínculos relacionados
Clave de sintaxis de línea de comandos

Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto


tsprof
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Copia la información de configuración de usuario de Servicios de Escritorio remoto de


un usuario a otro. La información de configuración de usuario de os Servicios de
Escritorio remoto aparece en las extensiones de Servicios de Escritorio remoto para
usuarios y grupos locales y usuarios y equipos de Active Directory.

7 Nota

También puede usar el comando tsprof para establecer la ruta de acceso del perfil
de un usuario.

Para conocer las novedades de la última versión, consulte Novedades de Servicios


de Escritorio remoto en Windows Server.

Sintaxis

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 Descripción

/update Actualiza la información de ruta de acceso de perfil de <username> en el


dominio <domainname> a <profilepath> .

/domain: <Domainname> Especifica el nombre del dominio en el que se aplica la operación.

/local Aplica la operación solo a las cuentas de usuario locales.


Parámetro Descripción

/profile: <path> Especifica la ruta de acceso del perfil tal y como se muestra en las
extensiones de Servicios de Escritorio remoto en usuarios y grupos
locales y usuarios y equipos de Active Directory.

<username> Especifica el nombre del usuario para el que desea actualizar o consultar
la ruta de acceso del perfil del servidor.

/copy Copia la información de configuración del usuario de <src_user> a


<dest_user> y actualiza la información de la ruta de acceso del perfil de
<dest_user> a <profilepath> . Tanto <src_user> como <dest_user>
deben ser locales o deben estar en el dominio <domainname> .

<src_user> Especifica el nombre del usuario del que desea copiar la información de
configuración del usuario. También conocido como usuario de origen.

<dest_user> Especifica el nombre del usuario al que desea copiar la información de


configuración del usuario. También conocido como usuario de destino.

/q Muestra la ruta de acceso del perfil actual del usuario para el que desea
consultar la ruta de acceso del perfil del servidor.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para copiar la información de configuración del usuario de LocalUser1 a LocalUser2,
escriba:

tsprof /copy /local LocalUser1 LocalUser2

Para establecer la ruta de acceso del perfil de Servicios de Escritorio remoto para
LocalUser1 en un directorio denominado c:\profiles, escriba:

tsprof /update /local /profile:c:\profiles LocalUser1

Vínculos relacionados
Clave de sintaxis de línea de comandos
Referencia de comandos (Terminal Services) de Servicios de Escritorio remoto
tipo
Artículo • 14/04/2023

En el shell de comandos de Windows, type es un comando integrado que muestra el


contenido de un archivo de texto. Use el comando type para ver un archivo de texto sin
modificarlo.

En PowerShell, type es un alias integrado para el Get-Content cmdlet, que también


muestra el contenido de un archivo, pero con una sintaxis diferente.

Sintaxis

type [<drive>:][<path>]<filename>

Parámetros

Parámetro Descripción

[<drive>:] Especifica la ubicación y el nombre del archivo o los archivos que desea ver. Si su
[<path>] <filename> contiene espacios, debe incluirlo entre comillas (por ejemplo, “Nombre
<filename> de archivo que contiene espacios.txt”). También puede agregar varios nombres de
archivo agregando espacios entre ellos.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si muestra un archivo binario o un archivo creado por un programa, es posible que
vea caracteres extraños en la pantalla, incluidos los caracteres de avance de
formulario y los símbolos de secuencia de escape. Estos caracteres representan
códigos de control que se usan en el archivo binario. En general, evite usar el
comando type para mostrar archivos binarios.

Ejemplos
Para mostrar el contenido de un archivo denominado holiday.mar, escriba:
type holiday.mar

Para mostrar el contenido de un archivo largo denominado holiday.mar pantalla a


pantalla, escriba:

type holiday.mar | more

Vínculos relacionados
Clave de sintaxis de línea de comandos
typeperf
Artículo • 15/06/2023

El comando typeperf escribe datos de rendimiento en la ventana de comandos o en un


archivo de registro. Para detener typeperf, presione CTRL+C.

Sintaxis

typeperf <counter [counter ...]> [options]


typeperf -cf <filename> [options]
typeperf -q [object] [options]
typeperf -qx [object] [options]

Parámetros

Parámetro Descripción

<counter Especifica los contadores de rendimiento que se van a supervisar. El parámetro


[counter <counter> es el nombre completo de un contador de rendimiento en formato
[...]]> \Computer\Object(Instance)\Counter, como \\Server1\Processor(0)\% User Time .

Opciones

Opción Descripción

-f <CSV | TSV | Especifica el formato de archivo de salida. El valor predeterminado es CSV.


BIN | SQL>

-cf <filename> Especifica un archivo que contiene una lista de contadores de rendimiento que
se van a supervisar, con un contador por línea.

-si Especifica el intervalo de ejemplo. El valor predeterminado es un segundo.


<[[hh:]mm:]ss>

-o <filename> Especifica la ruta de acceso para el archivo de salida o la base de datos SQL. El
valor predeterminado es STDOUT (escrito en la ventana de comandos).

-q [object] Muestra una lista de contadores instalados (sin instancias). Para enumerar los
contadores de un objeto, incluya el nombre del objeto.
Opción Descripción

-qx [object] Muestra una lista de contadores instalados con instancias. Para enumerar los
contadores de un objeto, incluya el nombre del objeto.

-sc <samples> Especifica el número de muestras que se van a recopilar. El valor


predeterminado es recopilar datos hasta que se presione CTRL+C.

-config Especifica un archivo de configuración que contiene las opciones de comando.


<filename>

-s Especifica un equipo remoto que se va a supervisar si no se especifica ningún


<computer_name> equipo en la ruta de acceso del contador.

-y Responder sí a todas las preguntas sin preguntar.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para escribir los valores del contador \Processor(_Total)\% Processor Time de
rendimiento del equipo local en la ventana de comandos en un intervalo de ejemplo
predeterminado de 1 segundo hasta que se presione CTRL+C, escriba:

typeperf \Processor(_Total)\% Processor Time

Para escribir los valores de la lista de contadores del archivo counters.txt en el archivo
delimitado por tabulaciones domain2.tsv con un intervalo de muestreo de 5 segundos
hasta que se hayan recogido 50 muestras, escriba:

typeperf -cf counters.txt -si 5 -sc 50 -f TSV -o domain2.tsv

Para consultar los contadores instalados con instancias para el objeto contador
PhysicalDisk y escribir la lista resultante en el archivo counters.txt, escriba:

typeperf -qx PhysicalDisk -o counters.txt


Vínculos relacionados
Clave de sintaxis de línea de comandos
tzutil
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra la utilidad de zona horaria de Windows.

Sintaxis

tzutil [/?] [/g] [/s <timezoneID>[_dstoff]] [/l]

Parámetros

Parámetro Descripción

/g Muestra el id. actual de la zona horaria.

/s Establece la zona horaria actual con el identificador de zona horaria especificado.


<timezoneID> El sufijo _dstoff deshabilita los ajustes del horario de verano para la zona horaria
[_dstoff] (si procede). Su valor debe estar entrecomillado.

/l Enumera todos los identificadores de zona horaria válidos y los nombres para
mostrar. La salida tiene el siguiente aspecto:
<display name>
<time zone ID>

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Un código de salida de 0 indica que el comando se completó correctamente.

Ejemplos
Para mostrar el id. de zona horaria actual, escriba:
tzutil /g

Para establecer la zona horaria actual en Hora estándar del Pacífico, escriba:

tzutil /s "Pacific Standard time"

Para establecer la zona horaria actual en Hora estándar del Pacífico y deshabilitar los
ajustes del horario de verano, escriba:

tzutil /s "Pacific Standard time_dstoff"

Vínculos relacionados
Clave de sintaxis de línea de comandos
unexpose
Artículo • 08/04/2023

Anula la exposición de una instantánea expuesta mediante el comando expose. La


instantánea expuesta se puede especificar mediante su id. de instantánea, letra de
unidad, recurso compartido o punto de montaje.

Sintaxis

unexpose {<shadowID> | <drive:> | <share> | <mountpoint>}

Parámetros

Parámetro Descripción

<shadowID> Muestra la instantánea especificada por el id. de instantánea especificado. Puede


usar un alias existente o una variable de entorno en lugar de <shadowID> . Use el
comando add sin parámetros para ver todos los alias existentes.

<drive:> Muestra la instantánea asociada a la letra de unidad especificada (por ejemplo,


unidad P).

<share> Muestra la instantánea asociada al recurso compartido especificado (por ejemplo,


\\MachineName ).

<mountpoint> Muestra la instantánea asociada al punto de montaje especificado (por ejemplo,


C:\shadowcopy\ ).

add El uso sin parámetros le mostrará los alias existentes.

Ejemplos
Para anular la exposición de la instantánea asociada a *unidad P:*, escriba:

unexpose P:

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando add

Comando expose
uniqueid
Artículo • 06/04/2023

Muestra o establece el identificador de la tabla de particiones GUID (GPT) o la firma del


registro de arranque maestro (MBR) para el disco básico o dinámico con el foco. Debe
seleccionarse un disco básico o dinámico para que esta operación se realice
correctamente. Use el comando select disk para seleccionar un disco y desplazar el foco
a él.

Sintaxis

uniqueid disk [id={<dword> | <GUID>}] [noerr]

Parámetros

Parámetro Descripción

id= {<dword> En el caso de los discos MBR, este parámetro especifica un valor de 4 bytes
| <GUID>} (DWORD) en formato hexadecimal para la firma. En el caso de los discos GPT, este
parámetro especifica un GUID para el identificador.

noerr Sólo para scripting. Cuando se detecta un error, DiskPart sigue procesando
comandos como si no hubiera habido ningún error. Sin este parámetro, un error
hace que DiskPart salga con un código de error.

Ejemplos
Para mostrar la firma del disco MBR con el foco, escriba:

uniqueid disk

Para establecer la firma del disco MBR con el foco en el valor DWORD 5f1b2c36, escriba:

uniqueid disk id=5f1b2c36


Para establecer el identificador del disco GPT con el foco en el valor GUID baf784e7-
6bbd-4cfb-aaac-e86c96e166ee, escriba:

uniqueid disk id=baf784e7-6bbd-4cfb-aaac-e86c96e166ee

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando select disk


unlodctr
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Quita los nombres del contador de rendimiento y texto explicativo de un servicio o


controlador de dispositivo del registro del sistema.

2 Advertencia

La edición incorrecta del Registro puede dañar gravemente el sistema. Antes de


realizar cambios en el Registro, debe hacer una copia de seguridad de los datos de
valor guardados en el equipo.

Sintaxis

unlodctr <drivername>

Parámetros

Parámetro Descripción

<drivername> Quita la configuración del nombre de contador de rendimiento y el texto


explicativo del controlador o servicio <drivername> del registro de Windows
Server. Si su <drivername> incluye espacios, debe usar comillas alrededor del
texto, por ejemplo, “Nombre del controlador”.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para quitar los nombres actuales del contador de rendimiento y el texto explicativo
para el servicio del protocolo simple de transferencia de correo (SMTP), escriba:
unlodctr SMTPSVC

Vínculos relacionados
Clave de sintaxis de línea de comandos
ver
Artículo • 14/04/2023

Muestra el número de versión del sistema operativo. Este comando se admite en el


símbolo del sistema de Windows (Cmd.exe), pero no en ninguna versión de PowerShell.

Sintaxis

ver

Parámetros

Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para obtener el número de versión del sistema operativo desde el shell de comandos
(cmd.exe), escriba:

ver

Si desea obtener el número de versión del sistema operativo a través de Windows


PowerShell, escriba:

PowerShell

$PSVersionTable.BuildVersion

Si desea obtener el número de versión del sistema operativo a través de


PowerShell 7.x.x, escriba:

PowerShell

$PSVersionTable.OS
Vínculos relacionados
Clave de sintaxis de línea de comandos
verifier
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

El Comprobador de controladores supervisa los controladores del modo kernel de


Windows y los controladores gráficos para detectar llamadas o acciones de función no
válidas que podrían dañar el sistema. El Comprobador de controladores puede someter
los controladores de Windows a una variedad de esfuerzos y pruebas para encontrar un
comportamiento incorrecto. Puede configurar las pruebas que se van a ejecutar, lo que
le permite someter a un controlador a cargas de esfuerzo pesadas o a pruebas más
simplificadas. También puede ejecutar el Controlador de controladores en varios
controladores simultáneamente o en un controlador a la vez.

) Importante

Debe estar en el grupo Administradores del equipo para usar el Comprobador de


controladores. La ejecución del Comprobador de controladores puede hacer que el
equipo se bloquee, por lo que solo debe ejecutar esta utilidad en los equipos que
se usan para probar y depurar.

Sintaxis

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 Descripción

/all Dirige la utilidad Comprobador de controladores para comprobar


todos los controladores instalados después del siguiente arranque.

/bootmode [persistent Controla si la configuración de la utilidad Comprobador de


\| disableafterfail \| controladores está habilitada después de un reinicio. Para establecer o
oneboot \| cambiar esta opción, debe reiniciar el equipo. Los siguientes modos
resetonunusualshutdown] están disponibles:
persistent: garantiza que la configuración del Comprobador de
controladores persiste (permanece en vigor) durante muchos
reinicios. Esta es la configuración predeterminada.
disableafterfail: si Windows no se inicia, esta configuración
deshabilita la utilidad Comprobador de controladores para los
reinicios posteriores.
oneboot: solo habilita la configuración del Comprobador de
controladores para la próxima vez que se inicie el equipo. La
utilidad Comprobador de controladores está deshabilitada para
los reinicios posteriores.
resetonunusualshutdown: la utilidad Comprobador de
controladores se conservará hasta que se produzca un apagado
inusual. Se puede usar su abreviación: "rous".

/driver <driverlist> Especifica uno o varios controladores que se comprobarán. El


parámetro driverlist es una lista de controladores por nombre binario,
como driver.sys. Use un espacio para separar cada nombre de
controlador. No se admiten valores comodín, como n*.sys .

/driver.exclude Especifica uno o varios controladores que se excluirán de la


<driverlist> comprobación. Este parámetro solo es aplicable si se seleccionan
todos los controladores para la comprobación. El parámetro driverlist
es una lista de controladores por nombre binario, como driver.sys. Use
un espacio para separar cada nombre de controlador. No se admiten
valores comodín, como n*.sys .
Parámetro Descripción

/faults Habilita la característica Simulación de recursos bajos en la utilidad


Comprobador de controladores. Puede usar /faults en lugar de /flags
0x4 . Sin embargo, /flags 0x4 no se puede usar con los
subparámetros /faults. Puede usar los siguientes subparámetros del
parámetro /faults para configurar la característica Simulación de
recursos bajos:

Probabilidad: especifica la probabilidad de que la utilidad


Comprobador de controladores produzca un error en una
asignación determinada. Escriba un número (en decimal o
hexadecimal) para representar el número de posibilidades en
10 000 de que la utilidad Comprobador de controladores
produzca un error en la asignación. El valor predeterminado,
600, significa 600/10000, es decir, el 6 %.
Etiquetas de bloques: limita las asignaciones en las que la
utilidad Comprobador de controladores puede producir errores
en las asignaciones con las etiquetas de bloques especificadas.
Puede usar un carácter comodín (*) para representar varias
etiquetas de bloque. Para enumerar varias etiquetas de bloque,
sepárelas con espacios. De forma predeterminada, se pueden
producir errores en todas las asignaciones.
Aplicaciones: limita las asignaciones en las que la utilidad
Comprobador de controladores puede producir errores en las
asignaciones para el programa especificado. Escriba el nombre
de un archivo ejecutable. Para enumerar programas, separe sus
nombres con espacios. De forma predeterminada, se pueden
producir errores en todas las asignaciones.
DelayMins: especifica el número de minutos después del
arranque durante el cual la utilidad Comprobador de
controladores no produce errores intencionadamente en
ninguna asignación. Este retraso permite que los controladores
se carguen y el sistema se estabilice antes de que comience la
prueba. Escriba un número (en decimal o hexadecimal). El valor
predeterminado es 7 minutos.
Parámetro Descripción

/faultssystematic Especifica las opciones de simulación de Recursos bajos sistemáticos.


Use la marca 0x40000 para seleccionar la opción de simulación
Recursos bajos sistemáticos. Están disponibles las siguientes
opciones:

enableboottime: habilita las inyecciones de errores en los


reinicios del equipo.
disableboottime: deshabilita las inyecciones de errores en los
reinicios del equipo (esta es la configuración predeterminada).
recordboottime: habilita las inyecciones de errores en el modo
what if en los reinicios del equipo.
resetboottime: deshabilita las inyecciones de errores en los
reinicios del equipo y borra la lista de exclusión de la pila.
enableruntime: habilita dinámicamente las inyecciones de
errores.
disableruntime: deshabilita dinámicamente las inyecciones de
errores.
recordruntime: habilita dinámicamente las inyecciones de
errores en el modo what if.
resetruntime: deshabilita dinámicamente las inyecciones de
errores y borra la lista de pila con errores anteriores.
querystatistics: muestra las estadísticas de inyección de errores
actuales.
incrementcounter: incrementa el contador de pruebas
superadas que se usa para identificar cuándo se inyectó un
error.
getstackid COUNTER: recupera el identificador de pila
inyectado indicado.
excludestack STACKID: excluye la pila de la inyección de errores.
Parámetro Descripción

/flags <options> Activa las opciones especificadas después del siguiente reinicio. Este
número se puede especificar en formato decimal o hexadecimal (con
un prefijo 0x). Se permite cualquier combinación de los valores
siguientes:
Valor: 1 o 0x1 (bit 0) - Comprobación especial del grupo
Valor: 2 o 0x2 (bit 1) - Forzar la comprobación de IRQL
Valor: 4 o 0x4 (bit 2) - Simulación de recursos bajos
Valor: 8 o 0x8 (bit 3) - Seguimiento de bloques
Valor: 16 o 0x10 (bit 4) - Comprobación de E/S
Valor: 32 o 0x20 (bit 5) - Detección de interbloqueo
Valor: 64 o 0x40 (bit 6) - Comprobación mejorada de E/S. Esta
opción se activa automáticamente al seleccionar Comprobación
de E/S.
Valor: 128 o 0x80 (bit 7) - Comprobación de DMA
Valor: 256 o 0x100 (bit 8) - Comprobaciones de seguridad
Valor: 512 o 0x200 (bit 9) - Exigir solicitudes de E/S pendientes
Valor: 1024 o 0x400 (bit 10) - Registro IRP
Valor: 2048 o 0x800 (bit 11) - Comprobaciones diversas
Valor: 8192 o 0x2000 (bit 13) - Comprobación MDL invariable
para pila
Valor: 16384 o 0x4000 (bit 14) - Comprobación MDL invariable
para controlador
Valor: 32768 o 0x8000 (bit 15) - Pruebas de exploración de
vulnerabilidades mediante datos aleatorios de retraso de marco
de energía
Valor: 65536 o 0x10000 (bit 16): Comprobación de la interfaz de
puerto o minipuerto
Valor: 131072 o 0x20000 (bit 17) - Comprobación de
cumplimiento DDI
Valor: 262144 o 0x40000 (bit 18) - Simulación sistemática de
recursos insuficientes
Valor: 524288 o 0x80000 (bit 19) - Comprobación de
cumplimiento DDI (adicional)
Valor: 2097152 o 0x200000 (bit 21) - Comprobación NDIS/WIFI
Valor: 8388608 o 0x800000 (bit 23) - Pruebas de exploración de
vulnerabilidades mediante datos aleatorios de retraso de
sincronización de kernel
Valor: 16777216 o 0x1000000 (bit 24) - Verificación de switch de
VM
Valor: 33554432 o 0x2000000 (bit 25): Comprobaciones de
integridad de código. No puede usar este método para activar
las opciones Comprobación SCSI o Comprobación Storport. Para
obtener más información, consulte Comprobación SCSI y
Comprobación Storport.
Parámetro Descripción

/flags <volatileoptions> Especifica las opciones de la utilidad Comprobador de controladores


que se cambian inmediatamente sin reiniciar. Este número se puede
especificar en formato decimal o hexadecimal (con un prefijo 0x). Se
permite cualquier combinación de los valores siguientes:
Valor: 1 o 0x1 (bit 0): Bloque especial
Valor: 2 o 0x2 (bit 1): Exigir comprobación IRQL
Valor: 4 o 0x4 (bit 2): Simulación de recursos bajos

<probability> Número comprendido entre 1 y 10 000 que especifica la probabilidad


de inyección de errores. Por ejemplo, especificar 100 significa una
probabilidad de inyección de errores del 1 % (100/10 000).
Si no se especifica este parámetro, se usa la probabilidad
predeterminada del 6 %.

<tags> Especifica las etiquetas de bloque que se insertarán con errores,


separadas por caracteres de espacio. Si no se especifica este
parámetro, se puede insertar cualquier asignación de grupo con
errores.

<apps> Especifica el nombre de archivo de imagen de las aplicaciones que se


inyectarán con errores, separados por caracteres de espacio. Si no se
especifica este parámetro, la simulación de recursos bajos se puede
realizar en cualquier aplicación.

<minutes> Número positivo que especifica la longitud del período después del
reinicio, en minutos, durante el cual no se producirá ninguna inyección
de errores. Si no se especifica este parámetro, se usa la longitud
predeterminada de 8 minutos.

/iolevel <level> Especifica el nivel de la opción Comprobación de E/S. El valor de


[nivel] puede ser 1: habilita la comprobación de E/S de nivel 1
(predeterminado) o 2: habilita la comprobación de E/S de nivel 1 y la
comprobación de E/S de nivel 2. Si la opción Comprobación de E/S no
está habilitada (mediante /flags 0x10 ), /iolevel se omite.

/log <logfilename> Crea un archivo de registro con el nombre especificado. La utilidad


[/intervalseconds] Comprobador de controladores escribe periódicamente estadísticas en
este archivo, en función del intervalo que establezca opcionalmente. El
intervalo predeterminado es de 30 segundos.

Si se escribe un comando /log del comprobador en la línea de


comandos, el símbolo del sistema no se devuelve. Para cerrar el
archivo de registro y devolver un símbolo del sistema, use la tecla
CTRL+C. Después de un reinicio, para crear un registro, debe enviar el
comando /log del comprobador de nuevo.
Parámetro Descripción

/rules <option> Opciones que se pueden deshabilitar para las reglas, entre las que se
incluyen:
query: muestra el estado actual de las reglas controlables.
reset: restablece el estado predeterminado de todas las reglas.
default ID: establece el estado predeterminado del id. de regla.
En el caso de las reglas admitidas, el id. de regla es el valor del
parámetro 1 de la comprobación de errores 0xC4
(DRIVER_VERIFIER_DETECTED_VIOLATION).
disable ID: deshabilita el id. de regla especificado. En el caso de
las reglas admitidas, el id. de regla es el valor del parámetro 1
de la comprobación de errores 0xC4
(DRIVER_VERIFIER_DETECTED_VIOLATION).

/standard Activa las opciones "estándar" o predeterminadas del Comprobador


de controladores después del siguiente reinicio. Las opciones estándar
son Bloque especial, Forzar comprobación IRQL, Seguimiento de
bloques, Comprobación de E/S, Detección de interbloqueo,
Comprobación de DMA, Comprobaciones de seguridad,
Comprobaciones diversas y Comprobación de cumplimiento DDI. Es
equivalente a /flags 0x209BB .

[!NOTA] A partir de las versiones posteriores a la versión 1803 de


Windows 10, el uso de /flags 0x209BB ya no habilitará
automáticamente la comprobación de WDF. Use la sintaxis /standard
para habilitar las opciones estándar, con la comprobación de WDF
incluida.

/volatile Cambia la configuración sin reiniciar el equipo. La configuración volátil


surte efecto inmediatamente.
Puede usar el parámetro /volatile con el parámetro /flags para
habilitar y deshabilitar algunas opciones sin reiniciar. También puede
usar /volatile con los parámetros /adddriver y /removedriver para
iniciar o detener la comprobación de un controlador sin reiniciar,
incluso si la utilidad Comprobador de controladores no se está
ejecutando. Para obtener más información, consulte Uso de la
configuración volátil.

/adddriver Agrega los controladores especificados a partir de la configuración


<volatiledriverlist> volátil. Para especificar varios controladores, enumere sus nombres,
separados por espacios. No se admiten valores comodín, como n.sys.

/removedriver Quita los controladores especificados a partir de la configuración


<volatiledriverlist> volátil. Para especificar varios controladores, enumere sus nombres,
separados por espacios. No se admiten valores comodín, como n.sys.
Parámetro Descripción

/reset Borra toda la configuración de la utilidad Comprobador de


controladores. Después del siguiente reinicio, no se comprobará
ningún controlador.

/querysettings Muestra un resumen de las opciones que se activarán y controladores


que se comprobarán después del siguiente arranque. La pantalla no
incluye controladores ni opciones agregadas mediante el parámetro
/volatile. Para otras formas de ver esta configuración, consulte
Visualización de la configuración del Comprobador de controladores.

/query Muestra un resumen de la actividad actual de la utilidad Comprobador


de controladores. El campo Nivel de la pantalla es el valor
hexadecimal de las opciones establecidas con el parámetro /volatile.
Para obtener explicaciones de cada estadística, consulte Supervisión
de contadores globales y Supervisión de contadores individuales.

/domain <types> Controla la configuración de la extensión del comprobador. Se


<options> admiten los siguientes tipos de extensión de comprobador:
wdm: habilita la extensión del comprobador para los
controladores WDM.
ndis: habilita la extensión del comprobador para los
controladores de red.
ks: habilita la extensión del comprobador para los controladores
de streaming en modo kernel.
audio: habilita la extensión del comprobador para los
controladores de audio.

. Se admiten las siguientes opciones de extensión:

rules.default: habilita las reglas de validación predeterminadas


para la extensión de comprobador seleccionada.
rules.all: habilita todas las reglas de validación para la extensión
de comprobador seleccionada.

/logging Habilita el registro de reglas infringidas detectadas por las extensiones


de comprobador seleccionadas.

/livedump Habilita la recopilación de volcados de memoria en vivo para las reglas


infringidas detectadas por las extensiones de comprobador
seleccionadas.

/? Muestra la ayuda de la línea de comandos.

Códigos de retorno
Los valores siguientes se devuelven después de que se haya ejecutado el comprobador
del controlador:

0: EXIT_CODE_SUCCESS

1: EXIT_CODE_ERROR

2: EXIT_CODE_REBOOT_NEEDED

Comentarios
Puede usar el parámetro /volatile con algunas de las opciones /flags de la utilidad
Comprobador de controladores y con /standard. No puede usar /volatile con las
opciones /flags para Comprobación de cumplimiento DDI, Pruebas de exploración
de vulnerabilidades mediante datos aleatorios de retraso de marco de
energíaComprobación Storport o Comprobación SCSI. Para obtener más
información, consulte Uso de la configuración volátil.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comprobador de controladores

Control del Comprobador de controladores

Supervisión del Comprobador de controladores

Uso de la configuración volátil


Comprobación
Artículo • 06/04/2023

Indica a la herramienta del símbolo del sistema (cmd.exe) si los archivos se escriben
correctamente en un disco.

Sintaxis

verify [on | off]

Parámetros

Parámetro Descripción

[on \| off] Activa o desactiva la configuración de verificación.

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para mostrar la configuración actual de verificación, escriba:

verify

Para activar la configuración de verificación, escriba:

verify on

Vínculos relacionados
Clave de sintaxis de línea de comandos
vol
Artículo • 14/04/2023

Muestra la etiqueta de volumen de disco y el número de serie, si existen. Si se usa sin


parámetros, vol muestra información de la unidad actual.

Sintaxis

vol [<drive>:]

Parámetros

Parámetro Descripción

<drive>: Especifica la unidad que contiene el disco para el que desea mostrar la etiqueta de
volumen y el número de serie.

/? Muestra la ayuda en el símbolo del sistema.

Vínculos relacionados
Clave de sintaxis de línea de comandos
vssadmin
Artículo • 14/04/2023

Se aplica 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, Windows Server 2008

Muestra las copias de seguridad de instantáneas de volumen actuales y todos los


editores y proveedores de instantáneas instalados. Seleccione un nombre de comando
en la tabla siguiente para ver su sintaxis de comando.

Get-Help Descripción Disponibilidad

vssadmin delete Elimina las instantáneas de volumen. Cliente y


shadows servidor

vssadmin list Enumera las instantáneas de volumen existentes. Cliente y


shadows servidor

vssadmin list writers Enumera todos los editores de instantáneas de volumen Cliente y
suscritos en el sistema. servidor

vssadmin resize Cambia el tamaño máximo de una asociación de Cliente y


shadowstorage almacenamiento de instantáneas. servidor

Vínculos relacionados
Clave de sintaxis de línea de comandos
vssadmin delete shadows
Artículo • 14/04/2023

Se aplica 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, Windows Server 2008

Elimina las instantáneas de un volumen especificado. Solo puede eliminar las


instantáneas con el tipo client-accessible.

Sintaxis

vssadmin delete shadows /for=<ForVolumeSpec> [/oldest | /all | /shadow=


<ShadowID>] [/quiet]

Parámetros

Parámetro Descripción

/for= <ForVolumeSpec> Especifica qué instantánea del volumen se eliminará.

/oldest Elimina solo la instantánea más antigua.

/all Elimina todas las instantáneas del volumen especificado.

/shadow= <ShadowID> Elimina la instantánea que especifica ShadowID. Para obtener el id. de
instantánea, use el comando vssadmin list shadows. Al escribir un id. de
instantánea, introduzca el siguiente formato, en el que cada X representa
un carácter hexadecimal:

XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

/quiet Especifica que el comando no mostrará los mensajes mientras se ejecuta.

Ejemplos
Para eliminar la instantánea más antigua del volumen C, escriba:
vssadmin delete shadows /for=c: /oldest

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando vssadmin

Comando vssadmin list shadows


vssadmin list shadows
Artículo • 12/04/2023

Se aplica 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, Windows Server 2008

Enumera todas las instantáneas existentes de un volumen especificado. Si usa este


comando sin parámetros, muestra todas las instantáneas de volumen en el equipo en el
orden que dicta el conjunto de instantáneas.

Sintaxis

vssadmin list shadows [/for=<ForVolumeSpec>] [/shadow=<ShadowID>]

Parámetros

Parámetro Descripción

/for= <ForVolumeSpec> Especifica el volumen para el que se mostrarán las instantáneas.

/shadow= <ShadowID> Enumera la instantánea que especifica ShadowID. Para obtener el id. de
instantánea, use el comando vssadmin list shadows. Al escribir un id. de
instantánea, use el siguiente formato, en el que cada X representa un
carácter hexadecimal:

XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando vssadmin

Comando vssadmin list shadows


vssadmin list writers
Artículo • 06/04/2023

Se aplica 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, Windows Server 2008

Enumera los escritores de instantáneas de volumen suscritos.

Sintaxis

vssadmin list writers

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando vssadmin
vssadmin resize shadowstorage
Artículo • 06/04/2023

Se aplica 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, Windows Server 2008

Cambia el tamaño de la cantidad máxima de espacio de almacenamiento que se puede


usar para el almacenamiento de instantáneas.

La cantidad mínima de espacio de almacenamiento que se puede usar para el


almacenamiento de instantáneas se puede especificar mediante el valor del registro
MinDiffAreaFileSize. Para más información, consulte: MinDiffAreaFileSize.

2 Advertencia

Cambiar el tamaño de la asociación de almacenamiento puede hacer que


desaparezcan las instantáneas.

Sintaxis

vssadmin resize shadowstorage /for=<ForVolumeSpec> /on=<OnVolumeSpec>


[/maxsize=<MaxSizeSpec>]

Parámetros

Parámetro Descripción

/for= <ForVolumeSpec> Especifica el volumen para el que se va a cambiar el tamaño de la


cantidad máxima de espacio de almacenamiento.

/on= <OnVolumeSpec> Especifica el volumen de almacenamiento.


Parámetro Descripción

[/maxsize= <MaxSizeSpec> ] Especifica la cantidad máxima de espacio que se puede usar para
almacenar instantáneas. Si no se especifica ningún valor para
/maxsize, no hay ningún límite en la cantidad de espacio de
almacenamiento que se puede usar.

El valor MaxSizeSpec debe ser igual o superior a 1 MB y debe


expresarse en una de las siguientes unidades: KB, MB, GB, TB, PB o
EB. Si no se especifica ninguna unidad, MaxSizeSpec usa bytes de
forma predeterminada.

Ejemplos
Para cambiar el tamaño de la instantánea del volumen C en el volumen D, con un
tamaño máximo de 900 MB, escriba:

vssadmin resize shadowstorage /For=C: /On=D: /MaxSize=900MB

Para cambiar el tamaño de la instantánea del volumen C en el volumen D, sin tamaño


máximo, escriba:

vssadmin resize shadowstorage /For=C: /On=D: /MaxSize=UNBOUNDED

Para cambiar el tamaño de la instantánea del volumen C en un 20 %, escriba:

vssadmin resize shadowstorage /For=C: /On=C: /MaxSize=20%

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando vssadmin
waitfor
Artículo • 08/04/2023

Envía o espera una señal en un sistema. Este comando se usa para sincronizar equipos a
través de una red.

Sintaxis

waitfor [/s <computer> [/u [<domain>\]<user> [/p [<password>]]]] /si


<signalname>
waitfor [/t <timeout>] <signalname>

Parámetros

Parámetro Descripción

/s <computer> Especifica el nombre o la dirección IP de un equipo remoto (no use barras


diagonales inversas). La opción predeterminada es el equipo local. Este parámetro
se aplica a todos los archivos y carpetas especificados en el comando. Si no usa
este parámetro, la señal se transmite a todos los sistemas de un dominio. Si usa
este parámetro, la señal solo se envía al sistema especificado.

/u Ejecuta el script con las credenciales de la cuenta de usuario especificada. De


[<domain>] forma predeterminada, waitfor usa las credenciales del usuario actual.
<user>

/p [\ Especifica la contraseña de la cuenta de usuario especificada en el parámetro /u.


<password>]

/si Envía la señal especificada a través de la red. Este parámetro también le permite
activar manualmente una señal.

/t <timeout> Especifica el número de segundos que se esperarán para una señal. De forma
predeterminada, waitfor espera indefinidamente.

<signalname> Especifica la señal que waitfor espera o envía. Este parámetro no distingue
mayúsculas de minúsculas y no puede superar los 225 caracteres. Los caracteres
válidos incluyen a-z, A-Z, 0-9 y el juego de caracteres extendidos ASCII (128-255).

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Puede ejecutar varias instancias de waitfor en un solo equipo, pero cada instancia
de waitfor debe esperar una señal diferente. Solo una instancia de waitfor puede
esperar una señal determinada en un equipo determinado.

Los equipos solo pueden recibir señales si están en el mismo dominio que el
equipo que envía la señal.

Puede usar este comando al probar compilaciones de software. Por ejemplo, el


equipo de compilación puede enviar una señal a varios equipos que ejecutan
waitfor después de que la compilación se haya completado correctamente. Al
recibir la señal, el archivo por lotes que incluye waitfor puede indicar a los equipos
que inicien inmediatamente la instalación de software o la ejecución de pruebas en
la compilación compilada.

Ejemplos
Para esperar hasta que se reciba la señal espresso\build007, escriba:

waitfor espresso\build007

De manera predeterminada, waitfor espera indefinidamente una señal.

Para esperar 10 segundos a que se reciba la señal espresso\compile007 antes de agotar el


tiempo de espera, escriba:

waitfor /t 10 espresso\build007

Para activar manualmente la señal espresso\build007, escriba:

waitfor /si espresso\build007

Vínculos relacionados
Clave de sintaxis de línea de comandos
wbadmin
Artículo • 08/04/2023

Permite realizar copias de seguridad y restaurar el sistema operativo, volúmenes,


archivos, carpetas y aplicaciones desde un símbolo del sistema.

Para configurar una copia de seguridad programada periódicamente mediante este


comando, debe ser miembro del grupo Administradores. Para realizar el resto de tareas
con este comando, debe ser miembro del grupo Operadores de copias de seguridad o
del grupo Administradores, o se le deben haber delegado los permisos adecuados.

Debe ejecutar wbadmin desde un símbolo del sistema con privilegios elevados,
haciendo clic con el botón derecho en Símbolo del sistema y seleccionando Ejecutar
como administrador.

Parámetros
Parámetro Descripción

wbadmin delete Elimina el catálogo de copias de seguridad en el equipo local. Use este
catalog comando solo si el catálogo de copias de seguridad de este equipo está
dañado y no tiene copias de seguridad almacenadas en otra ubicación que
puede usar para restaurar el catálogo.

wbadmin delete Elimina una o varias copias de seguridad de estado del sistema.
systemstatebackup

wbadmin disable Deshabilita las copias de seguridad diarias.


backup

wbadmin enable Configura y habilita una copia de seguridad programada periódicamente.


backup

wbadmin get disks Enumera los discos que están actualmente en línea.

wbadmin get items Enumera los elementos incluidos en una copia de seguridad.

wbadmin get status Muestra el estado de la operación de copia de seguridad o recuperación


que se está ejecutando actualmente.

wbadmin get Enumera los detalles de las copias de seguridad recuperables desde el
versions equipo local o, si se especifica otra ubicación, desde otro equipo.

wbadmin restore Recupera un catálogo de copias de seguridad de una ubicación de


catalog almacenamiento especificada en caso de que el catálogo de copia de
seguridad del equipo local esté dañado.
Parámetro Descripción

wbadmin start Ejecuta una copia de seguridad única. Si se usa sin parámetros, usa la
backup configuración de la programación de copia de seguridad diaria.

wbadmin start Ejecuta una recuperación de los volúmenes, aplicaciones, archivos o


recovery carpetas especificados.

wbadmin start Ejecuta una recuperación del sistema completo (al menos de todos los
sysrecovery volúmenes que contienen el estado del sistema operativo). Este comando
solo está disponible si usa el entorno de recuperación de Windows.

wbadmin start Ejecuta una copia de seguridad de estado del sistema.


systemstatebackup

wbadmin start Ejecuta una recuperación de estado del sistema.


systemstaterecovery

wbadmin stop job Detiene la operación de copia de seguridad o recuperación en curso.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Cmdlets de copia de seguridad de Windows Server en Windows PowerShell

Entorno de recuperación de Windows (WinRE)


wbadmin delete catalog
Artículo • 08/04/2023

Elimina el catálogo de copia de seguridad que se almacena en el equipo local. Use este
comando cuando el catálogo de copia de seguridad se haya dañado y no pueda
restaurarlo mediante el comando wbadmin restore catalog.

Para eliminar un catálogo de copias de seguridad usando este comando, debe ser
miembro del grupo Operadores de copias de seguridad o del grupo Administradores,
o se le deben haber delegado los permisos adecuados. Además, debe ejecutar wbadmin
desde un símbolo del sistema con privilegios elevados, haciendo clic con el botón
derecho en Símbolo del sistema y seleccionando Ejecutar como administrador.

Sintaxis

wbadmin delete catalog [-quiet]

Parámetros

Parámetro Descripción

-quiet Ejecuta el comando sin solicitudes al usuario.

Comentarios
Si elimina el catálogo de copias de seguridad de un equipo, ya no podrá acceder a
las copias de seguridad creadas para ese equipo mediante el complemento Copias
de seguridad de Windows Server. Sin embargo, si puede acceder a otra ubicación
de copia de seguridad y ejecutar el comando wbadmin restore catalog, puede
restaurar el catálogo de copia de seguridad desde esa ubicación.

Se recomienda encarecidamente crear una nueva copia de seguridad después de


eliminar un catálogo de copia de seguridad.

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wbadmin

Comando wbadmin restore catalog

Remove-WBCatalog
wbadmin delete systemstatebackup
Artículo • 08/04/2023

Elimina las copias de seguridad de estado del sistema que especifique. Si el volumen
especificado contiene copias de seguridad distintas de las del estado del sistema de su
servidor local, dichas copias no se eliminarán.

Para eliminar una copia de seguridad del estado del sistema usando este comando,
debe ser miembro del grupo Operadores de copias de seguridad o del grupo
Administradores, o se le deben haber delegado los permisos adecuados. Además, debe
ejecutar wbadmin desde un símbolo del sistema con privilegios elevados, haciendo clic
con el botón derecho en Símbolo del sistema y seleccionando Ejecutar como
administrador.

7 Nota

Copias de seguridad de Windows Server no realiza copias de seguridad ni recupera


los subárboles de usuario del registro (HKEY_CURRENT_USER) como parte de la
copia de seguridad del estado del sistema o de la recuperación del estado del
sistema.

Sintaxis

wbadmin delete systemstatebackup {-keepVersions:<numberofcopies> | -version:


<versionidentifier> | -deleteoldest} [-backupTarget:<volumename>] [-machine:
<backupmachinename>] [-quiet]

) Importante

Solo debe especificar uno de estos parámetros: -keepVersions, -version o -


deleteOldest.

Parámetros

Parámetro Descripción
Parámetro Descripción

- Especifica el número de copias de seguridad de estado del sistema más recientes


keepVersions que se van a conservar. El valor debe ser un entero positivo. El valor del
parámetro -keepversions:0 elimina todas las copias de seguridad de estado del
sistema.

-version Especifica el identificador de versión de la copia de seguridad en formato


MM/DD/AAAA-HH:MM. Si no conoce el identificador de versión, ejecute el
comando wbadmin get versions.

Las versiones formadas por copias de seguridad de estado del sistema exclusivas
se pueden eliminar mediante este comando. Ejecute el comando wbadmin get
items para ver el tipo de versión.

- Elimina la copia de seguridad de estado del sistema más antigua.


deleteOldest

- Especifica la ubicación de almacenamiento de la copia de seguridad que quiere


backupTarget eliminar. La ubicación de almacenamiento para las copias de seguridad en disco
puede ser una letra de unidad, un punto de montaje o una ruta de volumen
basada en GUID. Solo es necesario especificar este valor para ubicar las copias de
seguridad que no se encuentran en el equipo local. La información sobre las
copias de seguridad del equipo local está disponible en el catálogo de copias de
seguridad del equipo local.

-machine Especifica el equipo cuya copia de seguridad del estado del sistema quiere
eliminar. Resulta útil cuando se ha realizado la copia de seguridad de varios
equipos en la misma ubicación. Debería usarse cuando se especifica el parámetro
-backupTarget.

-quiet Ejecuta el comando sin solicitudes al usuario.

Ejemplos
Para eliminar la copia de seguridad de estado del sistema creada el 31 de marzo de
2013 a las 10:00, escriba:

wbadmin delete systemstatebackup -version:03/31/2013-10:00

Para eliminar todas las copias de seguridad de estado del sistema, excepto las tres más
recientes, escriba:
wbadmin delete systemstatebackup -keepVersions:3

Para eliminar la copia de seguridad de estado del sistema más antigua almacenada en el
disco f:, escriba:

wbadmin delete systemstatebackup -backupTarget:f:\ -deleteOldest

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wbadmin

Comando wbadmin get versions

Comando wbadmin get items


wbadmin disable backup
Artículo • 14/04/2023

Detiene la ejecución de las copias de seguridad diarias programadas existentes.

Para deshabilitar una copia de seguridad diaria programada mediante este comando,
debe ser miembro del grupo Administradores o bien tener delegados los permisos
apropiados. Además, debe ejecutar wbadmin desde un símbolo del sistema con
privilegios elevados, haciendo clic con el botón derecho en Símbolo del sistema y
seleccionando Ejecutar como administrador.

Sintaxis

wbadmin disable backup [-quiet]

Parámetros

Parámetro Descripción

-quiet Ejecuta el comando sin indicaciones al usuario.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wbadmin

Comando wbadmin enable backup


wbadmin enable backup
Artículo • 12/04/2023

Crea y habilita una programación de copia de seguridad diaria o modifica una


programación existente. Si no se especifican parámetros, muestra la configuración de
copia de seguridad programada en ese momento.

Para configurar o modificar una programación de copia de seguridad diaria mediante


este comando, debe ser miembro del grupo Operadores de copia de seguridad o del
grupo Administradores. Además, debe ejecutar wbadmin desde un símbolo del sistema
con privilegios elevados, haciendo clic con el botón derecho en Símbolo del sistema y
seleccionando Ejecutar como administrador.

Para ver el valor del identificador de disco de los discos, ejecute el comando wbadmin
get disks.

Sintaxis

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 Descripción
Parámetro Descripción

-addtarget Especifica la ubicación de almacenamiento de las copias de seguridad.


Requiere que especifique la ubicación como una ruta de acceso de
disco, volumen o convención de nomenclatura universal (UNC) a una
carpeta compartida remota ( \\<servername>\<sharename> ). De forma
predeterminada, la copia de seguridad se guardará en: \\<servername>\
<sharename> WindowsImageBackup <ComputerBackedUp> . Si especifica un
disco, este se formateará antes de su uso y los datos existentes en él se
borrarán de forma permanente. Si especifica una carpeta compartida,
no puede agregar más ubicaciones. Solo puede especificar una carpeta
compartida como ubicación de almacenamiento a la vez.

Importante:Si guarda una copia de seguridad en una carpeta


compartida remota, dicha copia de seguridad se sobrescribirá si usa la
misma carpeta para realizar de nuevo la copia de seguridad del mismo
sistema. Además, si se produce un error en la operación de copia de
seguridad, podría quedarse sin ninguna copia de seguridad porque la
copia anterior se sobrescribirá y la nueva no se podrá usar. Para evitar
esta situación, puede crear subcarpetas en la carpeta compartida
remota y organizar en ellas las copias de seguridad. Si usa este enfoque,
las subcarpetas necesitarán el doble de espacio que la carpeta principal.

Solo se puede especificar una ubicación en un solo comando. Se


pueden agregar varias ubicaciones de almacenamiento de copia de
seguridad de volumen y disco al ejecutar el comando de nuevo.

-removetarget Especifica la ubicación de almacenamiento que desea quitar de la


programación de copia de seguridad existente. Requiere que
especifique la ubicación como un identificador de disco.

-schedule Especifica las horas del día para crear una copia de seguridad, con
formato HH:MM y delimitada por comas.

-include Especifica la lista delimitada por comas de elementos que se van a


incluir en la copia de seguridad. Se pueden incluir varios archivos,
carpetas o volúmenes. Las rutas de acceso a los volúmenes se pueden
especificar mediante letras de unidad, puntos de montaje o nombres
basados en identificadores GUID. Si usa un nombre de volumen basado
en GUID, debe terminar con una barra diagonal inversa ( \ ). Puede usar
el carácter comodín ( * ) en el nombre del archivo cuando especifique
una ruta de acceso a un archivo.
Parámetro Descripción

-nonRecurseInclude Especifica la lista no recursiva, delimitada por comas, de elementos a


incluir en la copia de seguridad. Se pueden incluir varios archivos,
carpetas o volúmenes. Las rutas de acceso a los volúmenes se pueden
especificar mediante letras de unidad, puntos de montaje o nombres
basados en identificadores GUID. Si usa un nombre de volumen basado
en GUID, debe terminar con una barra diagonal inversa ( \ ). Puede usar
el carácter comodín ( * ) en el nombre del archivo cuando especifique
una ruta de acceso a un archivo. Debería usarse solo cuando se use el
parámetro -backupTarget.

-exclude Especifica la lista delimitada por comas de elementos que se van a


excluir de la copia de seguridad. Puede excluir archivos, carpetas o
volúmenes. Las rutas de acceso a los volúmenes se pueden especificar
mediante letras de unidad, puntos de montaje o nombres basados en
identificadores GUID. Si usa un nombre de volumen basado en GUID,
debe terminar con una barra diagonal inversa ( \ ). Puede usar el
carácter comodín ( * ) en el nombre del archivo cuando especifique una
ruta de acceso a un archivo.

-nonRecurseExclude Especifica la lista no recursiva, delimitada por comas, de elementos a


excluir de la copia de seguridad. Puede excluir archivos, carpetas o
volúmenes. Las rutas de acceso a los volúmenes se pueden especificar
mediante letras de unidad, puntos de montaje o nombres basados en
identificadores GUID. Si usa un nombre de volumen basado en GUID,
debe terminar con una barra diagonal inversa ( \ ). Puede usar el
carácter comodín ( * ) en el nombre del archivo cuando especifique una
ruta de acceso a un archivo.

-hyperv Especifica la lista delimitada por comas de componentes que deben


incluirse en la copia de seguridad. El identificador puede ser un nombre
de componente o un GUID de componente (con o sin llaves).

-systemState Crea una copia de seguridad que incluye el estado del sistema además
de cualquier otro elemento que haya especificado con el parámetro -
include. El estado del sistema contiene archivos de arranque (Boot.ini,
NDTLDR, NTDetect.com), el Registro de Windows, incluida la
configuración COM, SYSVOL (directivas de grupo y scripts de inicio de
sesión), Active Directory y NTDS.DIT en los controladores de dominio y,
si el servicio de certificados está instalado, el almacén de certificados. Si
su servidor tiene instalado el rol de servidor web, se incluirá el
metadirectorio de IIS. Si el servidor forma parte de un clúster, también
se incluye la información del servicio de clúster.
Parámetro Descripción

-allCritical Especifica que todos los volúmenes críticos (volúmenes que contienen
el estado del sistema operativo) se incluyan en las copias de seguridad.
Este parámetro es útil si va a crear una copia de seguridad para la
recuperación completa del estado del sistema o del sistema. Solo se
debe usar cuando se especifica -backupTarget; de lo contrario, se
produce un error en el comando. Se puede usar con la opción -include.

Consejo: El volumen de destino de una copia de seguridad de volumen


crítico puede ser una unidad local, pero no puede ser ninguno de los
volúmenes incluidos en la copia de seguridad.

-vssFull Realiza una copia de seguridad completa usando el Servicio de


instantáneas de volumen (VSS). Se realiza una copia de seguridad de
todos los archivos, se actualiza el historial de cada archivo para reflejar
que se ha realizado una copia de seguridad y se pueden truncar los
registros de las copias de seguridad anteriores. Si no se usa este
parámetro, el comando wbadmin start backup realiza una copia de
seguridad, pero no se actualiza el historial de los archivos de los que se
está haciendo una copia de seguridad.

Precaución: No use este parámetro si está usando un producto que no


sea Copias de seguridad de Windows Server para hacer copias de
seguridad de las aplicaciones que están en los volúmenes incluidos en
la copia de seguridad actual. Hacerlo puede romper potencialmente las
copias de seguridad incrementales, diferenciales o de otro tipo que el
otro producto de copia de seguridad esté creando, porque el historial
en el que se basan para determinar la cantidad de datos de los que hay
que hacer una copia de seguridad podría faltar y se podría realizar una
copia de seguridad completa innecesariamente.

-vssCopy Realiza una copia de seguridad de copia mediante VSS. Se realiza una
copia de seguridad de todos los archivos, pero no se actualiza el
historial de los archivos de los que se realiza la copia de seguridad, por
lo que se conserva toda la información sobre los archivos que se han
modificado, eliminado, etc., así como los archivos de registro de la
aplicación. El uso de este tipo de copia de seguridad no afecta a la
secuencia de copias de seguridad incrementales y diferenciales que
pueden producirse independientemente de esta copia de seguridad.
Este es el valor predeterminado.
Advertencia: No se puede usar una copia de seguridad de copia para
copias de seguridad o restauraciones incrementales o diferenciales.

-user Especifica el usuario con permiso de escritura en el destino de


almacenamiento de la copia de seguridad (si es una carpeta compartida
remota). El usuario debe ser miembro del grupo Administradores o
Operadores de copia de seguridad en el equipo del que se realiza una
copia de seguridad.
Parámetro Descripción

-password Especifica la contraseña del nombre de usuario proporcionado por el


parámetro -user.

- Sobrescribe las copias de seguridad realizadas antes de actualizar el


allowDeleteOldBackups equipo.

-quiet Ejecuta el comando sin solicitudes al usuario.

Ejemplos
Para programar copias de seguridad diarias a las 9:00 y a las 18:00 para las unidades de
disco duro E:, D:\mountpoint y \\?\Volume{cc566d14-44a0-11d9-9d93-806e6f6e6963}\ , y
para guardar los archivos en el disco denominado DiskID, escriba:

wbadmin enable backup -addtarget:DiskID -schedule:09:00,18:00 -


include:E:,D:\mountpoint,\\?\Volume{cc566d14-44a0-11d9-9d93-806e6f6e6963}\

Para programar copias de seguridad diarias de la carpeta D:\documents a las 00:00 y a


las 19:00 en la ubicación de red \\backupshare\backup1 , mediante las credenciales de
red para el operador de copia de seguridad, Aaren Ekelund (aekel), cuya contraseña es
$3hM9^5lp y que es miembro del dominio CONTOSOEAST, que se usa para autenticar el
acceso al recurso compartido de red, escriba:

wbadmin enable backup –addtarget:\\backupshare\backup1 –include:


D:\documents –user:CONTOSOEAST\aekel –password:$3hM9^5lp –
schedule:00:00,19:00

Para programar copias de seguridad diarias del volumen T: y la carpeta D:\documents a


la 1:00 a la unidad H:, excepto la carpeta d:\documents\~tmp y realizar una copia de
seguridad completa mediante el servicio de instantáneas de volumen, escriba:

wbadmin enable backup –addtarget:H: –include T:,D:\documents –exclude


D:\documents\~tmp –vssfull –schedule:01:00
Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wbadmin

Comando wbadmin enable backup

Comadowbadmin start backup

Comando wbadmin get disks


wbadmin get disks
Artículo • 06/04/2023

Enumera los discos internos y externos que están actualmente en línea para el equipo
local.

Para enumerar los discos en línea usando este comando, debe ser miembro del grupo
Operadores de copias de seguridad o del grupo Administradores, o se le deben haber
delegado los permisos adecuados. Además, debe ejecutar wbadmin desde un símbolo
del sistema con privilegios elevados, haciendo clic con el botón derecho en Símbolo del
sistema y seleccionando Ejecutar como administrador.

Sintaxis

wbadmin get disks

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wbadmin

Get-WBDisk
wbadmin get items
Artículo • 08/04/2023

Enumera los elementos incluidos en una copia de seguridad específica.

Para enumerar los elementos incluidos en una copia de seguridad específica usando
este comando, debe ser miembro del grupo Operadores de copias de seguridad o del
grupo Administradores, o se le deben haber delegado los permisos adecuados.
Además, debe ejecutar wbadmin desde un símbolo del sistema con privilegios elevados,
haciendo clic con el botón derecho en Símbolo del sistema y seleccionando Ejecutar
como administrador.

Sintaxis

wbadmin get items -version:<VersionIdentifier> [-backupTarget:


{<BackupDestinationVolume> | <NetworkSharePath>}] [-machine:
<BackupMachineName>]

Parámetros

Parámetro Descripción

-version Especifica la versión de la copia de seguridad en formato MM/DD/AAAA-HH:MM.


Si no conoce la información de la versión, ejecute el comando wbadmin get
versions.

- Especifica la ubicación de almacenamiento que contiene las copias de seguridad


backupTarget para las que quiere los detalles. Se usa para enumerar las copias de seguridad
almacenadas en esa ubicación de destino. Las ubicaciones de destino de copia de
seguridad pueden ser una unidad de disco conectada localmente o una carpeta
compartida remota. Si este comando se ejecuta en el mismo equipo donde se
creó la copia de seguridad, este parámetro no es necesario. Sin embargo, este
parámetro es necesario para obtener información sobre una copia de seguridad
creada desde otro equipo.

-machine Especifica el nombre del equipo para el que quiere los detalles de la copia de
seguridad. Resulta útil cuando se ha realizado la copia de seguridad de varios
equipos en la misma ubicación. Debe usarse cuando se especifica -backupTarget.

Ejemplos
Para enumerar elementos de la copia de seguridad que se ejecutó el 31 de marzo de
2013 a las 9:00 a. m., escriba:

wbadmin get items -version:03/31/2013-09:00

Para enumerar los elementos de la copia de seguridad del server01 que se ejecutó el 30
de abril de 2013 a las 9:00 a. m. y se almacenó en \\<servername>\<share> , escriba:

wbadmin get items -version:04/30/2013-09:00 -backupTarget:\\servername\share


-machine:server01

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wbadmin

Comando wbadmin get versions

Get-WBBackupSet
wbadmin get status
Artículo • 14/04/2023

Notifica el estado de la operación de copia de seguridad o recuperación que se está


ejecutando actualmente.

Para obtener el estado de la operación de copia de seguridad o recuperación que se


está ejecutando actualmente usando este comando, debe ser miembro del grupo
Operadores de copia de seguridad o del grupo Administradores, o se le deben haber
delegado los permisos adecuados. Además, debe ejecutar wbadmin desde un símbolo
del sistema con privilegios elevados, haciendo clic con el botón derecho en Símbolo del
sistema y seleccionando Ejecutar como administrador.

) Importante

Este comando no se detiene hasta que finalice la operación de copia de seguridad


o recuperación. El comando se sigue ejecutando aunque cierre la ventana del
comando. Para detener la operación actual de copia de seguridad o recuperación,
ejecute el comando wbadmin stop job.

Sintaxis

wbadmin get status

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wbadmin

Comando wbadmin stop job

Get-WBJob
wbadmin get versions
Artículo • 14/04/2023

Muestra detalles sobre las copias de seguridad disponibles almacenadas en el equipo


local u otro equipo. Los detalles proporcionados para una copia de seguridad incluyen
el tiempo de copia de seguridad, la ubicación de almacenamiento de copia de
seguridad, el identificador de versión y el tipo de recuperaciones que puede realizar.

Para obtener detalles sobre las copias de seguridad disponibles usando este comando,
debe ser miembro del grupo Operadores de copias de seguridad o del grupo
Administradores, o se le deben haber delegado los permisos adecuados. Además, debe
ejecutar wbadmin desde un símbolo del sistema con privilegios elevados, haciendo clic
con el botón derecho en Símbolo del sistema y seleccionando Ejecutar como
administrador.

Si este comando se usa sin parámetros, enumera todas las copias de seguridad del
equipo local, incluso si esas copias de seguridad no están disponibles.

Sintaxis

wbadmin get versions [-backupTarget:{<BackupTargetLocation> |


<NetworkSharePath>}] [-machine:BackupMachineName]

Parámetros

Parámetro Descripción

- Especifica la ubicación de almacenamiento que contiene las copias de seguridad


backupTarget para las que desea obtener detalles. Se usa para enumerar las copias de
seguridad almacenadas en esa ubicación de destino. Las ubicaciones de destino
de copia de seguridad pueden estar conectadas localmente a unidades de disco,
volúmenes, carpetas compartidas remotas y medios extraíbles, como unidades de
DVD u otros medios ópticos. Si este comando se ejecuta en el mismo equipo
donde se creó la copia de seguridad, este parámetro no es necesario. Sin
embargo, este parámetro es necesario para obtener información sobre una copia
de seguridad creada desde otro equipo.

-machine Especifica el equipo para el que desea obtener los detalles de copia de seguridad.
Se usa cuando las copias de seguridad de varios equipos se almacenan en la
misma ubicación. Debe usarse cuando se especifica -backupTarget.
Ejemplos
Para ver una lista de las copias de seguridad disponibles almacenadas en el volumen H:,
escriba:

wbadmin get versions -backupTarget:H:

Para ver una lista de las copias de seguridad disponibles almacenadas en la carpeta
compartida remota \\<servername>\<share> para el server01 del equipo, escriba:

wbadmin get versions -backupTarget:\\servername\share -machine:server01

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wbadmin

Comando wbadmin get items

Get-WBBackupTarget
wbadmin restore catalog
Artículo • 14/04/2023

Recupera un catálogo de copia de seguridad para el equipo local desde una ubicación
de almacenamiento que especifique.

Para recuperar el catálogo de copia de seguridad incluido en una copia de seguridad


específica usando este comando, debe ser miembro del grupo Operadores de copias
de seguridad o del grupo Administradores, o se le deben haber delegado los permisos
adecuados. Además, debe ejecutar wbadmin desde un símbolo del sistema con
privilegios elevados, haciendo clic con el botón derecho en Símbolo del sistema y
seleccionando Ejecutar como administrador.

7 Nota

Si la ubicación (disco, DVD o carpeta compartida remota) donde almacena las


copias de seguridad está dañada o se ha perdido y no se puede usar para restaurar
el catálogo de copia de seguridad, ejecute el comando wbadmin delete catalog
para eliminar el catálogo dañado. En este caso, se recomienda crear una nueva
copia de seguridad después de eliminar el catálogo de copias de seguridad.

Sintaxis

wbadmin restore catalog -backupTarget:{<BackupDestinationVolume> |


<NetworkShareHostingBackup>} [-machine:<BackupMachineName>] [-quiet]

Parámetros

Parámetro Descripción

- Especifica la ubicación del catálogo de copia de seguridad del sistema tal y como
backupTarget estaba en el momento después de crear la copia de seguridad.

-machine Especifica el nombre del equipo para el que desea recuperar la copia de
seguridad del catálogo. Se usa cuando se han almacenado copias de seguridad
para varios equipos en la misma ubicación. Debe usarse cuando se especifica -
backupTarget.

-quiet Ejecuta el comando sin solicitudes al usuario.


Ejemplos
Para restaurar un catálogo a partir de una copia de seguridad almacenada en el disco D:,
escriba:

wbadmin restore catalog -backupTarget:D

Para restaurar un catálogo a partir de una copia de seguridad almacenada en la carpeta


compartida \\<servername>\<share> de server01, escriba:

wbadmin restore catalog -backupTarget:\\servername\share -machine:server01

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wbadmin

Comando wbadmin delete catalog

Restore-WBCatalog
wbadmin start backup
Artículo • 06/04/2023

Crea una copia de seguridad mediante parámetros especificados. Si no se especifica


ningún parámetro y ha creado una copia de seguridad diaria programada, este
comando crea la copia de seguridad mediante la configuración de la copia de seguridad
programada. Si se especifican parámetros, crea una copia de seguridad de copia del
Servicio de instantáneas de volumen (VSS) y no actualiza el historial de los archivos de
los que se realiza una copia de seguridad.

Para crear una copia de seguridad única usando este comando, debe ser miembro del
grupo Operadores de copias de seguridad o del grupo Administradores, o se le deben
haber delegado los permisos adecuados. Además, debe ejecutar wbadmin desde un
símbolo del sistema con privilegios elevados, haciendo clic con el botón derecho en
Símbolo del sistema y seleccionando Ejecutar como administrador.

Sintaxis
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 Descripción

-backupTarget Especifica la ubicación de almacenamiento de esta copia de seguridad.


Requiere una letra de unidad de disco duro (f:), una ruta basada en GUID de
volumen con el formato \\?\Volume{GUID} , o una ruta de Convención de
nomenclatura universal (UNC) a una carpeta compartida remota (\\
<servername>\<sharename>\) . De forma predeterminada, la copia de
seguridad se guardará en: \\<servername>\<sharename>\WindowsImageBackup\
<ComputerBackedUp>\ .
Parámetro Descripción

-include Especifica la lista delimitada por comas de elementos que se van a incluir en
la copia de seguridad. Se pueden incluir varios archivos, carpetas o
volúmenes. Las rutas de acceso a los volúmenes se pueden especificar
mediante letras de unidad, puntos de montaje o nombres basados en
identificadores GUID. Si usa un nombre de volumen basado en GUID, debe
terminar con una barra diagonal inversa ( \ ). Puede usar el carácter comodín
( * ) en el nombre del archivo cuando especifique una ruta de acceso a un
archivo. El parámetro -include solo debe usarse junto con el parámetro -
backupTarget.

-exclude Especifica la lista delimitada por comas de elementos que se van a excluir
de la copia de seguridad. Puede excluir archivos, carpetas o volúmenes. Las
rutas de acceso a los volúmenes se pueden especificar mediante letras de
unidad, puntos de montaje o nombres basados en identificadores GUID. Si
usa un nombre de volumen basado en GUID, debe terminar con una barra
diagonal inversa ( \ ). Puede usar el carácter comodín ( * ) en el nombre del
archivo cuando especifique una ruta de acceso a un archivo. El parámetro -
exclude solo se debe usar junto con el parámetro -backupTarget.

- Especifica la lista no recursiva, delimitada por comas, de elementos a incluir


nonRecurseInclude en la copia de seguridad. Se pueden incluir varios archivos, carpetas o
volúmenes. Las rutas de acceso a los volúmenes se pueden especificar
mediante letras de unidad, puntos de montaje o nombres basados en
identificadores GUID. Si usa un nombre de volumen basado en GUID, debe
terminar con una barra diagonal inversa ( \ ). Puede usar el carácter comodín
( * ) en el nombre del archivo cuando especifique una ruta de acceso a un
archivo. El parámetro -nonRecurseInclude solo debe usarse junto con el
parámetro -backupTarget.

- Especifica la lista no recursiva, delimitada por comas, de elementos a excluir


nonRecurseExclude de la copia de seguridad. Puede excluir archivos, carpetas o volúmenes. Las
rutas de acceso a los volúmenes se pueden especificar mediante letras de
unidad, puntos de montaje o nombres basados en identificadores GUID. Si
usa un nombre de volumen basado en GUID, debe terminar con una barra
diagonal inversa ( \ ). Puede usar el carácter comodín ( * ) en el nombre del
archivo cuando especifique una ruta de acceso a un archivo. El parámetro -
nonRecurseExclude solo debe usarse junto con el parámetro -
backupTarget.
Parámetro Descripción

-allCritical Especifica que todos los volúmenes críticos (volúmenes que contienen el
estado del sistema operativo) se incluyan en las copias de seguridad. Este
parámetro es útil si va a crear una copia de seguridad para la recuperación
sin sistema operativo. Solo se debe usar cuando se especifica -
backupTarget; de lo contrario, se produce un error en el comando. Se
puede usar con la opción -include.

Consejo: El volumen de destino de una copia de seguridad de volumen


crítico puede ser una unidad local, pero no puede ser ninguno de los
volúmenes incluidos en la copia de seguridad.

-systemState Crea una copia de seguridad que incluye el estado del sistema además de
cualquier otro elemento que haya especificado con el parámetro -include.
El estado del sistema contiene los archivos de arranque (Boot.ini, NDTLDR,
NTDetect.com), el Registro de Windows, incluida la configuración COM,
SYSVOL (directivas de grupo y scripts de inicio de sesión), Active Directory y
NTDS.DIT en los controladores de dominio y, si el servicio de certificados
está instalado, el almacén de certificados. Si su servidor tiene instalado el rol
de servidor web, se incluirá el metadirectorio de IIS. Si el servidor forma
parte de un clúster, también se incluirá información sobre el servicio de
clúster.

-noVerify Especifica que las copias de seguridad guardadas en medios extraíbles


(como un DVD) no se comprueben en busca de errores. Si no usa este
parámetro, las copias de seguridad guardadas en medios extraíbles se
comprueban en busca de errores.

-user Si la copia de seguridad se guarda en una carpeta compartida remota,


especifique el nombre de usuario con permiso de escritura en la carpeta.

-password Especifica la contraseña del nombre de usuario proporcionado por el


parámetro -user.

-noInheritAcl Aplica los permisos de la lista de control de acceso (ACL) que corresponden
a las credenciales proporcionadas por los parámetros -user y -password a
\\<servername>\<sharename>\WindowsImageBackup\<ComputerBackedUp>\ (la
carpeta que contiene la copia de seguridad). Para acceder posteriormente a
la copia de seguridad, deberá usar estas credenciales o ser miembro del
grupo de Administradores o del grupo de Operadores de copias de
seguridad en el equipo con la carpeta compartida. Si no se usa -
noInheritAcl, los permisos de ACL de la carpeta compartida remota se
aplican a la carpeta \<ComputerBackedUp> de forma predeterminada para
que cualquier persona con acceso a la carpeta compartida remota pueda
acceder a la copia de seguridad.
Parámetro Descripción

-vssFull Realiza una copia de seguridad completa usando el Servicio de instantáneas


de volumen (VSS). Se realiza una copia de seguridad de todos los archivos,
se actualiza el historial de cada archivo para reflejar que se ha realizado una
copia de seguridad y se pueden truncar los registros de las copias de
seguridad anteriores. Si no se usa este parámetro, wbadmin start backup
realiza una copia de seguridad, pero no se actualiza el historial de los
archivos de los que se está haciendo una copia de seguridad.

Precaución: No use este parámetro si está usando un producto que no sea


Copias de seguridad de Windows Server para hacer copias de seguridad de
las aplicaciones que están en los volúmenes incluidos en la copia de
seguridad actual. Hacerlo puede romper potencialmente las copias de
seguridad incrementales, diferenciales o de otro tipo que el otro producto
de copia de seguridad esté creando, porque el historial en el que se basan
para determinar la cantidad de datos de los que hay que hacer una copia de
seguridad podría faltar y se podría realizar una copia de seguridad completa
innecesariamente.

-vssCopy Realiza una copia de seguridad de copia mediante VSS. Se realiza una copia
de seguridad de todos los archivos, pero no se actualiza el historial de los
archivos de los que se realiza la copia de seguridad, por lo que se conserva
toda la información sobre los archivos que se han modificado, eliminado,
etc., así como los archivos de registro de la aplicación. El uso de este tipo de
copia de seguridad no afecta a la secuencia de copias de seguridad
incrementales y diferenciales que pueden producirse independientemente
de esta copia de seguridad. Este es el valor predeterminado.
Advertencia: No se puede usar una copia de seguridad de copia para
copias de seguridad o restauraciones incrementales o diferenciales.

-quiet Ejecuta el comando sin solicitudes al usuario.

Comentarios
Si guarda la copia de seguridad en una carpeta compartida remota y después
realiza otra en el mismo equipo y en la misma carpeta compartida remota,
sobrescribirá la copia de seguridad anterior.

Si se produce un error en la operación de copia de seguridad, puede terminar sin


una copia de seguridad porque se sobrescribe la copia de seguridad anterior, pero
la copia de seguridad más reciente no se puede usar. Para evitarlo, le
recomendamos que cree subcarpetas en la carpeta compartida remota para
organizar sus copias de seguridad. Sin embargo, debido a esta organización, debe
tener dos veces el espacio disponible como la carpeta primaria.
Ejemplos
Para crear una copia de seguridad de los volúmenes e:, d:\mountpoint y \\?
\Volume{cc566d14-4410-11d9-9d93-806e6f6e6963}\ en el volumen f:, escriba:

wbadmin start backup -backupTarget:f: -include:e:,d:\mountpoint,\\?


\Volume{cc566d14-44a0-11d9-9d93-806e6f6e6963}\

Para realizar una copia de seguridad única de f:\folder1} y h:\folder2 en el volumen d:,
para hacer una copia de seguridad del estado del sistema, y hacer una copia de
seguridad de copia para que la copia de seguridad diferencial programada
normalmente no se vea afectada, escriba:

wbadmin start backup –backupTarget:d: -include:g\folder1,h:\folder2 –


systemstate -vsscopy

Para realizar una copia de seguridad única y no recursiva de d:\folder1 en la ubicación


de red \\backupshare\backup1* y restringir el acceso a los miembros del grupo
Administradores u Operadores de copias de seguridad, escriba:

wbadmin start backup –backupTarget: \\backupshare\backup1 -noinheritacl -


nonrecurseinclude:d:\folder1

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wbadmin
wbadmin start recovery
Artículo • 14/04/2023

Ejecuta una operación de recuperación basada en los parámetros que especifique.

Para realizar una recuperación usando este comando, debe ser miembro del grupo
Operadores de copias de seguridad o del grupo Administradores, o se le deben haber
delegado los permisos adecuados. Además, debe ejecutar wbadmin desde un símbolo
del sistema con privilegios elevados, haciendo clic con el botón derecho en Símbolo del
sistema y seleccionando Ejecutar como administrador.

Sintaxis

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 Descripción

-version Especifica el identificador de versión de la copia de seguridad a recuperar


en formato MM/DD/AAAA-HH:MM. Si no conoce el identificador de
versión, ejecute el comando wbadmin get versions.

-items Especifica una lista delimitada por comas de volúmenes, aplicaciones,


archivos o carpetas que se van a recuperar. Debe usar este parámetro con
el parámetro -itemtype.
Parámetro Descripción

-itemtype Especifica el tipo de elementos que se van a recuperar. Debe ser Volume,
App o File. Si el -itemtype es Volume, puede especificar solo un volumen,
proporcionando la letra de unidad de volumen, el punto de montaje del
volumen o el nombre del volumen basado en GUID. Si el -itemtype es
App, solo puede especificar una sola aplicación o puede usar el valor
ADIFM para recuperar una instalación de Active Directory. Para
recuperarse, la aplicación debe haberse registrado con copias de
seguridad de Windows Server. Si el -itemtype es File, puede especificar
archivos o carpetas, pero deben formar parte del mismo volumen y deben
estar en la misma carpeta primaria.

-backupTarget Especifica la ubicación de almacenamiento que contiene la copia de


seguridad que quiere recuperar. Este parámetro es útil cuando la
ubicación es diferente de donde suelen almacenarse las copias de
seguridad de este equipo.

-machine Especifica el nombre del equipo para el que desea recuperar la copia de
seguridad. Este parámetro se debe usar cuando se especifica el parámetro
-backupTarget. El parámetro -machine es útil cuando se ha realizado una
copia de seguridad de varios equipos en la misma ubicación.

-recoveryTarget Especifica la ubicación a la que se va a restaurar. Este parámetro es útil si


esta ubicación es diferente de la ubicación de la que se ha realizado
anteriormente una copia de seguridad. También se puede usar para
restauraciones de volúmenes, archivos o aplicaciones. Si va a restaurar un
volumen, puede especificar la letra de unidad de volumen del volumen
alternativo. Si va a restaurar un archivo o una aplicación, puede especificar
una ubicación de recuperación alternativa.

-recursive Válido solo cuando se recuperan archivos. Recupera los archivos de las
carpetas y todos los archivos subordinados a las carpetas especificadas.
De forma predeterminada, solo se recuperan los archivos que residen
directamente en las carpetas especificadas.

-overwrite Válido solo cuando se recuperan archivos. Especifica la acción que se debe
realizar cuando ya existe un archivo que se está recuperando en la misma
ubicación. Las opciones válidas son:
Skip: hace que copias de seguridad de Windows Server omitan el
archivo existente y continúen con la recuperación del siguiente
archivo.
CreateCopy: hace que la copia de seguridad de Windows Server
cree una copia del archivo existente para que el archivo existente no
se modifique.
Overwrite: hace que la copia de seguridad de Windows Server
sobrescriba el archivo existente con el archivo de la copia de
seguridad.
Parámetro Descripción

-notRestoreAcl Válido solo cuando se recuperan archivos. Especifica que no se restauren


las listas de control de acceso de seguridad (ACL) de los archivos que se
recuperan de la copia de seguridad. De forma predeterminada, se
restauran las ACL de seguridad (el valor predeterminado es true). Si se usa
este parámetro, las ACL de los archivos restaurados se heredarán de la
ubicación a la que se van a restaurar los archivos.

- Válido solo cuando se recuperan volúmenes. Omite la comprobación de la


skipBadClusterCheck existencia de información de clúster errónea en los discos a los que se está
realizando la recuperación. Si va a recuperarse en un servidor o hardware
alternativo, se recomienda no usar este parámetro. Puede ejecutar
manualmente el comando chkdsk /b en estos discos en cualquier
momento para comprobar si tienen clústeres en mal estado, y después
actualizar la información del sistema de archivos en consecuencia.

Importante: Hasta que no ejecute chkdsk /b, es posible que los clústeres
en mal estado de los que se informa en su sistema recuperado no sean
exactos.

-noRollForward Válido solo cuando se recuperan aplicaciones. Permite la recuperación a


un momento dado anterior de una aplicación si selecciona la versión más
reciente de las copias de seguridad. La recuperación a un momento dado
anterior se realiza como valor predeterminado para todas las demás
versiones que no son más recientes de la aplicación.

-quiet Ejecuta el comando sin solicitudes al usuario.

Comentarios
Para ver una lista de elementos disponibles para recuperarse de una versión de
copia de seguridad específica, ejecute el comando wbadmin get items. Si un
volumen no tenía un punto de montaje o una letra de unidad en el momento de la
copia de seguridad, este comando devuelve un nombre de volumen basado en
GUID que se debe usar para recuperar el volumen.

Si usa un valor de ADIFM para realizar una instalación desde una operación
multimedia para recuperar los datos relacionados necesarios para Servicios de
dominio de Active Directory, ADIFM crea una copia del estado de la base de datos,
el registro y SYSVOL de Active Directory y, a continuación, guarda esta información
en la ubicación especificada por -recoveryTarget. Use este parámetro solo cuando
se especifique -recoveryTarget.

Ejemplos
Para ejecutar una recuperación de la copia de seguridad desde el 31 de marzo de 2020,
realizada a las 9:00 a. m., del volumen d:, escriba:

wbadmin start recovery -version:03/31/2020-09:00 -itemType:Volume -items:d:

Para ejecutar una recuperación en la unidad d de la copia de seguridad desde el 31 de


marzo de 2020, realizada a las 9:00 a. m., del registro, escriba:

wbadmin start recovery -version:03/31/2020-09:00 -itemType:App -


items:Registry -recoverytarget:d:\

Para ejecutar una recuperación de la copia de seguridad desde el 31 de marzo de 2020,


realizada a las 9:00 a. m., de la carpeta d:\folder y las carpetas subordinadas a d:\folder,
escriba:

wbadmin start recovery -version:03/31/2020-09:00 -itemType:File -


items:d:\folder -recursive

Para ejecutar una recuperación de la copia de seguridad desde el 31 de marzo de 2020,


realizada a las 9:00 a. m., del volumen \\?\Volume{cc566d14-44a0-11d9-9d93-
806e6f6e6963}\ , escriba:

wbadmin start recovery -version:03/31/2020-09:00 -itemType:Volume -items:\\?


\Volume{cc566d14-44a0-11d9-9d93-806e6f6e6963}\

Para ejecutar una recuperación de la copia de seguridad desde el 30 de abril de 2020,


realizada a las 9:00 a. m., de la carpeta compartida \\servername\share desde server01,
escriba:

wbadmin start recovery -version:04/30/2020-09:00 -


backupTarget:\\servername\share -machine:server01
Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wbadmin

Start-WBFileRecovery

Start-WBHyperVRecovery

Start-WBSystemStateRecovery

Start-WBVolumeRecovery
wbadmin start sysrecovery
Artículo • 08/04/2023

Realiza una recuperación del sistema (reconstrucción completa) usando los parámetros
especificados.

Para realizar una recuperación del sistema usando este comando, debe ser miembro del
grupo Operadores de copias de seguridad o del grupo Administradores, o se le deben
haber delegado los permisos adecuados.

) Importante

El comando wbadmin start sysrecovery debe ejecutarse desde la Consola de


recuperación de Windows y no aparece en el texto de uso predeterminado de la
herramienta wbadmin. Para obtener más información, consulte Entorno de
recuperación de Windows (WinRE).

Sintaxis

wbadmin start sysrecovery -version:<VersionIdentifier> -backupTarget:


{<BackupDestinationVolume> | <NetworkShareHostingBackup>} [-machine:
<BackupMachineName>] [-restoreAllVolumes] [-recreateDisks] [-excludeDisks]
[-skipBadClusterCheck] [-quiet]

Parámetros

Parámetro Descripción

-version Especifica el identificador de versión de la copia de seguridad a recuperar


en formato MM/DD/AAAA-HH:MM. Si no conoce el identificador de
versión, ejecute el comando wbadmin get versions.

-backupTarget Especifica la ubicación de almacenamiento que contiene la copia o copias


de seguridad que quiere recuperar. Este parámetro es útil cuando la
ubicación de almacenamiento es diferente de donde suelen almacenarse
las copias de seguridad de este equipo.
Parámetro Descripción

-machine Especifica el nombre del equipo para el que desea recuperar la copia de
seguridad. Este parámetro se debe usar cuando se especifica el parámetro
-backupTarget. El parámetro -machine es útil cuando se ha realizado una
copia de seguridad de varios equipos en la misma ubicación.

-restoreAllVolumes Recupera todos los volúmenes de la copia de seguridad seleccionada. Si


no se especifica este parámetro, solo se recuperan los volúmenes críticos
(volúmenes que contienen el estado del sistema y los componentes del
sistema operativo). Este parámetro es útil cuando es necesario recuperar
volúmenes no críticos durante la recuperación del sistema.

-recreateDisks Recupera una configuración de disco en el estado que existía cuando se


creó la copia de seguridad.
Advertencia: Este parámetro elimina todos los datos de los volúmenes
que hospedan componentes del sistema operativo. También puede
eliminar datos de volúmenes de datos.

-excludeDisks Válido solo cuando se especifica con el parámetro -recreateDisks y debe


introducirse como una lista delimitada por comas de identificadores de
disco (como se enumeran en la salida del comando wbadmin get disks).
Los discos excluidos no tienen particiones ni formato. Este parámetro
ayuda a conservar los datos de los discos que no desea modificar durante
la operación de recuperación.

- Válido solo cuando se recuperan volúmenes. Omite la comprobación de la


skipBadClusterCheck existencia de información de clúster errónea en los discos a los que se está
realizando la recuperación. Si va a recuperarse en un servidor o hardware
alternativo, se recomienda no usar este parámetro. Puede ejecutar
manualmente el comando chkdsk /b en estos discos en cualquier
momento para comprobar si tienen clústeres en mal estado, y después
actualizar la información del sistema de archivos en consecuencia.

Importante: Hasta que no ejecute chkdsk /b, es posible que los clústeres
en mal estado de los que se informa en su sistema recuperado no sean
exactos.

-quiet Ejecuta el comando sin solicitudes al usuario.

Ejemplos
Para empezar a recuperar la información de la copia de seguridad que se ejecutó el 31
de marzo de 2020 a las 9:00 a. m., ubicada en la unidad d:, escriba:

wbadmin start sysrecovery -version:03/31/2020-09:00 -backupTarget:d:


Para empezar a recuperar la información de la copia de seguridad que se ejecutó el 30
de abril de 2020 a las 9:00 a. m., ubicada en la carpeta compartida \\servername\share
de server01, escriba:

wbadmin start sysrecovery -version:04/30/2020-09:00 -


backupTarget:\\servername\share -machine:server01

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wbadmin

Get-WBBareMetalRecovery
wbadmin start systemstatebackup
Artículo • 06/04/2023

Crea una copia de seguridad del estado del sistema del equipo local y la almacena en la
ubicación especificada.

Para realizar una copia de seguridad del estado del sistema usando este comando, debe
ser miembro del grupo Operadores de copias de seguridad o del grupo
Administradores, o se le deben haber delegado los permisos adecuados. Además, debe
ejecutar wbadmin desde un símbolo del sistema con privilegios elevados, haciendo clic
con el botón derecho en Símbolo del sistema y seleccionando Ejecutar como
administrador.

7 Nota

Copias de seguridad de Windows Server no realiza copias de seguridad ni recupera


los subárboles de usuario del registro (HKEY_CURRENT_USER) como parte de la
copia de seguridad del estado del sistema o de la recuperación del estado del
sistema.

Sintaxis

wbadmin start systemstatebackup -backupTarget:<VolumeName> [-quiet]

Parámetros

Parámetro Descripción

- Especifica la ubicación en la que quiere almacenar la copia de seguridad. La


backupTarget ubicación de almacenamiento requiere una letra de unidad o un volumen basado
en GUID con el formato: \\?\Volume{*GUID*} . Use el comando -
backuptarget:\\servername\sharedfolder\ para almacenar copias de seguridad de
estado del sistema.

-quiet Ejecuta el comando sin indicaciones al usuario.

Ejemplos
Para crear una copia de seguridad de estado del sistema y almacenarla en el volumen f,
escriba:

wbadmin start systemstatebackup -backupTarget:f:

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wbadmin

Start-WBBackup
wbadmin start systemstaterecovery
Artículo • 06/04/2023

Realiza una recuperación del estado del sistema a una ubicación y a partir de una copia
de seguridad que usted especifique.

Para realizar una recuperación del estado del sistema usando este comando, debe ser
miembro del grupo Operadores de copias de seguridad o del grupo Administradores,
o se le deben haber delegado los permisos adecuados. Además, debe ejecutar wbadmin
desde un símbolo del sistema con privilegios elevados, haciendo clic con el botón
derecho en Símbolo del sistema y seleccionando Ejecutar como administrador.

7 Nota

Copias de seguridad de Windows Server no realiza copias de seguridad ni recupera


los subárboles de usuario del registro (HKEY_CURRENT_USER) como parte de la
copia de seguridad del estado del sistema o de la recuperación del estado del
sistema.

Sintaxis

wbadmin start systemstaterecovery -version:<VersionIdentifier> -showsummary


[-backupTarget:{<BackupDestinationVolume> | <NetworkSharePath>}]
[-machine:<BackupMachineName>] [-recoveryTarget:<TargetPathForRecovery>] [-
authsysvol] [-autoReboot] [-quiet]

Parámetros

Parámetro Descripción

-version Especifica el identificador de versión de la copia de seguridad a recuperar en


formato MM/DD/AAAA-HH:MM. Si no conoce el identificador de versión,
ejecute el comando wbadmin get versions.

- Informa del resumen de la última recuperación de estado del sistema (después


showsummary del reinicio necesario para finalizar la operación). Este parámetro no puede ir
acompañado de ningún otro parámetro.
Parámetro Descripción

-backupTarget Especifica la ubicación de almacenamiento que contiene la copia o copias de


seguridad que quiere recuperar. Este parámetro es útil cuando la ubicación de
almacenamiento es diferente de la ubicación en la que normalmente se
almacenan las copias de seguridad.

-machine Especifica el nombre del equipo para el que se va a recuperar la copia de


seguridad. Este parámetro se debe usar cuando se especifica el parámetro -
backupTarget. El parámetro -machine es útil cuando se ha realizado una copia
de seguridad de varios equipos en la misma ubicación.

- Especifica el directorio en el que se restaura. Este parámetro es útil si la copia de


recoveryTarget seguridad se restaura en una ubicación alternativa.

-authsysvol Realiza una restauración autoritativa del directorio compartido del volumen del
sistema (sysvol).

-autoReboot Especifica que se reinicie el sistema al final de la operación de recuperación de


estado del sistema. Este parámetro solo es válido para una recuperación en la
ubicación original. No se recomienda usar este parámetro si necesita realizar
pasos después de la operación de recuperación.

-quiet Ejecuta el comando sin indicaciones al usuario.

Ejemplos
Para iniciar una recuperación de estado del sistema de la copia de seguridad del
31/03/2020 a las 9:00 a.m., escriba:

wbadmin start systemstaterecovery -version:03/31/2020-09:00

Para iniciar una recuperación del estado del sistema de la copia de seguridad del
30/04/2020 a las 9:00 a.m. que está almacenada en el recurso compartido
\\servername\share para server01, escriba:

wbadmin start systemstaterecovery -version:04/30/2013-09:00 -


backupTarget:\\servername\share -machine:server01

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wbadmin

Start-WBSystemStateRecovery
wbadmin stop job
Artículo • 06/04/2023

Cancela la operación de copia de seguridad o recuperación que se esté ejecutando en


ese momento.

) Importante

Las operaciones canceladas no pueden reiniciarse. Deberá volver a ejecutar una


copia de seguridad cancelada o una operación de recuperación desde el principio.

Para detener una operación de copia de seguridad o recuperación usando este


comando, debe ser miembro del grupo Operadores de copia de seguridad o del grupo
Administradores, o se le deben haber delegado los permisos adecuados. Además, debe
ejecutar wbadmin desde un símbolo del sistema con privilegios elevados, haciendo clic
con el botón derecho en Símbolo del sistema y seleccionando Ejecutar como
administrador.

Sintaxis

wbadmin stop job [-quiet]

Parámetros

Parámetro Descripción

-quiet Ejecuta el comando sin indicaciones al usuario.

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wbadmin
wdsutil
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Wdsutil es una utilidad de línea de comandos que se usa para administrar el servidor de
Servicios de implementación de Windows. Para ejecutar estos comandos, haga clic en
Inicio, haga clic con el botón secundario en Símbolo del sistema y, a continuación, haga
clic en Ejecutar como administrador.

Comandos
Get-Help Descripción

Comando Agrega objetos o equipos preconfigurados.


wdsutil add

Comando Aprueba los equipos que están pendientes de aprobación administrativa.


wdsutil approve-
autoadddevices

Comando Convierte una imagen de preparación de instalación remota (RIPrep) existente


wdsutil convert- en un archivo de imagen de Windows (.wim).
riprepimage

Comando Copia una imagen o un grupo de controladores.


wdsutil copy

Comando Elimina los equipos que se encuentran en la base de datos de incorporación


wdsutil delete- automática (que almacena información sobre los equipos del servidor).
autoadddevices

Comando Deshabilita todos los servicios para Servicios de implementación de Windows.


wdsutil disable

Comando Desconecta un cliente de una transmisión de multidifusión o un espacio de


wdsutil nombres.
disconnect-client

Comando Habilita todos los servicios para Servicios de implementación de Windows.


wdsutil enable
Get-Help Descripción

Comando Exporta una imagen del almacén de imágenes a un archivo .wim.


wdsutil export-
image

Comando Recupera propiedades y atributos sobre el objeto especificado.


wdsutil get

Comando Configura un servidor de Servicios de implementación de Windows para su


wdsutil initialize- uso inicial.
server

Comando Crea nuevas imágenes de captura y detección, así como transmisiones de


wdsutil new multidifusión y espacios de nombres.

Comando Muestra el estado de progreso mientras se ejecuta un comando.


wdsutil progress

Comando Rechaza los equipos que están pendientes de aprobación administrativa.


wdsutil reject-
autoadddevices

Comando Quita objetos.


wdsutil remove

Comando Reemplaza una imagen de arranque o instalación por una nueva versión de
wdsutil replace- esa imagen.
image

Comando Establece propiedades y atributos en el objeto especificado.


wdsutil set

Comando Inicia todos los servicios en el servidor de Servicios de implementación de


wdsutil start Windows, incluidas las transmisiones de multidifusión, los espacios de
server nombres y el servidor de transporte.

Comando Detiene todos los servicios en el servidor de Servicios de implementación de


wdsutil stop Windows.
server

Comando Revierte los cambios realizados durante la inicialización del servidor.


wdsutil
uninitialize-
server

Comando Actualiza los archivos de servidor en el recurso compartido remoteInstall.


wdsutil update-
serverfiles
Get-Help Descripción

Comando Muestra la salida detallada de un comando especificado.


wdsutil verbose
Comandos wdsutil add
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Parámetros
Parámetro Descripción

Comando wdsutil Preconfigura un equipo en Active Directory.


add-device

Comando wdsutil Agrega imágenes de arranque o instalación.


add-image

Comando wdsutil Agrega un grupo de imágenes.


add-imagegroup

Comando wdsutil Agrega un paquete de controladores a un grupo de controladores.


add-
drivergrouppackage

Comando wdsutil Agrega paquetes de controladores a un grupo de controladores.


add-
drivergrouppackages

Comando wdsutil Agrega un paquete de controladores al servidor.


add-driverpackage

Comando wdsutil Agrega un paquete de controladores que se encuentra en el almacén de


add- controladores a una imagen de arranque existente en el servidor.
imagedriverpackage

Comando wdsutil Agrega paquetes de controladores desde el almacén de controladores a


add- una imagen de arranque en el servidor.
imagedriverpackages

Subcomando wdsutil Agrega paquetes de controladores de una carpeta a un servidor.


add-alldriverpackages

Comando wdsutil Agrega un grupo de controladores a un servidor.


add-drivergroup

Comando wdsutil Agrega un filtro a un grupo de controladores en un servidor.


add-drivergroupfilter
Vínculos relacionados
Clave de sintaxis de línea de comandos

Cmdlets de Servicios de implementación de Windows


wdsutil add-alldriverpackages
Artículo • 06/04/2023

Agrega todos los paquetes de controladores almacenados en una carpeta a un servidor.

Sintaxis

wdsutil /Add-AllDriverPackages /FolderPath:<folderpath> [/Server:


<servername>] [/Architecture:{x86 | ia64 | x64}] [/DriverGroup:<groupname>]

Parámetros

Parámetro Descripción

/FolderPath: <folderpath> Especifica la ruta de acceso completa a la carpeta que contiene


los archivos .inf para los paquetes de controladores.

[/Server: <servername> ] Especifica el nombre del servidor. Puede ser el nombre de


NetBIOS o el FQDN. Si no se especifica el nombre del servidor,
se usará el servidor local.

[/Architecture: {x86|ia64|x64} ] Especifica el tipo de arquitectura para el paquete de


controladores.

[/DriverGroup: <groupname> ] Especifica el nombre del grupo de controladores al que se


deben agregar los paquetes.

Ejemplos
Para agregar paquetes de controladores, escriba:

wdsutil /verbose /Add-AllDriverPackages /FolderPath:C:\Temp\Drivers


/Architecture:x86

wdsutil /Add-AllDriverPackages /FolderPath:C:\Temp\Drivers\Printers


/DriverGroup:Printer Drivers
Vínculos relacionados
Clave de sintaxis de línea de comandos

Cmdlets de Servicios de implementación de Windows

Add-WdsDriverPackage
wdsutil add-device
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Preconfigura un equipo en Active Directory Domain Services (AD DS). Los equipos
preconfigurados también se denominan equipos conocidos. Esto le permite configurar
propiedades para controlar la instalación del cliente. Por ejemplo, puede configurar el
programa de arranque de red y el archivo de instalación desatendida que el cliente
debería recibir, así como el servidor del que el cliente debería descargar los archivos de
arranque.

Sintaxis

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 Descripción

/Device: <Devicename> Especifica el nombre del dispositivo que se va a agregar.

/ID: <UUID|MAC address> Especifica el GUID/UUID o la dirección MAC del equipo.


Un GUID/UUID debe tener uno de los dos formatos:
cadena binaria ( /ID:ACEFA3E81F20694E953EB2DAA1E8B1B6 ) o
cadena GUID ( /ID:E8A3EFAC-201F-4E69-953E-
B2DAA1E8B1B6 ). Una dirección MAC debe tener el
siguiente formato: 00B056882FDC (sin guiones) o 00-B0-
56-88-2F-DC (con guiones)

[/ReferralServer: <Servername> ] Especifica el nombre del servidor con el que se debe


poner en contacto para descargar el programa de
arranque de red y la imagen de arranque mediante Trivial
File Transfer Protocol (tftp).
Parámetro Descripción

[/BootProgram: <Relativepath> ] Especifica la ruta relativa desde la carpeta remoteInstall


al programa de arranque en red que debería recibir este
equipo. Por ejemplo: boot\x86\pxeboot.com

[/WdsClientUnattend: <Relativepath> ] Especifica la ruta de acceso relativa de la carpeta


remoteInstall al archivo de instalación desatendida que
automatiza las pantallas de instalación del cliente de
Servicios de implementación de Windows.

[/User: <Domain\User|User@Domain> ] Establece permisos en el objeto de cuenta de equipo


para conceder al usuario especificado los derechos
necesarios para unir el equipo al dominio.

[/JoinRights: {JoinOnly|Full} ] Especifica el tipo de derechos que se asignarán al


usuario.
JoinOnly: requiere que el administrador restablezca
la cuenta del equipo antes de que el usuario pueda
unir el equipo al dominio.
Full: proporciona acceso total al usuario, incluido el
derecho de unir el equipo al dominio.

[/JoinDomain: {Yes|No} ] Especifica si el equipo debe unirse al dominio como esta


cuenta de equipo durante la instalación del sistema
operativo. El valor predeterminado es Yes.

[/BootImagepath: <Relativepath> ] Especifica la ruta de acceso relativa desde la carpeta


remoteInstall a la imagen de arranque que debe usar
este equipo.

[/OU: <DN of OU> ] Nombre distintivo de la unidad organizativa donde se


debe crear el objeto de cuenta de equipo. Por ejemplo:
OU=MyOU,CN=Test, DC=Domain,DC=com. La
ubicación predeterminada es el contenedor del equipo
predeterminado.

[/Domain: <Domain> ] El dominio donde se debe crear el objeto de cuenta de


equipo. La ubicación predeterminada es el directorio
local.

Ejemplos
Para agregar un equipo mediante una dirección MAC, escriba:

wdsutil /add-Device /Device:computer1 /ID:00-B0-56-88-2F-DC


Para agregar un equipo mediante una cadena GUID, escriba:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil get-alldevices

Comando wdsutil get-device

Comando wdsutil set-device

Servicios de implementación de Windows cmdlets

New-WdsClient
wdsutil add-drivergroup
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Agrega un grupo de controladores al servidor.

Sintaxis

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 Descripción

/DriverGroup: <Groupname> Especifica el nombre del nuevo grupo de controladores.

/Server: <Servername> Especifica el nombre del servidor. Puede ser el nombre de NetBIOS
o el FQDN. Si no se especifica el nombre del servidor, se usará el
servidor local.

/Enabled: {Yes|No} Habilita o deshabilita el paquete.

/Applicability: {Matched|All} Especifica los paquetes que se van a instalar si se cumplen los
criterios de filtro. Matched significa instalar solo los paquetes de
controladores que coinciden con el hardware de un cliente. All
significa instalar todos los paquetes en los clientes
independientemente de su hardware.
Parámetro Descripción

/Filtertype: <Filtertype> Especifica el tipo del filtro que se va a agregar al grupo. Puede
especificar varios tipos de filtro en un solo comando. Cada tipo de
filtro debe ir seguido de /Policy y al menos un /Value. Los valores
válidos son:

BiosVendor
Biosversion
Chassistype
Fabricante
Uuid
Osversion
Osedition
OsLanguage

Para obtener información sobre cómo obtener valores para todos


los demás tipos de filtro, consulte Filtros de grupo de
controladores.

[/Policy: {Include|Exclude} ] Especifica la directiva que se va a establecer en el filtro. Si /Policy


se establece en Include, los equipos cliente que coincidan con el
filtro podrán instalar los controladores de este grupo. Si /Policy se
establece en Exclude, los equipos cliente que coincidan con el
filtro no podrán instalar los controladores de este grupo.

[/Value: <Value> ] Especifica el valor de cliente que corresponde a /Filtertype. Puede


especificar varios valores para un único tipo. Para obtener
información sobre los valores de tipo de filtro aceptables, consulte
Filtros de grupo de controladores.

Ejemplos
Para agregar un grupo de controladores, escriba:

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
Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil add-drivergrouppackage

Comando wdsutil add-drivergrouppackages

Comando wdsutil add-drivergroupfilter

Cmdlets de Servicios de implementación de Windows


add-DriverGroupFilter
Artículo • 12/04/2023

Agrega un filtro a un grupo de controladores en un servidor.

Sintaxis

wdsutil /Add-DriverGroupFilter /DriverGroup:<Group Name> [/Server:<Server


name>] /FilterType:<Filter Type> /Policy:{Include | Exclude} /Value:<Value>
[/Value:<Value> ...]

Parámetros

Parámetro Descripción

/DriverGroup: <Groupname> Especifica el nombre del nuevo grupo de controladores.

/Server: <Servername> Especifica el nombre del servidor. Puede ser el nombre NetBIOS o el
FQDN. Si no se especifica el nombre del servidor, se usará el
servidor local.

/Filtertype: <Filtertype> Especifica el tipo del filtro que se va a agregar al grupo. Puede
especificar varios tipos de filtro en un solo comando. Cada tipo de
filtro debe ir seguido de /Policy y al menos un /Value. Los valores
válidos son:

BiosVendor
Biosversion
ChassisType
Fabricante
Uuid
OsVersion
Osedition
OsLanguage

Para obtener información sobre cómo obtener valores para todos


los demás tipos de filtro, consulte Filtros de grupo de
controladores.
Parámetro Descripción

[/Policy: {Include|Exclude} ] Especifica la directiva que se va a establecer en el filtro. Si /Policy se


establece en Include, los equipos cliente que coincidan con el filtro
podrán instalar los controladores de este grupo. Si /Policy se
establece en Exclude, los equipos cliente que coincidan con el filtro
no podrán instalar los controladores de este grupo.

[/Value: <Value> ] Especifica el valor de cliente que corresponde a /Filtertype. Puede


especificar varios valores para un único tipo. Para obtener
información sobre los valores de tipo de filtro aceptables, consulte
Filtros de grupo de controladores.

Ejemplos
Para agregar un filtro a un grupo de controladores, escriba:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil add-drivergrouppackage

Comando wdsutil add-drivergrouppackages

Comando wdsutil add-drivergroup

Cmdlets de Servicios de implementación de Windows


wdsutil add-drivergrouppackage
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Agrega un paquete de controladores a un grupo de controladores.

Sintaxis

wdsutil /add-DriverGroupPackage /DriverGroup:<Group Name> [/Server:<Server


Name>] {/DriverPackage:<Name> | /PackageId:<ID>}

Parámetros

Parámetro Descripción

/DriverGroup: <Groupname> Especifica el nombre del nuevo grupo de controladores.

/Server: <Servername> Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o
el FQDN. Si no se especifica el nombre del servidor, se usará el
servidor local.

/DriverPackage: <Name> Especifica el nombre del paquete de controladores que se va a


agregar al grupo. Debe especificar esta opción si el paquete de
controladores no puede identificarse de forma única por su nombre.

/PackageId: <ID> Especifica el identificador de un paquete. Para encontrar el id. del


paquete, seleccione el grupo de controladores en el que se
encuentra el paquete (o el nodo Todos los paquetes), haga clic con
el botón derecho en el paquete y después seleccione Propiedades. El
id. del paquete se enumera en la pestaña General, por ejemplo:
{DD098D20-1850-4fc8-8E35-EA24A1BEFF5E}.

Ejemplos
Para agregar un paquete de grupo de controladores, escriba:
wdsutil /add-DriverGroupPackage /DriverGroup:printerdrivers /PackageId:
{4D36E972-E325-11CE-Bfc1-08002BE10318}

wdsutil /add-DriverGroupPackage /DriverGroup:printerdrivers


/DriverPackage:XYZ

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil add-drivergroupfilter

Comando wdsutil add-drivergrouppackages

Comando wdsutil add-drivergroup

Cmdlets de Servicios de implementación de Windows


wdsutil add-drivergrouppackages
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Agrega paquetes de grupos de controladores.

Sintaxis

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 Descripción

/DriverGroup: <Groupname> Especifica el nombre del


nuevo grupo de
controladores.

/Server: <Servername> Especifica el nombre del


servidor. Puede ser el nombre
de NetBIOS o el FQDN. Si no
se especifica el nombre del
servidor, se usará el servidor
local.
Parámetro Descripción

/Filtertype: <Filtertype> Especifica el tipo del paquete


de controladores que se va a
buscar. Puede especificar
varios atributos en un solo
comando. También debe
especificar /Operator y
/Value con esta opción. Los
valores válidos son:

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 la relación entre el


atributo y los valores. Solo
puede especificar Contains
con atributos de cadena. Solo
puede especificar Equal,
NotEqual, GreaterOrEqual y
LessOrEqual con atributos de
fecha y versión.

/Value: <Value> Especifica el valor de cliente


correspondiente a
/Filtertype. Puede especificar
varios valores para un solo
/Filtertype. Los valores
disponibles para cada filtro
son:
Parámetro Descripción

PackageId: especifique
un GUID válido. Por
ejemplo: {4d36e972-
e325-11ce-bfc1-
08002be10318}
PackageName:
especifique cualquier
valor de cadena
PackageEnabled:
especifique Yes o No
Packagedateadded:
especifique la fecha en
el formato siguiente:
AAAA/MM/DD
PackageInfFilename:
especifique cualquier
valor de cadena
PackageClass:
especifique un nombre
de clase o un GUID de
clase válidos. Por
ejemplo: DiskDrive,
Net o {4d36e972-e325-
11ce-bfc1-
08002be10318}
PackageProvider:
especifique cualquier
valor de cadena
PackageArchitecture:
especifique x86, x64 o
ia64
PackageLocale:
especifique un
identificador de idioma
válido. Por ejemplo:
en-US o es-ES
PackageSigned:
especifique Yes o No
PackagedatePublished:
especifique la fecha en
el formato siguiente:
AAAA/MM/DD
Packageversion:
especifique la versión
en el siguiente
formato: a.b.x.y. Por
ejemplo: 6.1.0.0
Parámetro Descripción

Driverdescription:
especifique cualquier
valor de cadena
DriverManufacturer:
especifique cualquier
valor de cadena
DriverHardwareId:
especifique cualquier
valor de cadena
DrivercompatibleId:
especifique cualquier
valor de cadena
DriverExcludeId:
especifique cualquier
valor de cadena
DriverGroupId:
especifique un GUID
válido. Por ejemplo:
{4d36e972-e325-11ce-
bfc1-08002be10318}
DriverGroupName:
especifique cualquier
valor de cadena

Para más información sobre


estos valores, vea Atributos
de controlador y paquete.

Ejemplos
Para agregar un paquete de grupo de controladores, escriba:

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
Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil add-driverpackage

Comando wdsutil add-drivergrouppackage

Comando wdsutil add-alldriverpackages

Cmdlets de Servicios de implementación de Windows


add-DriverPackage
Artículo • 06/04/2023

Agrega un paquete de controladores al servidor.

Sintaxis

wdsutil /Add-DriverPackage /InfFile:<Inf File path> [/Server:<Server name>]


[/Architecture:{x86 | ia64 | x64}] [/DriverGroup:<Group Name>] [/Name:
<Friendly Name>]

Parámetros

Parámetro Descripción

/InfFile: <InfFilepath> Especifica la ruta de acceso completa del archivo .inf que se va a
agregar.

[/Server: <Servername> ] Especifica el nombre del servidor. Puede ser el nombre de NetBIOS
o el FQDN. Si no se especifica el nombre del servidor, se usará el
servidor local.

[/Architecture: {x86 | ia64 Especifica el tipo de arquitectura para el paquete de controladores.


| x64} ]

[/DriverGroup: <groupname> ] Especifica el nombre del grupo de controladores al que se deben


agregar los paquetes.

[/Name: <friendlyname> ] Especifica el nombre descriptivo del paquete de controladores.

Ejemplos
Para agregar un paquete de controladores, escriba:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil add-drivergrouppackage

Comando wdsutil add-alldriverpackages

Cmdlets de Servicios de implementación de Windows


wdsutil add-image
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Agrega imágenes a un servidor de Servicios de implementación de Windows.

Sintaxis
Para las imágenes de arranque, use la sintaxis siguiente:

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 las imágenes de instalación, use la sintaxis siguiente:

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 Descripción

/ImageFile: <.wim filepath> Especifica la ruta de acceso completa y el nombre del


archivo de imagen de Windows (.wim) que contiene las
imágenes que se van a agregar.

[/Server: <Servername> ] Especifica el nombre del servidor. Puede ser el nombre de


NetBIOS o el nombre de dominio completo (FQDN). Si no
se especifica un nombre de servidor, se usará el servidor
local.

[/ImageType: {Boot \| Install} ] Especifica el tipo de imágenes que se van a agregar.


Parámetro Descripción

[/SkipVerify] Especifica que la comprobación de integridad no se


realizará en el archivo de imagen de origen antes de
agregar la imagen.

[/Name: <Name> ] Establece el nombre para mostrar de la imagen.

[/Description: <Description> ] Establece la descripción de la imagen.

[/Filename: <Filename> ] Especifica el nuevo nombre del archivo .wim. Esto le


permite cambiar el nombre del archivo .wim al agregar la
imagen. Si no especifica un nombre de archivo, se usará el
nombre de archivo de la imagen de origen. En todos los
casos, Servicios de implementación de Windows
comprueba si el nombre de archivo es único en el almacén
de imágenes de arranque del equipo de destino.

/ImageGroup: <Imagegroupname> ] Especifica el nombre del grupo de imágenes en el que se


van a agregar las imágenes. Si existe más de un grupo de
imágenes en el servidor, deberá especificarse el grupo de
imágenes. Si no especifica el grupo de imágenes y aún no
existe un grupo de imágenes, se crea un nuevo grupo de
imágenes. De otro modo, se usa el grupo de imágenes
existente.

[/SingleImage: <Singleimagename> ] Copia la imagen única especificada de un archivo .wim y


[/Name: <Name> ] [/Description: establece el nombre para mostrar y la descripción de la
<Description> ] imagen.

[/UnattendFile: <Unattendfilepath> ] Especifica la ruta de acceso completa al archivo de


instalación desatendida que se va a asociar a las imágenes
que se van a agregar. Si no se especifica /SingleImage, el
mismo archivo desatendido está asociado a todas las
imágenes del archivo .wim.

Ejemplos
Para agregar una imagen de arranque, escriba:

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 agregar una imagen de instalación, escriba una de las siguientes opciones:
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"

Vínculos relacionados
Clave de sintaxis de línea de comandos

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 de Servicios de implementación de Windows


wdsutil add-imagedriverpackage
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Agrega un paquete de controladores que se encuentra en el almacén de controladores


a una imagen de arranque existente en el servidor.

Sintaxis

wdsutil /add-ImageDriverPackage [/Server:<Servername>] [media:<Imagename>]


[mediatype:Boot] [/Architecture:{x86 | ia64 | x64}] [/Filename:<Filename>]
{/DriverPackage:<Package Name> | /PackageId:<ID>}

Parámetros

Parámetro Descripción

[/Server: <Servername> ] Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el
nombre de dominio completo (FQDN). Si no se especifica un nombre
de servidor, se usará el servidor local.

[media: <Imagename> ] Especifica el nombre de la imagen a la que se va a agregar el


controlador.

[mediatype:Boot] Especifica el tipo de imagen al que se va a agregar el controlador. Los


paquetes de controladores solo se pueden agregar a las imágenes de
arranque.

[/Architecture: {x86 | Especifica la arquitectura de la imagen de arranque. Dado que es


ia64 | x64} ] posible tener el mismo nombre de imagen para imágenes de arranque
en diferentes arquitecturas, debe especificar la arquitectura para
garantizar que se usa la imagen correcta.

[/Filename: <Filename> ] Especifica el nombre del archivo. Si la imagen no se puede identificar de


forma única por nombre, se debe especificar el nombre de archivo.

[/DriverPackage: <Name> Especifica el nombre del paquete de controladores que se va a agregar


a la imagen.
Parámetro Descripción

[/PackageId: <ID> ] Especifica el identificador de Servicios de implementación de Windows


del paquete de controladores. Debe especificar esta opción si el
paquete de controladores no puede identificarse de forma única por su
nombre. Para encontrar el id. del paquete, seleccione el grupo de
controladores en el que se encuentra el paquete (o el nodo Todos los
paquetes), haga clic con el botón derecho en el paquete y después
seleccione Propiedades. El id. de paquete aparece en la pestaña
General. Por ejemplo: {DD098D20-1850-4fc8-8E35-EA24A1BEFF5E}.

Ejemplos
Para agregar un paquete de controladores a una imagen de arranque, escriba:

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}

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil add-imagedriverpackages

Servicios de implementación de Windows cmdlets


wdsutil add-imagedriverpackages
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Agrega paquetes de controladores desde el almacén de controladores a una imagen de


arranque.

Sintaxis

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 Descripción

[/Server: <Servername> ] Especifica el nombre del


servidor. Puede ser el nombre
de NetBIOS o el nombre de
dominio completo (FQDN). Si
no se especifica un nombre
de servidor, se usará el
servidor local.

[media: <Imagename> ] Especifica el nombre de la


imagen a la que se va a
agregar el controlador.

[mediatype:Boot] Especifica el tipo de imagen


al que se va a agregar el
controlador. Los paquetes de
controladores solo se pueden
agregar a las imágenes de
arranque.
Parámetro Descripción

[/Architecture: {x86 | ia64 | x64} ] Especifica la arquitectura de


la imagen de arranque. Dado
que es posible tener el
mismo nombre de imagen
para imágenes de arranque
en diferentes arquitecturas,
debe especificar la
arquitectura para garantizar
que se usa la imagen
correcta.

[/Filename: <Filename> ] Especifica el nombre del


archivo. Si la imagen no se
puede identificar de forma
única por nombre, se debe
especificar el nombre de
archivo.

/Filtertype: <Filtertype> Especifica el atributo del


paquete de controladores
que se va a buscar. Puede
especificar varios atributos en
un solo comando. También
debe especificar /Operator y
/Value con esta opción. Los
valores válidos son:

PackageId
PackageName
PackageEnabled
Packagedateadded
PackageInfFilename
PackageClass
PackageProvider
PackageArchitecture
PackageLocale
PackageSigned
PackagedatePublished
Packageversion
Driverdescription
DriverManufacturer
DriverHardwareId
DrivercompatibleId
DriverExcludeId
DriverGroupId
DriverGroupName**

.
Parámetro Descripción

/Operator: {Equal|NotEqual|GreaterOrEqual|LessOrEqual|Contains} Especifica la relación entre el


atributo y los valores. Solo
puede especificar Contains
con atributos de cadena. Solo
puede especificar
GreaterOrEqual y
LessOrEqual con atributos de
fecha y versión.

/Value: <Value> Especifica el valor a buscar


relativo al <attribute>
especificado. Puede
especificar varios valores para
un solo /Filtertype. Los
valores disponibles para cada
filtro son:

PackageId: especifique
un GUID válido. Por
ejemplo: {4d36e972-
e325-11ce-bfc1-
08002be10318}
PackageName:
especifique cualquier
valor de cadena
PackageEnabled:
especifique Yes o No
Packagedateadded:
especifique la fecha en
el formato siguiente:
AAAA/MM/DD
PackageInfFilename:
especifique cualquier
valor de cadena
PackageClass:
especifique un nombre
de clase o un GUID de
clase válidos. Por
ejemplo: DiskDrive,
Net o {4d36e972-e325-
11ce-bfc1-
08002be10318}
PackageProvider:
especifique cualquier
valor de cadena
PackageArchitecture:
especifique x86, x64 o
ia64
Parámetro Descripción

PackageLocale:
especifique un
identificador de idioma
válido. Por ejemplo:
en-US o es-ES
PackageSigned:
especifique Yes o No
PackagedatePublished:
especifique la fecha en
el formato siguiente:
AAAA/MM/DD
Packageversion:
especifique la versión
en el siguiente
formato: a.b.x.y. Por
ejemplo: 6.1.0.0
Driverdescription:
especifique cualquier
valor de cadena
DriverManufacturer:
especifique cualquier
valor de cadena
DriverHardwareId:
especifique cualquier
valor de cadena
DrivercompatibleId:
especifique cualquier
valor de cadena
DriverExcludeId:
especifique cualquier
valor de cadena
DriverGroupId:
especifique un GUID
válido. Por ejemplo:
{4d36e972-e325-11ce-
bfc1-08002be10318}
DriverGroupName:
especifique cualquier
valor de cadena

Para más información sobre


estos valores, vea Atributos
de controlador y paquete.

Ejemplos
Para agregar paquetes de controladores a una imagen de arranque, escriba una de las
siguientes opciones:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil add-imagedriverpackage

Comando wdsutil add-alldriverpackages

Cmdlets de Servicios de implementación de Windows


wdsutil add-imagegroup
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Agrega un grupo de imágenes a un servidor de Servicios de implementación de


Windows.

Sintaxis

wdsutil [Options] /add-ImageGroup imageGroup:<Imagegroupname> [/Server:


<Server name>]

Parámetros

Parámetro Descripción

[imageGroup: <Imagegroupname> ] Especifica el nombre de una imagen que se va a agregar.

[/Server: <Servername> ] Especifica el nombre del servidor. Puede ser el nombre de


NetBIOS o el nombre de dominio completo (FQDN). Si no se
especifica un nombre de servidor, se usará el servidor local.

Ejemplos
Para agregar un grupo de imágenes, escriba:

wdsutil /add-ImageGroup imageGroup:ImageGroup2

wdsutil /verbose /add-Imagegroup imageGroup:My Image Group


/Server:MyWDSServer
Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil get-allimagegroups

Comando wdsutil get-imagegroup

Comando wdsutil remove-imagegroup

Comando wdsutil set-imagegroup

Cmdlets de Servicios de implementación de Windows


wdsutil approve-autoadddevices
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Aprueba los equipos que están pendientes de aprobación administrativa. Cuando está
activada la directiva Agregar automáticamente, se requiere la aprobación administrativa
antes de que los equipos desconocidos (los que no están preconfigurados) puedan
instalar una imagen. Puede habilitar esta directiva mediante la pestaña Respuesta de
entorno de ejecución previo al arranque de la página de propiedades del servidor.

Sintaxis

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 Descripción

/Server: <Servername> Especifica el nombre del servidor. Puede ser el nombre


de NetBIOS o el FQDN. Si no se especifica el nombre del
servidor, se usará el servidor local.

/RequestId: {Request ID|ALL} Especifica el identificador de solicitud asignado al equipo


pendiente. Especifique ALL para aprobar todos los
equipos pendientes.

/Machinename: <Devicename> Especifica el nombre del dispositivo que se va a agregar.


No puede usar esta opción al aprobar todos los equipos.

[/OU: <DN of OU> ] Nombre distintivo de la unidad organizativa donde se


debe crear el objeto de cuenta de equipo. Por ejemplo:
OU=MyOU,CN=Test, DC=Domain,DC=com. La
ubicación predeterminada es el contenedor del equipo
predeterminado.
Parámetro Descripción

[/User: <Domain\User|User@Domain> ] Establece permisos en el objeto de cuenta de equipo


para conceder al usuario especificado los derechos
necesarios para unir el equipo al dominio.

[/JoinRights: {JoinOnly|Full} ] Especifica el tipo de derechos que se asignarán al


usuario.
JoinOnly: requiere que el administrador restablezca
la cuenta del equipo antes de que el usuario pueda
unir el equipo al dominio.
Full: proporciona acceso total al usuario, incluido el
derecho de unir el equipo al dominio.

[/JoinDomain: {Yes|No} ] Especifica si el equipo debe unirse al dominio como esta


cuenta de equipo durante la instalación del sistema
operativo. El valor predeterminado es Yes.

[/ReferralServer: <Servername> ] Especifica el nombre del servidor con el que se debe


ponerse en contacto para descargar el programa de
arranque de red y la imagen de arranque mediante Trivial
File Transfer Protocol (tftp).

[/BootProgram: <Relativepath> ] Especifica la ruta relativa desde la carpeta remoteInstall


al programa de arranque en red que debería recibir este
equipo. Por ejemplo: boot\x86\pxeboot.com.

[/WdsClientUnattend: <Relativepath> ] Especifica la ruta de acceso relativa desde la carpeta


remoteInstall al archivo desatendido que automatiza el
cliente de Servicios de implementación de Windows.

[/BootImagepath: <Relativepath> ] Especifica la ruta de acceso relativa desde la carpeta


remoteInstall a la imagen de arranque que debería recibir
este equipo.

Ejemplos
Para aprobar el equipo con un RequestId de 12, escriba:

wdsutil /Approve-AutoaddDevices /RequestId:12

Para aprobar el equipo con un RequestID de 20 e implementar la imagen con la


configuración especificada, escriba:
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 aprobar todos los equipos pendientes, escriba:

wdsutil /verbose /Approve-AutoaddDevices /RequestId:ALL

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil delete-autoadddevices

Comando wdsutil get-autoadddevices

Comando wdsutil reject-autoadddevices

Cmdlets de Servicios de implementación de Windows


convert-riprepimage
Artículo • 14/04/2023

Convierte una imagen de preparación de instalación remota (RIPrep) existente en


formato de imagen de Windows (.wim).

Sintaxis

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 Descripción

/FilePath: <Filepath Especifica la ruta de acceso de archivo completa y el nombre del archivo .sif
and name> que corresponde a la imagen RIPrep. Este archivo se suele denominar
Riprep.sif y se encuentra en la subcarpeta \Templates de la carpeta que
contiene la imagen RIPrep.

/DestinationImage Especifica la configuración de la imagen de destino. Usa las siguientes


opciones:
/FilePath:<Filepath and name> : establece la ruta de acceso de
archivo completa para el nuevo archivo. Por ejemplo:
C:\Temp\convert.wim
[ /Name:<Name> ]: establece el nombre para mostrar de la imagen. Si no
se especifica ningún nombre para mostrar, se usa el nombre para
mostrar de la imagen de origen.
[ /Description:<Description> ]: establece la descripción de la imagen.
[/InPlace]: especifica que la conversión debe realizarse en la imagen
RIPrep original y no en una copia de la imagen original, que es el
comportamiento predeterminado.
[ /Overwrite:{Yes | No | Append} ]: establece si esta imagen debe
sobrescribir o anexar los archivos existentes.

Ejemplos
Para convertir la imagen RIPrep.sif especificada en RIPREP.wim, escriba:
wdsutil /Convert-RiPrepImage /FilePath:R:\RemoteInstall\Setup\English
\Images\Win2k3.SP1\i386\Templates\riprep.sif /DestinationImage
/FilePath:C:\Temp\RIPREP.wim

Para convertir la imagen RIPrep.sif especificada en RIPREP.wim con el nombre y la


descripción especificados, y sobrescribirla con el nuevo archivo si ya existe un archivo,
escriba:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Cmdlets de Servicios de implementación de Windows


Comandos wdsutil copy
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Copian una imagen o un grupo de controladores.

Parámetros
Parámetro Descripción

Comando wdsutil copy-image Copia imágenes que están dentro del mismo grupo de
imágenes.

Comando wdsutil copy- Copia un grupo de controladores existente en el servidor.


drivergroup

Vínculos relacionados
Clave de sintaxis de línea de comandos

Cmdlets de Servicios de implementación de Windows


copy-drivergroup
Artículo • 06/04/2023

Duplica un grupo de controladores existente en el servidor, incluidos los filtros, los


paquetes de controladores y el estado habilitado o deshabilitado.

Sintaxis

wdsutil /Copy-DriverGroup [/Server:<Server name>] /DriverGroup:<Source


Groupname> /GroupName:<New Groupname>

Parámetros

Parámetro Descripción

/Server: <Servername> Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el
FQDN. Si no se especifica el nombre del servidor, se usará el servidor
local.

/DriverGroup: <Source Especifica el nombre del grupo de controladores de origen.


Groupname>

/GroupName: <New Especifica el nombre del nuevo grupo de controladores.


Groupname>

Ejemplos
Para copiar un grupo de controladores, escriba:

wdsutil /Copy-DriverGroup /Server:MyWdsServer /DriverGroup:PrinterDrivers


/GroupName:X86PrinterDrivers

wdsutil /Copy-DriverGroup /DriverGroup:PrinterDrivers


/GroupName:ColorPrinterDrivers
Vínculos relacionados
Clave de sintaxis de línea de comandos

Cmdlets de Servicios de implementación de Windows


wdsutil copy-image
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Copia imágenes que están dentro del mismo grupo de imágenes. Para copiar imágenes
entre grupos de imágenes, use el comando wdsutil Export-Image y, a continuación, el
comando wdsutil add-Image.

Sintaxis

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 Descripción

imagen: <Imagename> especifica el nombre de una imagen que se va a copiar.

[/Server: <Servername> ] Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el
nombre de dominio completo (FQDN). Si no se especifica el nombre del
servidor, se usará el servidor local.

imagetype:Install Especifica el tipo de imagen que se va a copiar. Esta opción debe


establecerse en install.

\imageGroup: <Image Especifica el grupo de imágenes que contiene la imagen que se va a


groupname> ] copiar. Si no se especifica ningún grupo de imágenes y solo existe un
grupo en el servidor, ese grupo de imágenes se usa de forma
predeterminada. Si existen varios grupos de imágenes en el servidor,
debe especificar el grupo de imágenes.

[/Filename: <Filename> ] Especifica el nombre de archivo de la imagen que se va a copiar. Si la


imagen no se puede identificar de manera exclusiva por el nombre,
debe especificar esta opción.
Parámetro Descripción

/DestinationImage Especifica la configuración de la imagen de destino. Los valores válidos


son:
/Name: <Name> establece el nombre para mostrar de la imagen
que se va a copiar.
/Filename: <Filename> establece el nombre del archivo de imagen
de destino que contendrá la copia de la imagen.
[/Description: <Description> ]: establece la descripción de la copia
de la imagen.

Ejemplos
Para crear una copia de la imagen especificada y asignar un nombre a
WindowsVista.wim, escriba:

wdsutil /copy-Image image:Windows Vista with Office imagetype:Install


/DestinationImage /Name:copy of Windows Vista with Office /
Filename:WindowsVista.wim

Para crear una copia de la imagen especificada, aplicar la configuración especificada y


asignare el nombre WindowsVista.wim a la copia, escriba:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil add-image

Comando wdsutil export-image

Comando wdsutil get-image

Comando wdsutil remove-image


Comando wdsutil replace-image

Comando wdsutil set-image

Servicios de implementación de Windows cmdlets


wdsutil delete autoadddevices
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Elimina los equipos pendientes, rechazados o aprobados de la base de datos de adición


automática. Esta base de datos almacena información sobre estos equipos en el
servidor.

Sintaxis

wdsutil /delete-AutoaddDevices [/Server:<Servername>] /Devicetype:


{PendingDevices | RejectedDevices |ApprovedDevices}

Parámetros

Parámetro Descripción

[/Server: <Servername> ] Especifica el nombre del


servidor. Puede ser el nombre
de NetBIOS o el nombre de
dominio completo (FQDN). Si
no se especifica un nombre de
servidor, se usará el servidor
local.

/Devicetype: {PendingDevices|RejectedDevices|ApprovedDevices} Especifica el tipo de equipo


que se va a eliminar de la base
de datos. Este tipo puede ser
PendingDevices, que devuelve
todos los equipos de la base
de datos en estado pendiente,
RejectedDevices, que devuelve
todos los equipos de la base
de datos en estado rechazado
o ApprovedDevices, que
devuelve todos los equipos en
estado aprobado.
Ejemplos
Para eliminar todos los equipos rechazados, escriba:

wdsutil /delete-AutoaddDevices /Devicetype:RejectedDevices

Para eliminar todos los equipos aprobados, escriba:

wdsutil /verbose /delete-AutoaddDevices /Server:MyWDSServer


/Devicetype:ApprovedDevices

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil approve-autoadddevices

Comando wdsutil get-autoadddevices

Comando wdsutil reject-autoadddevices

Cmdlets de Servicios de implementación de Windows


Comandos wdsutil disable
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Deshabilita todos los servicios para Servicios de implementación de Windows.

Parámetros
Parámetro Descripción

Comando wdsutil Deshabilita todos los servicios de Servicios de implementación de


disable-server Windows en un servidor especificado (Servidor de implementación).

Comando wdsutil Deshabilita todos los servicios de los Servicios de implementación de


disable- Windows en un Servidor de transporte especificado.
transportserver

Vínculos relacionados
Clave de sintaxis de línea de comandos

Cmdlets de Servicios de implementación de Windows


wdsutil disable-server
Artículo • 06/10/2023

Deshabilita todos los servicios de un servidor de Servicios de implementación de


Windows.

Sintaxis

wdsutil [Options] /Disable-Server [/Server:<Server name>]

Parámetros

Parámetro Descripción

[/Server: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


<Servername> ] nombre de dominio completo (FQDN). Si no se especifica un nombre de
servidor, se usará el servidor local.

Ejemplos
Para deshabilitar el servidor, escriba:

wdsutil /Disable-Server

wdsutil /Verbose /Disable-Server /Server:MyWDSServer

Vínculos relacionados
Clave de sintaxis de línea de comandos

Cmdlets de Servicios de implementación de Windows


wdsutil disable-transportserver
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Deshabilita todos los servicios de un servidor de transporte.

Sintaxis

wdsutil [Options] /Disable-TransportServer [/Server:<Servername>]

Parámetros

Parámetro Descripción

[/Server: <Servername> ] Especifica el nombre del Servidor de transporte que se va a deshabilitar.


Puede ser el nombre de NetBIOS o el nombre de dominio completo
(FQDN). Si no se especifica un nombre de servidor de transporte, se
usará el servidor local.

Ejemplos
Para deshabilitar el servidor, escriba:

wdsutil /Disable-TransportServer

wdsutil /verbose /Disable-TransportServer /Server:MyWDSServer

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil enable-transportserver

Comando wdsutil get-transportserver

Comando wdsutil set-transportserver

Comando wdsutil start-transportserver

Comando wdsutil stop-transportserver

Cmdlets de Servicios de implementación de Windows


wdsutil disconnect-client
Artículo • 08/04/2023

Desconecta un cliente de una transmisión de multidifusión o un espacio de nombres. A


menos que especifique /Force, el cliente revertirá a otro método de transferencia (si es
compatible con el cliente).

Sintaxis

wdsutil /Disconnect-Client /ClientId:<Client ID> [/Server:<Server name>]


[/Force]

Parámetros

Parámetro Descripción

/ClientId: <ClientID> Especifica el identificador del cliente que se va a desconectar. Para ver el
id. de un cliente, ejecute el comando wdsutil /get-
multicasttransmission /show:clients .

[/Server: <Servername> ] Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el
nombre de dominio completo (FQDN). Si no se especifica el nombre del
servidor, se usará el servidor local.

[/Force] Detiene la instalación por completo y no usa un método de reserva.


Dado que Wdsmcast.exe no admite ningún mecanismo de reserva, el
comportamiento predeterminado es el siguiente:
Si usa el cliente de Servicios de implementación de Windows: El
cliente continúa la instalación mediante unicasting.
Si no usa el cliente de Servicios de implementación de Windows:
Se produce un error en la instalación.

Importante: Se recomienda encarecidamente usar este parámetro con


precaución porque si se produce un error en la instalación, el equipo
puede quedar en un estado inutilizable.

Ejemplos
Para desconectar un cliente, escriba:
wdsutil /Disconnect-Client /ClientId:1

Para desconectar un cliente y forzar que se produzca un error en la instalación, escriba:

wdsutil /Disconnect-Client /Server:MyWDSServer /ClientId:1 /Force

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil get-multicasttransmission

Cmdlets de Servicios de implementación de Windows


Comandos wdsutil enable
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Habilita todos los servicios para Servicios de implementación de Windows.

Parámetros
Parámetro Descripción

Comando wdsutil Habilita todos los servicios en un servidor de Servicios de


enable-server implementación de Windows especificado (Servidor de implementación).

Comando wdsutil Habilita todos los servicios en un Servidor de transporte especificado.


enable-
transportserver

Vínculos relacionados
Clave de sintaxis de línea de comandos

Cmdlets de Servicios de implementación de Windows


wdsutil enable-server
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Habilita todos los servicios para Servicios de implementación de Windows.

Sintaxis

wdsutil [options] /Enable-Server [/Server:<Servername>]

Parámetros

Parámetro Descripción

[/Server: <Servername> ] Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el
nombre de dominio completo (FQDN). Si no se especifica el nombre del
servidor, se usará el servidor local.

Ejemplos
Para habilitar los servicios en el servidor, escriba:

wdsutil /Enable-Server

wdsutil /verbose /Enable-Server /Server:MyWDSServer

Vínculos relacionados
Clave de sintaxis de línea de comandos
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

Servicios de implementación de Windows cmdlets


wdsutil enable-transportserver
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Habilita todos los servicios para el servidor de transporte.

Sintaxis

wdsutil [options] /Enable-TransportServer [/Server:<Servername>]

Parámetros

Parámetro Descripción

[/Server: <Servername> ] Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el
nombre de dominio completo (FQDN). Si no se especifica el nombre del
servidor, se usará el servidor local.

Ejemplos
Para habilitar los servicios en el servidor, escriba:

wdsutil /Enable-TransportServer

wdsutil /verbose /Enable-TransportServer /Server:MyWDSServer

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil disable-transportserver

Comando wdsutil get-transportserver

Comando wdsutil set-transportserver

Comando wdsutil start-transportserver

Comando wdsutil stop-transportserver

Cmdlets de Servicios de implementación de Windows


wdsutil export-image
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Exporta una imagen existente del almacén de imágenes a otro archivo de imagen de
Windows (.wim).

Sintaxis
Para imágenes de arranque:

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 imágenes de instalación:

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 Descripción

imagen: <Imagename> Especifica el nombre de la imagen que se va a exportar.


Parámetro Descripción

[/Server: <Servername> ] Especifica el nombre del servidor. Puede ser el nombre de


NetBIOS o el nombre de dominio completo (FQDN). Si no se
especifica un nombre de servidor, se usará el servidor local.

imagetype: {Boot|Install} Especifica el tipo de imagen que se va a exportar.

\imageGroup: <Image group Especifica el grupo de imágenes que contiene la imagen que se va
name> ] a exportar. Si no se especifica ningún nombre de grupo de
imágenes y solo existe un grupo de imágenes en el servidor, ese
grupo de imágenes se usará de forma predeterminada. Si existe
más de un grupo de imágenes en el servidor, deberá especificarse
el grupo de imágenes.

/Architecture: {x86|ia64|x64} Especifica la arquitectura de la imagen que se va a exportar. Dado


que es posible tener el mismo nombre de imagen para las
imágenes de arranque en diferentes arquitecturas, especificar el
valor de arquitectura garantiza que se devuelva la imagen
correcta.

[/Filename: <Filename> ] Si la imagen no se puede identificar de forma única por nombre,


se debe especificar el nombre de archivo.

/DestinationImage Especifica la configuración de la imagen de destino. Puede


especificar esta configuración mediante las siguientes opciones:
/Filepath:<Filepath and name> : especifica la ruta de acceso
completa del archivo de la nueva imagen.
[/Name:<Name>] : establece el nombre para mostrar de la
imagen. Si no se especifica ningún nombre, se usará el
nombre para mostrar de la imagen de origen.
[/Description: <Description>] : establece la descripción de
la imagen.

[/Overwrite: {Yes|No|append} ] Determina si el archivo especificado en la opción


/DestinationImage se sobrescribirá si ya existe un archivo con ese
nombre en /Filepath. La opción Yes hace que el archivo existente
se sobrescriba, la opción No (valor predeterminado) provoca un
error si ya existe un archivo con el mismo nombre y la opción
append hace que la imagen generada se anexe como una nueva
imagen dentro del archivo .wim existente.

Ejemplos
Para exportar una imagen de arranque, escriba:
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 una imagen de instalación, escriba:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil add-image

Comando wdsutil copy-image

Comando wdsutil get-image

Comando wdsutil remove-image

Comando wdsutil replace-image

Comando wdsutil set-image

Servicios de implementación de Windows cmdlets


wdsutil get
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Recupera propiedades o atributos sobre el objeto especificado.

Subcomandos
Subcomando Descripción

Comando wdsutil get- Muestra información sobre todos los equipos preconfigurados.
alldevices

Comando wdsutil get- Muestra información sobre todos los grupos de imágenes.
allImagegroups

Comando wdsutil get- Muestra información sobre todas las imágenes.


allimages

Comando wdsutil get- Muestra los atributos de todas las transmisiones de multidifusión.
allmulticasttransmissions

Comando wdsutil get- Muestra los atributos de todos los espacios de nombres.
allnamespaces

Comando wdsutil get- Muestra información sobre todos los servidores de Servicios de
allservers implementación de Windows.

Comando wdsutil get- Muestra los equipos que están pendientes de aprobación
autoadddevices administrativa en un servidor especificado.

Comando wdsutil get- Muestra los atributos de un equipo pendiente.


device

Comando wdsutil get- Muestra los atributos de una imagen existente.


image

Comando wdsutil get- Muestra información sobre las imágenes en un archivo .wim
imagefile especificado.

Comando wdsutil get- Muestra información sobre un grupo de imágenes especificado.


imagegroup

Comando wdsutil get- Muestra los atributos de una transmisión de multidifusión


multicasttransmission especificada.
Subcomando Descripción

Comando wdsutil get- Muestra los atributos de un espacio de nombres especificado.


namespace

Comando wdsutil get- Muestra información sobre un servidor de Servicios de


server implementación de Windows especificado.

Comando wdsutil get- Muestra información sobre un servidor de transporte especificado.


transportserver

Comando wdsutil get- Muestra información sobre los paquetes de controladores en un


driverpackage servidor.

Comando wdsutil get- Muestra información sobre todos los grupos de controladores en el
alldrivergroups servidor.

Comando wdsutil get- Muestra información sobre los grupos de controladores en un


drivergroup servidor.

Comando wdsutil get- Muestra información sobre todos los paquetes de controladores de un
alldriverpackages servidor que coinciden con los criterios de búsqueda especificados.

Comando wdsutil get- Muestra información sobre un paquete de controladores, incluidos los
driverpackagefile controladores y los archivos que contiene.
wdsutil get-alldevices
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra las propiedades de Servicios de implementación de Windows de todos los


equipos preconfigurados. Un equipo preconfigurado es un equipo físico que se ha
vinculado a una cuenta de equipo en Active Directory Domain Services.

Sintaxis

wdsutil [options] /get-alldevices [/forest:{Yes | No}] [/referralserver:


<servername>]

Parámetros

Parámetro Descripción

[/forest:{Yes | Especifica si los Servicios de implementación de Windows deben devolver


No}] equipos en todo el bosque o en el dominio local. El valor predeterminado es
No, lo que significa que solo se devuelven los equipos del dominio local.

[/referralserver: Devuelve solo los equipos que están preconfigurados para el servidor
<servername>] especificado.

Ejemplos
Para ver todos los equipos, escriba:

wdsutil /get-alldevices

wdsutil /verbose /get-alldevices /forest:Yes /referralserver:MyWDSServer


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil set-device

Comando wdsutil add-device

Comando wdsutil get-device


wdsutil get-alldrivergroups
Artículo • 17/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre todos los grupos de controladores de un servidor.

Sintaxis

wdsutil /get-alldrivergroups [/server:<servername>] [/show:{packagemetadata


| filters | all}]

Parámetros

Parámetro Descripción

[/server: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el FQDN.
<servername>] Si no se especifica un nombre de servidor, se usará el servidor local.

/show: Muestra los metadatos de todos los paquetes de controladores del grupo
{packagemetadata especificado. PackageMetaData muestra información sobre todos los filtros
| filters | del grupo de controladores. Filters muestra los metadatos de todos los
all}] paquetes de controladores y los filtros para el grupo.

Ejemplos
Para ver información sobre un archivo de controlador, escriba:

wdsutil /get-alldrivergroups /server:MyWdsServer /show:All

wdsutil /get-alldrivergroups [/show:packagemetadata]


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil get-drivergroup


wdsutil get-alldriverpackages
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre todos los paquetes de controladores de un servidor que


coinciden con los criterios de búsqueda especificados.

Sintaxis

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 Descripción

[/server: El nombre del servidor. Puede ser el nombre de NetBIOS o el FQDN. Si no se


<servername>] especifica un nombre de servidor, se usará el servidor local.

[/show: Indica la información del paquete que se va a mostrar. Si no se especifica


{drivers | /show, el valor predeterminado es devolver solo los metadatos del paquete de
files | all}] controladores. Drivers muestra la lista de controladores del paquete, files
muestra la lista de archivos del paquete y all muestra los controladores y los
archivos.
Parámetro Descripción

/filtertype: Especifica el atributo del paquete de controladores que se va a buscar. Puede


<filtertype> especificar varios atributos en un solo comando. También debe especificar
/operator y /value con esta opción.

<filtertype> puede ser uno de los siguientes:

PackageId
PackageName
PackageEnabled
Packagedateadded
PackageInfFilename
PackageClass
PackageProvider
PackageArchitecture
PackageLocale
PackageSigned
PackagedatePublished
Packageversion
Driverdescription
DriverManufacturer
DriverHardwareId
DrivercompatibleId
DriverGroupId
DriverGroupName

/operator: Especifica la relación entre el atributo y los valores. Puede especificar contains
{equal | solo con atributos de cadena. Puede especificar greaterorequal y lessorequal
notequal | solo con atributos de fecha y versión.
greaterorequal
| lessorequal |
contains}
Parámetro Descripción

/value:<value> Especifica el valor en el que se va a buscar el <attribute> especificado. Puede


especificar varios valores para un solo /filtertype. En la lista siguiente se
describen los atributos que puede especificar para cada filtro. Para más
información sobre estos atributos, consulte Atributos de controlador y
paquete. Los atributos pueden incluir:

PackageId. Especifica un GUID válido. Por ejemplo:{4d36e972-e325-


11ce-bfc1-08002be10318}.
PackageName. Especifica cualquier valor de cadena.
PackageEnabled. Especifica Yes o No.
Packagedateadded. Especifica la fecha en el formato siguiente:
AAAA/MM/DD
PackageInfFilename. Especifica cualquier valor de cadena.
PackageClass. Especifica un GUID de clase o un nombre de clase válidos.
Por ejemplo: DiskDrive, Net o {4d36e972-e325-11ce-bfc1-08002be10318}.
PackageProvider. Especifica cualquier valor de cadena.
PackageArchitecture. Especifica x86, x64 o ia64.
PackagLocale. Especifica un identificador de idioma válido. Por ejemplo:
en-US o es-ES.
PackageSigned. Especifica Yes o No.
PackagedatePublished. Especifica la fecha en el formato siguiente:
AAAA/MM/DD.
Packageversion. Especifica la versión en el siguiente formato: a.b.x.y. Por
ejemplo: 6.1.0.0.
Driverdescription. Especifica cualquier valor de cadena.
DriverManufacturer. Especifica cualquier valor de cadena.
DriverHardwareId. Especifica cualquier valor de cadena.
DrivercompatibleId. Especifica cualquier valor de cadena.
DriverExcludeId. Especifica cualquier valor de cadena.
DriverGroupId. Especifica un GUID válido. Por ejemplo: {4d36e972-e325-
11ce-bfc1-08002be10318}.
DriverGroupName. Especifica cualquier valor de cadena.

Ejemplos
Para mostrar información, escriba:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil get-driverpackage

Comando wdsutil get-driverpackagefile


wdsutil get-allimagegroups
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Recupera información sobre todos los grupos de imágenes de un servidor y todas las
imágenes de esos grupos de imágenes.

Sintaxis

wdsutil [options] /get-allimagegroups [/server:<servername>] [/detailed]

Parámetros

Parámetro Descripción

[/server: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el nombre
<servername>] de dominio completo (FQDN). Si no se especifica el nombre del servidor, se usará
el servidor local.

[/detailed] Devuelve los metadatos de la imagen de cada imagen. Si no se usa este


parámetro, el comportamiento predeterminado es devolver solo el nombre de la
imagen, la descripción y el nombre de archivo para cada imagen.

Ejemplos
Para ver información sobre los grupos de imágenes, escriba:

wdsutil /get-allimagegroups

wdsutil /verbose /get-allimagegroups /server:MyWDSServer /detailed


Vínculos relacionados
Clave de sintaxis de línea de comandos

Comando wdsutil add-imagegroup

Comando wdsutil remove-imagegroup

Comando wdsutil set-imagegroup


wdsutil get-allimages
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Recupera información sobre todas las imágenes de un servidor.

Sintaxis

wdsutil /get-allimages [/server:<servername>] /show:{boot | install |


legacyris | all} [/detailed]

Parámetros

Parámetro Descripción

[/server: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el nombre
<servername>] de dominio completo (FQDN). Si no se especifica el nombre del servidor, se usará
el servidor local.

/show:{boot | Donde boot devuelve solo imágenes de arranque, install devuelve imágenes de
install | instalación así como información sobre los grupos de imágenes que las
legacyris | contienen, LegacyRis devuelve solo imágenes de Servicios de instalación remota
all} (RIS) y All devuelve información de imágenes de arranque, información de
imágenes de instalación (incluyendo información sobre los grupos de imágenes)
e información de imágenes de RIS.

[/detailed] Indica que se deben devolver todos los metadatos de imagen de cada imagen. Si
no se usa esta opción, el comportamiento predeterminado es devolver solo el
nombre de la imagen, la descripción y el nombre de archivo.

Ejemplos
Para ver información sobre las imágenes, escriba:

wdsutil /get-allimages /show:install


wdsutil /verbose /get-allimages /server:MyWDSServer /show:all /detailed

Vínculos relacionados
Clave de sintaxis de línea de comandos

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
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre todas las transmisiones de multidifusión en un servidor.

Sintaxis
Para Windows Server 2008:

wdsutil /Get-AllMulticastTransmissions [/Server:<Server name>]


[/Show:Clients] [/ExcludedeletePending]

Para Windows Server 2008 R2:

wdsutil /Get-AllMulticastTransmissions [/Server:<Server name>] [/Show:{Boot


| Install | All}] [/details:Clients] [/ExcludedeletePending]

Parámetros

Parámetro Explicación

[/Servidor:<Nombre del Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el
servidor>] nombre de dominio completo (FQDN). Si no se especifica un nombre
de servidor, se usará el servidor local.

[/Show] Windows Server 2008

/Show:Clients: muestra información sobre los equipos cliente que están


conectados a las transmisiones de multidifusión.

Windows Server 2008 R2

Show: {Boot | Install | All}: tipo de imagen que se va a devolver. Boot


devuelve solo transmisiones de imagen de arranque. Install devuelve
solo transmisiones de imagen de instalación. All devuelven ambos
tipos de imagen.
Parámetro Explicación

/details:clients Solo se admite para Windows Server 2008 R2. Si está presente, se
mostrarán los clientes conectados a la transmisión.

[/ExcludedeletePending] Excluye las transmisiones desactivadas de la lista.

Ejemplos
Para ver información sobre todas las transmisiones, escriba:

Windows Server 2008: wdsutil /Get-AllMulticastTransmissions


Windows Server 2008 R2: wdsutil /Get-AllMulticastTransmissions /Show:All para
ver información sobre todas las transmisiones excepto las transmisiones
desactivadas, escriba:
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

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil get-multicasttransmission
Comando wdsutil new-multicasttransmission
Comando wdsutil remove-multicasttransmission
Comando wdsutil start-multicasttransmission
wdsutil get-allnamespaces
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre todos los espacios de nombres de un servidor.

Sintaxis
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:<Server Especifica el nombre del servidor. Puede ser el nombre de


name>] NetBIOS o el nombre de dominio completo (FQDN). Si no
se especifica un nombre de servidor, se usará el servidor
local.

[/ContentProvider: Muestra los espacios de nombres únicamente para el


<name>] proveedor de contenido especificado.

[/Show:Clients] Solo se admite para Windows Server 2008. Muestra


información sobre los equipos cliente que están
conectados al espacio de nombres.
Parámetro Windows Server 2008 Windows
Server
2008 R2

[/details:Clients] Solo se admite para Windows Server 2008 R2. Muestra


información sobre los equipos cliente que están
conectados al espacio de nombres.

[/ExcludedeletePending] Excluye las transmisiones desactivadas de la lista.

Ejemplos
Para ver todos los espacios de nombres, escriba:

wdsutil /Get-AllNamespaces

Para ver todos los espacios de nombres excepto los que están desactivados, escriba:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil new-namespace
Comando wdsutil remove-namespace
Comando wdsutil start-nmespace
get-AllServers
Artículo • 14/04/2023

Recupera información sobre todos los servidores de Servicios de implementación de


Windows.

7 Nota

Este comando puede tardar un tiempo prolongado en completarse si hay muchos


servidores de Servicios de implementación de Windows en su entorno o si la
conexión de red que vincula los servidores es lenta.

Sintaxis

wdsutil [Options] /Get-AllServers /Show:{Config | Images | All} [/Detailed]


[/Forest:{Yes | No}]

Parámetros

Parámetro Descripción

/Show: Imágenes
{Config

[/Detailed] Cuando se usa junto con /Show:Images o /Show:All, devuelve todos los metadatos
de imagen de cada imagen. Si no se especifica la opción /Detailed, el
comportamiento predeterminado es devolver el nombre, la descripción y el nombre
de archivo de la imagen.

[/Forest: No}]
{Yes

Ejemplos
Para ver información sobre todos los servidores, escriba:

wdsutil /Get-AllServers /Show:Config


Para ver información detallada sobre todos los servidores, escriba:

wdsutil /Verbose /Get-AllServers /Show:All /Detailed /Forest:Yes

Vínculos relacionados
Clave de sintaxis de línea de comandos
wdsutil get autoadddevices
Artículo • 12/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra todos los equipos que se encuentran en la base de datos de adición automática
en un servidor de Servicios de implementación de Windows.

Sintaxis

wdsutil [Options] /Get-AutoaddDevices [/Server:<Server name>] /Devicetype:


{PendingDevices | RejectedDevices | ApprovedDevices}

Parámetros

Parámetro Descripción

[/Servidor:<Nombre del Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o
servidor>] el nombre de dominio completo (FQDN). Si no se especifica un
nombre de servidor, se usará el servidor local.

/Devicetype: Especifica el tipo de equipo que se va a devolver.


{PendingDevices | - PendingDevices devuelve todos los equipos de la base de datos que
RejectedDevices | estén en estado pendiente.
ApprovedDevices} - RejectedDevices devuelve todos los equipos de la base de datos
que estén en estado rechazado.
- ApprovedDevices devuelve todos los equipos de la base de datos
que estén en estado aprobado.

Ejemplos
Para ver todos los equipos aprobados, escriba:

wdsutil /Get-AutoaddDevices /Devicetype:ApprovedDevices

Para ver todos los equipos rechazados, escriba:


wdsutil /verbose /Get-AutoaddDevices /Devicetype:RejectedDevices
/Server:MyWDSServer

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil delete-autoadddevices
Comando wdsutil approve-autoadddevices
Comando wdsutil reject-autoadddevices
wdsutil get-device
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Recupera información de los Servicios de implementación de Windows sobre un equipo


preconfigurado (es decir, un equipo físico que se ha alineado con una cuenta de equipo
en Active Directory Domain Services).

Sintaxis

wdsutil /Get-Device {/Device:<Device name> | /ID:<MAC or UUID>} [/Domain:


<Domain>] [/forest:{Yes | No}]

Parámetros

Parámetro Descripción

/Device: Especifica el nombre del equipo (SAMAccountName).


<nombre
del
dispositivo>

/ID:<MAC o Especifica la dirección MAC o el UUID (GUID) del equipo, como se muestra en los
UUID> ejemplos siguientes. Tenga en cuenta que un GUID válido debe tener uno de los
dos formatos de cadena binaria o cadena GUID.
- Cadena binaria: /ID:ACEFA3E81F20694E953EB2DAA1E8B1B6
- Dirección MAC: 00B056882FDC (sin guiones) o 00-B0-56-88-2F-DC (con guiones)
- Cadena GUID: /ID:E8A3EFAC-201F-4E69-953-B2DAA1E8B1B6

[/Domain: Especifica el dominio que se va a buscar en el equipo preconfigurado. El valor


<Dominio>] predeterminado de este parámetro es el dominio local.

[/forest:{Yes Especifica si los Servicios de implementación de Windows deben buscar en todo el


| No}] bosque o en el dominio local. El valor predeterminado es No, lo que significa que
solo se buscará en el dominio local.

Ejemplos
Para obtener información mediante el nombre del equipo, escriba:

wdsutil /Get-Device /Device:computer1

Para obtener información mediante la dirección MAC, escriba:

wdsutil /verbose /Get-Device /ID:00-B0-56-88-2F-DC /Domain:MyDomain

Para obtener información mediante la cadena GUID, escriba:

wdsutil /verbose /Get-Device /ID:E8A3EFAC-201F-4E69-953-B2DAA1E8B1B6


/forest:Yes

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil set-device
Comando wdsutil add-device
Comando wdsutil get-alldevices
wdsutil get-drivergroup
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre los grupos de controladores de un servidor.

Sintaxis

wdsutil /Get-DriverGroup /DriverGroup:<Group Name> [/Server:<Server name>]

Parámetros

Parámetro Descripción

/DriverGroup: Especifica el nombre del grupo de controladores.


<Nombre del grupo>

[/Servidor:<Nombre Especifica el nombre del servidor. Este puede ser el nombre NetBIOS o
del servidor>] el FQDN. Si no se especifica un nombre de servidor, se usará el servidor
local.

[/Show: Muestra los metadatos de todos los paquetes de controladores del


{PackageMetaData | grupo especificado. PackageMetaData muestra información sobre
Filters | All}] todos los filtros del grupo de controladores. Filters muestra los
metadatos de todos los paquetes de controladores y los filtros para el
grupo.

Ejemplos
Para ver información sobre un archivo de controlador, escriba:

wdsutil /Get-DriverGroup /DriverGroup:printerdrivers /Show:PackageMetaData


wdsutil /Get-DriverGroup /DriverGroup:printerdrivers /Server:MyWdsServer
/Show:Filters

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil get-alldrivergroups
get-DriverPackage
Artículo • 06/10/2023

Muestra información sobre un paquete de controladores en el servidor.

Sintaxis

wdsutil /Get-DriverPackage [/Server:<Server name>] {/DriverPackage:<Package


Name> | /PackageId:<ID>} [/Show:{Drivers | Files | All}]

Parámetros

Parámetro Descripción

[/Servidor:<Nombre Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


del servidor>] FQDN. Si no se especifica el nombre del servidor, se usará el servidor
local.

[/DriverPackage: Especifica el nombre del paquete de controladores que se va a mostrar.


<Name>]

[/PackageId:<ID>] Especifica el id. de los Servicios de implementación de Windows del


paquete de controladores que se va a mostrar. Debe especificar el
identificador si el paquete de controladores no se puede identificar de
forma única por nombre.

[/Show: {Drivers Archivos

Ejemplos
Para ver información sobre un paquete de controladores, escriba una de las siguientes
opciones:

wdsutil /Get-DriverPackage /PackageId:{4D36E972-E325-11CE-BFC1-08002BE10318}


wdsutil /Get-DriverPackage /DriverPackage:MyDriverPackage /Show:All

Vínculos relacionados
Clave de sintaxis de línea de comandos
wdsutil get-image
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Recupera información sobre una imagen.

Sintaxis
Para imágenes de arranque:

wdsutil [Options] /Get-Image image:<Image name> [/Server:<Server name>


imagetype:Boot /Architecture:{x86 | ia64 | x64} [/Filename:<File name>]

Para imágenes de instalación:

wdsutil [Options] /Get-image image:<Image name> [/Server:<Server name>


imagetype:Install imagegroup:<Image group name>] [/Filename:<File name>]

Parámetros

Parámetro Descripción

\image:<Nombre de Especifica el nombre de la imagen.


imagen>

[/Servidor:<Nombre Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


del servidor>] nombre de dominio completo (FQDN). Si no se especifica un nombre de
servidor, se usará el servidor local.

imagetype:{Boot | Especifica el tipo de imagen.


Install}

/Architecture:{x86 | Especifica la arquitectura de la imagen. Dado que es posible tener el


ia64 | x64} mismo nombre de imagen para las imágenes de arranque en diferentes
arquitecturas, especificar el valor de arquitectura garantiza que se
devuelva la imagen correcta.
Parámetro Descripción

[/Filename:<Nombre Si la imagen no se puede identificar de forma única por nombre, debe


de archivo>] usar esta opción para especificar el nombre de archivo.

\imagegroup: Especifica el grupo de imágenes que contiene la imagen. Si no se


<Nombre del grupo especifica ningún grupo de imágenes y solo existe un grupo de imágenes
de imágenes>] en el servidor, se usará ese grupo. Si existen varios grupos de imágenes
en el servidor, debe usar este parámetro para especificar el grupo de
imágenes.

Ejemplos
Para recuperar información sobre una imagen de arranque, escriba una de las siguientes
opciones:

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 información sobre una imagen de instalación, escriba una de las
siguientes opciones:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos
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
Artículo • 06/04/2023

Recupera información sobre las imágenes contenidas en un archivo de imagen de


Windows (.wim).

Sintaxis

wdsutil [Options] /Get-ImageFile /ImageFile:<wim file path> [/Detailed]

Parámetros

Parámetro Descripción

/ImageFile: Especifica la ruta de acceso completa y el nombre del archivo .wim.


<WIM file
path>

[/Detailed] Devuelve todos los metadatos de imagen de cada imagen. Si no se usa esta opción,
el comportamiento predeterminado es devolver solo el nombre de la imagen, la
descripción y el nombre de archivo.

Ejemplos
Para ver información sobre una imagen, escriba:

wdsutil /Get-ImageFile /ImageFile:C:\temp\install.wim

Para ver información detallada, escriba:

wdsutil /Verbose /Get-ImageFile /ImageFile:\\Server\Share\My Folder


\install.wim /Detailed

Vínculos relacionados
Clave de sintaxis de línea de comandos
wdsutil get-imagegroup
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Recupera información sobre un grupo de imágenes y las imágenes que contiene.

Sintaxis

wdsutil [Options] /Get-ImageGroup ImageGroup:<Image group name> [/Server:


<Server name>] [/detailed]

Parámetros

Parámetro Descripción

/ImageGroup: Especifica el nombre del grupo de imágenes.


<Nombre del
grupo de
imágenes>

[/Server:<Nombre Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


del servidor>] nombre de dominio completo (FQDN). Si no se especifica un nombre de
servidor, se usará el servidor local.

[/detailed] Devuelve los metadatos de cada imagen. Si no se usa este parámetro, el


comportamiento predeterminado es devolver solo el nombre de la imagen,
la descripción y el nombre del archivo.

Ejemplos
Para ver información sobre un grupo de imágenes, escriba:

wdsutil /Get-ImageGroup ImageGroup:ImageGroup1

Para ver la información, incluidos los metadatos, escriba:


wdsutil /verbose /Get-ImageGroup ImageGroup:ImageGroup1 /Server:MyWDSServer
/detailed

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil add-imagegroup
Comando wdsutil get-allimagegroups
Comando wdsutil remove-imagegroup
Comando wdsutil set-imagegroup
wdsutil get-multicasttransmission
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre la transmisión de multidifusión para una imagen


especificada.

Sintaxis
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 transmisiones de imágenes de arranque:

wdsutil [Options] /Get-MulticastTransmissiomedia:<Image name>


[/Server:<Server name>]
[/details:Clients]
mediatype:Boot
/Architecture:{x86 | ia64 | x64}
[/Filename:<File name>]

para transmisiones de imágenes de instalación:

wdsutil [Options] /Get-MulticastTransmissiomedia:<Image name>


[/Server:<Server name>]
[/details:Clients]
mediatype:Install
mediaGroup:<Image Group>]
[/Filename:<File name>]
Parámetros

Parámetro Descripción

media:<Nombre Muestra la transmisión de multidifusión asociada a esta imagen.


de la imagen>

[/Servidor: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


<Nombre del nombre de dominio completo (FQDN). Si no se especifica el nombre del
servidor>] servidor, se usará el servidor local.

/imagetype:Install Especifica el tipo de imagen. Tenga en cuenta que esta opción debe
establecerse en Install.

/imagegroup: Especifica el grupo de imágenes que contiene la imagen. Si no se especifica


<Nombre del ningún nombre de grupo de imágenes y solo existe un grupo de imágenes
grupo de en el servidor, se usa ese grupo de imágenes. Si existe más de un grupo de
imágenes>] imágenes en el servidor, debe usar esta opción para especificar un grupo de
imágenes.

/Architecture:{x86 Especifica la arquitectura de la imagen de arranque asociada a la transmisión.


| ia64 | x64} Dado que es posible tener el mismo nombre de imagen para imágenes de
arranque en diferentes arquitecturas, debe especificar la arquitectura para
garantizar que se usa la imagen correcta.

[/Filename: Especifica el archivo que contiene la imagen. Si la imagen no se puede


<Nombre de identificar de forma única por nombre, debe usar esta opción para especificar
archivo>] el nombre de archivo.

[/Show:Clients] Muestra información sobre los equipos cliente que están conectados a la
o transmisión de multidifusión.

[/details:Clients]

Ejemplos
Windows Server 2008

Para ver información sobre la transmisión de una imagen denominada Vista con Office,
escriba una de las siguientes opciones:

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 ver información sobre la transmisión de una imagen denominada Vista con Office,
escriba una de las siguientes opciones:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil get-allmulticasttransmissions
Comando wdsutil new-multicasttransmission
Comando wdsutil remove-multicasttransmission
Comando wdsutil start-multicasttransmission
wdsutil get-namespace
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre un espacio de nombres personalizado.

Sintaxis
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 Descripción

/Namespace: Especifica el nombre del espacio de nombres. Tenga en cuenta que este no
<Nombre de es el nombre descriptivo y debe ser único.
espacio de - Servidor de implementación: la sintaxis del nombre del espacio de
nombres> nombres es /Namspace:WDS:<ImageGroup>/<ImageName>/<Index>. Por
ejemplo: WDS:ImageGroup1/install.wim/1
- Servidor de transporte: este valor debe coincidir con el nombre
proporcionado al espacio de nombres cuando se creó en el servidor.

[/Server:<Server Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


name>] nombre de dominio completo (FQDN). Si no se especifica el nombre del
servidor, se usará el servidor local.

[/Show:Clients] o Muestra información sobre los equipos cliente que están conectados al
[/details:Clients] espacio de nombres especificado.
Ejemplos
Para ver información sobre un espacio de nombres, escriba:

wdsutil /Get-Namespace /Namespace:Custom Auto 1

Para ver información sobre un espacio de nombres y los clientes que están conectados,
escriba una de las siguientes opciones:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil get-allnamespaces
Comando wdsutil new-namespace
Comando wdsutil remove-namespace
Comando wdsutil start-namespace
wdsutil get-server
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Recupera información del servidor de Servicios de implementación de Windows


especificado.

Sintaxis

wdsutil [Options] /Get-Server [/Server:<Server name>] /Show:{Config | Images


| All} [/detailed]

Parámetros

Parámetro Descripción

[/Servidor: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


<Nombre del nombre de dominio completo (FQDN). Si no se especifica el nombre del
servidor>] servidor, se usará el servidor local.

/Show:{Config | Especifica el tipo de información que se va a devolver.


Images | All} - Config devuelve información de configuración.
- Images devuelven información sobre grupos de imágenes, imágenes de
arranque e imágenes de instalación.
- All devuelve información de configuración e información de imagen.

[/detailed] Puede usar esta opción con /Show:Images o /Show:All para indicar que se
deben devolver todos los metadatos de imagen de cada imagen. Si no se usa
la opción /detailed, el comportamiento predeterminado es devolver solo el
nombre de la imagen, la descripción y el nombre de archivo.

Ejemplos
Para ver información sobre el servidor, escriba:
wdsutil /Get-Server /Show:Config

Para ver información detallada sobre el servidor, escriba:

wdsutil /verbose /Get-Server /Server:MyWDSServer /Show:All /detailed

Vínculos relacionados
Clave de sintaxis de línea de comandos
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
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Muestra información sobre un servidor de transporte especificado.

Sintaxis

wdsutil [Options] /Get-TransportServer [/Server:<Server name>] /Show:


{Config}

Parámetros

Parámetro Descripción

[/Servidor: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


<Nombre del nombre de dominio completo (FQDN). Si no se especifica un nombre de
servidor>] servidor, se usará el servidor local.

/Show:{Config} Devuelve información de configuración sobre el servidor de transporte


especificado.

Ejemplos
Para ver información sobre el servidor, escriba:

wdsutil /Get-TransportServer /Show:Config

Para ver la información de configuración, escriba:

wdsutil /Get-TransportServer /Server:MyWDSServer /Show:Config


Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil disable-transportserver
Comando wdsutil enable-transportserver
Comando wdsutil set-transportserver
Comando wdsutil start-transportserver
Comando wdsutil stop-transportserver
wdsutil initialize-server
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Configura un servidor de Servicios de implementación de Windows para su uso inicial


una vez instalado el rol de servidor. Después de ejecutar este comando, debe usar el
comando wdsutil add-Image para agregar imágenes al servidor.

Sintaxis

wdsutil /Initialize-Server [/Server:<Server name>] /remInst:<Full path>


[/Authorize]

Parámetros

Parámetro Descripción

[/Servidor: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el nombre
<Nombre del de dominio completo (FQDN). Si no se especifica un nombre de servidor, se
servidor>] usará el servidor local.

/remInst:<Ruta Especifica la ruta de acceso completa y el nombre de la carpeta remoteInstall. Si


de acceso la carpeta especificada aún no existe, esta opción la creará cuando se ejecute el
completa> comando. Siempre debe escribir una ruta de acceso local, incluso en el caso de
un equipo remoto. Por ejemplo: D:\remoteInstall.

[/Authorize] Autoriza el servidor en el Protocolo de control de host dinámico (DHCP). Esta


opción solo es necesaria si la detección no autorizada de DHCP está habilitada,
lo que significa que el servidor de entorno PXE de Servicios de implementación
de Windows debe estar autorizado en DHCP antes de que se pueda atender a
los equipos cliente. Tenga en cuenta que la detección no autorizada de DHCP
está deshabilitada de forma predeterminada.

Ejemplos
Para inicializar el servidor y establecer la carpeta compartida remoteInstall en la unidad
F:, escriba.
wdsutil /Initialize-Server /remInst:F:\remoteInstall

Para inicializar el servidor y establecer la carpeta compartida remoteInstall en la unidad


C:, escriba.

wdsutil /verbose /Progress /Initialize-Server /Server:MyWDSServer


/remInst:C:\remoteInstall

Vínculos relacionados
Clave de sintaxis de línea de comandos
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
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea imágenes de captura y detección, transmisiones de multidifusión y espacios de


nombres.

Subcomandos
Subcomando Descripción

Comando wdsutil new- Crea una nueva imagen de captura a partir de una imagen de
captureimage arranque existente.

Comando wdsutil new- Crea una nueva imagen de detección a partir de una imagen
discoverimage de arranque existente.

Comando wdsutil new- Crea una nueva transmisión de multidifusión.


multicasttransmission

Comando wdsutil new- Crea un nuevo espacio de nombres.


namespace
new-CaptureImage
Artículo • 08/04/2023

Crea una nueva imagen de captura a partir de una imagen de arranque existente. Las
imágenes de captura son imágenes de arranque que inician la utilidad de captura de
Servicios de implementación de Windows en lugar de iniciar la Configuración. Cuando
arranca un equipo de referencia (preparado con Sysprep) en una imagen de captura, un
asistente crea una imagen de instalación del equipo de referencia y la guarda como
archivo de Imagen de Windows (.wim). También puede agregar la imagen a un medio
(como un CD, DVD o unidad USB) y después arrancar un equipo desde ese medio. Tras
crear la imagen de instalación, podrá agregar la imagen al servidor para la
implementación del arranque PXE. Para obtener más información, vea Creación de
imágenes (https://go.microsoft.com/fwlink/?LinkId=115311).

Sintaxis

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 Descripción

[/Servidor: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


<Nombre del nombre de dominio completo (FQDN). Si no se especifica un nombre de
servidor>] servidor, se usará el servidor local.

/image:<Nombre Especifica el nombre de la imagen de arranque de origen.


de la imagen>

/Architecture: {x86 ia64


Parámetro Descripción

[/Filename: Si la imagen no se puede identificar de forma única por nombre, debe usar
<Nombre de esta opción para especificar el nombre de archivo.
archivo>]

/DestinationImage Especifica la configuración de la imagen de destino. Puede especificar la


configuración usando las siguientes opciones:
- /FilePath: <Ruta de acceso y nombre del archivo> Establece la ruta de
acceso completa del archivo para la nueva imagen de captura.
- [/Name: <Nombre>] - Establece el nombre para mostrar de la imagen. Si
no se especifica ningún nombre para mostrar, se usará el nombre para
mostrar de la imagen de origen.
- [/Description: Descripción<] - >Establece la descripción de la imagen.
- [/Overwrite: {Yes

Ejemplos
Para crear una imagen de captura y llamarla WinPECapture.wim, escriba:

wdsutil /New-CaptureImage /Image:WinPE boot image /Architecture:x86


/DestinationImage /FilePath:C:\Temp\WinPECapture.wim

Para crear una imagen de captura y aplicar la configuración especificada, escriba:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos
new-DiscoverImage
Artículo • 14/04/2023

Crea una nueva imagen de detección a partir de una imagen de arranque existente. Las
imágenes de detección son imágenes de arranque que obligan al programa Setup.exe a
iniciarse en el modo de Servicios de implementación de Windows y, a continuación, a
buscar un servidor de Servicios de implementación de Windows. Normalmente, estas
imágenes se usan para implementar imágenes en equipos que no son capaces de
arrancar en PXE. Para obtener más información, vea Creación de imágenes
(https://go.microsoft.com/fwlink/?LinkId=115311).

Sintaxis

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 Descripción

[/Server:<Nombre Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


del servidor>] nombre de dominio completo (FQDN). Si no se especifica un nombre de
servidor, se usará el servidor local.

/image:<Nombre Especifica el nombre de la imagen de arranque de origen.


de la imagen>

/Architecture:{x86 ia64

[/Filename: Si la imagen no se puede identificar de forma única por nombre, debe usar
<Nombre de esta opción para especificar el nombre de archivo.
archivo>]
Parámetro Descripción

/DestinationImage Especifica la configuración de la imagen de destino. Puede especificar la


configuración mediante las siguientes opciones:
- /FilePath:< ruta de acceso y nombre del archivo>: establece la ruta de
acceso completa del archivo para la nueva imagen.
- [/Name:<Nombre>]: establece el nombre para mostrar de la imagen. Si no
se especifica ningún nombre para mostrar, se usará el nombre para mostrar
de la imagen de origen.
- [/Description: <Descripción>]: establece la descripción de la imagen.
- [/WDSServer: <Nombre del servidor>]: especifica el nombre del servidor
con el que deben ponerse en contacto todos los clientes que arrancan desde
la imagen especificada para descargar la imagen de instalación. De forma
predeterminada, todos los clientes que arrancan esta imagen detectarán un
servidor válido de Servicios de implementación de Windows. El uso de esta
opción omite la funcionalidad de detección y exige al cliente de arranque a
ponerse en contacto con el servidor especificado.
- [/Overwrite:{Yes

Ejemplos
Para crear una imagen de detección fuera de la imagen de arranque y asignarla el
nombre WinPEDiscover.wim, escriba:

wdsutil /New-DiscoverImage /Image:WinPE boot image /Architecture:x86


/DestinationImage /FilePath:C:\Temp\WinPEDiscover.wim

Para crear una imagen de detección fuera de la imagen de arranque y asignarla el


nombre WinPEDiscover.wim con la configuración especificada, escriba:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos
wdsutil new-multicasttransmission
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea una nueva transmisión por multidifusión para una imagen. Este comando equivale
a crear una transmisión mediante el complemento mmc de Servicios de implementación
de Windows (haga clic con el botón derecho en el nodo Transmisiones por
multidifusión y, a continuación, haga clic en Crear transmisión por multidifusión). Debe
usar este comando cuando tenga instalados tanto el servicio de rol de Servidor de
implementación como el servicio de rol de Servidor de transporte (que es la instalación
predeterminada). Si solo tiene instalado el servicio de rol Servidor de transporte, use el
comando wdsutilnew-Namespace.

Sintaxis
Para instalar transmisiones de imágenes:

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 las transmisiones de imágenes de arranque (solo se admiten para 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 Descripción

/image:<Nombre Especifica el nombre de la imagen que se va a transmitir mediante


de la imagen> multidifusión.

[/Server:<Nombre Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


del servidor>] nombre de dominio completo (FQDN). Si no se especifica un nombre de
servidor, se usará el servidor local.

/FriendlyName: Especifica el nombre descriptivo de la transmisión.


<Nombre
descriptivo>

[/Description: Especifica la descripción de la transmisión.


<Descripción>]

/imagetype: Especifica el nombre de imagen que se va a transmitir mediante


{Boot|Install} multidifusión. Tenga en cuanta que Boot solo se admite para Windows
Server 2008 R2.

/ImageGroup: Especifica el grupo de imágenes que contiene la imagen. Si no se especifica


<Nombre del ningún nombre de grupo de imágenes y solo existe un grupo de imágenes
grupo de en el servidor, se us ese grupo de imágenes. Si existen varios grupos de
imágenes>] imágenes en el servidor, debe usar esta opción para especificar el nombre
del grupo de imágenes.

[/Filename: especifica el nombre de archivo. Si la imagen de origen no se puede


<Nombre de identificar de forma única por nombre, debe usar esta opción para
archivo>] especificar el nombre de archivo.
Parámetro Descripción

/Transmissiontype: Especifica si se debe iniciar la transmisión automáticamente (AutoCast) o en


{AutoCast | función de los criterios de inicio especificados (ScheduledCast).
ScheduledCast}
Auto-Cast. Este tipo de transmisión indica que tan pronto como un
cliente aplicable solicite una imagen de instalación, comenzará una
transmisión por multidifusión de la imagen seleccionada. A medida
que otros clientes soliciten la misma imagen, se unirán a la transmisión
que ya está iniciada.
Scheduled-Cast. Este tipo de transmisión establece los criterios para
iniciar la transmisión, según el número de clientes que soliciten una
imagen o el día y la hora específicos. Puede especificar las siguientes
opciones:

[/time: <hora>]: establece la hora a la que debe comenzar la


transmisión; el formato utilizado es AAAA/MM/DD:hh:mm.
[/Clients: <Número de clientes>]: establece el número mínimo de
clientes que se esperarán antes de que se inicie la transmisión.

/Architecture:{x86 Especifica la arquitectura de la imagen de arranque que se va a transmitir


| ia64 | x64} mediante multidifusión. Dado que es posible tener el mismo nombre para
las imágenes de arranque de diferentes arquitecturas, debe especificar la
arquitectura para asegurarse de que se usa la imagen correcta.

[/Filename: especifica el nombre de archivo. Si la imagen de origen no se puede


<Nombre de identificar de forma única por nombre, debe especificar el nombre de
archivo>] archivo.

Ejemplos
Para crear una transmisión de tipo Auto-Cast de una imagen de arranque en Windows
Server 2008 R2, escriba:

wdsutil /New-MulticastTransmission /FriendlyName:WDS Boot Transmission


/Image:X64 Boot imagetype:Boot /Architecture:x64 /Transmissiontype:AutoCast

Para crear una transmisión de tipo Auto-Cast de una imagen de instalación, escriba:

wdsutil /New-MulticastTransmission /FriendlyName:WDS AutoCast Transmission


/Image:Vista with Officeimage imagetype:Install /Transmissiontype:AutoCast
Para crear una transmisión de tipo Scheduled-Cast de una imagen de instalación,
escriba:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil get-allmulticasttransmissions
Comando wdsutil get-multicasttransmission
Comando wdsutil remove-multicasttransmission
Comando wdsutil start-multicasttransmission
wdsutil new-namespace
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Crea y configura un nuevo espacio de nombres. Debe usar esta opción cuando solo
tenga instalado el servicio de rol de Servidor de transporte. Si tiene instalados tanto el
servicio de rol de Servidor de implementación como el servicio de rol de Servidor de
transporte (que es el predeterminado), use el comando wdsutilnew-
MulticastTransmission. Tenga en cuenta que debe registrar el proveedor de contenido
antes de usar esta opción.

Sintaxis

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 Descripción

[/Servidor: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


<Nombre del nombre de dominio completo (FQDN). Si no se especifica el nombre del
servidor>] servidor, se usará el servidor local.

/FriendlyName: Especifica el nombre descriptivo del espacio de nombres.


<Nombre
descriptivo>

[/Description: Establece la descripción del espacio de nombres.


<Descripción>]
Parámetro Descripción

/Namespace: Especifica el nombre del espacio de nombres. Tenga en cuenta que este no es
<Nombre de el nombre descriptivo y debe ser único.
espacio de - Servicio de rol de Servidor de implementación: La sintaxis de esta opción
nombres> es /Namespace:WDS:<Grupo de imágenes>/<Nombre de
imagen>/<Índice>. Por ejemplo: WDS:ImageGroup1/install.wim/1
- Servicio de rol de Servidor de transporte: Este valor debe coincidir con el
nombre dado cuando se creó el espacio de nombres en el servidor.

/ContentProvider: Especifica el nombre del proveedor de contenido que proporcionará


<Nombre>] contenido para el espacio de nombres.

[/ConfigString: Especifica la cadena de configuración del proveedor de contenido.


<Cadena de
configuración>]

/Namespacetype: Especifica la configuración de la transmisión. Especifique la configuración


{AutoCast | mediante las siguientes opciones:
ScheduledCast} - [/time: <hora >]: Establece la hora a la que debe comenzar la transmisión
con el siguiente formato: AAAA/MM/DD:hh:mm. Esta opción solo se aplica a
las transmisiones de Scheduled-Cast.
- [/Clients: <Número de clientes>]: Establece el número mínimo de clientes
que se esperarán antes de que se inicie la transmisión. Esta opción solo se
aplica a las transmisiones de Scheduled-Cast.

Ejemplos
Para crear un espacio de nombres de Auto-Cast, escriba:

wdsutil /New-Namespace /FriendlyName:Custom AutoCast Namespace


/Namespace:Custom Auto 1 /ContentProvider:MyContentProvider
/Namespacetype:AutoCast

Para crear un espacio de nombres de Scheduled-Cast, escriba:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil get-allnamespaces
Comando wdsutil remove-namespace
Comando wdsutil start-namespace
wdsutil /progress
Artículo • 06/04/2023

Muestra el progreso mientras se ejecuta un comando. Puede usar /progress con


cualquier otro comando wdsutil que ejecute. Si quiere activar el registro detallado para
este comando, debe especificar /verbose y /progress directamente después de wdsutil.

Sintaxis

wdsutil /progress <commands>

Ejemplos
Para inicializar el servidor y mostrar el progreso, escriba:

wdsutil /verbose /progress /Initialize-Server /Server:MyWDSServer


/RemInst:C:\RemoteInstall

Vínculos relacionados
Clave de sintaxis de línea de comandos
wdsutil reject-autoadddevices
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Rechaza los equipos que están pendientes de aprobación administrativa. Cuando está
activada la directiva Agregar automáticamente, se requiere la aprobación administrativa
antes de que los equipos desconocidos (los que no están preconfigurados) puedan
instalar una imagen. Puede habilitar esta directiva mediante la pestaña Respuesta de
entorno de ejecución previo al arranque de la página de propiedades del servidor.

Sintaxis

wdsutil [Options] /Reject-AutoaddDevices [/Server:<Server name>] /RequestId:


<Request ID or ALL>

Parámetros

Parámetro Descripción

[/Servidor: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el nombre
<Nombre del de dominio completo (FQDN). Si no se especifica un nombre de servidor, se
servidor>] usará el servidor local.

/RequestId: Especifica el identificador de solicitud asignado al equipo pendiente. Para


<Request ID | rechazar todos los equipos pendientes, especifique ALL.
ALL>

Ejemplos
Para rechazar un único equipo, escriba:

wdsutil /Reject-AutoaddDevices /RequestId:12

Para rechazar todos los equipos, escriba:


wdsutil /verbose /Reject-AutoaddDevices /Server:MyWDSServer /RequestId:ALL

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil approve-autoadddevices
Comando wdsutil delete-autoadddevices
Comando wdsutil get-autoadddevices
wdsutil remove
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Subcomandos
Subcomando Descripción

Comando wdsutil remove-image Quita una imagen de arranque o instalación del servidor.

Comando wdsutil remove- Quita un grupo de imágenes del servidor.


imagegroup

Comando wdsutil remove- Deshabilita la transmisión de multidifusión de una imagen.


multicasttransmission

Comando wdsutil remove- Quita un espacio de nombres del servidor.


namespace

Comando wdsutil remove- Quita un paquete de controladores de un grupo de


drivergrouppackage controladores en un servidor.

Comando wdsutil remove- Quita los paquetes de controladores de un grupo de


drivergrouppackages controladores en un servidor.

Comando wdsutil remove- Quita un paquete de controladores de un servidor.


driverpackage

Comando wdsutil remove- Quita los paquetes de controladores de un servidor.


driverpackages

Comando wdsutil remove- Quita un grupo de controladores de un servidor.


drivergroup

Comando wdsutil remove- Quita una regla de filtro de un grupo de controladores en


drivergroupfilter un servidor.
remove-DriverGroup
Artículo • 06/10/2023

Quita un grupo de controladores de un servidor.

Sintaxis

wdsutil /Remove-DriverGroup /DriverGroup:<Group Name> [/Server:<Server


name>]

Parámetros

Parámetro Descripción

/DriverGroup: Especifica el nombre del grupo de controladores que se va a quitar.


<Nombre del grupo>

[/Servidor:<Nombre Especifica el nombre del servidor. Este puede ser el nombre NetBIOS o
del servidor>] el FQDN. Si no se especifica un nombre de servidor, se usará el servidor
local.

Ejemplos
Para quitar un grupo de controladores, escriba una de las siguientes opciones:

wdsutil /Remove-DriverGroup /DriverGroup:PrinterDrivers

wdsutil /Remove-DriverGroup /DriverGroup:PrinterDrivers /Server:MyWdsServer

Vínculos relacionados
Clave de sintaxis de línea de comandos
remove-DriverGroupFilter
Artículo • 06/04/2023

Quita una regla de filtro de un grupo de controladores en un servidor.

Sintaxis

wdsutil /Remove-DriverGroupFilter /DriverGroup:<Group Name> [/Server:<Server


name>] /FilterType:<Filter Type>

Parámetros

Parámetro Descripción

/DriverGroup: Especifica el nombre del grupo de controladores.


<Nombre del
grupo>

[/Servidor: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


<Nombre del FQDN. Si no se especifica un nombre de servidor, se usará el servidor local.
servidor>]

[/FilterType: Especifica el tipo del filtro que se va a quitar del grupo. <FilterType> puede
<FilterType>] ser uno de los siguientes:
BiosVendor
BiosVersion
ChassisType
Manufacturer
Uuid
OsVersion
OsEdition
OsLanguage

Ejemplos
Para quitar un filtro, escriba una de las siguientes opciones:

wdsutil /Remove-DriverGroupFilter /DriverGroup:PrinterDrivers


/FilterType:Manufacturer
wdsutil /Remove-DriverGroupFilter /DriverGroup:PrinterDrivers
/FilterType:Manufacturer /FilterType:OSLanguage

Vínculos relacionados
Clave de sintaxis de línea de comandos
remove-DriverGroupPackage
Artículo • 06/10/2023

Quita un paquete de controladores de un grupo de controladores en un servidor.

Sintaxis

wdsutil /Remove-DriverGroupPackage /DriverGroup:<Group Name> [/Server:


<Server Name>] {/DriverPackage:<Name> | /PackageId:<ID>}

Parámetros

Parámetro Descripción

[/Servidor:<Nombre Especifica el nombre del servidor. Este puede ser el nombre NetBIOS o el
del servidor>] FQDN. Si no se especifica un nombre de servidor, se usará el servidor
local.

[/DriverPackage: Especifica el nombre del paquete de controladores que se va a quitar.


<Name>]

[/PackageId:<ID>] Especifica el id. de los Servicios de implementación de Windows del


paquete de controladores que se va a quitar. Debe especificar esta opción
si el paquete de controladores no puede identificarse de forma única por
su nombre.

Ejemplos

wdsutil /Remove-DriverGroupPackage /DriverGroup:PrinterDrivers /PackageId:


{4D36E972-E325-11CE-BFC1-08002BE10318}

wdsutil /Remove-DriverGroupPackage /DriverGroup:PrinterDrivers


/DriverPackage:XYZ
Vínculos relacionados
Clave de sintaxis de línea de comandos
wdsutil remove-drivergrouppackages
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Quita los paquetes de controladores de un grupo de controladores en un servidor.

Sintaxis

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 Descripción

/DriverGroup: Especifica el nombre del grupo de controladores.


<Nombre del grupo>

[/Servidor:<Nombre Especifica el nombre del servidor. Este puede ser el nombre NetBIOS o el
del servidor>] FQDN. Si no se especifica un nombre de servidor, se usará el servidor
local.

/Filtertype:<Tipo de Especifica el atributo del paquete de controladores que se va a buscar.


filtro> Puede especificar varios atributos en un solo comando. También debe
especificar /Operator y /Value con esta opción.

<El tipo de filtro> puede ser uno de los siguientes:

PackageId

PackageName

PackageEnabled

Packagedateadded

PackageInfFilename

PackageClass

PackageProvider
Parámetro Descripción

PackageArchitecture

PackageLocale

PackageSigned

PackagedatePublished

Packageversion

Driverdescription

DriverManufacturer

DriverHardwareId

DrivercompatibleId

DriverExcludeId

DriverGroupId

DriverGroupName

/Operator:{Equal | Especifica la relación entre el atributo y los valores. Solo puede


NotEqual | especificar Contains con atributos de cadena. Solo puede especificar
GreaterOrEqual | GreaterOrEqual y LessOrEqual con atributos de fecha y versión.
LessOrEqual |
Contains}

/Value:<Valor> Especifica el valor a buscar para el <atributo> especificado. Puede


especificar varios valores para un solo /Filtertype. En la lista siguiente se
describen los atributos que puede especificar para cada filtro. Para más
información sobre estos atributos, consulte Atributos de controlador y
paquete (https://go.microsoft.com/fwlink/?LinkId=166895 ).

- PackageId: especifique un GUID válido. Por ejemplo: {4d36e972-e325-


11ce-bfc1-08002be10318}.
- PackageName: especifique cualquier valor de cadena.
- PackageEnabled: especifique Yes o No.
- Packagedateadded: especifique la fecha en el formato AAAA/MM/DD.
- PackageInfFilename: especifique cualquier valor de cadena.
- PackageClass: especifique un nombre de clase o un GUID de clase
válidos. Por ejemplo: DiskDrive, Net, or {4d36e972-e325-11ce-bfc1-
08002be10318}.
- PackageProvider: especifique cualquier valor de cadena.
- PackageArchitecture: especifique x86, x64 o ia64.
- PckageLocale: especifique un identificador de idioma válido. Por
ejemplo: en-US o es-ES.
- PackageSigned: especifique Yes o No.
Parámetro Descripción

- PackagedatePublished: especifique la fecha en el formato


AAAA/MM/DD.
- Packageversion: especifique la versión en el formato a.b.x.y, por
ejemplo, 6.1.0.0
- Driverdescription: especifique cualquier valor de cadena.
- DriverManufacturer: especifique cualquier valor de cadena.
- DriverHardwareId: especifique cualquier valor de cadena.
- DrivercompatibleId: especifique cualquier valor de cadena.
- DriverExcludeId: especifique cualquier valor de cadena.
- DriverGroupId: especifique un GUID válido. Por ejemplo: {4d36e972-
e325-11ce-bfc1-08002be10318}.
- DriverGroupName: especifique cualquier valor de cadena.

Ejemplos
Para quitar paquetes de controladores de un grupo de controladores, escriba uno de los
siguientes:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil remove-drivergrouppackage
wdsutil remove-driverpackage
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Quita un paquete de controladores de un servidor.

Sintaxis

wdsutil /remove-DriverPackage [/Server:<Server name>] {/DriverPackage:


<Package Name> | /PackageId:<ID>}

Parámetros

Parámetro Descripción

[/Servidor:<Nombre Especifica el nombre del servidor. Este puede ser el nombre NetBIOS o el
del servidor>] FQDN. Si no se especifica un nombre de servidor, se usará el servidor
local.

[/DriverPackage: Especifica el nombre del paquete de controladores que se va a quitar.


<Name>]

[/PackageId:<ID>] Especifica el id. de los Servicios de implementación de Windows del


paquete de controladores que se va a quitar. Debe especificar el
identificador si el paquete de controladores no se puede identificar de
forma única por nombre.

Ejemplos
Para ver información sobre las imágenes, escriba una de las siguientes opciones:

wdsutil /remove-DriverPackage /PackageId:{4D36E972-E325-11CE-Bfc1-


08002BE10318}
wdsutil /remove-DriverPackage /Server:MyWdsServer
/DriverPackage:MyDriverPackage

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil remove-driverpackages
wdsutil remove-driverpackages
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Quita los paquetes de controladores del servidor.

Sintaxis

wdsutil /remove-DriverPackages [/Server:<Server name>] /Filtertype:<Filter


type> /Operator:{Equal | NotEqual | GreaterOrEqual | LessOrEqual | Contains}
/Value:<Value> [/Value:<Value> ...]

Parámetros

Parámetro Descripción

[/Server: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el FQDN.
<Nombre del Si no se especifica un nombre de servidor, se usará el servidor local.
servidor>]
Parámetro Descripción

/Filtertype: Especifica el atributo del paquete de controladores que se va a buscar. Puede


<Tipo de especificar varios atributos en un solo comando. También debe especificar
filtro> /Operator y /Value con esta opción. <El tipo de filtro> puede ser uno de los
siguientes:

PackageId
PackageName
PackageEnabled
Packagedateadded
PackageInfFilename
PackageClass
PackageProvider
PackageArchitecture
PackageLocale
PackageSigned
PackagedatePublished
Packageversion
Driverdescription
DriverManufacturer
DriverHardwareId
DrivercompatibleId
DriverExcludeId
DriverGroupId
DriverGroupName

/Operator: Especifica la relación entre el atributo y los valores. Solo puede especificar
{Equal | Contains con atributos de cadena. Solo puede especificar GreaterOrEqual y
NotEqual | LessOrEqual con atributos de fecha y versión.
GreaterOrEqual
| LessOrEqual |
Contains}
Parámetro Descripción

/Value:<Valor> Especifica el valor a buscar para el <atributo> especificado. Puede especificar


varios valores para un solo /Filtertype. En la lista siguiente se describen los
atributos que puede especificar para cada filtro. Para más información sobre
estos atributos, consulte Atributos de controlador y paquete
(https://go.microsoft.com/fwlink/?LinkId=166895 ).

PackageId: especifique un GUID válido. Por ejemplo: {4d36e972-e325-


11ce-bfc1-08002be10318}.
PackageName: especifique cualquier valor de cadena.
PackageEnabled: especifique Yes o No.
Packagedateadded: especifique la fecha en el formato siguiente:
AAAA/MM/DD.
PackageInfFilename: especifique cualquier valor de cadena.
PackageClass: especifique un nombre de clase o un GUID de clase válidos.
Por ejemplo: DiskDrive, Net o {4d36e972-e325-11ce-bfc1-
08002be10318}.
PackageProvider: especifique cualquier valor de cadena.
PackageArchitecture: especifique x86, x64 o ia64.
PckageLocale: especifique un identificador de idioma válido. Por ejemplo:
en-US o es-ES.
PackageSigned: especifique Yes o No.
PackagedatePublished: especifique la fecha en el formato siguiente:
AAAA/MM/DD.
Packageversion: especifique la versión en el siguiente formato: a.b.x.y. Por
ejemplo: 6.1.0.0.
Driverdescription: especifique cualquier valor de cadena.
DriverManufacturer: especifique cualquier valor de cadena.
DriverHardwareId: especifique cualquier valor de cadena.
DrivercompatibleId: especifique cualquier valor de cadena.
DriverExcludeId: especifique cualquier valor de cadena.
DriverGroupId: especifique un GUID válido. Por ejemplo: {4d36e972-e325-
11ce-bfc1-08002be10318}.
DriverGroupName: especifique cualquier valor de cadena.

Ejemplos
Para quitar paquetes, escriba una de las siguientes opciones:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil remove-driverpackage
wdsutil remove-image
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Elimina una imagen de un servidor.

Sintaxis
para imágenes de arranque:

wdsutil [Options] /remove-Image:<Image name> [/Server:<Server name>


type:Boot /Architecture:{x86 | ia64 | x64} [/Filename:<Filename>]

para imágenes de instalación:

wdsutil [Options] /remove-image:<Image name> [/Server:<Server name>


type:Install ImageGroup:<Image group name>] [/Filename:<Filename>]

Parámetros

Parámetro Descripción

/remove-image: Especifica el nombre de la imagen.


<Image name>

[/Servidor:<Nombre Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


del servidor>] nombre de dominio completo (FQDN). Si no se especifica un nombre de
servidor, se usará el servidor local.

mediatype:{Boot | Especifica el tipo de imagen.


Install}

/Architecture:{x86 | Especifica la arquitectura de la imagen. Dado que es posible tener el


ia64 | x64} mismo nombre de imagen para las distintas imágenes de arranque en
diferentes arquitecturas, especificar el valor de arquitectura garantiza que
se borre la imagen correcta.
Parámetro Descripción

\ImageGroup: Especifica el grupo de imágenes que contiene la imagen. Si no se


<Nombre del grupo especifica ningún nombre de grupo de imágenes y solo existe un grupo
de imágenes>] de imágenes en el servidor, se usará ese grupo de imágenes. Si existen
varios grupos de imágenes, debe usar esta opción para especificar el
grupo de imágenes.

[/Filename:<Nombre Si la imagen no se puede identificar de forma única por nombre, debe


de archivo>] usar esta opción para especificar el nombre de archivo.

Ejemplos
Para quitar una imagen de arranque, escriba:

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 quitar una imagen de instalación, escriba:

wdsutil /remove-Image:Windows Vista with Officemediatype:Install

wdsutil /verbose /remove-Image:Windows Vista with Office


/Server:MyWDSServemediatype:Instal ImageGroup:ImageGroup1
/Filename:install.wim

Vínculos relacionados
Clave de sintaxis de línea de comandos
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
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Quita un grupo de imágenes de un servidor.

Sintaxis

wdsutil [Options] /remove-ImageGroup Group:<Image group name> [/Server:


<Server name>]

Parámetros

Parámetro Descripción

imagegroup: Especifica el nombre del grupo de imágenes que se va a eliminar


<Nombre del
grupo de
imágenes>

[/Servidor: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


<Nombre del nombre de dominio completo (FQDN). Si no se especifica un nombre de
servidor>] servidor, se usará el servidor local.

Ejemplos
Para quitar el grupo de imágenes, escriba una de las siguientes opciones:

wdsutil /remove-ImageGroumediaGroup:ImageGroup1
wdsutil /verbose /remove-ImageGroumediaGroup:My Image Group
/Server:MyWDSServer

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil add-imagegroup
Comando wdsutil get-allimagegroups
Comando wdsutil get-imagegroup
Comando wdsutil set-imagegroup
wdsutil remove-multicasttransmission
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Deshabilita la transmisión de multidifusión para una imagen. A menos que especifique


/force, los clientes existentes completarán la transferencia de imágenes, pero los nuevos
clientes no podrán unirse.

Sintaxis
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 imágenes de arranque:

wdsutil [Options] /remove-MulticastTransmissiomedia:<Image name>


\x20 [/Server:<Server name>]
\x20 mediatype:Boot
\x20 /Architecture:{x86 | ia64 | x64}
\x20 [/Filename:<File name>]

para imágenes de instalación:

wdsutil [Options] /remove-MulticastTransmissiomedia:<Image name>


[/Server:<Server name>]
mediatype:Install
mediaGroup:<Image Group
[/Filename:<File name>]

Parámetros
Parámetro Descripción

media: Especifica el nombre de la imagen.


<Nombre de
la imagen>

[/Server: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el nombre
<Server de dominio completo (FQDN). Si no se especifica el nombre del servidor, se usará
name>] el servidor local.

mediatype: Especifica el tipo de imagen. Tenga en cuenta que esta opción debe establecerse
{Install|Boot} en Install para Windows Server 2008.

/Architecture: Especifica la arquitectura de la imagen de arranque asociada a la transmisión


{x86 | ia64 | para iniciar. Puesto que es posible tener el mismo nombre de imagen para las
x64} imágenes de arranque en diferentes arquitecturas, debe especificar la
arquitectura para asegurarse de que se usa la transmisión correcta.

\mediaGroup: Especifica el grupo de imágenes que contiene la imagen. Si no se especifica


<Nombre del ningún nombre de grupo de imágenes y solo existe un grupo de imágenes en el
grupo de servidor, se usa ese grupo de imágenes. Si existen varios grupos de imágenes en
imágenes>] el servidor, debe usar esta opción para especificar el nombre del grupo de
imágenes.

[/Filename: especifica el nombre de archivo. Si la imagen de origen no se puede identificar


<Nombre de de forma única por nombre, debe usar esta opción para especificar el nombre de
archivo>] archivo.

[/force] Quita la transmisión y finaliza todos los clientes. A menos que especifique un
valor para la opción /force, los clientes existentes pueden completar la
transferencia de imágenes, pero los nuevos clientes no pueden unirse.

Ejemplos
Para detener un espacio de nombres (los clientes actuales completarán la transmisión,
pero los nuevos clientes no podrán unirse), escriba:

wdsutil /remove-MulticastTransmission:Vista with Office


/Imagetype:Install

wdsutil /remove-MulticastTransmission:x64 Boot Image


/Imagetype:Boot /Architecture:x64
Para forzar la finalización de todos los clientes, escriba:

wdsutil /remove-MulticastTransmission /Server:MyWDSServer


/Image:Vista with Officemediatype:InstalmediaGroup:ImageGroup1
/Filename:install.wim /force

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil get-allmulticasttransmissions
Comando wdsutil get-multicasttransmission
Comando wdsutil new-multicasttransmission
Comando wdsutil start-multicasttransmission
wdsutil remove-namespace
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Quita un espacio de nombres personalizado.

Sintaxis

wdsutil /remove-Namespace /Namespace:<Namespace name> [/Server:<Server


name>] [/force]

Parámetros

Parámetro Descripción

/Namespace: Especifica el nombre del espacio de nombres. Este no es el nombre


<Nombre del descriptivo y debe ser único.
espacio de - Implementación del servicio de rol: la sintaxis del nombre del espacio de
nombres> nombres es /Namespace:WDS:<ImageGroup>/<ImageName>/<Index>.
Por ejemplo: WDS:ImageGroup1/install.wim/1
- Servicio de rol de Servidor de transporte: este valor debe coincidir con el
nombre que se le ha dado al espacio de nombres cuando se creó en el
servidor.

[/Server:<Server Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


name>] nombre de dominio completo (FQDN). Si no se especifica el nombre del
servidor, se usará el servidor local.

[/force] Quita el espacio de nombres inmediatamente y finaliza todos los clientes.


Tenga en cuenta que, a menos que especifique /force, los clientes
existentes pueden completar la transferencia, pero los nuevos clientes no
pueden unirse.

Ejemplos
Para detener un espacio de nombres (los clientes actuales pueden completar la
transferencia, pero los nuevos clientes no pueden unirse), escriba:
wdsutil /remove-Namespace /Namespace:Custom Auto 1

Para forzar la finalización de todos los clientes, escriba:

wdsutil /remove-Namespace /Server:MyWDSServer /Namespace:Custom Auto 1


/force

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil get-allnamespaces
Comando wdsutil new-namespace
Comando wdsutil start-namespace
wdsutil replace-image
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Reemplaza una imagen existente por una nueva versión de esa imagen.

Sintaxis
para imágenes de arranque:

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 imágenes de instalación:

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 Descripción

media:<Nombre Especifica el nombre de la imagen que se va a reemplazar.


de la imagen>
Parámetro Descripción

[/Server:<Server Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


name>] nombre de dominio completo (FQDN). Si no se especifica un nombre de
servidor, se usará el servidor local.

mediatype:{Boot | Especifica el tipo de imagen que se va a reemplazar.


Install}

/Architecture:{x86 | Especifica la arquitectura de la imagen que se va a reemplazar. Dado que es


ia64 | x64} posible tener el mismo nombre de imagen para diferentes imágenes de
arranque en arquitecturas diferentes, especificar la arquitectura garantiza
que se reemplace la imagen correcta.

[/Filename: Si la imagen no se puede identificar de forma única por nombre, debe usar
<Nombre de esta opción para especificar el nombre de archivo.
archivo>]

/replacementImage Especifica la configuración de la imagen de reemplazo. Esta configuración


se establece con las siguientes opciones:
- mediaFile: <file path>: especifica el nombre y la ubicación (ruta de acceso
completa) del nuevo archivo .wim.
- [/SourceImage: <image name>]: especifica la imagen que se va a usar si el
archivo .wim contiene varias imágenes. Esta opción solo se aplica a
imágenes de instalación.
- [/Name:<Image name>] establece el nombre para mostrar de la imagen.
- [/Description:<Image description>]: establece la descripción de la imagen.

Ejemplos
Para reemplazar una imagen de arranque, escriba una de las siguientes opciones:

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 reemplazar una imagen de instalación, escriba una de las siguientes opciones:

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.

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil add-image
Comando wdsutil copy-image
Comando wdsutil export-image
Comando wdsutil get-image
Comando wdsutil replace-image
Comando wdsutil set-image
Uso del comando set
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Establece propiedades y atributos para servidores de los Servicios de implementación


de Windows, equipos preconfigurados, imágenes, grupos de imágenes y servidores de
transporte.

Subcomandos
Subcomando Descripción

Subcomando: Cambia los atributos de un equipo preconfigurado. Un equipo


set-Device preconfigurado es un equipo que se ha vinculado a un objeto de cuenta de
equipo en Active Directory Domain Services (AD DS). Los clientes
preconfigurados también se denominan equipos conocidos.

Subcomando: Cambia los atributos de una imagen existente.


set-Image

Subcomando: Cambia los atributos de un grupo de imágenes existente.


set-ImageGroup

Subcomando: Configura los ajustes de un servidor de Servicios de implementación de


set-Server Windows.

Subcomando: Configura los ajustes de un servidor de transporte.


set-
TransportServer

Subcomando: Cambia el nombre o habilita o deshabilita un paquete de controladores en un


set- servidor.
DriverPackage

Subcomando: Establece las propiedades de un grupo de controladores existente en un


set-DriverGroup servidor.

Subcomando: Agrega o quita un filtro de grupo de controladores existente de un grupo de


set- controladores.
DriverGroupFilter
wdsutil set-device
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia los atributos de un equipo preconfigurado. Un equipo preconfigurado es un


equipo que se ha vinculado a un objeto de cuenta de equipo en Active Directory
Domain Services (AD DS). Los clientes preconfigurados también se denominan equipos
conocidos. Puede configurar propiedades en la cuenta de equipo para controlar la
instalación del cliente. Por ejemplo, puede configurar el programa de arranque de red y
el archivo de instalación desatendida que el cliente debería recibir, así como el servidor
del que el cliente debería descargar los archivos de arranque.

Sintaxis

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 Descripción

/Device:<nombre del Especifica el nombre del equipo (SAM-Account-Name).


equipo>

[/ID:<UUID | MAC Especifica el GUID/UUID o la dirección MAC del equipo. Este valor debe
address>] tener uno de los tres formatos siguientes:
- Cadena binaria: /ID:ACEFA3E81F20694E953EB2DAA1E8B1B6
- Cadena GUID/UUID: /ID:E8A3EFAC-201F-4E69-953E-B2DAA1E8B1B6
- Dirección MAC: 00B056882FDC (sin guiones) o 00-B0-56-88-2F-DC
(con guiones)

[/ReferralServer: Especifica el nombre del servidor con el que se debe poner en contacto
<Nombre del para descargar el programa de arranque de red y la imagen de arranque
servidor>] mediante Trivial File Transfer Protocol (tftp).
Parámetro Descripción

[/BootProgram:< Especifica la ruta de acceso relativa de la carpeta remoteInstall al


Ruta de acceso programa de arranque de red que recibirá el equipo especificado. Por
relativa>] ejemplo: boot\x86\pxeboot.com

[/WdsClientUnattend: Especifica la ruta de acceso relativa de la carpeta remoteInstall al archivo


<Ruta de acceso desatendido que automatiza las pantallas de instalación para el cliente de
relativa>] Servicios de implementación de Windows.

[/Usuario:< Establece permisos en el objeto de cuenta de equipo para conceder al


Dominio\Usuario | usuario especificado los derechos necesarios para unir el equipo al
>User@Domain] dominio.

[/JoinRights: Especifica el tipo de derechos que se asignarán al usuario.


{JoinOnly | Full}] - JoinOnly requiere que el administrador restablezca la cuenta del equipo
antes de que el usuario pueda unir el equipo al dominio.
- Full proporciona acceso total al usuario, incluido el derecho de unir el
equipo al dominio.

[/JoinDomain:{Yes | Especifica si el equipo debe unirse o no al dominio como esta cuenta de


No}] equipo durante una instalación de Servicios de implementación de
Windows. El valor predeterminado es Sí.

[/BootImagepath:< Especifica la ruta de acceso relativa desde la carpeta remoteInstall a la


Ruta de acceso imagen de arranque que usará este equipo.
relativa>]

[/Domain: Especifica el dominio que se va a buscar en el equipo preconfigurado. El


<Dominio>] valor predeterminado es el nombre del dominio local.

[/resetAccount] Restablece los permisos en el equipo especificado para que cualquier


persona con los permisos adecuados pueda unirse al dominio mediante
esta cuenta.

Ejemplos
Para establecer el programa de arranque de red y el servidor de referencia para un
equipo, escriba:

wdsutil /Set-Device /Device:computer1 /ReferralServer:MyWDSServer


/BootProgram:boot\x86\pxeboot.n12

Para establecer varias opciones de configuración para un equipo, escriba:


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

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil add-device
Comando wdsutil get-alldevices
Comando wdsutil get-device
Subcomando: set-DriverGroup
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Establece las propiedades de un grupo de controladores existente en un servidor.

Sintaxis

wdsutil /Set-DriverGroup /DriverGroup:<Group Name> [/Server:<Server Name>]


[/Name:<New Group Name>] [/Enabled:{Yes | No}] [/Applicability:{Matched |
All}]

Parámetros

Parámetro Descripción

/DriverGroup: Especifica el nombre del grupo de controladores.


<Nombre del
grupo>

[/Servidor: Especifica el nombre del servidor. Este puede ser el nombre NetBIOS o el
<Nombre del FQDN. Si no se especifica un nombre de servidor, se usará el servidor local.
servidor>]

[/Name:< Nuevo Especifica el nuevo nombre del grupo de controladores.


nombre del
grupo>]

[/Enabled:{Yes | Habilita o deshabilita el grupo de controladores.


No}

[/Applicability: Especifica los paquetes que se van a instalar si se cumplen los criterios de
{Matched | All}] filtro. Matched significa instalar solo los paquetes de controladores que
coinciden con el hardware de un cliente. All significa instalar todos los
paquetes en los clientes independientemente de su hardware.

Ejemplos
Para establecer las propiedades de un grupo de controladores, escriba una de las
siguientes opciones:

wdsutil /Set-DriverGroup /DriverGroup:printerdrivers /Enabled:Yes

wdsutil /Set-DriverGroup /DriverGroup:printerdrivers


/Name:colorprinterdrivers /Applicability:All

Vínculos relacionados
Subcomando Command-Line Syntax Key: set-DriverGroupFilter
Subcomando: set-DriverGroupFilter
Artículo • 08/04/2023

Agrega o quita un filtro de grupo de controladores existente de un grupo de


controladores.

Sintaxis

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 Descripción

/DriverGroup: Especifica el nombre del grupo de controladores.


<Nombre del
grupo>

[/Servidor: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el FQDN.
<Nombre del Si no se especifica un nombre de servidor, se usará el servidor local.
servidor>]

/FilterType: Especifica el tipo de filtro de grupo de controladores que se va a agregar o


<FilterType> quitar. Puede especificar varios filtros en un solo comando. Para cada
/FilterType, puede agregar o quitar varios valores mediante /RemoveValue y
/AddValue. <FilterType> puede ser uno de los siguientes:
BiosVendor
BiosVersion
ChassisType
Manufacturer
Uuid
OsVersion
OsEdition
OsLanguage

[/Policy: Exclude}]
{Include
Parámetro Descripción

[/AddValue: Especifica el nuevo valor de cliente que se va a agregar al filtro. Puede


<Value>] especificar varios valores para un único tipo de filtro. Consulte la lista siguiente
para ver los valores de atributo válidos para ChassisType. Para obtener
información sobre cómo obtener los valores de todos los demás tipos de filtro,
vea Filtros de grupo de controladores (https://go.microsoft.com/fwlink/?
LinkID=155158 ).
Other
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 el valor de cliente existente que se va a quitar del filtro tal y como se
<Value>] especifica con /AddValue.

Ejemplos
Para quitar un filtro, escriba una de las siguientes opciones:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos
Subcomando: set-DriverPackage
Artículo • 06/10/2023

Cambia el nombre o habilita o deshabilita un paquete de controladores en un servidor.

Sintaxis

wdsutil /Set-DriverPackage [/Server:<Server name>] {/DriverPackage:<Name> |


/PackageId:<ID>} [/Name:<New Name>] [/Enabled:{Yes | No}

Parámetros

Parámetro Descripción

[/Servidor: Especifica el nombre del servidor. Este puede ser el nombre NetBIOS o el
<Nombre del FQDN. Si no se especifica un nombre de servidor, se usará el servidor local.
servidor>]

[/DriverPackage: Especifica el nombre actual del paquete de controladores que se va a


<Nombre>] modificar.

[/PackageId:<ID>] Especifica el identificador de Servicios de implementación de Windows del


paquete de controladores. Debe especificar esta opción si el paquete de
controladores no puede identificarse de forma única por su nombre. Para
buscar este identificador para un paquete, haga clic en el grupo de
controladores en el que se encuentra el paquete (o en el nodo Todos los
paquetes), haga clic con el botón derecho en el paquete y, a continuación,
haga clic en Propiedades. El id. de paquete aparece en la pestaña General.
Por ejemplo: {DD098D20-1850-4FC8-8E35-EA24A1BEFF5E}.

[/Name:<New Especifica el nuevo nombre del paquete de controladores.


Name>]

[/Enabled:{Yes No}

Ejemplos
Para cambiar la configuración de un paquete, escriba una de las siguientes opciones:
wdsutil /Set-DriverPackage /PackageId:{4D36E972-E325-11CE-BFC1-08002BE10318}
/Name:MyDriverPackage

wdsutil /Set-DriverPackage /DriverPackage:MyDriverPackage /Name:NewName


/Enabled:Yes

Vínculos relacionados
Clave de sintaxis de línea de comandos
wdsutil set-image
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia los atributos de una imagen.

Sintaxis
para imágenes de arranque:

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 imágenes de instalación:

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 Descripción

media:<Nombre de Especifica el nombre de la imagen.


la imagen>

[/Server:<Nombre Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


del servidor>] nombre de dominio completo (FQDN). Si no se especifica un nombre de
servidor, se usará el servidor local.
Parámetro Descripción

mediatype:{Boot | Especifica el tipo de imagen.


Install}

/Architecture:{x86 | Especifica la arquitectura de la imagen. Dado que puede tener el mismo


ia64 | x64} nombre de imagen para diferentes imágenes de arranque en
arquitecturas diferentes, especificar la arquitectura garantiza que se
modifique la imagen correcta.

[/Filename:<Nombre Si la imagen no se puede identificar de forma única por nombre, debe


de archivo>] usar esta opción para especificar el nombre de archivo.

[/Name] Especifica el nombre de la imagen.

[/Description: Establece la descripción de la imagen.


<Descripción>]

[/Enabled:{Yes | No}] Habilita o deshabilita la imagen.

\mediaGroup: Especifica el grupo de imágenes que contiene la imagen. Si no se


<Nombre del grupo especifica ningún nombre de grupo de imágenes y solo existe un grupo
de imágenes>] de imágenes en el servidor, se usará ese grupo de imágenes. Si existen
varios grupos de imágenes en el servidor, debe usar esta opción para
especificar el grupo de imágenes.

[/UserFilter:<SDDL>] Establece el filtro de usuario en la imagen. La cadena del filtro debe estar
en formato de lenguaje de definición de descriptores de seguridad
(SDDL). Tenga en cuenta que, a diferencia de la opción /Security para los
grupos de imágenes, esta opción solo restringe quién puede ver la
definición de la imagen y no los recursos reales del archivo de imagen.
Para restringir el acceso a los recursos de archivo y, por tanto, el acceso a
todas las imágenes de un grupo de imágenes, deberá establecer la
seguridad para el propio grupo de imágenes.

[/UnattendFile: Establece la ruta de acceso completa al archivo de instalación desatendida


<Ruta de acceso al que se va a asociar con la imagen. Por ejemplo:
archivo D:\Files\Unattend\Img1Unattend.xml
desatendido>]

[/OverwriteUnattend: Puede especificar /Overwrite para sobrescribir el archivo desatendido si


{Yes | No}] ya hay un archivo desatendido asociado a la imagen. Tenga en cuenta que
la configuración predeterminada es No.

Ejemplos
Para establecer valores para una imagen de arranque, escriba una de las siguientes
opciones:
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 establecer valores para una imagen de instalación, escriba una de las siguientes
opciones:

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

Vínculos relacionados
Clave de sintaxis de línea de comandos
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
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Cambia los atributos de un grupo de imágenes.

Sintaxis

wdsutil [Options] /set-imagegroup:<Image group name> [/Server:<Server name>]


[/Name:<New image group name>] [/Security:<SDDL>]

Parámetros

Parámetro Descripción

/set-imagegroup: Especifica el nombre del grupo de imágenes.


<Nombre del grupo
de imágenes>

[/Server:<Nombre del Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el
servidor>] nombre de dominio completo (FQDN). Si no se especifica, se usará el
servidor local.

[/Name:< Nuevo Especifica el nuevo nombre del grupo de imágenes.


nombre del grupo de
imágenes>]

[/Security:<SDDL>] Especifica el nuevo Descriptor de seguridad del grupo de imágenes, en


formato de lenguaje de definición de descriptores de seguridad (SDDL).

Ejemplos
Para establecer el nombre de un grupo de imágenes, escriba:

wdsutil /Set-ImageGroup:ImageGroup1 /Name:New Image Group Name


Para especificar varias opciones de configuración para un grupo de imágenes, escriba:

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)

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil add-imagegroup
Comando wdsutil get-allimagegroups
Comando wdsutil get-imagegroup
Comando wdsutil remove-imagegroup
wdsutil set-server
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Configura los valores de un servidor de Servicios de implementación de Windows.

Sintaxis

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 Descripción

[/Servidor:<Nombre del Especifica el nombre del servidor. Puede ser el nombre de


servidor>] NetBIOS o el nombre de dominio completo (FQDN). Si no se
especifica un nombre de servidor, se usará el servidor local.

[/Authorize:{Yes | No}] Especifica si se debe autorizar este servidor en el Protocolo de


control dinámico de host (DHCP).

[/RogueDetection:{Yes | No}] Habilita o deshabilita la detección no autorizada de DHCP.

[/AnswerClients:{All | Known Especifica qué clientes responderá este servidor. Si establece este
| None}] valor en Known, un equipo debe estar preconfigurado en Active
Directory Domain Services (AD DS) antes de que sea respondido
por el servidor de Servicios de implementación de Windows.

[/Responsedelay:<tiempo en Cantidad de tiempo que el servidor esperará antes de responder a


segundos>] un cliente de arranque. Esta configuración no se aplica a equipos
preconfigurados.

[/AllowN12forNewClients: para Windows Server 2008, especifica que los clientes


{Yes | No}] desconocidos no tendrán que presionar la tecla F12 para iniciar un
arranque de red. Los clientes conocidos recibirán el programa de
arranque especificado para el equipo o, si no se especifica, el
programa de arranque especificado para la arquitectura.
para Windows Server 2008 R2, esta opción se ha reemplazado por
el siguiente comando: wdsutil /Set-Server /PxepromptPolicy
/New:Noprompt

[/ArchitectureDiscovery:{Yes | Habilita o deshabilita la detección de arquitectura. Esto facilita la


No}] detección de clientes basados en x64 que no difunden
correctamente su arquitectura.

[/resetBootProgram:{Yes | Determina si la ruta de acceso de arranque se borrará para un


No}] cliente que acaba de arrancar sin necesidad de presionar una tecla
F12.

[/DefaultX86X64Imagetype: Controla qué imágenes de arranque se mostrarán a los clientes


{x86 | x64 | Both}] basados en x64.

[/UseDhcpPorts:{Yes | No}] Especifica si el servidor del entorno de ejecución previo al


arranque debe intentar enlazarse al puerto DHCP, puerto TCP 67.
Si DHCP y los Servicios de implementación de Windows se están
ejecutando en el mismo equipo, debería establecer esta opción en
No para permitir que el servidor DHCP utilice el puerto, y
establecer el parámetro /DhcpOption60 en Yes. La configuración
predeterminada para este valor es Yes.
Parámetro Descripción

[/DhcpOption60:{Yes | No}] Especifica si la opción DHCP 60 debe configurarse para la


compatibilidad con el entorno de ejecución previo al arranque. Si
DHCP y los Servicios de implementación de Windows se ejecutan
en el mismo servidor, establezca esta opción en Yes y la opción
/UseDhcpPorts en No. La configuración predeterminada para este
valor es No.

[/RpcPort:<Número de Especifica el número de puerto TCP que se usará para atender las
puerto>] solicitudes de cliente.

[/PxepromptPolicy] Configura el modo en que los clientes nuevos y conocidos


(preconfigurados) inician un arranque del entorno de ejecución
previo al arranque. Esta opción solo se aplica a Windows Server
2008 R2. La configuración se establece con las siguientes
opciones:
- [/Known:{OptIn| OptOut| Noprompt}]: establece la directiva para
los clientes preconfigurados.
- [/New:{OptIn| OptOut| Noprompt}]: establece la directiva para
los nuevos clientes.

OptIn significa que el cliente debe presionar una tecla para


arrancar el entorno de ejecución previo al arranque ; de lo
contrario, volverá al siguiente dispositivo de arranque.

Noprompt significa que el cliente siempre arrancará el entorno de


ejecución previo al arranque.

OptOut significa que el cliente arrancará el entorno de ejecución


previo al arranque a menos que se presione la tecla Esc.

[/BootProgram:<Ruta de Especifica la ruta de acceso relativa al programa de arranque en la


acceso relativa>] carpeta remoteInstall (por ejemplo, boot\x86\pxeboot.n12) y
/Architecture:{x86 | ia64 | especifica la arquitectura del programa de arranque.
x64}

[/N12BootProgram:<Ruta de Especifica la ruta de acceso relativa al programa de arranque que


acceso relativa>] no requiere pulsar la tecla F12 (por ejemplo,
/Architecture:{x86 | ia64 | boot\x86\pxeboot.n12), y especifica la arquitectura del programa
x64} de arranque.

[/BootImage:<Ruta de Especifica la ruta de acceso relativa a la imagen de arranque que


acceso relativa>] deben recibir los clientes de arranque y especifica la arquitectura
/Architecture:{x86 | ia64 | de la imagen de arranque. Puede especificar esto para cada
x64} arquitectura.

[/PreferredDC:<Nombre del Especifica el nombre del controlador de dominio que deben usar
controlador de dominio>] los Servicios de implementación de Windows. Éste puede ser el
nombre NetBIOS o el FQDN.
Parámetro Descripción

[/PreferredGC:<Nombre de Especifica el nombre del servidor de catálogo global que deben


GC>] usar los Servicios de implementación de Windows. Éste puede ser
el nombre NetBIOS o el FQDN.

[/PrestageUsingMAC:{Yes | Especifica si los Servicios de implementación de Windows, al crear


No}] cuentas de equipo en AD DS, deben usar la dirección MAC en
lugar del GUID/UUID para identificar el equipo.

[/NewMachineNamingPolicy: Especifica el formato que se va a usar al generar nombres de


<Directiva>] equipo para los clientes. Para obtener información sobre el
formato que se va a usar para la <directiva>, haga clic con el
botón derecho en el servidor en el complemento mmc, haga clic
en Propiedades y vea la pestaña Servicios de directorio. Por
ejemplo, /NewMachineNamingPolicy: %61Username%#.

[/NewMachineOU] Se usa para especificar la ubicación en AD DS donde se crearán las


cuentas de equipo cliente. Especifique la ubicación usando las
siguientes opciones.
- [/type: Serverdomain | Userdomain | UserOU | Custom ]
Especifica el tipo de ubicación. Serverdomain crea cuentas en el
mismo dominio que el servidor de Servicios de implementación
de Windows. Userdomain crea cuentas en el mismo dominio que
el usuario que realiza la instalación. UserOU crea cuentas en la
unidad organizativa del usuario que realiza la instalación. Custom
le permite especificar una ubicación personalizada (también debe
especificar un valor para /OU con esta opción).
- [/OU:<Nombre de dominio de OU>]: si especifica Custom para
la opción /type, esta opción especifica la unidad organizativa
donde se deben crear las cuentas de equipo.

[/DomainSearchOrder: Especifica la directiva para buscar cuentas de equipo en AD DS


{GCOnly | DCFirst}] (catálogo global o controlador de dominio).

[/NewMachineDomainJoin: Especifica si un equipo que aún no está preconfigurado en AD DS


{Yes | No}] debe unirse al dominio durante la instalación. El valor
predeterminado es Sí.

[/WdsClientLogging] Especifica el nivel de registro del servidor.


- [/Enabled:{Yes| No}] : habilita o deshabilita el registro de acciones
de cliente de Servicios de implementación de Windows.
- [/LoggingLevel: {None | Errors | Warnings | Info}: establece el
nivel de registro. None equivale a deshabilitar el registro. Errors es
el nivel más bajo de registro e indican que solo se registrarán los
errores. Warnings incluye advertencias y errores. Info es el nivel
más alto de registro e incluye errores, advertencias y eventos
informativos.
Parámetro Descripción

[/WdsUnattend] Estas configuraciones controlan el comportamiento de la


instalación desatendida del cliente de Servicios de
implementación de Windows. La configuración se establece con
las siguientes opciones:
- [/Policy:{Enabled | Disabled}]: especifica si se usa o no la
instalación desatendida.
- [/CommandlinePrecedence: {Yes | No}]: especifica si un archivo
Autounattend.xml (si está presente en el cliente) o un archivo de
instalación desatendido que se pasó directamente al cliente de
Servicios de implementación de Windows con la opción /Unattend
se usará en lugar de un archivo desatendido de imagen durante
una instalación de cliente. El valor predeterminado es No.
- [/Archivo:<Ruta de acceso> /Architecture:{x86 | ia64 | x64}]:
especifica el nombre de archivo, la ruta de acceso y la arquitectura
del archivo desatendido.
Parámetro Descripción

[/AutoaddPolicy] Esta configuración controla la directiva Agregar automáticamente.


Puede establecer la configuración usando las siguientes opciones:
- [/Policy: {AdminApproval | Disabled}] - AdminApprove hace que
todos los equipos desconocidos se agreguen a una cola
pendiente, donde el administrador puede revisar la lista de
equipos y aprobar o rechazar cada solicitud, según corresponda.
Disabled indica que no se realiza ninguna acción adicional cuando
un equipo desconocido intenta arrancar en el servidor.
- /PollInterval:{tiempo en segundos}]: especifica el intervalo (en
segundos) en el que el programa de arranque en red debe
sondear el servidor de Servicios de implementación de Windows.
- /MaxRetry: <Número>]: especifica el número de veces que el
programa de arranque en red debe sondear el servidor de
Servicios de implementación de Windows. Este valor, junto con
/PollInterval, dicta cuánto tiempo esperará el programa de
arranque de la red a que un administrador apruebe o rechace el
equipo antes de que se agote el tiempo de espera. Por ejemplo,
un valor MaxRetry de 10 y un valor PollInterval de 60 indicaría
que el cliente debería sondear el servidor 10 veces, esperando 60
segundos entre intentos. Por lo tanto, el cliente agotaría el tiempo
de espera después de 10 minutos (10 x 60 segundos = 10
minutos).
- [/Message: <Mensaje>]: especifica el mensaje que se muestra al
cliente en la página de diálogo del programa de arranque en red.
- [/RetentionPeriod]: especifica el número de días que un equipo
puede estar en un estado pendiente antes de purgarse
automáticamente.
- [/Approved: <tiempo en días>]: especifica el período de
retención para los equipos aprobados. Debe usar este parámetro
con la opción /RetentionPeriod.
- [/Others: <tiempo en días>]: especifica el período de retención
para equipos no aprobados (rechazados o pendientes). Debe usar
este parámetro con la opción /RetentionPeriod.
Parámetro Descripción

[/AutoaddSettings] Especifica la configuración predeterminada que se aplicará a cada


equipo. Puede establecer la configuración usando las siguientes
opciones:
- /Architecture: {x86 | ia64 | x64}: especifica la arquitectura.
- [/BootProgram: <Ruta de acceso relativa>]: especifica el
programa de arranque enviado al equipo aprobado. Si no se
especifica ningún programa de arranque, se usará el valor
predeterminado para la arquitectura del equipo (como se
especifica en el servidor).
- [/WdsClientUnattend: <Ruta de acceso relativa>]: establece la
ruta de acceso relativa al archivo desatendido que debe recibir el
cliente aprobado.
- [/ReferralServer: <Nombre del servidor>]: especifica el servidor
de Servicios de implementación de Windows que el cliente usará
para descargar imágenes.
- [/BootImage: <Ruta de acceso relativa>]: especifica la imagen de
arranque que recibirá el cliente aprobado.
- [/Usuario: <Dominio\Usuario | >Usuario@Dominio]: establece
permisos en el objeto de cuenta de equipo para conceder al
usuario especificado los derechos necesarios para unir el equipo al
dominio.
- [JoinRights: {JoinOnly | Full}]: especifica el tipo de derechos que
se asignarán al usuario. JoinOnly requiere que el administrador
restablezca la cuenta del equipo antes de que el usuario pueda
unir el equipo al dominio. Full proporciona acceso total al usuario,
incluido el derecho de unir el equipo al dominio.
- [/JoinDomain: {Yes | No}]: especifica si el equipo debe unirse o
no al dominio como esta cuenta de equipo durante una
instalación de Servicios de implementación de Windows. El valor
predeterminado es Sí.

[/BindPolicy] Configura las interfaces de red para que el proveedor del entorno
de ejecución previo al arranque escuche. Defina la directiva
usando las siguientes opciones:
- [/Policy: {Include | Exclude}]: establece la directiva de enlace de
interfaz para incluir o excluir las direcciones de la lista de interfaz.
- [/add]: agrega una interfaz a la lista. También debe especificar
/addresstype y /address.
- [/remove]: quita una interfaz de la lista. También debe especificar
/addresstype y /address.
- /address: <Dirección IP o MAC>: especifica la dirección IP o MAC
de la interfaz que se va a agregar o quitar.
- /addresstype: {IP | MAC}: indica el tipo de dirección especificado
en la opción /address.

[/RefreshPeriod: Especifica con qué frecuencia (en segundos) el servidor actualizará


<segundos>] su configuración.
Parámetro Descripción

[/BannedGuidPolicy] Administra la lista de GUID prohibidos mediante las siguientes


opciones:
- [/add] /Guid:<GUID>: agrega el GUID especificado a la lista de
GUID prohibidos. En su lugar, cualquier cliente con este GUID se
identificará mediante su dirección MAC.
- [/remove] /Guid:<GUID>: quita el GUID especificado de la lista
de GUID prohibidos.

[/BcdRefreshPolicy] Establece la configuración para la actualización de los archivos


Bcd usando las siguientes opciones:
- [/Enabled:{Yes | No}] : especifica la directiva de actualización de
Bcd. Cuando /Enabled se establece en Yes, los archivos Bcd se
actualizan en el intervalo de tiempo especificado.
- [/RefreshPeriod:<time en minutos>]: especifica el intervalo de
tiempo en el que se actualizan los archivos Bcd.

[/Transport] Configure las siguientes opciones:

[/ObtainIpv4From: {Dhcp | Range}]: especifica el origen de


las direcciones IPv4.
[/start: <Dirección Ipv4 inicial>]: especifica el inicio del
intervalo de direcciones IP. Esta opción es necesaria y
válida solo si /ObtainIpv4From está establecido en
Range
[/End: <Dirección Ipv4 final>: especifica el final del
intervalo de direcciones IP. Esta opción es necesaria y
válida solo si /ObtainIpv4From está establecido en
Range.
[/ObtainIpv6From:Range] [/start:<Dirección IP inicial>]
[/End:<Dirección IP final>] especifica el origen de las
direcciones IPv6. Esta opción solo se aplica a Windows
Server 2008 R2 y el único valor admitido es Range.
[/startPort: <puerto inicial>]: especifica el inicio del intervalo
de puertos.
[/EndPort: <puerto final>]: especifica el final del intervalo de
puertos.
[/Profile: {10 Mbps | 100 Mbps | 1Gbps | Custom}]: especifica
el perfil de red que se va a usar. Esta opción solo se admite
para servidores que ejecutan Windows Server 2008.
[/MulticastSessionPolicy] Configura los valores de
transferencia para las transmisiones de multidifusión. Este
comando solo está disponible para Windows Server 2008
R2.
[/Policy:{None | AutoDisconnect | Multistream}] :
determina cómo controlar clientes lentos. None significa
mantener todos los clientes en una sesión a la misma
velocidad. AutoDisconnect significa que todos los
clientes que bajen por debajo del umbral especificado se
Parámetro Descripción

desconectarán. Multistream significa que los clientes se


separarán en varias sesiones, según lo especificado por
/StreamCount.
[/Threshold:<Velocidad en KBps>: para
/Policy:AutoDisconnect, esta opción establece la
velocidad de transferencia mínima en KBps. Los clientes
que bajen por debajo de esta velocidad se
desconectarán de las transmisiones de multidifusión.
[/StreamCount:{2 | 3}] [/Fallback:{Yes | No}] : para
/Policy:Multistream, esta opción determina el número de
sesiones. 2 significa dos sesiones (rápida y lenta) 3
significa tres sesiones (lenta, media, rápida).
[/Fallback:{Yes | No}]: determina si los clientes que están
desconectados continuarán la transferencia mediante
otro método (si es compatible con el cliente). Si usa el
cliente WDS, el equipo volverá a la unidifusión.
Wdsmcast.exe no admite un mecanismo de reserva. Esta
opción también se aplica a los clientes que no admiten
Multistream. En ese caso, el equipo recurrirá a otro
método en lugar de pasar a una sesión de transferencia
más lenta.

Ejemplos
Para establecer que el servidor responda solo a los clientes conocidos, con un retraso de
respuesta de 4 minutos, escriba:

wdsutil /Set-Server /AnswerClients:Known /Responsedelay:4

Para establecer el programa de arranque y la arquitectura del servidor, escriba:

wdsutil /Set-Server /BootProgram:boot\x86\pxeboot.n12 /Architecture:x86

Para habilitar el registro en el servidor, escriba:

wdsutil /Set-Server /WdsClientLogging /Enabled:Yes /LoggingLevel:Warnings


Para activar el modo desatendido en el servidor, así como la arquitectura y el archivo de
desatendido del cliente, escriba:

wdsutil /Set-Server /WdsUnattend /Policy:Enabled /File:WDSClientUnattend


\unattend.xml /Architecture:x86

Para establecer que el servidor de ejecución previa al arranque (PXE) intente enlazar con
los puertos TCP 67 y 60, escriba:

wdsutil /Set-server /UseDhcpPorts:No /DhcpOption60:Yes

Vínculos relacionados
Clave de sintaxis de línea de comandos
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
Artículo • 08/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Establece los valores de configuración de un servidor de transporte.

Sintaxis

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 Descripción

[/Server:<Nombre del Especifica el nombre del servidor de transporte. Puede ser el nombre
servidor>] de NetBIOS o el nombre de dominio completo (FQDN). Si no se
especifica un nombre de servidor de transporte, se usa el servidor
local.
Parámetro Descripción

[/ObtainIpv4From:{Dhcp | Establece el origen de las direcciones IPv4 de la siguiente manera:


Range}] - [/start: <dirección IP>] Establece el inicio del intervalo de
direcciones IP. Esto es necesario y válido solo si se establece esta
opción en Rango.
- [/End: <dirección IP>] Establece el final del intervalo de direcciones
IP. Esto es necesario y válido solo si se establece esta opción en
Rango.
- [/startPort: <puerto>] Establece el inicio del intervalo de puertos.
- [/EndPort: <puerto>] Establece el final del intervalo de puertos.

[/ObtainIpv6From:Range] Especifica el origen de las direcciones IPv6. Esta opción solo se aplica
a Windows Server 2008 R2 y el único valor admitido es Range.

- [/start: <dirección IP>] Establece el inicio del intervalo de


direcciones IP. Esto es necesario y válido solo si se establece esta
opción en Rango.
- [/End: <dirección IP>] Establece el final del intervalo de direcciones
IP. Esto es necesario y válido solo si se establece esta opción en
Rango.
- [/startPort: <puerto>] Establece el inicio del intervalo de puertos.
- [/EndPort: <puerto>] Establece el final del intervalo de puertos.

[/Profile: {10Mbps | Especifica el perfil de red que se va a usar. Esta opción solo está
100Mbps | 1Gbps | disponible para servidores que ejecutan Windows Server 2008 o
Custom}] Windows Server 2003.
Parámetro Descripción

[/MulticastSessionPolicy] Configura las opciones de transferencia para las transmisiones de


multidifusión. Este comando solo está disponible para Windows
Server 2008 R2.
- [/Policy:{None | AutoDisconnect | Multistream}] Determina cómo
controlar clientes lentos. None significa mantener todos los clientes
en una sesión a la misma velocidad. AutoDisconnect significa que los
clientes que se encuentran por debajo del /Threshold especificado se
desconectan. Multistream significa que los clientes se separarán en
varias sesiones según lo especificado por /StreamCount.
- [/Threshold:<Velocidad en KBps>] Establece la velocidad de
transferencia mínima en KBps para /Policy:AutoDisconnect. Los
clientes que bajen por debajo de esta velocidad se desconectan de las
transmisiones de multidifusión.
- [/StreamCount:{2 | 3}] [/Fallback:{Yes | No}] Determina el número de
sesiones para /Policy:Multistream. 2 significa dos sesiones (rápidas y
lentas) y 3 significa tres sesiones (lentas, medianas, rápidas).
- [/Fallback:{Yes | No}] Determina si los clientes que se desconectan
continuarán la transferencia mediante otro método (si es compatible
con el cliente). Si usa el cliente WDS, el equipo volverá a la
unidifusión. Wdsmcast.exe no admite un mecanismo de reserva. Esta
opción también se aplica a los clientes que no admiten Multistream.
En ese caso, el equipo recurrirá a otro método en lugar de pasar a
una sesión de transferencia más lenta.

Ejemplos
Para establecer el intervalo de direcciones IPv4 para el servidor, escriba:

wdsutil /Set-TransportServer /ObtainIpv4From:Range /start:239.0.0.1


/End:239.0.0.100

Para establecer el intervalo de direcciones IPv4, el intervalo de puertos y el perfil del


servidor, escriba:

wdsutil /Set-TransportServer /Server:MyWDSServer /ObtainIpv4From:Range


/start:239.0.0.1 /End:239.0.0.100 /startPort:12000 /EndPort:50000
/Profile:10mbps

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil disable-transportserver
Comando wdsutil enable-transportserver
Comando wdsutil get-transportserver
Comando wdsutil start-transportserver
Comando wdsutil stop-transportserver
wdsutil start-multicasttransmission
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Inicia una transmisión Scheduled-Cast de una imagen.

Sintaxis
Windows Server 2008

wdsutil /start-MulticastTransmissiomedia:<Image name> [/Server:<Server


namemediatype:InstallmediaGroup:<Image group name>] [/Filename:<File name>]

Windows Server 2008 R2 para imágenes de arranque:

wdsutil [Options] /start-MulticastTransmissiomedia:<Image name>


[/Server:<Server name>]
mediatype:Boot
/Architecture:{x86 | ia64 | x64}
[/Filename:<File name>]

para imágenes de instalación:

wdsutil [Options] /start-MulticastTransmissiomedia:<Image name>


[/Server:<Server name>]
mediatype:Install
mediaGroup:<Image Group>]
[/Filename:<File name>]

Parámetros

Parámetro Descripción
Parámetro Descripción

media: Especifica el nombre de la imagen.


<Nombre de
la imagen>

[/Servidor: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el nombre
<Nombre del de dominio completo (FQDN). Si no se especifica un nombre de servidor, se usará
servidor>] el servidor local.

mediatype: Especifica el tipo de imagen. Tenga en cuenta que esta opción debe establecerse
{Install|Boot} en Install para Windows Server 2008.

/Architecture: Arquitectura de la imagen de arranque asociada a la transmisión que se va a


{x86 | ia64 | iniciar. Puesto que es posible tener el mismo nombre de imagen para las
x64} imágenes de arranque en diferentes arquitecturas, debe especificar la
arquitectura para asegurarse de que se usa la transmisión correcta.

\mediaGroup: Especifica el grupo de imágenes de la imagen. Si no se especifica ningún nombre


<Nombre del de grupo de imágenes y solo existe un grupo de imágenes en el servidor, se
grupo de usará ese grupo de imágenes. Si existen varios grupos de imágenes en el
imágenes>] servidor, debe usar esta opción para especificar el nombre del grupo de
imágenes.

[/Filename: Especifica el nombre del archivo que contiene la imagen. Si la imagen no se


<Nombre de puede identificar de forma única por nombre, debe usar esta opción para
archivo>] especificar el nombre de archivo.

Ejemplos
Para iniciar una transmisión de multidifusión, escriba una de las siguientes opciones:

wdsutil /start-MulticastTransmissiomedia:Vista with Office


/Imagetype:Install
wdsutil /start-MulticastTransmission /Server:MyWDSServemedia:Vista with
Officemediatype:InstalmediaGroup:ImageGroup1 /Filename:install.wim

Para iniciar una transmisión de multidifusión de imagen de arranque para Windows


Server 2008 R2, escriba:

wdsutil /start-MulticastTransmission /Server:MyWDSServemedia:X64 Boot


Imagemediatype:Boot /Architecture:x64
/Filename:boot.wim\n\
Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil get-allmulticasttransmissions
Comando wdsutil get-multicasttransmission
Comando wdsutil new-multicasttransmission
Comando wdsutil remove-multicasttransmission
wdsutil start-namespace
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Inicia un espacio de nombres Scheduled-Cast.

Sintaxis

wdsutil /start-Namespace /Namespace:<Namespace name[/Server:<Server name>]

Parámetros

Parámetro Descripción

/Namespace: Especifica el nombre del espacio de nombres. Tenga en cuenta que este no es
<Nombre del el nombre descriptivo y debe ser único.
espacio de - Servidor de implementación: La sintaxis del nombre del espacio de
nombres> nombres es /Namspace:WDS:<Grupo de imágenes>/<Nombre de la
imagen>/<Índice>. Por ejemplo: WDS:ImageGroup1/install.wim/1
- Servidor de transporte: Este nombre debe coincidir con el nombre dado al
espacio de nombres cuando se creó en el servidor.

[/Server: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el


<Nombre del nombre de dominio completo (FQDN). Si no se especifica un nombre de
servidor>] servidor, se usará el servidor local.

Ejemplos
Para iniciar un espacio de nombres, escriba una de las siguientes opciones:

wdsutil /start-Namespace /Namespace:Custom Auto 1


wdsutil /start-Namespace /Server:MyWDSServer /Namespace:Custom Auto 1

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil get-allnamespaces
Comando wdsutil new-namespace
Comando wdsutil remove-namespace
wdsutil start-server
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Inicia todos los servicios para un servidor de Servicios de implementación de Windows.

Sintaxis

wdsutil [Options] /start-Server [/Server:<Server name>]

Parámetros

Parámetro Descripción

[/Servidor: Especifica el nombre del servidor que se va a iniciar. Puede ser el nombre de
<Nombre NetBIOS o el nombre de dominio completo (FQDN). Si no se especifica un
del nombre de servidor, se usará el servidor local.
servidor>]

Ejemplos
Para iniciar el servidor, escriba una de las siguientes opciones:

wdsutil /start-Server
wdsutil /verbose /start-Server /Server:MyWDSServer

Vínculos relacionados
Clave de sintaxis de línea de comandos
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
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Inicia todos los servicios de un servidor de transporte.

Sintaxis

wdsutil [Options] /start-TransportServer [/Server:<Server name>]

Parámetros

Parámetro Descripción

[/Server:<Server Especifica el nombre del servidor de transporte. Puede ser el nombre de


name>] NetBIOS o el nombre de dominio completo (FQDN). Si no se especifica un
nombre de servidor, se usará el servidor local.

Ejemplos
Para iniciar el servidor, escriba una de las siguientes opciones:

wdsutil /start-TransportServer
wdsutil /verbose /start-TransportServer /Server:MyWDSServer

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil disable-transportserver
Comando wdsutil enable-transportserver
Comando wdsutil get-transportserver
Comando wdsutil set-transportserver
Comando wdsutil stop-transportserver
wdsutil stop-server
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Detiene todos los servicios en un servidor de Servicios de implementación de Windows.

Sintaxis

wdsutil [Options] /Stop-Server [/Server:<Server name>]

Parámetros

Parámetro Descripción

[/Servidor: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el nombre
<Nombre del de dominio completo (FQDN). Si no se especifica un nombre de servidor, se
servidor>] usará el servidor local.

Ejemplos
Para detener los servicios, escriba una de las siguientes opciones:

wdsutil /Stop-Server
wdsutil /verbose /Stop-Server /Server:MyWDSServer

Vínculos relacionados
Clave de sintaxis de línea de comandos
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
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Detiene todos los servicios de un servidor de transporte.

Sintaxis

wdsutil [Options] /Stop-TransportServer [/Server:<Server name>]

Parámetros

Parámetro Descripción

[/Server: Especifica el nombre del servidor de transporte. Puede ser el nombre de NetBIOS o
<Server el nombre de dominio completo (FQDN). Si no se especifica ningún servidor de
name>] transporte, se usará el servidor local.

Ejemplos
Para detener los servicios, escriba una de las siguientes opciones:

wdsutil /Stop-TransportServer
wdsutil /verbose /Stop-TransportServer /Server:MyWDSServer

Vínculos relacionados
Clave de sintaxis de línea de comandos
Comando wdsutil disable-transportserver
Comando wdsutil enable-transportserver
Comando wdsutil get-transportserver
Comando wdsutil set-transportserver
Comando wdsutil start-transportserver
wdsutil uninitialize-server
Artículo • 06/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Revierte los cambios realizados en el servidor durante la configuración inicial del


servidor. Esto incluye los cambios realizados por la opción /initialize-server o el
complemento mmc de los Servicios de implementación de Windows. Tenga en cuenta
que este comando restablece el servidor a un estado no configurado. Este comando no
modifica el contenido de la carpeta compartida remoteInstall. En su lugar, restablece el
estado del servidor para que pueda reinicializar el servidor.

Sintaxis

wdsutil [Options] /Uninitialize-Server [/Server:<Server name>]

Parámetros

Parámetro Descripción

[/Servidor: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el nombre
<Nombre del de dominio completo (FQDN). Si no se especifica un nombre de servidor, se
servidor>] usará el servidor local.

Ejemplos
Para reinicializar el servidor, escriba una de las siguientes opciones:

wdsutil /Uninitialize-Server
wdsutil /verbose /Uninitialize-Server /Server:MyWDSServer

Vínculos relacionados
Clave de sintaxis de línea de comandos
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
Artículo • 06/04/2023

Actualiza los archivos de la carpeta compartida REMINST usando los últimos archivos
almacenados en la carpeta %Windir%\System32\RemInst del servidor. Para garantizar la
validez de su instalación de Servicios de implementación de Windows, debe ejecutar
este comando una vez después de cada actualización del servidor, instalación del
Service Pack o actualización de los archivos de Servicios de implementación de
Windows.

Sintaxis

wdsutil [Options] /Update-ServerFiles [/Server:<Server name>]

Parámetros

Parámetro Descripción

[/Servidor: Especifica el nombre del servidor. Puede ser el nombre de NetBIOS o el nombre
<Nombre del de dominio completo (FQDN). Si no se especifica un nombre de servidor, se
servidor>] usará el servidor local.

Ejemplos
Para actualizar los archivos, escriba uno de los siguientes:

wdsutil /Update-ServerFiles
wdsutil /Verbose /Progress /Update-ServerFiles /Server:MyWDSServer

Vínculos relacionados
Clave de sintaxis de línea de comandos
Uso del comando verbose
Artículo • 06/04/2023

Muestra la salida detallada de un comando especificado. Puede usar /verbose con


cualquier otro comando wdsutil que ejecute. Tenga en cuenta que debe especificar
/verbose y /progress directamente después de wdsutil.

Sintaxis

wdsutil /verbose <commands>

Ejemplos
Para eliminar equipos aprobados de la base de datos Agregar automáticamente y
mostrar la salida detallada, escriba:

wdsutil /Verbose /progress /Delete-AutoAddDevices /Server:MyWDSServer


/DeviceType:ApprovedDevices
wecutil
Artículo • 06/04/2023

Le permite crear y administrar suscripciones a eventos que se reenvían desde equipos


remotos. El equipo remoto debe admitir el protocolo WS-Management.

) Importante

Si recibe el mensaje "El servidor RPC no está disponible" cuando intente ejecutar
wecutil, deberá iniciar el servicio del Recopilador de eventos de Windows (wecsvc).
Para iniciar wecsvc, en un símbolo del sistema con privilegios elevados, escriba net
start wecsvc .

Sintaxis
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 Descripción

{es | enum-subscription} Muestra los nombres de todas las suscripciones de


eventos remotos que existen.
Parámetro Descripción

{gs | get-subscription} <Subid> [/f: Muestra información de configuración de la


<Format>] [/uni:<Unicode>] suscripción remota. <Subid> es una cadena que
identifica de forma única una suscripción. Es la
misma que la cadena que se especificó en la
etiqueta <SubscriptionId> del archivo de
configuración XML, que se usó para crear la
suscripción.

{gr | get-subscriptionruntimestatus} Muestra el estado en tiempo de ejecución de una


<Subid> [<Eventsource> …] suscripción. <Subid> es una cadena que identifica de
forma única una suscripción. Es la misma que la
cadena que se especificó en la etiqueta
<SubscriptionId> del archivo de configuración XML,
que se usó para crear la suscripción. <Eventsource>
es una cadena que identifica un equipo que actúa
como origen de eventos. Debería ser un nombre de
dominio completo, un nombre de NetBIOS o una
dirección IP.

{ss | set-subscription} <Subid> [/e: Cambia la configuración de la suscripción. Puede


[<Subenabled>]] [/esa:<Address>] [/ese: especificar el identificador de suscripción y las
[<Srcenabled>]] [/aes] [/res] [/un: opciones adecuadas para cambiar los parámetros de
<Username>] [/up:<Password>] [/d:<Desc>] la suscripción, o puede especificar un archivo de
[/uri:<Uri>] [/cm:<Configmode>] [/ex: configuración XML para cambiar los parámetros de
<Expires>] [/q:<Query>] [/dia:<Dialect>] la suscripción.
[/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} <Configfile> Crea una suscripción remota. <Configfile>


[/cun:<Username> /cup:<Password>] especifica la ruta de acceso al archivo XML que
contiene la configuración de la suscripción. La ruta
de acceso puede ser absoluta o relativa al directorio
actual.
Parámetro Descripción

{ds | delete-subscription} <Subid> Elimina una suscripción y cancela la suscripción de


todos los orígenes de eventos que entregan eventos
en el registro de eventos de la suscripción. Los
eventos ya recibidos y registrados no se eliminan.
<Subid> es una cadena que identifica de forma única
una suscripción. Es la misma que la cadena que se
especificó en la etiqueta <SubscriptionId> del
archivo de configuración XML, que se usó para crear
la suscripción.

{rs | retry-subscription} <Subid> Vuelve a intentar establecer una conexión y enviar


[<Eventsource>…] una solicitud de suscripción remota a una
suscripción inactiva. Intenta reactivar todos los
orígenes de eventos o los orígenes de eventos
especificados. Los orígenes deshabilitados no se
reintentan. <Subid> es una cadena que identifica de
forma única una suscripción. Es la misma que la
cadena que se especificó en la etiqueta
<SubscriptionId> del archivo de configuración XML,
que se usó para crear la suscripción. <Eventsource>
es una cadena que identifica un equipo que actúa
como origen de eventos. Debería ser un nombre de
dominio completo, un nombre de NetBIOS o una
dirección IP.

{qc | quick-config} [/q:[<Quiet>]] Configura el servicio Recopilador de eventos de


Windows para asegurarse de que se puede crear y
mantener una suscripción a través de reinicios. Esto
incluye los siguientes pasos:

1. Habilite el canal ForwardedEvents si está


deshabilitado.
2. Establezca el servicio Recopilador de eventos
de Windows para retrasar el inicio.
3. Inicie el servicio Recopilador de eventos de
Windows si no se está ejecutando.

Opciones

Opción Descripción

/f: <Format> Especifica el formato de la información que se muestra. <Format> puede


ser XML o Terse. Si es XML, la salida se muestra en formato XML. Si es
Terse, la salida se muestra en pares nombre-valor. El valor
predeterminado es Terse.
Opción Descripción

/c: <Configfile> Especifica la ruta de acceso al archivo XML que contiene una
configuración de suscripción. La ruta de acceso puede ser absoluta o
relativa al directorio actual. Esta opción solo se puede usar con las
opciones /cun y /cup y es mutuamente excluyente con todas las demás
opciones.

/e:[ <Subenabled> ] Habilita o deshabilita una suscripción. <Subenabled> puede ser true o
false. El valor predeterminado de esta opción es true.

/esa: <Address> Especifica la dirección de un origen de eventos. <Address> es una cadena


que contiene un nombre de dominio completo, un nombre de NetBIOS o
una dirección IP, que identifica un equipo que actúa como origen de
eventos. Esta opción debe usarse con las opciones /ese, /aes, /res o /un y
/up.

/ese:[ <Srcenabled> ] Habilita o deshabilita un origen de eventos. <Srcenabled> puede ser true
o false. Esta opción solo está permitida si se especifica la opción /esa. El
valor predeterminado de esta opción es true.

/aes Agrega el origen de eventos especificado por la opción /esa si aún no


forma parte de la suscripción. Si la dirección especificada por la opción
/esa ya forma parte de la suscripción, se notifica un error. Esta opción
solo está permitida si se especifica la opción /esa.

/res Quita el origen del evento especificado por la opción /esa si ya forma
parte de la suscripción. Si la dirección especificada por la opción /esa no
forma parte de la suscripción, se informa de un error. Esta opción solo
está permitida si se especifica la opción /esa.

/un: <Username> Especifica la credencial de usuario que se va a usar con el origen del
evento especificado por la opción /esa. Esta opción solo está permitida si
se especifica la opción /esa.

/up: <Password> Especifica la contraseña que corresponde a la credencial de usuario. Esta


opción solo está permitida si se especifica la opción /un.

/d: <Desc> Proporciona una descripción para la suscripción.

/uri: <Uri> Especifica el tipo de los eventos consumidos por la suscripción. <Uri>
contiene una cadena de URI que se combina con la dirección del equipo
de origen del evento para identificar de forma única el origen de los
eventos. La cadena de URI se usa para todas las direcciones de origen de
eventos de la suscripción.
Opción Descripción

/cm: <Configmode> Establece el modo de configuración. <Configmode> puede ser una de las
siguientes cadenas: Normal, Custom, MinLatency o MinBandwidth. Los
modos Normal, MinLatency y MinBandwidth establecen el modo de
entrega, los elementos máximos de entrega, el intervalo de latido y el
tiempo de latencia máxima de entrega. Las opciones /dm, /dmi, /hi o
/dmlt solo se pueden especificar si el modo de configuración está
establecido en Custom.

/ex: <Expires> Establece la hora en que expira la suscripción. <Expires> debe definirse
en formato de fecha y hora XML estándar o ISO8601: yyyy-MM-
ddThh:mm:ss[.sss][Z] , donde T es el separador de hora y Z indica la hora
UTC.

/q: <Query> Especifica la cadena de consulta de la suscripción. El formato de <Query>


puede ser diferente para distintos valores de URI y se aplica a todos los
orígenes de la suscripción.

/dia: <Dialect> Define el dialecto que usa la cadena de consulta.

/tn: <Transportname> Especifica el nombre del transporte que se usa para conectarse a un
origen de eventos remotos.

/tp: <Transportport> Establece el número de puerto que usa el transporte al conectarse a un


origen de eventos remoto.

/dm: <Deliverymode> Especifica el modo de entrega. <Deliverymode> puede ser pull o push.
Esta opción solo es válida si la opción /cm está establecida en Custom.

/dmi: <Deliverymax> Establece el número máximo de elementos para la entrega por lotes. Esta
opción solo es válida si /cm está establecido en Personalizado.

/dmlt: <Deliverytime> Establece la latencia máxima en la entrega de un lote de eventos.


<Deliverytime> es el número de milisegundos. Esta opción solo es válida
si /cm está establecida en Custom.

/hi: <Heartbeat> Define el intervalo de latido. <Heartbeat> es el número de milisegundos.


Esta opción solo es válida si /cm está establecido en Personalizado.

/cf: <Content> Especifica el formato de los eventos que se devuelven. <Content> puede
ser Events o RenderedText. Cuando el valor es RenderedText, los eventos
se devuelven con las cadenas localizadas (como la descripción del evento)
adjunta al evento. El valor predeterminado es RenderedText.

/l: <Locale> Especifica la configuración regional para la entrega de las cadenas


localizadas en formato RenderedText. <Locale> es un idioma y un
identificador de país o región, por ejemplo, EN-us. Esta opción solo es
válida si la opción /cf está establecida en RenderedText.
Opción Descripción

/ree:[ <Readexist> ] Identifica los eventos que se entregan para la suscripción. <Readexist>
puede ser true or false. Cuando <Readexist> es true, todos los eventos
existentes se leen de los orígenes de eventos de la suscripción. Cuando
<Readexist> es false, solo se entregan los eventos futuros (que llegan). El
valor predeterminado es true para una opción /ree sin un valor. Si no se
especifica ninguna opción /ree, el valor predeterminado es false.

/lf: <Logfile> Especifica el registro de eventos local que se usa para almacenar los
eventos recibidos de los orígenes de eventos.

/pn: <Publishername> Especifica el nombre del publicador. Debe ser un publicador propietario o
importado del registro especificado por la opción /lf.

/essp: <Enableport> Especifica que el número de puerto debe anexarse al nombre de la


entidad de seguridad de servicio del servicio remoto. <Enableport>
puede ser true o false. El número de puerto se anexa cuando
<Enableport> es true. Cuando se anexa el número de puerto, es posible
que se requiera alguna configuración para evitar que se deniegue el
acceso a los orígenes de eventos.

/hn: <Hostname> Especifica el nombre DNS del equipo local. El origen de eventos remotos
usa este nombre para devolver eventos y solo se debe usar para una
suscripción de inserción.

/ct: <Type> Establece el tipo de credencial para el acceso de origen remoto. <Type>
debe ser uno de los siguientes valores: default, negotiate, digest, basic o
localmachine. El valor predeterminado es default.

/cun: <Comusername> Establece la credencial de usuario compartido que se usará para los
orígenes de eventos que no tienen sus propias credenciales de usuario. Si
se especifica esta opción con la opción /c, se omiten la configuración de
UserName y UserPassword para orígenes de eventos individuales del
archivo de configuración. Si quiere usar una credencial diferente para un
origen de eventos específico, deberá anular este valor especificando las
opciones /un y /up para un origen de eventos específico en la línea de
comandos de otro comando ss.

/cup: <Compassword> Establece la contraseña de usuario para la credencial de usuario


compartido. Cuando <Compassword> se establece en * (asterisco), la
contraseña se lee desde la consola. Esta opción solo es válida cuando se
especifica la opción /cun.

/q:[ <Quiet> ] Especifica si el procedimiento de configuración solicita confirmación.


<Quiet> puede ser true o false. Si <Quiet> es true, el procedimiento de
configuración no solicita confirmación. El valor predeterminado de esta
opción es false.
Ejemplos
Para mostrar el contenido de un archivo de configuración, escriba:

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 ver la información de configuración de salida de una suscripción denominada sub1,


escriba:

command

wecutil gs sub1

Salida de ejemplo:

Resultados

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 mostrar el estado en tiempo de ejecución de una suscripción denominada sub1,


escriba:

command

wecutil gr sub1

Para actualizar la configuración de la suscripción denominada sub1 desde un nuevo


archivo XML denominado WsSelRg2.xml, escriba:

command

wecutil ss sub1 /c:%Windir%system32WsSelRg2.xml

Para actualizar la configuración de la suscripción denominada sub2 con varios


parámetros, escriba:

command

wecutil ss sub2 /esa:myComputer /ese /un:uname /up:* /cm:Normal

Para eliminar una suscripción denominada sub1, escriba:

wecutil ds sub1

Vínculos relacionados
Clave de sintaxis de línea de comandos
wevtutil
Artículo • 07/10/2023

Permite recuperar información acerca de los registros de eventos y los editores. También
puede utilizar este comando para instalar y desinstalar los manifiestos de eventos,
ejecutar consultas, y exportar, archivar y borrar registros.

Sintaxis

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>] [/rf:<Path>] [/mf:<Path>] [/pf:<Path>]
[{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 Descripción

{el | enum-logs} Muestra los nombres de todos los registros.

{gl | get-log} <Logname> [/f: Muestra información de configuración para el registro


<Format>] especificado, que incluye si el registro está habilitado o no,
el límite de tamaño máximo actual del registro y la ruta de
acceso al archivo donde se almacena el registro.

{sl | set-log} <Logname> [/e: Modifica la configuración del registro especificado.


<Enabled>] [/i:<Isolation>] [/lfn:
<Logpath>] [/rt:<Retention>] [/ab:
<Auto>] [/ms:<MaxSize>] [/l:
Parámetro Descripción

<Level>] [/k:<Keywords>] [/ca:


<Channel>] [/c:<Config>]

{ep | enum-publishers} Muestra los publicadores de eventos en el equipo local.

{gp | get-publisher} Muestra la información de configuración del publicador de


<Publishername> [/ge: eventos especificado.
<Metadata>] [/gm:<Message>] [/f:
<Format>]]

{im | install-manifest} <Manifest> Instala publicadores de eventos y registros desde un


[/{rf | resourceFilePath}:value] manifiesto. Para más información sobre los manifiestos de
[/{mf | messageFilePath}:value] eventos y el uso de este parámetro, consulte el SDK de
[/{pf | parameterFilePath}:value] registro de eventos de Windows en el sitio web de
Microsoft Developers Network (MSDN)
(https://msdn.microsoft.com). El valor es la ruta de acceso
completa al archivo mencionado.

{um | uninstall-manifest} Desinstala todos los publicadores y registros de un


<Manifest> manifiesto. Para más información sobre los manifiestos de
eventos y el uso de este parámetro, consulte el SDK de
registro de eventos de Windows en el sitio web de
Microsoft Developers Network (MSDN)
(https://msdn.microsoft.com).

{qe | query-events} <Path> [/lf: Lee eventos de un registro de eventos, de un archivo de


<Logfile>] [/sq:<Structquery>] [/q: registro o mediante una consulta estructurada. De forma
<Query>] [/bm:<Bookmark>] predeterminada, se proporciona un nombre de registro
[/sbm:<Savebm>] [/rd: para <Path>. Sin embargo, si usa la opción /lf, <Path> debe
<Direction>] [/f:<Format>] [/l: ser una ruta de acceso a un archivo de registro. Si usa el
<Locale>] [/c:<Count>] [/e: parámetro /sq, <Path> debe ser una ruta de acceso a un
<Element>] archivo que contenga una consulta estructurada.

{gli | get-loginfo} <Logname> [/lf: Muestra información de estado sobre un registro de


<Logfile>] eventos o un archivo de registro. Si se usa la opción /lf,
<Logname> es una ruta de acceso a un archivo de registro.
Puede ejecutar wevtutil el para obtener una lista de
nombres de registro.

{epl | export-log} <Path> Exporta eventos desde un registro de eventos, desde un


<Exportfile> [/lf:<Logfile>] [/sq: archivo de registro o mediante una consulta estructurada al
<Structquery>] [/q:<Query>] [/ow: archivo especificado. De forma predeterminada, se
<Overwrite>] proporciona un nombre de registro para <Path>. Sin
embargo, si usa la opción /lf, <Path> debe ser una ruta de
acceso a un archivo de registro. Si usa la opción /sq,
<Path> debe ser una ruta de acceso a un archivo que
contenga una consulta estructurada. <Exportfile> es una
ruta de acceso al archivo donde se almacenarán los eventos
exportados.
Parámetro Descripción

{al | archive-log} <Logpath> [/l: Guarda el archivo de registro especificado en un formato


<Locale>] independiente. Se crea un subdirectorio con el nombre de
la configuración regional y toda la información específica
de la configuración regional se guarda en ese subdirectorio.
Después de crear el directorio y el archivo de registro
mediante la ejecución de wevtutil al, los eventos del
archivo se pueden leer si el publicador está instalado o no.

{cl | clear-log} <Logname> [/bu: Borra los eventos del registro de eventos especificado. Se
<Backup>] puede usar la opción /bu para hacer una copia de
seguridad de los eventos borrados.

Opciones
Opción Descripción

/f:<Format> Especifica que la salida debe ser XML o un formato de texto. Si <Format> es
XML, la salida se muestra en formato XML. Si <Format> es Text, la salida se
muestra sin etiquetas XML. El valor predeterminado es texto.

/e:<Enabled> Habilita o deshabilita un registro. <Enabled> puede ser true o false.

/i:<Isolation> Establece el modo de aislamiento de registro. <Isolation> puede ser sistema,


aplicación o personalizado. El modo de aislamiento de un registro determina si
un registro comparte una sesión con otros registros en la misma clase de
aislamiento. Si especifica el aislamiento del sistema, el registro de destino
compartirá al menos permisos de escritura con el registro del sistema. Si
especifica el aislamiento de la aplicación, el registro de destino compartirá al
menos permisos de escritura con el registro de aplicaciones. Si especifica
aislamiento personalizado, también debe proporcionar un descriptor de
seguridad mediante la opción /ca.

/lfn: Define el nombre del archivo de registro. <Logpath> es una ruta de acceso
<Logpath> completa al archivo donde el servicio de registro de eventos almacena los
eventos de este registro.

/rt: Establece el modo de retención del registro. <Retention> puede ser true o false.
<Retention> El modo de retención del registro determina el comportamiento del servicio de
registro de eventos cuando un registro alcanza su tamaño máximo. Si un
registro de eventos alcanza su tamaño máximo y el modo de retención del
registro es true, se conservan los eventos existentes y se descartan los eventos
entrantes. Si el modo de retención del registro es false, los eventos entrantes
sobrescriben los eventos más antiguos del registro.

/ab:<Auto> Especifica la directiva de copia de seguridad automática del registro. <Auto>


puede ser true o false. Si este valor es true, se realizará una copia de seguridad
del registro automáticamente cuando alcance el tamaño máximo. Si este valor
Opción Descripción

es true, la retención (especificada con la opción /rt) también debe establecerse


en true.

/ms: Tamaño máximo del archivo de registro en bytes. El tamaño mínimo del registro
<MaxSize> es 1048576 bytes (1024 KB) y los archivos de registro siempre son múltiplos de
64 KB, por lo que el valor que escriba se redondeará según corresponda.

/l:<Level> Define el filtro de nivel del registro. <Level> puede ser cualquier valor de nivel
válido. Esta opción solo se aplica a los registros con una sesión dedicada. Puede
quitar un filtro de nivel estableciendo <Level> en 0.

/k: Especifica el filtro de palabras clave del registro. <Keywords> puede ser
<Keywords> cualquier máscara de palabra clave de 64 bits válida. Esta opción solo se aplica a
los registros con una sesión dedicada.

/ca:<Channel> Establece el permiso de acceso para un registro de eventos. <Channel> es un


descriptor de seguridad que usa el lenguaje de definición de descriptor de
seguridad (SDDL). Para más información sobre el formato SDDL, consulte el sitio
web de Microsoft Developers Network (MSDN) (https://msdn.microsoft.com).

/c:<Config> Especifica la ruta de acceso a un archivo de configuración. Esta opción hará que
las propiedades del registro se lean desde el archivo de configuración definido
en <Config>. Si usa esta opción, no debe especificar un parámetro <Logname>.
El nombre del registro se leerá del archivo de configuración.

/ge: Obtiene información de metadatos para los eventos que puede generar este
<Metadata> publicador. <Metadata> puede ser true o false.

/gm: Muestra el mensaje real en lugar del identificador de mensaje numérico.


<Message> <Message> puede ser true o false.

/lf:<Logfile> Especifica que los eventos se deben leer de un registro o de un archivo de


registro. <Logfile> puede ser true o false. Si es true, el parámetro para el
comando es la ruta de acceso a un archivo de registro.

/sq: Especifica que los eventos se deben obtener con una consulta estructurada.
<Structquery> <Structquery> puede ser true o false. Si es true, <Path> es la ruta de acceso a
un archivo que contiene una consulta estructurada.

/q:<Query> Define la consulta XPath para filtrar los eventos que se leen o exportan. Si no se
especifica esta opción, se devolverán o exportarán todos los eventos. Esta
opción no está disponible cuando /sq es true.

/bm: Especifica la ruta de acceso a un archivo que contiene un marcador de una


<Bookmark> consulta anterior.

/sbm: Especifica la ruta de acceso a un archivo que se usa para guardar un marcador
<Savebm> de esta consulta. La extensión de nombre de archivo debe ser .xml.
Opción Descripción

/rd: Especifica la dirección en la que se leen los eventos. <Direction> puede ser true
<Direction> o false. Si es true, primero se devuelven los eventos más recientes.

/l:<Locale> Define una cadena de configuración regional que se usa para imprimir el texto
del evento en una configuración regional específica. Solo está disponible al
imprimir eventos en formato de texto mediante la opción /f.

/c:<Count> Establece el número máximo de eventos que se van a leer.

/e:<Element> Incluye un elemento raíz al mostrar eventos en XML. <Element> es la cadena


que desea dentro del elemento raíz. Por ejemplo, /e:root daría como resultado
XML que contiene la <raíz> del par de elementos raíz.

/ow: Especifica que se debe sobrescribir el archivo de exportación. <Overwrite>


<Overwrite> puede ser true o false. Si es true y el archivo de exportación especificado en
<Exportfile> ya existe, se sobrescribirá sin confirmación.

/bu:<Backup> Especifica la ruta de acceso a un archivo donde se almacenarán los eventos


borrados. Incluya la extensión .evtx en el nombre del archivo de copia de
seguridad.

/r:<Remote> Ejecuta el comando en un equipo remoto. <Remote> es el nombre del equipo


remoto. Los parámetros im y um no admiten la operación remota.

/u: Especifica un usuario diferente para iniciar sesión en un equipo remoto.


<Username> <Username> es el nombre de usuario de forma dominio\usuario o usuario. Esta
opción solo es válida cuando se especifica la opción /r.

/p: Especifica la contraseña del usuario. Si se usa la opción /u y esta opción no se


<Password> especifica o <Password> es *, se pedirá al usuario que escriba una contraseña.
Esta opción solo es válida cuando se especifica la opción /u.

/a:<Auth> Define el tipo de autenticación para conectarse a un equipo remoto. <Auth>


puede ser Default, Negotiate, Kerberos o NTLM. El valor predeterminado es
Negotiate.

/uni: Muestra la salida en Unicode. <Unicode> puede ser true o false. Si <Unicode>
<Unicode> es true, la salida se encuentra en Unicode.

Comentarios
Uso de un archivo de configuración con el parámetro sl

El archivo de configuración es un archivo XML con el mismo formato que la salida


de wevtutil gl <Logname> /f:xml. Para mostrar el formato de un archivo de
configuración que habilita la retención, habilita la copia de seguridad automática y
establece el tamaño máximo del registro en el registro de aplicación:
<?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>

Ejemplos
Enumere los nombres de todos los registros:

wevtutil el

Muestra información de configuración sobre el registro del sistema en el equipo local en


formato XML:

wevtutil gl System /f:xml

Use un archivo de configuración para establecer atributos de registro de eventos


(consulte los comentarios para obtener un ejemplo de un archivo de configuración):

wevtutil sl /c:config.xml

Muestra información sobre el publicador de eventos Microsoft-Windows-Eventlog,


incluidos los metadatos sobre los eventos que el publicador puede generar:

wevtutil gp Microsoft-Windows-Eventlog /ge:true

Instale publicadores y registros desde el archivo de manifiesto de myManifest.xml:


wevtutil im myManifest.xml

Desinstale publicadores y registros del archivo de manifiesto de myManifest.xml:

wevtutil um myManifest.xml

Muestre los tres eventos más recientes del registro de aplicación en formato de texto:

wevtutil qe Application /c:3 /rd:true /f:text

Muestre el estado del registro de aplicación:

wevtutil gli Application

Exporte los eventos del registro del sistema a C:\backup\system0506.evtx:

wevtutil epl System C:\backup\system0506.evtx

Borre todos los eventos del registro de aplicaciones después de guardarlos en


C:\admin\backups\a10306.evtx:

wevtutil cl Application /bu:C:\admin\backups\a10306.evtx

Archive el archivo de registro especificado (.evtx) en un formato independiente. Se crea


un subdirectorio (LocaleMetaData) y toda la información específica de la configuración
regional se guarda en ese subdirectorio:

wevtutil archive-log "C:\backup\Application.evtx" /locale:en-us


Vínculos relacionados
Clave de sintaxis de línea de comandos
, donde
Artículo • 14/04/2023

Muestra la ubicación de los archivos que coinciden con el patrón de búsqueda


especificado.

Sintaxis

where [/r <Dir>] [/q] [/f] [/t] [$<ENV>:|<Path>:]<Pattern>[ ...]

Parámetros

Parámetro Descripción

/r <Dir> Indica una búsqueda recursiva, empezando por el directorio especificado.

/q Devuelve un código de salida (0 si se ha realizado correctamente, 1 si se produce un


error) sin mostrar la lista de archivos coincidentes.

/f Muestra los resultados del comando where entre comillas.

/t Muestra el tamaño del archivo y la fecha y hora de la última modificación de cada


archivo coincidente.

[$<ENV>:| Especifica el patrón de búsqueda para que coincidan los archivos. Se requiere al
<Path>:] menos un patrón y el patrón puede incluir caracteres comodín (* y ?). De forma
<Pattern>[ predeterminada, where busca en el directorio actual y las rutas de acceso
...] especificadas en la variable de entorno PATH. Puede especificar una ruta de acceso
diferente para buscar mediante el formato $ENV:Pattern (donde ENV es una variable
de entorno existente que contiene una o varias rutas de acceso) o mediante el
formato Path:Pattern (donde Path es la ruta de acceso del directorio que desea
buscar). Estos formatos opcionales no se deben usar con la opción de línea de
comandos /r.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si no especifica una extensión de nombre de archivo, las extensiones enumeradas
en la variable de entorno PATHEXT se anexan al patrón de forma predeterminada.
Where puede ejecutar búsquedas recursivas, mostrar información de archivo,
como fecha o tamaño, y aceptar variables de entorno en lugar de rutas de acceso
en equipos locales.

Ejemplos
Para buscar todos los archivos denominados Test in drive C del equipo actual y sus
subdirectorios, escriba:

where /r c:\ test

Para enumerar todos los archivos del directorio público, escriba:

where $public:*.*

Para buscar todos los archivos denominados Bloc de notas en la unidad C del equipo
remoto, Computer1 y sus subdirectorios, escriba:

where /r \\computer1\c notepad.*

Vínculos relacionados
Clave de sintaxis de línea de comandos
whoami
Artículo • 08/04/2023

Muestra información del usuario, el grupo y los privilegios del usuario que tiene una
sesión iniciada actualmente en el sistema local. Si se usa sin parámetros, whoami
muestra el nombre de usuario y el dominio actuales.

Sintaxis

whoami [/upn | /fqdn | /logonid]


whoami {[/user] [/groups] [/priv]} [/fo <Format>] [/nh]
whoami /all [/fo <Format>] [/nh]

Parámetros

Parámetro Descripción

/upn Muestra el nombre de usuario en formato de nombre de entidad de seguridad del


usuario (UPN).

/fqdn Muestra el nombre de usuario en formato de nombre de dominio completo (FQDN).

/logonid Muestra el identificador de inicio de sesión del usuario actual.

/user Muestra el dominio y el nombre de usuario actuales y el identificador de seguridad


(SID).

/groups Muestra los grupos de usuarios a los que pertenece el usuario actual.

/priv Muestra los privilegios de seguridad del usuario actual.

/fo Especifica el formato de salida. Los valores válidos incluyen:


<Format> table Muestra la salida en una tabla. Este es el valor predeterminado.
list Muestra la salida en una lista.
csv Muestra la salida en formato de valores separados por comas (CSV).

/all Muestra toda la información del token de acceso actual, incluidos el nombre de
usuario actual, los identificadores de seguridad (SID), los privilegios y los grupos a
los que pertenece el usuario actual.

/nh Especifica que el encabezado de columna no debe mostrarse en la salida. Esto solo
es válido para formatos de tabla y CSV.
Parámetro Descripción

/? Muestra la ayuda en el símbolo del sistema.

Ejemplos
Para mostrar el dominio y el nombre de usuario de la persona que ha iniciado sesión
actualmente en este equipo, escriba:

whoami

Verá un resultado similar al siguiente:

DOMAIN1\administrator

Para mostrar toda la información en el token de acceso actual, escriba:

whoami /all

Vínculos relacionados
Clave de sintaxis de línea de comandos
winnt
Artículo • 10/05/2023

Se aplica a: Windows Server (todas las versiones compatibles)

El comando winnt está en desuso y es posible que no se admita en futuras versiones de


Windows.

Esta herramienta está incluida en Windows Server 2003. Para más información, consulte
Winnt.
winnt32
Artículo • 14/04/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

Realiza una instalación o actualización a un producto en Windows Server 2003. Puede


ejecutar winnt32 en el símbolo del sistema en un equipo que ejecute Windows 95,
Windows 98, Windows Millennium Edition, Windows NT, Windows 2000, Windows XP o
un producto en Windows Server 2003. Si ejecuta winnt32 en un equipo que ejecuta
Windows NT versión 4.0, primero debe aplicar Service Pack 5 o posterior.

Sintaxis

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 Descripción

/checkupgradeonly Comprueba la compatibilidad de actualización del equipo con productos de


Windows Server 2003.
Si usa esta opción con /unattend, no se requiere ninguna entrada de
usuario. De lo contrario, los resultados se muestran en la pantalla y puede
guardarlos en el nombre de archivo que especifique. El nombre de archivo
predeterminado es upgrade.txt en la carpeta systemroot.

/cmd Indica a la instalación que lleve a cabo un comando específico antes de la


fase final de la instalación. Esto ocurre después de que el equipo se haya
reiniciado y después de que el programa de instalación haya recopilado la
información de configuración necesaria, pero antes de que se complete la
instalación.

<CommandLine> Especifica la línea de comandos que se va a llevar a cabo antes de la fase


final de la instalación.
Parámetro Descripción

/cmdcons En un equipo basado en x86, instala la consola de recuperación como


opción de inicio. La consola de recuperación es una interfaz de línea de
comandos desde la que puede realizar tareas como iniciar y detener
servicios y acceder a la unidad local (incluidas las unidades con formato
NTFS). Solo puede usar la opción /cmdcons una vez finalizada la instalación.

/copydir Crea una carpeta adicional dentro de la carpeta en la que se instalan los
archivos del sistema operativo. Por ejemplo, para equipos basados en x86 y
x64, podría crear una carpeta denominada Private_drivers dentro de la
carpeta de origen de i386 para la instalación y colocar los archivos de
controlador en la carpeta. Escriba /copydir:i386\Private_drivers para que el
programa de instalación copie esa carpeta en el equipo recién instalado, lo
que hace que la nueva ubicación de carpeta sea systemroot\Private_drivers.

- i386 especifica i386


- ia64 especifica ia64

Puede usar /copydir para crear tantas carpetas adicionales como desee.

<FolderName> Especifica la carpeta que creó para que contenga modificaciones de su sitio.

/copysource Crea una carpeta adicional temporal dentro de la carpeta en la que se


instalan los archivos del sistema operativo. Puede usar /copysource para
crear tantas carpetas adicionales como desee.

A diferencia de las carpetas que crea /copydir, las carpetas /copysource se


eliminan una vez completada la instalación.

/debug Crea un registro de depuración en el nivel especificado, por ejemplo,


/debug4:Debug.log. El archivo de registro predeterminado es C:\
systemroot\winnt32.log y

<level> Valores y descripciones de nivel


- 0: Errores graves
- 1: Errores
- 2: Nivel predeterminado. Advertencias
- 3: Información
- 4: Información detallada para la depuración

Cada nivel incluye los niveles inferiores.

/dudisable Impide que se ejecute la actualización dinámica. Sin actualización dinámica,


el programa de instalación solo se ejecuta con los archivos de instalación
originales. Esta opción deshabilitará la actualización dinámica incluso si usa
un archivo de respuesta y especifica las opciones de actualización dinámica
en ese archivo.
Parámetro Descripción

/duprepare Lleva a cabo preparativos en un recurso compartido de instalación para que


se pueda usar con archivos de actualización dinámica que descargó del sitio
web de Windows Update. A continuación, este recurso compartido se
puede usar para instalar Windows XP para varios clientes.

<pathName> Especifica el nombre de ruta de acceso completa.

/dushare Especifica un recurso compartido en el que descargó previamente los


archivos de actualización dinámica (archivos actualizados para su uso con el
programa de instalación) del sitio web de Windows Update y en el que
ejecutó previamente /duprepare:< pathName>. Cuando se ejecuta en un
cliente, especifica que la instalación del cliente usará los archivos
actualizados en el recurso compartido especificado en <pathName>.

/emsport Habilita o deshabilita los servicios de administración de emergencia durante


la instalación y una vez instalado el sistema operativo del servidor. Con los
servicios de administración de emergencia, puede administrar de forma
remota un servidor en situaciones de emergencia que normalmente
requerirían un teclado local, un ratón y un monitor, como cuando la red no
está disponible o el servidor no funciona correctamente. Los servicios de
administración de emergencia tienen requisitos de hardware específicos y
solo están disponibles para productos en Windows Server 2003.
- com1 solo es aplicable para equipos basados en x86 (no en equipos
basados en arquitectura Itanium).
- com2 solo es aplicable para equipos basados en x86 (no en equipos
basados en arquitectura Itanium).
- Default. Usa la configuración especificada en la tabla Redirección de la
consola de puerto serie (SPCR) del BIOS o, en sistemas basados en
arquitectura Itanium, a través de la ruta de acceso del dispositivo de la
consola EFI. Si especifica usebiossettings y no hay ninguna tabla SPCR o
ruta de acceso de dispositivo de consola EFI adecuada, no se habilitarán los
Servicios de administración de emergencia.
- off deshabilita los Servicios de administración de emergencia. Más
adelante puede habilitarlos modificando la configuración de arranque.

/emsbaudrate Para equipos basados en x86, especifica la velocidad de baudios para los
Servicios de administración de emergencias. (La opción no es aplicable a los
equipos basados en arquitectura de Itanium). Debe usarse con
/emsport:com1 o /emsport:com2 (de lo contrario, se omite /emsbaudrate).

<BaudRate> Especifica la velocidad en baudios de 9600, 19200, 57600 o 115200. 9600 es


el valor predeterminado.

/m Especifica que el programa de instalación copia los archivos de reemplazo


desde una ubicación alternativa. Indica al programa de instalación que
busque primero en la ubicación alternativa y, si los archivos se encuentran
en dicha ubicación, que los use en lugar de los de la ubicación
predeterminada.
Parámetro Descripción

/makelocalsource Indica al programa de instalación que copie todos los archivos de origen de
instalación en el disco duro local. Use /makelocalsource si realiza la
instalación desde un CD para proporcionar archivos de instalación cuando
el CD no esté disponible más adelante en la instalación.

/noreboot Indica al programa de instalación que no reinicie el equipo una vez


completada la fase de copia de archivos de instalación para que pueda
ejecutar otro comando.

/s Especifica la ubicación de origen de los archivos para la instalación. Para


copiar archivos simultáneamente desde varios servidores, escriba la opción
/s:<Sourcepath> varias veces (hasta un máximo de ocho). Si escribe la
opción varias veces, el primer servidor especificado debe estar disponible o
se producirá un error en la instalación.

<Sourcepath> Especifica el nombre de ruta de acceso de origen completo.

/syspart En un equipo basado en x86, especifica que puede copiar los archivos de
inicio del programa de instalación en un disco duro, marcar el disco como
activo y, a continuación, instalar el disco en otro equipo. Al iniciar ese
equipo, se inicia automáticamente con la siguiente fase de instalación.
Siempre debe usar el parámetro /tempdrive con el parámetro /syspart.

Puedes iniciar winnt32 con la opción /syspart en un equipo basado en x86


que ejecute Windows NT 4.0, Windows 2000, Windows XP o un producto en
Windows Server 2003. Si el equipo ejecuta la versión 4.0 de Windows NT,
requiere Service Pack 5 o posterior. El equipo no puede ejecutar Windows
95, Windows 98 o Windows Millennium Edition.

<DriveLetter> Especifica la letra de unidad.

/tempdrive Dirige la instalación para ubicar los archivos temporales en la partición


especificada.
Para una nueva instalación, el sistema operativo del servidor también se
instalará en la partición especificada.

Para una actualización, la opción /tempdrive afecta solo a la colocación de


archivos temporales; el sistema operativo se actualizará en la partición
desde la que se ejecuta winnt32.

/udf Indica un identificador (<ID>) que usa el programa de instalación para


especificar cómo un archivo de base de datos de exclusividad (UDB)
modifica un archivo de respuesta (vea la opción /unattend). La UDB invalida
los valores del archivo de respuesta y el identificador determina qué valores
se usan en el archivo UDB. Por ejemplo, /udf:RAS_user,Our_company.udb
invalida la configuración especificada para el identificador de RAS_user en el
archivo Our_company.udb. Si no se especifica ningún <UDB_file>, el
programa de instalación solicita al usuario que inserte un disco que
contenga el archivo $Unique$.udb.
Parámetro Descripción

<Id> Indica un identificador usado para especificar cómo un archivo de base de


datos de exclusividad (UDB) modifica un archivo de respuesta.

<UDB_file> Especifica un archivo de base de datos de exclusividad (UDB).

/unattend En un equipo basado en x86, actualiza la versión anterior de Windows NT


4.0 Server (con Service Pack 5 o posterior) o Windows 2000 en modo de
instalación desatendida. Todos los valores de configuración del usuario se
heredan de la instalación anterior, de forma que no es necesaria una
intervención por parte del usuario durante la instalación.

<num> Especifica el número de segundos entre el momento en que el programa de


instalación finaliza la copia de los archivos y cuando reinicia el equipo.
Puede usar <Num> en cualquier equipo que ejecute Windows 98, Windows
Millennium Edition, Windows NT, Windows 2000, Windows XP o un
producto en Windows Server 2003. Si el equipo ejecuta la versión 4.0 de
Windows NT, requiere Service Pack 5 o posterior.

<AnswerFile> Proporciona la configuración con las especificaciones personalizadas.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Si va a implementar Windows XP en equipos cliente, puede usar la versión de
winnt32.exe que viene con Windows XP. Otra manera de implementar Windows XP es
usar winnt32.msi, que funciona a través de Windows Installer, parte del conjunto de
tecnologías IntelliMirror. Para obtener más información sobre las implementaciones de
cliente, consulte el kit de implementación de Windows Server 2003, que se describe en
Uso de los kits de implementación y recursos de Windows.

En un equipo basado en Itanium, winnt32 se puede ejecutar desde la Extensible


Firmware Interface (EFI) o desde Windows Server 2003 Enterprise, Windows Server 2003
R2 Enterprise, Windows Server 2003 R2 Datacenter o Windows Server 2003 Datacenter.
Además, en un equipo basado en arquitectura Itanium, /cmdcons y /syspart no están
disponibles y las opciones relacionadas con las actualizaciones no están disponibles.
Para obtener más información sobre la compatibilidad de hardware, consulte
Compatibilidad de hardware. Para obtener información más detallada sobre el uso de la
actualización dinámica y la instalación de varios clientes, consulte el kit de
implementación de Windows Server 2003, que se describe en Uso de los kits de
implementación y recursos de Windows. Para obtener información sobre cómo
modificar la configuración de arranque, consulte los kits de implementación y recursos
de Windows para Windows Server 2003. Para obtener más información, consulte Uso de
los kits de implementación y recursos de Windows. El uso de la opción de línea de
comandos /unattend para automatizar la configuración afirma que ha leído y aceptado
el contrato de licencia de Microsoft para Windows Server 2003. Antes de usar esta
opción de línea de comandos para instalar Windows Server 2003 en nombre de una
organización distinta de la suya, debe confirmar que el usuario final (ya sea una persona
o una sola entidad) ha recibido, leído y aceptado los términos del contrato de licencia
de Microsoft para ese producto. Es posible que los OEM no especifiquen esta clave en
las máquinas que se venden a los usuarios finales.

Vínculos relacionados
Clave de sintaxis de línea de comandos
winrs
Artículo • 06/10/2023

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016,
Windows Server 2012 R2 y Windows Server 2012.

El uso del comando winrs en Administración remota de Windows permite administrar y


ejecutar programas de forma remota.

Sintaxis

winrs [/<parameter>[:<value>]] <command>

Parámetros
Parámetro Descripción

/remote: Especifica el punto de conexión de destino mediante un nombre NetBIOS o


<endpoint> la conexión estándar:
- <url>: [<transport>://]<target>[:<port>]

Si no se especifica, se usa /r:localhost.

/unencrypted Especifica que los mensajes que se envían al shell remoto no se cifran. Este
parámetro resulta útil para solucionar problemas o cuando el tráfico de red
ya está cifrado mediante ipsec o cuando se aplica la seguridad física.

De forma predeterminada, los mensajes se cifran mediante claves Kerberos


o NTLM.

Esta opción de línea de comandos se omite cuando se selecciona


transporte HTTPS.

/username: Especifica el nombre de usuario en la línea de comandos.


<username> Si no se especifica, la herramienta usa la autenticación Negotiate o solicita
el nombre.

Si se especifica /username, también se debe especificar /password.

/password: Especifica la contraseña en la línea de comandos.


<contraseña> Si no se especifica /password, pero /username sí, la herramienta solicita la
contraseña.
Parámetro Descripción

Si se especifica /password, también se debe especificar /username.

/timeout: Esta opción está en desuso.


<segundos>

/directory:<path> Especifica el directorio inicial para el shell remoto.


Si no se especifica, el shell remoto se inicia en el directorio principal del
usuario definido por la variable de entorno %USERPROFILE%.

/environment: Especifica una única variable de entorno que se va a establecer cuando se


<string>=<value> inicia el shell, lo que permite cambiar el entorno predeterminado para shell.
Se deben usar varias repeticiones de este modificador para especificar
varias variables de entorno.

/noecho Especifica que se debe deshabilitar el echo. Es posible que noecho sea
necesario para tener la certeza de que las respuestas del usuario a las
indicaciones remotas no se muestran localmente.
De forma predeterminada, echo está activado.

/noprofile Especifica que el perfil del usuario no debe cargarse.


De forma predeterminada, el servidor intenta cargar el perfil de usuario.

Si el usuario remoto no es un administrador local en el sistema de destino,


esta opción es obligatoria (el valor predeterminado genera un error).

/allowdelegate Especifica que las credenciales del usuario se pueden usar para acceder a
un recurso compartido remoto, por ejemplo, a una máquina diferente a la
del punto de conexión de destino.

/compression Active la compresión. Es posible que las instalaciones anteriores en


máquinas remotas no admitan la compresión.
La configuración predeterminada está desactivada, ya que es posible que
las instalaciones anteriores en máquinas remotas no admitan la
compresión.

/usessl Use una conexión SSL al usar un punto de conexión remoto. Especificando
SSL, en lugar del https: de transporte se usa el puerto predeterminado de
WinRM.

/? Muestra la ayuda en el símbolo del sistema.

Comentarios
Todas las opciones de línea de comandos aceptan formato corto o largo. Por
ejemplo, tanto /r como /remote son válidos.
Para finalizar el comando /remote, el usuario puede escribir Ctrl-C o Ctrl-break,
que se envía al shell remoto. El segundo Ctrl-C fuerza la terminación de winrs.exe.
Para administrar la configuración activa de shells remotos o winrs, use la
herramienta WinRM. El alias de URI para administrar shells activos es shell/cmd. El
alias de URI para la configuración de winrs es winrm/config/winrs.

Ejemplos

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

Vínculos relacionados
Clave de sintaxis de línea de comandos
winsat mem
Artículo • 06/10/2023

Se aplica a: Windows Server (todas las versiones compatibles)

El comando winsat mem prueba el ancho de banda de la memoria del sistema mediante
un proceso similar al de las copias del búfer de memoria a memoria de gran tamaño en
el procesamiento multimedia.

Sintaxis
CLI

winsat mem <parameters>

Parámetros

Parámetro Descripción

-up Forzar pruebas de memoria con solo un subproceso. El valor predeterminado es


ejecutar un subproceso por CPU física o núcleo.

-rn Especificar que los subprocesos de la evaluación deben ejecutarse con prioridad
normal. El valor predeterminado es ejecutarse con prioridad 15.

-nc Especifique que la evaluación debe asignar memoria y marcarla como no


almacenada en caché. Esta marca significa que las memorias caché del procesador
se omiten para las operaciones de copia. El valor predeterminado es ejecutarse en
el espacio almacenado en caché.

-do <n> Especifique la distancia, en bytes, entre el final del búfer de origen y el principio del
búfer de destino. El valor predeterminado es 64 bytes. El desplazamiento de
destino máximo permitido es de 16 MB. Si se especifica un desplazamiento de
destino no válido se produce un error.
Nota: El cero es un valor válido para <n> , pero los números negativos no lo son.

-mint <n> Especificar el tiempo mínimo de ejecución en segundos para la evaluación. El valor
predeterminado es 2.0. El valor mínimo es 1.0. El valor máximo es 30.0.
Nota: Si se especifica un valor -mint mayor que el valor -maxt cuando se usan los
dos parámetros en combinación, se produce un error.

-maxt <n> Especificar el tiempo máximo de ejecución en segundos para la evaluación. El valor
predeterminado es 5.0. El valor mínimo es 1.0. El valor máximo es 30.0. Si se usa en
combinación con el parámetro -mint , la evaluación comenzará a hacer
comprobaciones estadísticas periódicas de sus resultados tras el periodo de tiempo
Parámetro Descripción

especificado en -mint . Si se superan las comprobaciones estadísticas, la evaluación


termina antes de que haya transcurrido el periodo de tiempo especificado en -
maxt . Si la evaluación se ejecuta durante el periodo de tiempo especificado en -
maxt sin satisfacer las comprobaciones estadísticas, la evaluación finaliza en ese
momento y devuelve los resultados que haya recogido.

- Especificar el tamaño del búfer que debe usar la prueba de copia de memoria. Se
buffersize asigna el doble de esta cantidad por CPU, lo que determina la cantidad de datos
<n> copiados de un búfer a otro. El valor predeterminado es 16 MB. Este valor se
redondea al límite de 4 KB más cercano. El valor máximo es 32 MB. El valor mínimo
es de 4 KB. Si se especifica un tamaño de búfer no válido, se produce un error.

-v Enviar salida detallada a STDOUT, incluyendo información sobre el estado y el


progreso. Los errores también se escriben en la ventana de comandos.

-xml <file Guardar el resultado de la evaluación como el archivo XML especificado. Si el


name> archivo especificado existe, se sobrescribirá.

-idiskinfo Guardar la información sobre los volúmenes físicos y los discos lógicos como parte
de la sección <SystemConfig> de la salida XML.

-iguid Crear un identificador único global (GUID) en el archivo de salida XML.

-note Agregar el texto de la nota a la sección <note text> del archivo de salida XML.
<note
text>

-icn Incluir el nombre del equipo local en el archivo de salida XML.

-eef Enumere la información adicional del sistema en el archivo de salida XML.

Ejemplos
Para ejecutar la evaluación durante un mínimo de 4 segundos y un máximo de
12 segundos, usando un tamaño de búfer de 32 MB y guardando los resultados en
formato XML en el archivo memtest.xml :

CLI

winsat mem -mint 4.0 -maxt 12.0 -buffersize 32MB -xml memtest.xml

Comentarios
El requisito mínimo para usar el comando winsat mem es pertenecer al grupo local
de Administradores (o uno equivalente). Winsat mem debe ejecutarse desde una
ventana de símbolo del sistema con privilegios elevados.
Para abrir una ventana de símbolo del sistema con privilegios elevados, seleccione
Inicio, seleccione Accesorios, seleccione con el botón derecho en Símbolo del
sistema y, finalmente, seleccione Ejecutar como administrador.
winsat mfmedia
Artículo • 12/04/2023

Mide el rendimiento de la descodificación de vídeo (reproducción) mediante el marco


de Media Foundation.

Sintaxis

winsat mfmedia <parameters>

Parámetros

Parámetros Descripción

-input <file Obligatorio: especifique el archivo que contiene el clip de vídeo que se va a
name> reproducir o codificar. El archivo puede estar en cualquier formato que Media
Foundation pueda representar.

- Especifique que el gráfico de filtro se debe guardar en un archivo compatible con


dumpgraph GraphEdit antes de que se inicie la evaluación.

-ns Especifique que el gráfico de filtro debe ejecutarse con la velocidad de


reproducción normal del archivo de entrada. De forma predeterminada, el gráfico
de filtros se ejecuta lo más rápido posible, ignorando los tiempos de presentación.

-play Ejecute la evaluación en modo de descodificación y reproduzca el contenido de


audio proporcionado en el archivo especificado en -input mediante el dispositivo
DirectSound predeterminado. De forma predeterminada, la reproducción de audio
está deshabilitada.

-nopmp No use el proceso de canalización de medios protegidos (MFPMP) de Media


Foundation durante la evaluación.

-pmp Use siempre el proceso MFPMP durante la evaluación.


Nota: Si no se especifica -pmp o -nopmp, MFPMP solo se usará cuando sea
necesario.

-v Enviar salida detallada a STDOUT, incluyendo información sobre el estado y el


progreso. Los errores también se escribirán en la ventana de comandos.
Parámetros Descripción

-xml Guardar el resultado de la evaluación como el archivo XML especificado. Si el


<nombre archivo especificado existe, se sobrescribirá.
del
archivo>

-idiskinfo Guardar la información sobre los volúmenes físicos y los discos lógicos como parte
de la sección <SystemConfig> de la salida XML.

-iguid Crear un identificador único global (GUID) en el archivo de salida XML.

-note note Agregar el texto de la nota a la sección <nota> del archivo de salida XML.
text

-icn Incluir el nombre del equipo local en el archivo de salida XML.

-eef Enumere la información adicional del sistema en el archivo de salida XML.

Ejemplos
Para ejecutar la evaluación con el archivo de entrada que se usa durante una
evaluación formal de winsat, sin emplear la canalización de medios protegidos
(MFPMP) de Media Foundation, en un equipo donde c:\windows es la ubicación de
la carpeta Windows.

winsat mfmedia -input c:\windows\performance\winsat\winsat.wmv -nopmp

Comentarios
La pertenencia al grupo local de Administradores, o equivalente, es el mínimo
requerido para usar winsat. El comando debe ejecutarse desde una ventana de
símbolo del sistema con privilegios elevados.
Para abrir una ventana de símbolo del sistema con privilegios elevados, haga clic
en Inicio, haga clic en Accesorios, haga clic con el botón derecho en Símbolo del
sistema y haga clic en Ejecutar como administrador.

Vínculos relacionados
wmic
Artículo • 14/04/2023

Muestra información de WMI dentro de un shell de comandos interactivo.

) Importante

La utilidad de la línea de comandos de WMI (WMIC) está en desuso a partir de


Windows 10, versión 21H1 y a partir de la versión de canal semianual de 21H1 de
Windows Server. Esta utilidad se sustituye por Windows PowerShell para WMI
(consulte Capítulo 7: Trabajo con WMI). Este desuso solo se aplica a la utilidad de
la línea de comandos de WMI (WMIC); la propia extensión Instrumental de
administración de Windows (WMI) no se ve afectada. Consulte también
Características de Windows 10 que ya no desarrollaremos.

Sintaxis
Símbolo del sistema de Windows

wmic </parameter>

Subcomandos
Están disponibles los siguientes subcomandos:

Subcomando Descripción

clase Escapa del modo de alias predeterminado de WMIC para acceder a las clases del
esquema de WMI directamente.

path Escapa del modo de alias predeterminado de WMIC para acceder a las instancias
del esquema de WMI directamente.

context Muestra los valores actuales de todos los conmutadores globales.

[quit | exit] Sale del shell de comandos de WMIC.

Ejemplos
Para mostrar los valores actuales de todos los modificadores globales, escriba:
Símbolo del sistema de Windows

wmic context

Esto genera una salida similar a las siguientes visualizaciones:

Símbolo del sistema de 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 cambiar el id. de idioma usado por la línea de comandos a inglés (id. de
configuración regional 409), escriba:

Símbolo del sistema de Windows

wmic /locale:ms_409

Vínculos relacionados
Clave de sintaxis de línea de comandos
escritor
Artículo • 08/04/2023

Comprueba que se incluye un escritor o componente o excluye un escritor o


componente del procedimiento de copia de seguridad o restauración. Si se usa sin
parámetros, writer muestra la ayuda en el símbolo del sistema.

Sintaxis

writer verify [writer> | <component>]


writer exclude [<writer> | <component>]

Parámetros

Parámetro Descripción

Comprobación Comprueba que el sistema de escritura o componente especificado se incluye


en el procedimiento de copia de seguridad o restauración. Se producirá un error
en el procedimiento de copia de seguridad o restauración si no se incluye el
escritor o el componente.

exclude Excluye el escritor o componente especificados del procedimiento de copia de


seguridad o restauración.

Ejemplos
Para comprobar un escritor especificando su GUID (en este ejemplo, 4dc3bdd4-ab48-
4d07-adb0-3bee2926fd7f), escriba:

writer verify {4dc3bdd4-ab48-4d07-adb0-3bee2926fd7f}

Para excluir un escritor con el nombre System Writer, escriba:

writer exclude System Writer


Vínculos relacionados
Clave de sintaxis de línea de comandos
wscript
Artículo • 12/04/2023

Se aplica a Windows Server (todas las versiones compatibles)

Windows Script Host proporciona un entorno en el que los usuarios pueden ejecutar
scripts en varios lenguajes que usan varios modelos de objetos para realizar tareas.

Sintaxis

wscript [<scriptname>] [/b] [/d] [/e:<engine>] [{/h:cscript|/h:wscript}]


[/i] [/job:<identifier>] [{/logo|/nologo}] [/s] [/t:<number>] [/x] [/?]
[<ScriptArguments>]

Parámetros
Parámetro Descripción

scriptname Especifica la ruta de acceso y el nombre del archivo de escript.

/b Especifica el modo por lotes, que no muestra alertas, errores de scripting o


mensajes de entrada. El parámetro /b es el opuesto a /i.

/d Inicia el depurador.

/e Especifica el motor que se usa para ejecutar el script. Este parámetro le


permite ejecutar scripts que usan una extensión de nombre de archivo
personalizada. Sin el parámetro /e, solo puede ejecutar scripts que usen
extensiones de nombre de archivo registradas. Por ejemplo, si intenta ejecutar
este comando:
cscript test.admin
Recibe este mensaje de error: Error de entrada: No hay ningún motor de script
para la extensión de archivo .admin .
Una ventaja de usar extensiones de nombre de archivo no estándar es que
protege contra la selección accidental de un script y la ejecución de algo que
realmente no quería ejecutar.
Al usar esta extensión no se crea una asociación permanente entre la
extensión de nombre de archivo .admin y VBScript. Cada vez que ejecute un
script que use una extensión de nombre de archivo .admin , debe usar el
parámetro /e.

/h:cscript Registra cscript.exe como host de script predeterminado para ejecutar scripts.
Parámetro Descripción

/h:wscript Registra wscript.exe como host de script predeterminado para ejecutar scripts.
Este es el comportamiento predeterminado cuando se omite la opción /h.

/i Especifica el modo interactivo, que muestra alertas, errores de scripting y


mensajes de entrada.
El parámetro /i es el valor predeterminado y lo opuesto a /b.

/job:\ Ejecuta el trabajo identificado por identificador en un archivo de script .wsf.


<identifier>

/logo Especifica que el banner de Windows Script Host se muestra en la consola


antes de que se ejecute el script.
El parámetro /logo es el valor predeterminado y lo opuesto a /nologo.

/nologo Especifica que el banner de Windows Script Host no se muestra antes de que
se ejecute el script. El parámetro /nologo es el opuesto a /logo.

/s Guarda las opciones actuales del símbolo del sistema para el usuario actual.

/t:\<number> Especifica el tiempo máximo que puede ejecutar el script (en segundos).
Puede especificar hasta 32 767 segundos.
El valor predeterminado no es un límite de tiempo.

/x Inicia el script en el depurador.

ScriptArguments Especifica los argumentos pasados al script. Cada argumento de script debe ir
precedido de una barra diagonal (/).

/? Muestra la Ayuda en el símbolo del sistema.

Notas
La realización de esta tarea no le exige que tenga credenciales administrativas.
Considere la posibilidad de realizar esta tarea como un usuario sin credenciales
administrativas como procedimiento recomendado de seguridad.
Para abrir un símbolo del sistema, en la pantalla Inicio, escriba cmd y, a
continuación, seleccione símbolo del sistema.
Cada parámetro es opcional. Sin embargo, no se pueden especificar argumentos
de script sin especificar un script. Si no especifica un script o argumentos de script,
wscript.exe muestra el cuadro de diálogo Configuración de Windows Script Host.
Use el cuadro de diálogo para establecer propiedades de scripting globales para
todos los scripts que wscript.exe ejecuta en el equipo local.
El parámetro /t impide la ejecución excesiva de scripts estableciendo un
temporizador. Cuando el tiempo supera el valor especificado, wscript interrumpe
el motor de scripts y finaliza el proceso.
Los archivos de script de Windows suelen tener una de las siguientes extensiones
de nombre de archivo: .wsf, .vbs, .js.
Si selecciona un archivo de script con una extensión que no tiene ninguna
asociación, aparecerá el cuadro de diálogo Abrir con. Seleccione wscript o cscript
y, a continuación, seleccione Usar siempre este programa para abrir este tipo de
archivo. Esto registra wscript.exe o cscript.exe como host de script
predeterminado para los archivos de este tipo de archivo.
Puede establecer las propiedades para archivos individuales. Para más información
sobre Windows Script Host, vea Información general de Windows Script Host.
Windows Script Host puede usar archivos de script .wsf. Cada archivo .wsf puede
usar varios motores de scripting y realizar varios trabajos.

Vínculos relacionados
Clave de sintaxis de línea de comandos
xcopy
Artículo • 11/11/2023

Copia archivos y directorios, incluidos los subdirectorios.

Para obtener ejemplos de cómo utilizar este comando, consulte Ejemplos.

Sintaxis

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 Descripción

<Fuente> Necesario. Especifica la ubicación y el nombre del archivo cuyo


nombre desea copiar. Este parámetro debe incluir una unidad o una
ruta de acceso.

[<Destination>] Especifica el destino de los archivos que desea copiar. Este parámetro
puede incluir una letra de unidad y dos puntos, un nombre de
directorio, un nombre de archivo o una combinación de estos.

/w Muestra el siguiente mensaje y espera la respuesta antes de empezar


a copiar archivos:
Presione cualquier tecla para empezar a copiar archivos

/p Le pide que confirme si desea crear cada archivo de destino.

/C Omite los errores.

/v Comprueba cada archivo a medida que se escribe en el archivo de


destino para asegurarse de que los archivos de destino son idénticos
a los archivos de origen.

/q Suprime la presentación de mensajes de xcopy .

/f Muestra los nombres de archivo de origen y de destino al copiar.

/l Genera una lista de archivos que deben copiarse, pero no los copia
activamente.
Parámetro Descripción

/g Crea archivos de destino descifrados cuando el destino no admite


cifrado.

/d [:MM-DD-YYYY] Solo copia los archivos de origen modificados en o después de la


fecha especificada. Si no incluye un valor MM-DD-AAAA, xcopy copia
todos los archivos de origen que sean más recientes que los archivos
de destino existentes. Esta opción de línea de comandos permite
actualizar los archivos que han cambiado.

/U Solo copia los archivos del origen que existen en el destino.

/i Si el origen es un directorio o contiene caracteres comodín y el destino


no existe, xcopy asume que el destino especifica un nombre de
directorio y crea un directorio nuevo. A continuación, xcopy copia
todos los archivos especificados en el nuevo directorio. De forma
predeterminada, xcopy le pide que especifique si el destino es un
archivo o un directorio.

/s Copia directorios y subdirectorios, a menos que estén vacíos. Si omite


/s, xcopy funciona dentro de un único directorio.

/e Copia todos los subdirectorios, incluso si están vacíos. Use /e con las
opciones de línea de comandos /s y /t.

/t Copia solo la estructura del subdirectorio (es decir, el árbol), no los


archivos. Para copiar directorios vacíos, debe incluir la opción de línea
de comandos /e.

/k Copia los archivos y conserva el atributo de solo lectura en los


archivos de destino si están presentes en los archivos de origen. De
forma predeterminada, xcopy quita el atributo de solo lectura.

/r Copia los archivos de solo lectura.

/h Copia archivos con atributos de archivo ocultos y del sistema. De


forma predeterminada, xcopy no copia archivos ocultos ni del sistema

/a Copia solo los archivos de origen que tienen establecidos sus


atributos de archivo de almacenamiento. /a no modifica el atributo de
archivo de almacenamiento del archivo de origen. Para obtener
información sobre cómo establecer el atributo de archivo de
almacenamiento mediante attrib, consulte Vínculos relacionados.

/m Copia solo los archivos de origen que tienen establecidos sus


atributos de archivo de almacenamiento. A diferencia de /a, /m
desactiva los atributos de archivo de almacenamiento en los archivos
especificados en el origen. Para obtener información sobre cómo
establecer el atributo de archivo de almacenamiento mediante attrib,
consulte Vínculos relacionados.
Parámetro Descripción

/n Crea copias con los nombres cortos de directorio o archivo NTFS. /n


es necesario cuando se copian archivos o directorios de un volumen
NTFS a un volumen FAT o cuando se requiere la convención de
nomenclatura del sistema de archivos FAT (es decir, 8.3 caracteres) en
el sistema de archivos de destino. El sistema de archivos de destino
puede ser FAT o NTFS.

/o Copia la información de la propiedad del archivo y la lista de control


de acceso discrecional (DACL).

/x Copia la configuración de auditoría de archivos y la información de la


lista de control de acceso del sistema (SACL) (implica /o).

/exclude:FileName1[+ Especifica una lista de archivos. Debe especificarse al menos un


[FileName2]][+ archivo de origen. Cada archivo contendrá cadenas de búsqueda con
[FileName3]( )] cada cadena en una línea independiente del archivo. Cuando
cualquiera de las cadenas coincide con cualquier parte de la ruta de
acceso absoluta del archivo que se va a copiar, ese archivo quedará
excluido de la copia. Por ejemplo, si se especifica la cadena obj, se
excluirán todos los archivos situados debajo del directorio obj o todos
los archivos con la extensión .obj.

/y Suprime la solicitud para confirmar que desea sobrescribir un archivo


de destino existente.

/-y Solicita que confirme que desea sobrescribir un archivo de destino


existente.

/z Copia a través de una red en modo reiniciable.

/b Copia el vínculo simbólico en lugar de los archivos. Este parámetro se


incorporó en Windows Vista®.

/j Copia archivos sin almacenamiento en búfer. Recomendado para


archivos muy grandes. Este parámetro se agregó en Windows Server
2008 R2.

/compress Solicita la compresión de red durante la transferencia de archivos


cuando corresponda.

/? Muestra la ayuda en el símbolo del sistema.

/sparse Permite conservar el estado disperso de los archivos durante la copia.

Comentarios
Uso de /z
Si pierde la conexión durante la fase de copia (por ejemplo, si el servidor se queda
sin conexión), se reanuda después de restablecerla. /z también muestra el
porcentaje de la operación de copia completada para cada archivo.

Uso de /y en la variable de entorno COPYCMD.

Puede usar /y en la variable de entorno COPYCMD. Puede invalidar este comando


mediante /-y en la línea de comandos. De forma predeterminada, se le pedirá que
sobrescriba.

Copia de archivos cifrados

La copia de archivos cifrados en un volumen que no admite EFS produce un error.


Descifre primero los archivos o copie los archivos en un volumen que admita EFS.

Cómo agregar archivos

Para anexar archivos, especifique un único archivo como destino, pero varios
archivos como origen (es decir, mediante caracteres comodín o con el formato
archivo1+archivo2+archivo3).

Valor predeterminado para el destino

Si omite el destino, el xcopy comando copia los archivos en el directorio actual.

Cómo especificar si el destino es un archivo o directorio

Si el destino no contiene un directorio existente y no termina con una barra


diagonal inversa (), aparece el siguiente mensaje:

Does <Destination> specify a file name or directory name on the


target(F = file, D = directory)?

Presione F si desea que el archivo o los archivos se copien en un archivo. Presione


D si desea que el archivo o los archivos se copien en un directorio.

Puede suprimir este mensaje mediante la opción de línea de comandos /i, lo que
hace que xcopy asuma que el destino es un directorio si el origen es más de un
archivo o directorio.

Uso del comando xcopy para establecer el atributo de archivo para los archivos de
destino
El comando xcopy crea archivos con el conjunto de atributos de archivo,
independientemente de si este atributo se estableció o no en el archivo de origen.
Para obtener más información sobre los atributos de archivo y attrib, consulte
Vínculos relacionados.

Comparación de xcopy y diskcopy

Si tiene un disco que contiene archivos en subdirectorios y quiere copiarlo en un


disco que tenga un formato diferente, use el comando xcopy en lugar de
diskcopy. Dado que el comando diskcopy copia los discos por pistas, los discos de
origen y de destino deben tener el mismo formato. El comando xcopy no tiene
este requisito. Use xcopy a menos que necesite una copia de imagen de disco
completa.

Error de memoria insuficiente

Puede producirse un error de "memoria insuficiente" si se ejecuta xcopy para


copiar un archivo o carpeta cuya ruta de acceso de nombre de archivo es superior
a 255 caracteres.

Códigos de salida para xcopy

Para procesar los códigos de salida devueltos por xcopy , use el parámetro
ErrorLevel en la línea de comandos if de un programa por lotes. Para obtener un
ejemplo de un programa por lotes que procese códigos de salida mediante if,
consulte Vínculos relacionados. En la siguiente tabla se enumeran los códigos de
salida y una breve descripción de su significado.

Código de Descripción
salida

0 Los archivos se copiaron sin errores.

1 No se encontraron archivos para copiar.

2 El usuario presionó CTRL+C para finalizar xcopy .

4 Error de inicialización. No hay suficiente memoria o espacio en disco, o ha


escrito un nombre de unidad no válido o una sintaxis no válida en la línea de
comandos.

5 Error de escritura en disco.

Ejemplos
1. Para copiar todos los archivos y subdirectorios (incluidos los subdirectorios vacíos) de
la unidad A a la unidad B, escriba:

xcopy a: b: /s /e

2. Para incluir cualquier sistema o archivos ocultos en el ejemplo anterior, agregue la


opción de línea de comandos /h como se indica a continuación:

xcopy a: b: /s /e /h

3. Para actualizar archivos en el directorio \Reports con los archivos del directorio
\Rawdata que han cambiado desde el 29 de diciembre de 1993, escriba:

xcopy \rawdata \reports /d:12-29-1993

4. Para actualizar todos los archivos que existen en \Reports en el ejemplo anterior,
independientemente de la fecha, escriba:

xcopy \rawdata \reports /u

5. Para obtener una lista de los archivos que va a copiar el comando anterior (es decir,
sin copiar realmente los archivos), escriba:

xcopy \rawdata \reports /d:12-29-1993 /l > xcopy.out

El archivo xcopy.out enumera todos los archivos que se van a copiar.

6. Para copiar el directorio \Customer y todos los subdirectorios en el directorio


\\Public\Address en la unidad de red H:, conserve el atributo de solo lectura y se le
solicite cuando se cree un nuevo archivo en H:, escriba:
xcopy \customer h:\public\address /s /e /k /p

7. Para emitir el comando anterior, asegúrese de que xcopy crea el directorio \Address
si no existe, y suprima el mensaje que aparece al crear un directorio nuevo, agregue la
opción de línea de comandos /i como se indica a continuación:

xcopy \customer h:\public\address /s /e /k /p /i

8. Puede crear un programa por lotes para realizar operaciones xcopy y usar el
comando por lotes if para procesar el código de salida si se produce un error. Por
ejemplo, el siguiente programa por lotes usa parámetros reemplazables para los
parámetros de origen y 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 el programa por lotes anterior para copiar todos los archivos del directorio
C:\Prgmcode y sus subdirectorios en la unidad B, escriba:

copyit c:\prgmcode b:

El intérprete de comandos sustituye C:\Prgmcode por %1 y B: para %2 y, a


continuación, usa xcopy con las opciones de línea de comandos /e y /s. Si xcopy
encuentra un error, el programa por lotes lee el código de salida y va a la etiqueta
indicada en la instrucción IF ERRORLEVEL adecuada y, a continuación, muestra el
mensaje adecuado y sale del programa por lotes.

9. En este ejemplo se copian todos los directorios no vacíos, además de los archivos con
la extensión de archivo asociada después del símbolo del 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

En el ejemplo anterior, este valor de parámetro de origen determinado .\toc*.yml copia


los mismos 3 archivos aunque se quitaran sus dos caracteres de ruta de acceso .\. Sin
embargo, no se copiaría ningún archivo si el carácter comodín asterisco se quitó del
parámetro de origen, lo que lo convierte en .\toc.yml.

Vínculos relacionados
Copiar
Mover
Dir
Attrib
Diskcopy
If
Clave de sintaxis de línea de comandos

También podría gustarte