comando pin (winget)

El comando anclar winget le permite limitar el administrador de paquetes de Windows para que actualice un paquete a un rango determinado de versiones, o puede evitar completamente que se actualice un paquete. Un paquete anclado todavía puede actualizarse por sí mismo y desde fuera del administrador de paquetes de Windows.

Tipos de anclaje

WinGet admite tres tipos de anclaje de paquetes:

• Anclaje: el paquete se excluye de winget upgrade --all pero permite winget upgrade <package>. Puede usar el argumento --include-pinned para permitir que winget upgrade --all incluya paquetes anclados.

• Bloqueo: el paquete queda bloqueado de winget upgrade --all o winget upgrade <package>, necesitará desanclar el paquete para que WinGet pueda realizar una actualización. La opción --force puede usarse para ignorar el comportamiento del anclaje.

• Restricción: el paquete está anclado para una versión o rango de versiones determinado. Puede especificar una versión exacta a la que quiere que el paquete se ancle o puede usar el comodín * como última parte de la versión para especificar un rango. Por ejemplo, si un paquete está anclado a la versión 1.2.*, cualquier versión entre 1.2.0 y 1.2.x se considera válida. La opción --force puede usarse para ignorar el comportamiento del anclaje.

Uso

winget pin <subcommand> <options>

Opciones

Están disponibles las opciones siguientes:

Opción	Descripción
-?, --help	Obtiene ayuda adicional sobre este comando.
--wait	Pide al usuario que presione cualquier tecla antes de salir.
--logs,--open-logs	Abre la ubicación predeterminada de los registros.
--verbose, --verbose-logs	Se usa para invalidar la configuración de registro y crear un registro detallado.
--nowarn,--ignore-warnings	Suprime las salidas de advertencia.
--disable-interactivity	Deshabilita los mensajes interactivos.
--proxy	Establezca un proxy que se usará para esta ejecución.
--no-proxy	Deshabilite el uso de proxy para esta ejecución.

Subcomandos

El comando pin admite los siguientes subcomandos.

Subcomando	Descripción
agregar	Agrega un nuevo anclaje.
remove	Quita un anclaje de paquete.
list	Enumera los anclajes actuales.
reset	Restablece los anclajes

add

El subcomando add agrega un nuevo anclaje. Este subcomando requiere que especifique el paquete exacto a anclar. Si hay alguna ambigüedad, se le pedirá que filtre más el subcomando add para que se aplique con exactitud.

Uso:

winget pin add [[-q] <query>] [<options>]

Argumentos

Argument	Descripción
-q,--query	Consulta usada para buscar una aplicación.

Opciones

Las opciones le permiten anclar de forma personalizada para satisfacer sus necesidades.

Opción	Descripción
--id	Limita la búsqueda al identificador de la aplicación.
--name	Limita la búsqueda al nombre de la aplicación.
--moniker	Limita la búsqueda al moniker que se muestra para la aplicación.
--tag	Limita la búsqueda a la etiqueta enumerada para la aplicación.
--cmd, --command	Limita la búsqueda al comando de la aplicación.
-e, --exact	Usa la cadena exacta en la consulta, incluso distingue mayúsculas y minúsculas. No usará el comportamiento predeterminado de una subcadena.
-v, --version	Le permite especificar una versión exacta para anclar. El comodín * puede usarse en lugar de la última parte de la versión. Cambia el comportamiento del anclaje a gating.
-s, --source	Restringe la búsqueda al nombre de origen indicado. Debe ir seguido del nombre del origen.
--header	Cabecera HTTP opcional de origen de REST de Windows-Package-Manager.
--authentication-mode	Especifique la preferencia de ventana de autenticación (silenciosa, PreferenciaSilenciosa o interactiva).
--authentication-account	Especifique la cuenta que se utilizará para la autenticación.
--accept-source-agreements	Se usa para aceptar el contrato de licencia de origen y evitar el aviso.
--force	Ejecute directamente el comando y continúe con incidencias no relacionadas con la seguridad.
--blocking	Bloquea la actualización hasta que el anclaje se quite, previniendo los argumentos de omisión. Cambia el comportamiento del anclaje a blocking.
--installed	Ancla una versión instalada en concreto
-?, --help	Obtiene ayuda adicional sobre este comando.
--wait	Pide al usuario que presione cualquier tecla antes de salir.
<--logs, --open-logs	Abre la ubicación predeterminada de los registros.
--verbose, --verbose-logs	Se usa para invalidar la configuración de registro y crear un registro detallado.
--nowarn,--ignore-warnings	Suprime las salidas de advertencia.
--disable-interactivity	Deshabilita los mensajes interactivos.
--proxy	Establezca un proxy que se usará para esta ejecución.
--no-proxy	Deshabilite el uso de proxy para esta ejecución.

Ejemplos

En el ejemplo siguiente se agrega un anclaje para una aplicación. Agregar este anclaje evita que este paquete se actualice al llamar a winget upgrade --all. Use el argumento --include-pinned con winget upgrade --all para incluir cualquier paquete anclado.

winget pin add powertoys

En el ejemplo siguiente se agrega un anclaje de bloqueo para una aplicación mediante su id. Agregar un anclaje de bloqueo evitará que este paquete se actualice al llamar a winget upgrade --all o winget upgrade <package>. Tendrá que desbloquear el paquete para que WinGet pueda realizar una actualización.

winget pin add --id Microsoft.PowerToys --blocking

En el ejemplo siguiente se agrega un anclaje de restricción para una aplicación mediante su id. Agregar un anclaje de restricción evitará actualizaciones que actualicen a una versión del paquete que no sea la especificada o esté en el rango restringido mediante un comodín.

winget pin add --id Microsoft.PowerToys --version 0.70.*

quitar

El subcomando remove quita un anclaje. Este subcomando requiere que especifique el anclaje de paquete exacto a quitar. Si hay alguna ambigüedad, se le pedirá que filtre mejor el subcomando add para que se aplique con exactitud.

Uso:

winget pin remove [[-q] <query>] [<options>]

Argumentos

Argument	Descripción
-q,--query	Consulta usada para buscar una aplicación.

Opciones

Las opciones le permiten personalizar la eliminación de anclajes para satisfacer sus necesidades.

Opción	Descripción
--id	Limita la búsqueda al identificador de la aplicación.
--name	Limita la búsqueda al nombre de la aplicación.
--moniker	Limita la búsqueda al moniker que se muestra para la aplicación.
-s, --source	Restringe la búsqueda al nombre de origen indicado. Debe ir seguido del nombre del origen.
--tag	Limita la búsqueda a la etiqueta enumerada para la aplicación.
--cmd, --command	Limita la búsqueda al comando de la aplicación.
-e, --exact	Usa la cadena exacta en la consulta, incluso distingue mayúsculas y minúsculas. No usará el comportamiento predeterminado de una subcadena.
--header	Cabecera HTTP opcional de origen de REST de Windows-Package-Manager.
--authentication-mode	Especifique la preferencia de ventana de autenticación (silenciosa, PreferenciaSilenciosa o interactiva).
--authentication-account	Especifique la cuenta que se utilizará para la autenticación.
--accept-source-agreements	Se usa para aceptar el contrato de licencia de origen y evitar el aviso.
--installed	Ancla una versión instalada en concreto.
-?, --help	Obtiene ayuda adicional sobre este comando.
--wait	Pide al usuario que presione cualquier tecla antes de salir.
<--logs, --open-logs	Abre la ubicación predeterminada de los registros.
--verbose, --verbose-logs	Se usa para invalidar la configuración de registro y crear un registro detallado.
--nowarn,--ignore-warnings	Suprime las salidas de advertencia.
--disable-interactivity	Deshabilita los mensajes interactivos.
--proxy	Establezca un proxy que se usará para esta ejecución.
--no-proxy	Deshabilite el uso de proxy para esta ejecución.

Ejemplos

En el ejemplo siguiente se quita un anclaje para una aplicación.

winget pin remove powertoys

En el ejemplo siguiente se quita un anclaje para una aplicación usando su id.

winget pin remove --id Microsoft.PowerToys

list

El subcomando list enumera todos los anclajes actuales.

Uso:

winget pin list [[-q] <query>] [<options>]

Argumentos

Argument	Descripción
-q,--query	Consulta usada para buscar una aplicación.

Opciones

Las opciones le permiten personalizar la enumeración de anclajes para satisfacer sus necesidades.

Opción	Descripción
--id	Limita la búsqueda al identificador de la aplicación.
--name	Limita la búsqueda al nombre de la aplicación.
--moniker	Limita la búsqueda al moniker que se muestra para la aplicación.
-s, --source	Restringe la búsqueda al nombre de origen indicado. Debe ir seguido del nombre del origen.
--tag	Limita la búsqueda a la etiqueta enumerada para la aplicación.
--cmd, --command	Limita la búsqueda al comando de la aplicación.
-e, --exact	Usa la cadena exacta en la consulta, incluso distingue mayúsculas y minúsculas. No usará el comportamiento predeterminado de una subcadena.
--header	Cabecera HTTP opcional de origen de REST de Windows-Package-Manager.
--authentication-mode	Especifique la preferencia de ventana de autenticación (silenciosa, PreferenciaSilenciosa o interactiva).
--authentication-account	Especifique la cuenta que se utilizará para la autenticación.
--accept-source-agreements	Se usa para aceptar el contrato de licencia de origen y evitar el aviso.
-?, --help	Obtiene ayuda adicional sobre este comando.
--wait	Pide al usuario que presione cualquier tecla antes de salir.
<--logs, --open-logs	Abre la ubicación predeterminada de los registros.
--verbose, --verbose-logs	Se usa para invalidar la configuración de registro y crear un registro detallado.
--nowarn,--ignore-warnings	Suprime las salidas de advertencia.
--disable-interactivity	Deshabilita los mensajes interactivos.
--proxy	Establezca un proxy que se usará para esta ejecución.
--no-proxy	Deshabilite el uso de proxy para esta ejecución.

Ejemplos

En el ejemplo siguiente se enumeran todos los anclajes actuales.

winget pin list

En el ejemplo siguiente se muestra un anclaje de paquete específico.

winget pin list --id Microsoft.PowerToys

reset

El subcomando reset restablece todos los anclajes.

Usar este subcomando sin el argmento --force mostrará todos los anclajes que se quitarían.

Para restablecer todos los anclajes, incluya el argumento --force.

Uso:

winget pin reset [<options>]

Opciones

Las opciones le permiten personalizar anclajes de restablecimiento para satisfacer sus necesidades.

Opción	Descripción
--force	Ejecute directamente el comando y continúe con incidencias no relacionadas con la seguridad.
-s, --source	Restringe la búsqueda al nombre de origen indicado. Debe ir seguido del nombre del origen.
-?, --help	Obtiene ayuda adicional sobre este comando.
--wait	Pide al usuario que presione cualquier tecla antes de salir.
<--logs, --open-logs	Abre la ubicación predeterminada de los registros.
--verbose, --verbose-logs	Se usa para invalidar la configuración de registro y crear un registro detallado.
--nowarn,--ignore-warnings	Suprime las salidas de advertencia.
--disable-interactivity	Deshabilita los mensajes interactivos.
--proxy	Establezca un proxy que se usará para esta ejecución.
--no-proxy	Deshabilite el uso de proxy para esta ejecución.

Ejemplos

En el ejemplo siguiente se muestran todos los anclajes que se restablecerían.

winget pin reset

En el ejemplo siguiente se restablecen todos los anclajes existentes.

winget pin reset --force