pin comando (winget)

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

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 winget upgrade --all ou winget upgrade <package>, você precisará desafixar o pacote para permitir que o WinGet execute um upgrade. A --force opção pode ser usada para substituir o pincomportamento de 's.

  • 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 --force opção pode ser usada para substituir o pincomportamento de 's.

Uso

winget pin <subcommand> <options>

Opções

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

Opção Descrição
-?, --help Obtém ajuda adicional sobre esse comando.
--wait 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.
--disable-interactivity Desabilitar prompts interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-proxy Desabilite o uso de proxy para essa execução.

Subcomandos

O pin comando dá suporte aos subcomandos a seguir.

Subcomando Descrição
add Adicionar um novo pin.
remove Remover um pacote pin.
list Listar os marcadores atuais.
reset Redefinir marcadores

adicionar

O add subcomando adiciona um novo pin. Esse subcomando requer que você especifique o pacote exato para pin. Se houver alguma ambiguidade, você será solicitado a filtrar ainda mais o add subcomando 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.
--name Limita a pesquisa ao nome do aplicativo.
--moniker Limita a pesquisa ao moniker listado para o aplicativo.
--tag Limita a pesquisa às marcas listadas para o aplicativo.
--cmd, --command Limita a pesquisa ao comando do aplicativo.
-e, --exact 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 para pin. O curinga * pode ser usado como a última parte da versão. Altera pin o comportamento a ser gating.
-s, --source Restringe a pesquisa ao nome de origem fornecido. Deve ser seguido pelo nome de origem.
--header O cabeçalho HTTP de origem REST opcional Windows-Package-Manager.
--authentication-mode Especifique a preferência da janela de autenticação (silent, silentPreferred ou interactive).
--authentication-account Especifique a conta a ser usada para autenticação.
--accept-source-agreements Usado para aceitar o contrato de licença de origem e evitar o prompt.
--force Executa o comando diretamente e continua com problemas não relacionados à segurança.
--blocking Bloqueie a atualização até que ela pin seja removida, impedindo que os argumentos de substituição sejam substituídos. Altera pin o comportamento a ser blocking.
--installed Fixa uma versão instalada específica
-?, --help Obtêm ajuda adicional sobre esse comando.
--wait 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.
--disable-interactivity Desabilitar prompts interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-proxy Desabilite o uso de proxy para essa execução.

Exemplos

O exemplo a seguir adiciona um pin para um aplicativo. Adicionar isso pin 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 bloqueio pin para um aplicativo usando sua ID. A adição de um bloqueio pin 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 um upgrade.

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

O exemplo a seguir adiciona um gating pin para um aplicativo usando sua ID. Adicionar um gating pin impedirá atualizações que upgrade a versão do pacote fora de uma versão específica ou do intervalo de caracteres curinga fechado.

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

remover

O remove subcomando remove um pin. Esse subcomando requer que você especifique o pacote pin exato a ser removido. Se houver alguma ambiguidade, você será solicitado a filtrar ainda mais o remove subcomando 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.
--name Limita a pesquisa ao nome do aplicativo.
--moniker Limita a pesquisa ao moniker listado para o aplicativo.
-s, --source Restringe a pesquisa ao nome de origem fornecido. Deve ser seguido pelo nome de origem.
--tag Limita a pesquisa às marcas listadas para o aplicativo.
--cmd, --command Limita a pesquisa ao comando do aplicativo.
-e, --exact 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.
--header O cabeçalho HTTP de origem REST opcional Windows-Package-Manager.
--authentication-mode Especifique a preferência da janela de autenticação (silent, silentPreferred ou interactive).
--authentication-account Especifique a conta a ser usada para autenticação.
--accept-source-agreements Usado para aceitar o contrato de licença de origem e evitar o prompt.
--installed Fixa uma versão instalada específica.
-?, --help Obtêm ajuda adicional sobre esse comando.
--wait 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.
--disable-interactivity Desabilitar prompts interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-proxy Desabilite o uso de proxy para essa execução.

Exemplos

O exemplo a seguir remove um pin para um aplicativo.

winget pin remove powertoys

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

winget pin remove --id Microsoft.PowerToys

lista

O list subcomando lista todos os pinos 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.
--name Limita a pesquisa ao nome do aplicativo.
--moniker Limita a pesquisa ao moniker listado para o aplicativo.
-s, --source Restringe a pesquisa ao nome de origem fornecido. Deve ser seguido pelo nome de origem.
--tag Limita a pesquisa às marcas listadas para o aplicativo.
--cmd, --command Limita a pesquisa ao comando do aplicativo.
-e, --exact 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.
--header O cabeçalho HTTP de origem REST opcional Windows-Package-Manager.
--authentication-mode Especifique a preferência da janela de autenticação (silent, silentPreferred ou interactive).
--authentication-account Especifique a conta a ser usada para autenticação.
--accept-source-agreements Usado para aceitar o contrato de licença de origem e evitar o prompt.
-?, --help Obtêm ajuda adicional sobre esse comando.
--wait 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.
--disable-interactivity Desabilitar prompts interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-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 pacote pinespecífico.

winget pin list --id Microsoft.PowerToys

redefinir

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
--force Executa o comando diretamente e continua com problemas não relacionados à segurança.
-s, --source Restringe a pesquisa ao nome de origem fornecido. Deve ser seguido pelo nome de origem.
-?, --help Obtêm ajuda adicional sobre esse comando.
--wait 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.
--disable-interactivity Desabilitar prompts interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-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
  • Last updated on