pin comando (winget)

El wingetpin comando le permite limitar el Windows Administrador de paquetes de actualizar un paquete a intervalos específicos de versiones, o puede impedir que actualice un paquete por completo. Un paquete anclado puede seguir siendo upgrade propio y actualizarse desde fuera del Windows Administrador de paquetes.

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 está bloqueado desde winget upgrade --all o winget upgrade <package>, tendrá que desanclar el paquete para permitir que WinGet realice un upgrade. La --force opción se puede usar para invalidar el pincomportamiento de .

• 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 --force opción se puede usar para invalidar el pincomportamiento de .

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 pin comando admite los siguientes subcomandos.

Subcomando	Descripción
add	Agregue un nuevo pin.
remove	Quite un paquete pin.
list	Enumera los anclajes actuales.
reset	Restablece los anclajes

añadir

El add subcomando agrega un nuevo pin. Este subcomando requiere que especifique el paquete exacto en pin. Si hay alguna ambigüedad, se le pedirá que filtre aún más el add subcomando a una aplicación exacta.

Uso:

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

Argumentos

Argumento	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	Permite especificar una versión exacta en pin. El comodín * puede usarse en lugar de la última parte de la versión. Cambia pin el comportamiento para que sea 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	Bloquee la actualización hasta pin que se quite, lo que impide que se invaliden los argumentos. Cambia pin el comportamiento para que sea 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 pin para una aplicación. Agregar esto pin impedirá 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 bloqueo pin para una aplicación mediante su identificador. Agregar un bloqueo pin impedirá que este paquete se actualice al llamar a winget upgrade --all o winget upgrade <package>. Tendrás que desbloquear el paquete para permitir que WinGet realice una upgrade.

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

En el ejemplo siguiente se agrega un gating pin para una aplicación mediante su identificador. Agregar un acceso pin impedirá las actualizaciones que upgrade la versión del paquete fuera de una versión específica o el intervalo de caracteres comodín cerrados.

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

quitar

El remove subcomando quita un pin. Este subcomando requiere que especifique el paquete pin exacto que se va a quitar. Si hay alguna ambigüedad, se le pedirá que filtre aún más el remove subcomando a una aplicación exacta.

Uso:

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

Argumentos

Argumento	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 pin para una aplicación.

winget pin remove powertoys

En el ejemplo siguiente se quita un pin elemento para una aplicación mediante su identificador.

winget pin remove --id Microsoft.PowerToys

lista

El list subcomando enumera todos los pines actuales.

Uso:

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

Argumentos

Argumento	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 paquete pinespecífico.

winget pin list --id Microsoft.PowerToys

restablecimiento

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