Compartir a través de

Verbos aprobados para los comandos de PowerShell

  • Artículo

PowerShell usa un par verbo-sustantivo para los nombres de los cmdlets y para sus clases derivadas de .NET. La parte del verbo del nombre identifica la acción que realiza el cmdlet. La parte de nombre del nombre identifica la entidad en la que se realiza la acción. Por ejemplo, el cmdlet Get-Command recupera todos los comandos registrados en PowerShell.

Nota:

PowerShell usa el término verbo para describir una palabra que implica una acción aunque esa palabra no sea un verbo estándar en inglés. Por ejemplo, el término New es un nombre de verbo de PowerShell válido porque implica una acción aunque no sea un verbo en inglés.

Cada verbo aprobado tiene un prefijo de alias correspondiente definido. Usamos este prefijo de alias en alias para comandos que usan ese verbo. Por ejemplo, el prefijo de alias para Import es ip y, en consecuencia, el alias de Import-Module es ipmo. Esta es una recomendación, pero no una regla; en concreto, no es necesario respetar los alias de comandos que imitan comandos conocidos de otros entornos.

Recomendaciones de nomenclatura de verbos

Las siguientes recomendaciones le ayudan a elegir un verbo adecuado para el cmdlet, para garantizar la coherencia entre los cmdlets que cree, los cmdlets proporcionados por PowerShell y los cmdlets diseñados por otros usuarios.

  • Uso de uno de los nombres de verbo predefinidos proporcionados por PowerShell
  • Use el verbo para describir el ámbito general de la acción y use parámetros para refinar aún más la acción del cmdlet.
  • No use un sinónimo de un verbo aprobado. Por ejemplo, use siempre Remove, nunca use Delete o Eliminate.
  • Use solo el formato de cada verbo que aparece en este tema. Por ejemplo, use Get, pero no use Getting ni Gets.
  • No use los siguientes verbos o alias reservados. El lenguaje de PowerShell y algunos cmdlets raros usan estos verbos en circunstancias excepcionales.
    • ForEach (foreach)
    • Ping (pi)
    • Ordenar (sr)
    • Tee (te)
    • Dónde (wh)

Puede obtener una lista completa de verbos mediante el cmdlet Get-Verb.

Verbos similares para diferentes acciones

Los siguientes verbos similares representan diferentes acciones.

Nuevo frente a Agregar

Use el verbo New para crear un nuevo recurso. Use el Add para agregar algo a un contenedor o recurso existente. Por ejemplo, Add-Content agrega la salida a un archivo existente.

Nuevo frente a Establecer

Use el verbo New para crear un nuevo recurso. Use el verbo Set para modificar un recurso existente, si no existe, como el cmdlet Set-Variable.

Use el verbo Find para buscar un objeto. Use el verbo Search para crear una referencia a un recurso de un contenedor.

Obtener frente a Lectura

Use el verbo Get para obtener información sobre un recurso (por ejemplo, un archivo) o para obtener un objeto con el que puede acceder al recurso en el futuro. Use el verbo Read para abrir un recurso y extraer información contenida en él.

Invocación frente a Inicio

Use el verbo Invoke para realizar operaciones sincrónicas, como ejecutar un comando y esperar a que finalice. Use el verbo Start para iniciar operaciones asincrónicas, como iniciar un proceso autónomo.

Ping frente a prueba

Use el verbo Test.

Verbos comunes

PowerShell usa la clase de enumeración System.Management.Automation.VerbsCommon para definir acciones genéricas que se pueden aplicar a casi cualquier cmdlet. En la tabla siguiente se enumeran la mayoría de los verbos definidos.

Verbo (alias) Acción Sinónimos que se deben evitar
Agregar (a) Agrega un recurso a un contenedor o asocia un elemento a otro elemento. Por ejemplo, el cmdlet Add-Content agrega contenido a un archivo. Este verbo se empareja con Remove. Append, Attach, Concatenate, Insert
Borrar (cl) Quita todos los recursos de un contenedor, pero no elimina el contenedor. Por ejemplo, el cmdlet Clear-Content quita el contenido de un archivo, pero no elimina el archivo. Flush, Erase, Release, Unmark, Unset, Nullify
Cerrar (cs) Cambia el estado de un recurso para que sea inaccesible, no disponible o inutilizable. Este verbo está emparejado con Open.
copiar (cp) Copia un recurso en otro nombre o en otro contenedor. Por ejemplo, el cmdlet Copy-Item copia un elemento (por ejemplo, un archivo) de una ubicación en el almacén de datos a otra ubicación. Duplicar, clonar, replicar, sincronizar
Escriba (et) Especifica una acción que permite al usuario pasar a un recurso. Por ejemplo, el cmdlet Enter-PSSession coloca al usuario en una sesión interactiva. Este verbo se empareja con Exit. Insertar, en
salir (por ejemplo) Establece el entorno o contexto actual en el contexto usado más recientemente. Por ejemplo, el cmdlet Exit-PSSession coloca al usuario en la sesión que se usó para iniciar la sesión interactiva. Este verbo se empareja con Enter. Pop, Out
Buscar (fd) Busca un objeto en un contenedor desconocido, implícito, opcional o especificado. Búsqueda
formato (f) Organiza objetos en un formulario o diseño especificados
Obtener (g) Especifica una acción que recupera un recurso. Este verbo se empareja con Set. Read, Open, Cat, Type, Dir, Obtain, Dump, Acquire, Examine, Find, Search
Ocultar (h) Hace que un recurso no se detecte. Por ejemplo, un cmdlet cuyo nombre incluye el verbo Ocultar podría ocultar un servicio de un usuario. Este verbo se empareja con Show. Bloquear
join (j) Combina recursos en un recurso. Por ejemplo, el cmdlet Join-Path combina una ruta de acceso con una de sus rutas secundarias para crear una sola ruta de acceso. Este verbo se empareja con Split. Combinar, Unir, Conectar, Asociar
bloqueo (lk) Protege un recurso. Este verbo se empareja con Unlock. Restringir, proteger
Mover (m) Mueve un recurso de una ubicación a otra. Por ejemplo, el cmdlet Move-Item mueve un elemento de una ubicación del almacén de datos a otra ubicación. Transferencia, nombre, migración
nuevo (n) Crea un recurso. (El verbo Set también se puede usar al crear un recurso que incluya datos, como el cmdlet Set-Variable). Crear, Generar, Compilar, Crear, Asignar
Abrir (op) Cambia el estado de un recurso para que sea accesible, disponible o utilizable. Este verbo se empareja con Close.
Optimizar (om) Aumenta la eficacia de un recurso.
Pop (pop) Quita un elemento de la parte superior de una pila. Por ejemplo, el cmdlet Pop-Location cambia la ubicación actual a la ubicación que se insertó más recientemente en la pila.
push (pu) Agrega un elemento a la parte superior de una pila. Por ejemplo, el cmdlet Push-Location inserta la ubicación actual en la pila.
rehacer (re) Restablece un recurso al estado que se deshagó.
Quitar (r) Elimina un recurso de un contenedor. Por ejemplo, el cmdlet Remove-Variable elimina una variable y su valor. Este verbo se empareja con Add. Borrar, Cortar, Eliminar, Descartar, Borrar
cambiar el nombre de (rn) Cambia el nombre de un recurso. Por ejemplo, el cmdlet Rename-Item, que se usa para acceder a los datos almacenados, cambia el nombre de un elemento del almacén de datos. Cambio
restablecer (rs) Vuelve a establecer un recurso en su estado original.
Cambiar tamaño(rz) Cambia el tamaño de un recurso.
Search (sr) Crea una referencia a un recurso de un contenedor. Buscar, buscar
Seleccionar (sc) Busca un recurso en un contenedor. Por ejemplo, el cmdlet Select-String busca texto en cadenas y archivos. Buscar, buscar
Establecer (s) Reemplaza los datos de un recurso existente o crea un recurso que contiene algunos datos. Por ejemplo, el cmdlet Set-Date cambia la hora del sistema en el equipo local. (El verbo New también se puede usar para crear un recurso). Este verbo se empareja con Get. Write, Reset, Assign, Configure, Update
Mostrar (sh) Hace que un recurso sea visible para el usuario. Este verbo se empareja con Hide. Mostrar, Producir
Omitir (sk) Omite uno o varios recursos o puntos en una secuencia. Omitir, saltar
división de (sl) Separa partes de un recurso. Por ejemplo, el cmdlet Split-Path devuelve diferentes partes de una ruta de acceso. Este verbo se empareja con Join. Separar
paso (st) Se mueve al siguiente punto o recurso de una secuencia.
switch (sw) Especifica una acción que alterna entre dos recursos, como cambiar entre dos ubicaciones, responsabilidades o estados.
deshacer (un) Establece un recurso en su estado anterior.
desbloquear (uk) Libera un recurso bloqueado. Este verbo se empareja con Lock. Release, Unrestrict, Unsecure
Inspección (wc) Inspecciona o supervisa continuamente un recurso para ver los cambios.

Verbos de comunicaciones

PowerShell usa la clase System.Management.Automation.VerbsCommunications para definir acciones que se aplican a las comunicaciones. En la tabla siguiente se enumeran la mayoría de los verbos definidos.

Verbo (alias) Acción Sinónimos que se deben evitar
Connect (cc) Crea un vínculo entre un origen y un destino. Este verbo se empareja con Disconnect. Join, Telnet, Login
Desconectar (dc) Interrumpe el vínculo entre un origen y un destino. Este verbo se empareja con Connect. Break, Logoff
de lectura (rd) Adquiere información de un origen. Este verbo se empareja con Write. Adquirir, preguntar, obtener
recibir (rc) Acepta información enviada desde un origen. Este verbo se empareja con Send. Leer, Aceptar, Ver
enviar (sd) Entrega información a un destino. Este verbo se empareja con Receive. Put, Broadcast, Mail, Fax
escribir (wr) Agrega información a un destino. Este verbo se empareja con Read. Put, Print

Verbos de datos

PowerShell usa la clase System.Management.Automation.VerbsData para definir acciones que se aplican al control de datos. En la tabla siguiente se enumeran la mayoría de los verbos definidos.

Nombre del verbo (alias) Acción Sinónimos que se deben evitar
backup (ba) Almacena los datos mediante la replicación. Guardar, grabar, replicar, sincronizar
de punto de control (ch) Crea una instantánea del estado actual de los datos o de su configuración. Diferencias
Comparar (cr) Evalúa los datos de un recurso con los datos de otro recurso. Diferencias
Comprimir (cm) Compacta los datos de un recurso. Pares con Expand. Compacto
convertir (cv) Cambia los datos de una representación a otra cuando el cmdlet admite la conversión bidireccional o cuando el cmdlet admite la conversión entre varios tipos de datos. Change, Resize, Resample
ConvertFrom (cf) Convierte un tipo principal de entrada (el nombre del cmdlet indica la entrada) en uno o varios tipos de salida admitidos. Exportación, salida, salida
ConvertTo (ct) Convierte de uno o varios tipos de entrada a un tipo de salida principal (el nombre del cmdlet indica el tipo de salida). Import, Input, In
desmontar (dm) Desasocia una entidad con nombre de una ubicación. Este verbo se empareja con Mount. Desmontar, Desvincular
editar (ed) Modifica los datos existentes agregando o quitando contenido. Cambiar, actualizar, modificar
expandir (en) Restaura los datos de un recurso que se ha comprimido en su estado original. Este verbo se empareja con Compress. Explotar, descomprimir
Export (ep) Encapsula la entrada principal en un almacén de datos persistente, como un archivo o en un formato de intercambio. Este verbo se empareja con Import. Extracción, copia de seguridad
grupo (gp) Organiza o asocia uno o varios recursos
importar (ip) Crea un recurso a partir de datos almacenados en un almacén de datos persistente (por ejemplo, un archivo) o en un formato de intercambio. Por ejemplo, el cmdlet Import-Csv importa datos de un archivo de valor separado por comas (CSV) a objetos que otros cmdlets pueden usar. Este verbo se empareja con Export. BulkLoad, Load
Inicializar (en) Prepara un recurso para su uso y lo establece en un estado predeterminado. Erase, Init, Renew, Rebuild, Reinitialize, Setup
límite de (l) Aplica restricciones a un recurso. Cuota
combinar (mg) Crea un único recurso a partir de varios recursos. Combinación, combinación
de montaje (mt) Asocia una entidad con nombre a una ubicación. Este verbo se empareja con Dismount. Conexión
salida (o) Envía datos fuera del entorno. Por ejemplo, el cmdlet Out-Printer envía datos a una impresora.
publicar (pb) Pone un recurso a disposición de otros usuarios. Este verbo se empareja con Unpublish. Implementación, versión, instalación
restaurar (rr) Establece un recurso en un estado predefinido, como un estado establecido por Checkpoint. Por ejemplo, el cmdlet Restore-Computer inicia una restauración del sistema en el equipo local. Reparación, devolución, deshacer, corregir
guardar (sv) Conserva los datos para evitar la pérdida.
sincronización (sy) Garantiza que dos o más recursos están en el mismo estado. Replicar, Coerce, Coincidir
sin publicar (ub) Hace que un recurso no esté disponible para otros usuarios. Este verbo se empareja con Publish. Desinstalar, Revertir, Ocultar
actualizar (ud) Aporta un recurso up-to-date para mantener su estado, precisión, conformidad o cumplimiento. Por ejemplo, el cmdlet Update-FormatData actualiza y agrega archivos de formato a la consola de PowerShell actual. Refresh, Renew, Recalculate, Re-index

Verbos de diagnóstico

PowerShell usa la clase System.Management.Automation.VerbsDiagnostic para definir acciones que se aplican a los diagnósticos. En la tabla siguiente se enumeran la mayoría de los verbos definidos.

Verbo (alias) Acción Sinónimos que se deben evitar
depurar (db) Examina un recurso para diagnosticar problemas operativos. Diagnosticar
Measure (ms) Identifica los recursos consumidos por una operación especificada o recupera estadísticas sobre un recurso. Calcular, determinar, analizar
Ping (pi) En desuso: use el verbo Test en su lugar.
reparar (rp) Restaura un recurso a una condición utilizable Corrección, restauración
Resolver (rv) Asigna una representación abreviada de un recurso a una representación más completa. Expandir, determinar
de prueba (t) Comprueba la operación o coherencia de un recurso. Diagnosticar, analizar, salvar, comprobar
de seguimiento (tr) Realiza un seguimiento de las actividades de un recurso. Seguimiento, Seguimiento, Inspección, Excavación

Verbos del ciclo de vida

PowerShell usa la clase System.Management.Automation.VerbsLifecycle para definir acciones que se aplican al ciclo de vida de un recurso. En la tabla siguiente se enumeran la mayoría de los verbos definidos.

Verbo (alias) Acción Sinónimos que se deben evitar
Aprobar (ap) Confirma o acepta el estado de un recurso o proceso.
aserción de (como) Afirma el estado de un recurso. Certify
build (bd) Crea un artefacto (normalmente un archivo binario o un documento) de algún conjunto de archivos de entrada (normalmente código fuente o documentos declarativos). Este verbo se agregó en PowerShell 6.
completado (cp) Concluye una operación.
Confirmar (cn) Confirma, comprueba o valida el estado de un recurso o proceso. Confirmar, Aceptar, Certificar, Validar, Comprobar
denegar (dn) Rechaza, objetos, bloques o se opone al estado de un recurso o proceso. Block, Object, Reject, Reject
Implementar (dp) Envía una aplicación, un sitio web o una solución a un destino remoto de tal manera que un consumidor de esa solución pueda acceder a ella una vez completada la implementación. Este verbo se agregó en PowerShell 6.
Deshabilitar (d) Configura un recurso en un estado no disponible o inactivo. Por ejemplo, el cmdlet Disable-PSBreakpoint hace que un punto de interrupción está inactivo. Este verbo se empareja con Enable. Detener, ocultar
Habilitar (e) Configura un recurso en un estado disponible o activo. Por ejemplo, el cmdlet Enable-PSBreakpoint activa un punto de interrupción. Este verbo se empareja con Disable. Inicio, Inicio
Instalar (es) Coloca un recurso en una ubicación y, opcionalmente, lo inicializa. Este verbo se empareja con Uninstall. Configuración
invocar (i) Realiza una acción, como ejecutar un comando o un método. Ejecutar, Iniciar
registrar (rg) Crea una entrada para un recurso en un repositorio como una base de datos. Este verbo se empareja con Unregister.
solicitud (rq) Solicita un recurso o solicita permisos.
reiniciar (rt) Detiene una operación y, a continuación, la inicia de nuevo. Por ejemplo, el cmdlet Restart-Service se detiene y, a continuación, inicia un servicio. Reciclar
Reanudar (ru) Inicia una operación que se ha suspendido. Por ejemplo, el cmdlet Resume-Service inicia un servicio que se ha suspendido. Este verbo se empareja con Suspend.
iniciar (sa) Inicia una operación. Por ejemplo, el cmdlet Start-Service inicia un servicio. Este verbo se empareja con Stop. Iniciar, Iniciar, Arrancar
Detener (sp) Interrumpe una actividad. Este verbo se empareja con Start. End, Kill, Terminate, Cancel
Enviar (sb) Presenta un recurso para su aprobación. Publicar
suspender (ss) Pausa una actividad. Por ejemplo, el cmdlet Suspend-Service pausa un servicio. Este verbo se empareja con Resume. Pausa
Desinstalar (nosotros) Quita un recurso de una ubicación indicada. Este verbo se empareja con Install.
anular el registro (su) Quita la entrada de un recurso de un repositorio. Este verbo se empareja con Register. Eliminar
wait (w) Pausa una operación hasta que se produce un evento especificado. Por ejemplo, el cmdlet Wait-Job pausa las operaciones hasta que se completen uno o varios de los trabajos en segundo plano. Suspensión, pausa

Verbos de seguridad

PowerShell usa la clase System.Management.Automation.VerbsSecurity para definir acciones que se aplican a la seguridad. En la tabla siguiente se enumeran la mayoría de los verbos definidos.

Verbo (alias) Acción Sinónimos que se deben evitar
bloque (bl) Restringe el acceso a un recurso. Este verbo se empareja con Unblock. Prevent, Limit, Deny
conceder (gr) Permite el acceso a un recurso. Este verbo se empareja con Revoke. Permitir, Habilitar
Proteger (pt) Protege un recurso de ataque o pérdida. Este verbo se empareja con Unprotect. Cifrar, proteger, sellar
revocar (rk) Especifica una acción que no permite el acceso a un recurso. Este verbo se empareja con Grant. Quitar, deshabilitar
desbloquear (ul) Quita las restricciones de un recurso. Este verbo se empareja con Block. Borrar, Permitir
desproteger (up) Quita las medidas de seguridad de un recurso que se agregaron para evitar que se produzcan ataques o pérdidas. Este verbo se empareja con Protect. Descifrado, Unseal

Otros verbos

PowerShell usa la clase System.Management.Automation.VerbsOther clase para definir nombres de verbo canónicos que no se ajustan a una categoría de nombre de verbo específico, como los verbos comunes, comunicaciones, datos, ciclo de vida o nombres de verbos de seguridad.

Verbo (alias) Acción Sinónimos que se deben evitar
Usar (u) Usa o incluye un recurso para hacer algo.

Véase también