Comando fixar (winget)

O comando wingetpin permite que você limite o Gerenciador de Pacotes do Windows de atualizar um pacote para intervalos específicos de versões ou pode impedi-lo de atualizar um pacote completamente. Um pacote fixado ainda pode ser atualizado por conta própria e ser atualizado de fora do Gerenciador de Pacotes do Windows.

Tipos de fixação

O WinGet dá suporte a três tipos de fixação de pacote:

• Fixação: o pacote é excluído de winget upgrade --all, mas permite winget upgrade <package>. Você pode usar o argumento --include-pinned para permitir que winget upgrade --all inclua pacotes fixados.

• Bloqueio: o pacote é bloqueado de winget upgrade --all ou winget upgrade <package>. Você precisará desafixar o pacote para permitir que o WinGet execute uma atualização. A opção --force pode ser usada para substituir o comportamento do marcador.

• Filtragem: o pacote é fixado em uma versão ou intervalo de versão específico. Você pode especificar uma versão exata à qual deseja que um pacote seja fixado ou pode utilizar o caractere curinga * como a última parte da versão para especificar um intervalo de versão. Por exemplo, se um pacote for fixado à versão 1.2.*, qualquer versão entre 1.2.0 a 1.2.x será considerada válida. A opção --force pode ser usada para substituir o comportamento do marcador.

Uso

winget pin <subcommand> <options>

Opções

As opções a seguir estão disponíveis.

Opção	Descrição
-?, --ajuda	Obtém ajuda adicional sobre esse comando.
--esperar	Solicita que o usuário pressione qualquer tecla antes de sair.
--logs,--open-logs	Abre o local de logs padrão.
--verbose, --verbose-logs	Usado para substituir a configuração de registro em log e criar um log detalhado.
--nowarn,--ignore-warnings	Suprime as saídas de aviso.
--desativar-interatividade	Desabilitar prompts interativos.
--procuração	Defina um proxy a ser usado para essa execução.
--sem proxy	Desabilite o uso de proxy para essa execução.

Subcomandos

O comando fixar dá suporte aos subcomandos a seguir.

Subcomando	Descrição
adicionar	Adicionar um novo marcador.
remover	Remover um marcador de pacote.
lista	Listar os marcadores atuais.
redefinir	Redefinir marcadores

adicionar

O subcomando adicionar adiciona um novo marcador. Esse subcomando exige que você especifique o pacote exato a ser fixado. Se houver alguma ambiguidade, será solicitado que você filtre ainda mais o subcomando adicionar para um aplicativo exato.

Uso:

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

Argumentos

Argumento	Descrição
-q,--query	A consulta usada para pesquisar um aplicativo.

Opções

As opções permitem que você personalize a adição de marcadores para atender às suas necessidades.

Opção	Descrição
--id	Limita a pesquisa à ID do aplicativo.
--nome	Limita a pesquisa ao nome do aplicativo.
--apelido	Limita a pesquisa ao moniker listado para o aplicativo.
--etiqueta	Limita a pesquisa às marcas listadas para o aplicativo.
--cmd, --comando	Limita a pesquisa ao comando do aplicativo.
-e, --exato	Usa a cadeia de caracteres exata na consulta, incluindo a verificação da diferenciação de maiúsculas e minúsculas. Ele não usará o comportamento padrão de uma substring.
-v, --version	Permite que você especifique uma versão exata a ser fixada. O curinga * pode ser usado como a última parte da versão. Altera o comportamento do marcador para ser gating.
-s, --fonte	Restringe a pesquisa ao nome de origem fornecido. Deve ser seguido pelo nome de origem.
--cabeçalho	O cabeçalho HTTP de origem REST opcional Windows-Package-Manager.
--modo de autenticação	Especifique a preferência da janela de autenticação (silent, silentPreferred ou interactive).
--conta-de-autenticação	Especifique a conta a ser usada para autenticação.
--aceitar-acordos-de-origem	Usado para aceitar o contrato de licença de origem e evitar o prompt.
--força	Executa o comando diretamente e continua com problemas não relacionados à segurança.
-- de bloqueio	Bloqueia a atualização até que o marcador seja removido, impedindo a substituição de argumentos. Altera o comportamento do marcador para ser blocking.
--instalado	Fixa uma versão instalada específica
-?, --ajuda	Obtêm ajuda adicional sobre esse comando.
--esperar	Solicita que o usuário pressione qualquer tecla antes de sair.
--logs, --open-logs	Abre o local de logs padrão.
--verbose, --verbose-logs	Usado para substituir a configuração de registro em log e criar um log detalhado.
--nowarn,--ignore-warnings	Suprime as saídas de aviso.
--desativar-interatividade	Desabilitar prompts interativos.
--procuração	Defina um proxy a ser usado para essa execução.
--sem proxy	Desabilite o uso de proxy para essa execução.

Exemplos

O exemplo a seguir adiciona um marcador para um aplicativo. Adicionar esse marcador impedirá que esse pacote seja atualizado ao chamar winget upgrade --all. Use o argumento --include-pinned com winget upgrade --all para incluir quaisquer pacotes fixados.

winget pin add powertoys

O exemplo a seguir adiciona um marcador de bloqueio para um aplicativo usando sua ID. Adicionar esse marcador de bloqueio impedirá que esse pacote seja atualizado ao chamar winget upgrade --all ou winget upgrade <package>. Você precisará desbloquear o pacote para permitir que o WinGet execute uma atualização.

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

O exemplo a seguir adiciona um marcador de filtragem para um aplicativo usando sua ID. A adição de um marcador de filtragem impedirá atualizações que atualizem a versão do pacote fora de uma versão específica ou do intervalo de caracteres curinga filtrado.

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

remover

O subcomando remover remove uma fonte. Esse subcomando exige que você especifique o marcador exato do pacote a ser fixado. Se houver alguma ambiguidade, será solicitado que você filtre ainda mais o subcomando remover para um aplicativo exato.

Uso:

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

Argumentos

Argumento	Descrição
-q,--query	A consulta usada para pesquisar um aplicativo.

Opções

As opções permitem que você personalize a remoção de marcadores para atender às suas necessidades.

Opção	Descrição
--id	Limita a pesquisa à ID do aplicativo.
--nome	Limita a pesquisa ao nome do aplicativo.
--apelido	Limita a pesquisa ao moniker listado para o aplicativo.
-s, --fonte	Restringe a pesquisa ao nome de origem fornecido. Deve ser seguido pelo nome de origem.
--etiqueta	Limita a pesquisa às marcas listadas para o aplicativo.
--cmd, --comando	Limita a pesquisa ao comando do aplicativo.
-e, --exato	Usa a cadeia de caracteres exata na consulta, incluindo a verificação da diferenciação de maiúsculas e minúsculas. Ele não usará o comportamento padrão de uma substring.
--cabeçalho	O cabeçalho HTTP de origem REST opcional Windows-Package-Manager.
--modo de autenticação	Especifique a preferência da janela de autenticação (silent, silentPreferred ou interactive).
--conta-de-autenticação	Especifique a conta a ser usada para autenticação.
--aceitar-acordos-de-origem	Usado para aceitar o contrato de licença de origem e evitar o prompt.
--instalado	Fixa uma versão instalada específica.
-?, --ajuda	Obtêm ajuda adicional sobre esse comando.
--esperar	Solicita que o usuário pressione qualquer tecla antes de sair.
--logs, --open-logs	Abre o local de logs padrão.
--verbose, --verbose-logs	Usado para substituir a configuração de registro em log e criar um log detalhado.
--nowarn,--ignore-warnings	Suprime as saídas de aviso.
--desativar-interatividade	Desabilitar prompts interativos.
--procuração	Defina um proxy a ser usado para essa execução.
--sem proxy	Desabilite o uso de proxy para essa execução.

Exemplos

O exemplo a seguir remove um marcador para um aplicativo.

winget pin remove powertoys

O exemplo a seguir remove um marcador para um aplicativo usando sua ID.

winget pin remove --id Microsoft.PowerToys

lista

O subcomando listar lista todos os marcadores atuais.

Uso:

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

Argumentos

Argumento	Descrição
-q,--query	A consulta usada para pesquisar um aplicativo.

Opções

As opções permitem que você personalize a listagem de marcadores para atender às suas necessidades.

Opção	Descrição
--id	Limita a pesquisa à ID do aplicativo.
--nome	Limita a pesquisa ao nome do aplicativo.
--apelido	Limita a pesquisa ao moniker listado para o aplicativo.
-s, --fonte	Restringe a pesquisa ao nome de origem fornecido. Deve ser seguido pelo nome de origem.
--etiqueta	Limita a pesquisa às marcas listadas para o aplicativo.
--cmd, --comando	Limita a pesquisa ao comando do aplicativo.
-e, --exato	Usa a cadeia de caracteres exata na consulta, incluindo a verificação da diferenciação de maiúsculas e minúsculas. Ele não usará o comportamento padrão de uma substring.
--cabeçalho	O cabeçalho HTTP de origem REST opcional Windows-Package-Manager.
--modo de autenticação	Especifique a preferência da janela de autenticação (silent, silentPreferred ou interactive).
--conta-de-autenticação	Especifique a conta a ser usada para autenticação.
--aceitar-acordos-de-origem	Usado para aceitar o contrato de licença de origem e evitar o prompt.
-?, --ajuda	Obtêm ajuda adicional sobre esse comando.
--esperar	Solicita que o usuário pressione qualquer tecla antes de sair.
--logs, --open-logs	Abre o local de logs padrão.
--verbose, --verbose-logs	Usado para substituir a configuração de registro em log e criar um log detalhado.
--nowarn,--ignore-warnings	Suprime as saídas de aviso.
--desativar-interatividade	Desabilitar prompts interativos.
--procuração	Defina um proxy a ser usado para essa execução.
--sem proxy	Desabilite o uso de proxy para essa execução.

Exemplos

Os exemplo a seguir lista todos os marcadores atuais.

winget pin list

O exemplo a seguir lista um marcador de pacote específico.

winget pin list --id Microsoft.PowerToys

repor

O subcomando de redefinição redefine todos os marcadores.

Usar esse subcomando sem o argumento --force mostrará os marcadores que seriam removidos.

Para redefinir todos os marcadores, inclua o argumento --force.

Uso:

winget pin reset [<options>]

Opções

As opções permitem que você personalize os pinos de redefinição para atender às suas necessidades.

Opção	Descrição
--força	Executa o comando diretamente e continua com problemas não relacionados à segurança.
-s, --fonte	Restringe a pesquisa ao nome de origem fornecido. Deve ser seguido pelo nome de origem.
-?, --ajuda	Obtêm ajuda adicional sobre esse comando.
--esperar	Solicita que o usuário pressione qualquer tecla antes de sair.
--logs, --open-logs	Abre o local de logs padrão.
--verbose, --verbose-logs	Usado para substituir a configuração de registro em log e criar um log detalhado.
--nowarn,--ignore-warnings	Suprime as saídas de aviso.
--desativar-interatividade	Desabilitar prompts interativos.
--procuração	Defina um proxy a ser usado para essa execução.
--sem proxy	Desabilite o uso de proxy para essa execução.

Exemplos

O exemplo a seguir mostra todos os marcadores que seriam redefinidos.

winget pin reset

O exemplo a seguir redefine todos os marcadores existentes.

winget pin reset --force