Comando fixar (winget)
O comando winget pin 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 permitewinget upgrade <package>. Você pode usar o argumento--include-pinnedpara permitir quewinget upgrade --allinclua pacotes fixados.Bloqueio: o pacote é bloqueado de
winget upgrade --allouwinget upgrade <package>. Você precisará desafixar o pacote para permitir que o WinGet execute uma atualização. A opção--forcepode 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ão1.2.*, qualquer versão entre1.2.0a1.2.xserá considerada válida. A opção--forcepode 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 |
|---|---|
| -?, --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 comando fixar dá suporte aos subcomandos a seguir.
| Subcomando | Descrição |
|---|---|
| adicionar | Adicionar um novo marcador. |
| remove | Remover um marcador de pacote. |
| list | Listar os marcadores atuais. |
| reset | Redefinir marcadores |
add
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
| Argument | 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 a ser fixada. O curinga * pode ser usado como a última parte da versão. Altera o comportamento do marcador para 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 | Bloqueia a atualização até que o marcador seja removido, impedindo a substituição de argumentos. Altera o comportamento do marcador para 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 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
| Argument | 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 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
list
O subcomando listar lista todos os marcadores atuais.
Uso:
winget pin list [[-q] <query>] [<options>]
Argumentos
| Argument | 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 marcador de pacote específico.
winget pin list --id Microsoft.PowerToys
reset
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
Windows developer