pin opdracht (winget)

Met wingetpin de opdracht kunt u het Windows Pakketbeheer beperken van het upgraden van een pakket naar specifieke bereiken met versies, of het kan voorkomen dat een pakket helemaal wordt bijgewerkt. Een vastgemaakt pakket kan nog steeds upgrade op zichzelf staan en worden bijgewerkt van buiten de Windows Pakketbeheer.

Typen vastmaken

WinGet ondersteunt drie typen pakketpinnen:

  • vastmaken: het pakket wordt uitgesloten van winget upgrade --all, maar staat winget upgrade <package>toe. U kunt het argument --include-pinned gebruiken om vastgemaakte pakketten winget upgrade --all toe te voegen.

  • Blokkeren: het pakket wordt geblokkeerd of winget upgrade --allwinget upgrade <package>, u moet het pakket losmaken om WinGet een upgradete laten uitvoeren. De --force optie kan worden gebruikt om het gedrag van het pintype te overschrijven.

  • Gating-: het pakket wordt vastgemaakt aan een specifieke versie of versiebereik. U kunt een exacte versie opgeven waaraan u een pakket wilt vastmaken of u kunt het jokerteken * gebruiken als laatste versieonderdeel om een versiebereik op te geven. Als een pakket bijvoorbeeld is vastgemaakt aan versie 1.2.*, wordt elke versie tussen 1.2.0 naar 1.2.x beschouwd als geldig. De --force optie kan worden gebruikt om het gedrag van het pintype te overschrijven.

Gebruik

winget pin <subcommand> <options>

Opties

De volgende opties zijn beschikbaar.

Optie Beschrijving
-?, --help Hiermee krijgt u aanvullende hulp bij deze opdracht.
--wait Vraagt de gebruiker om, voordat het programma wordt afgesloten, op een willekeurige toets te drukken.
--logs, --open-logs Open de standaardlocatie van de logboeken.
--verbose, --verbose-logs Wordt gebruikt om de loginstellingen te overschrijven en een gedetailleerd logboek te maken.
--nowarn, --ignore-warnings Onderdrukt waarschuwingsuitvoer.
--disable-interactivity Schakel interactieve prompts uit.
--proxy Stel een proxy in die moet worden gebruikt voor deze uitvoering.
--no-proxy Schakel het gebruik van proxy uit voor deze uitvoering.

Subopdrachten

De pin opdracht ondersteunt de volgende subopdrachten.

Subopdracht Beschrijving
add Voeg een nieuwe pintoe.
remove Een pakket pinverwijderen.
list Huidige spelden weergeven.
reset Pinnen opnieuw instellen

toevoegen

Met de add subopdracht wordt een nieuwe pintoegevoegd. Voor deze subopdracht moet u het exacte pakket opgeven.pin Als er dubbelzinnigheid is, wordt u gevraagd om de add subopdracht verder te filteren op een exacte toepassing.

Gebruik:

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

Argumenten

Argumentatie Beschrijving
-q, --query De query die wordt gebruikt om naar een app te zoeken.

Opties

Met de opties kunt u het toevoegen van pinnen aanpassen aan uw behoeften.

Optie Beschrijving
--id Hiermee wordt de zoekopdracht beperkt tot de id van de toepassing.
--name Hiermee beperkt u de zoekopdracht tot de naam van de toepassing.
--moniker Hiermee beperkt u de zoekopdracht tot de moniker die voor de toepassing wordt vermeld.
--tag Hiermee beperkt u de zoekopdracht tot de tag die voor de toepassing wordt vermeld.
--cmd, --command Hiermee beperkt u de zoekopdracht tot de opdracht van de toepassing.
-e, --exact Gebruikt de exacte tekenreeks in de query, inclusief het controleren op hoofdlettergevoeligheid. Het standaardgedrag van een subtekenreeks wordt niet gebruikt.
-v, --version Hiermee kunt u een exacte versie opgeven voor pin. Het jokerteken * kan worden gebruikt als het laatste versiedeel. Gedrag van wijzigingen pin dat moet worden gewijzigd gating.
-s, --source Hiermee wordt de zoekopdracht beperkt tot de opgegeven bronnaam. Moet worden gevolgd door de bronnaam.
--header Optionele Windows-Package-Manager REST-bron als HTTP-header.
--authentication-mode Geef de voorkeursvoorkeur voor verificatievensters op (stil, silentPreferred of interactief).
--authentication-account Geef het account op dat moet worden gebruikt voor verificatie.
--accept-source-agreements Wordt gebruikt om de bronlicentieovereenkomst te accepteren en de prompt te vermijden.
--force Voer de opdracht direct uit en ga door met niet-beveiligingsgerelateerde problemen.
--blocking Voorkomen dat u een upgrade uitvoert totdat de pin argumenten worden verwijderd, waardoor onderdrukkingsargumenten worden voorkomen. Gedrag van wijzigingen pin dat moet worden gewijzigd blocking.
--installed Een specifieke geïnstalleerde versie vastmaken
-?, --help Meer hulp krijgen bij deze opdracht.
--wait Vraagt de gebruiker om, voordat het programma wordt afgesloten, op een willekeurige toets te drukken.
--logs, --open-logs Open de standaardlocatie van de logboeken.
--verbose, --verbose-logs Wordt gebruikt om de loginstellingen te overschrijven en een gedetailleerd logboek te maken.
--nowarn, --ignore-warnings Onderdrukt waarschuwingsuitvoer.
--disable-interactivity Schakel interactieve prompts uit.
--proxy Stel een proxy in die moet worden gebruikt voor deze uitvoering.
--no-proxy Schakel het gebruik van proxy uit voor deze uitvoering.

Voorbeelden

In het volgende voorbeeld wordt een pin voor een toepassing toegevoegd. Als u dit pin toevoegt, wordt voorkomen dat dit pakket wordt bijgewerkt bij het aanroepen winget upgrade --all. Gebruik het argument --include-pinned met winget upgrade --all om vastgemaakte pakketten op te nemen.

winget pin add powertoys

In het volgende voorbeeld wordt een blokkering pin voor een toepassing toegevoegd met behulp van de bijbehorende id. Als u een blokkering pin toevoegt, wordt voorkomen dat dit pakket wordt bijgewerkt bij het aanroepen winget upgrade --all of winget upgrade <package>. U moet het pakket deblokkeren om WinGet een upgrade.

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

In het volgende voorbeeld wordt een gating pin voor een toepassing toegevoegd met behulp van de bijbehorende id. Als u een gat toevoegt pin , voorkomt u upgrades dat upgrade de pakketversie buiten een specifieke versie of het gated jokertekenbereik ligt.

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

verwijderen

Met de remove subopdracht wordt een pin. Voor deze subopdracht moet u het exacte pakket pin opgeven dat moet worden verwijderd. Als er dubbelzinnigheid is, wordt u gevraagd om de remove subopdracht verder te filteren op een exacte toepassing.

Gebruik:

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

Argumenten

Argumentatie Beschrijving
-q, --query De query die wordt gebruikt om naar een app te zoeken.

Opties

Met de opties kunt u het verwijderen van pinnen aanpassen aan uw behoeften.

Optie Beschrijving
--id Hiermee wordt de zoekopdracht beperkt tot de id van de toepassing.
--name Hiermee beperkt u de zoekopdracht tot de naam van de toepassing.
--moniker Hiermee beperkt u de zoekopdracht tot de moniker die voor de toepassing wordt vermeld.
-s, --source Hiermee wordt de zoekopdracht beperkt tot de opgegeven bronnaam. Moet worden gevolgd door de bronnaam.
--tag Hiermee beperkt u de zoekopdracht tot de tag die voor de toepassing wordt vermeld.
--cmd, --command Hiermee beperkt u de zoekopdracht tot de opdracht van de toepassing.
-e, --exact Gebruikt de exacte tekenreeks in de query, inclusief het controleren op hoofdlettergevoeligheid. Het standaardgedrag van een subtekenreeks wordt niet gebruikt.
--header Optionele Windows-Package-Manager REST-bron als HTTP-header.
--authentication-mode Geef de voorkeursvoorkeur voor verificatievensters op (stil, silentPreferred of interactief).
--authentication-account Geef het account op dat moet worden gebruikt voor verificatie.
--accept-source-agreements Wordt gebruikt om de bronlicentieovereenkomst te accepteren en de prompt te vermijden.
--installed Maak een specifieke geïnstalleerde versie vast.
-?, --help Meer hulp krijgen bij deze opdracht.
--wait Vraagt de gebruiker om, voordat het programma wordt afgesloten, op een willekeurige toets te drukken.
--logs, --open-logs Open de standaardlocatie van de logboeken.
--verbose, --verbose-logs Wordt gebruikt om de loginstellingen te overschrijven en een gedetailleerd logboek te maken.
--nowarn, --ignore-warnings Onderdrukt waarschuwingsuitvoer.
--disable-interactivity Schakel interactieve prompts uit.
--proxy Stel een proxy in die moet worden gebruikt voor deze uitvoering.
--no-proxy Schakel het gebruik van proxy uit voor deze uitvoering.

Voorbeelden

In het volgende voorbeeld wordt een pin voor een toepassing verwijderd.

winget pin remove powertoys

In het volgende voorbeeld wordt een pin voor een toepassing verwijderd met behulp van de id.

winget pin remove --id Microsoft.PowerToys

lijst

De list subopdracht bevat alle huidige spelden.

Gebruik:

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

Argumenten

Argumentatie Beschrijving
-q, --query De query die wordt gebruikt om naar een app te zoeken.

Opties

Met de opties kunt u lijstpinnen aanpassen aan uw behoeften.

Optie Beschrijving
--id Hiermee wordt de zoekopdracht beperkt tot de id van de toepassing.
--name Hiermee beperkt u de zoekopdracht tot de naam van de toepassing.
--moniker Hiermee beperkt u de zoekopdracht tot de moniker die voor de toepassing wordt vermeld.
-s, --source Hiermee wordt de zoekopdracht beperkt tot de opgegeven bronnaam. Moet worden gevolgd door de bronnaam.
--tag Hiermee beperkt u de zoekopdracht tot de tag die voor de toepassing wordt vermeld.
--cmd, --command Hiermee beperkt u de zoekopdracht tot de opdracht van de toepassing.
-e, --exact Gebruikt de exacte tekenreeks in de query, inclusief het controleren op hoofdlettergevoeligheid. Het standaardgedrag van een subtekenreeks wordt niet gebruikt.
--header Optionele Windows-Package-Manager REST-bron als HTTP-header.
--authentication-mode Geef de voorkeursvoorkeur voor verificatievensters op (stil, silentPreferred of interactief).
--authentication-account Geef het account op dat moet worden gebruikt voor verificatie.
--accept-source-agreements Wordt gebruikt om de bronlicentieovereenkomst te accepteren en de prompt te vermijden.
-?, --help Meer hulp krijgen bij deze opdracht.
--wait Vraagt de gebruiker om, voordat het programma wordt afgesloten, op een willekeurige toets te drukken.
--logs, --open-logs Open de standaardlocatie van de logboeken.
--verbose, --verbose-logs Wordt gebruikt om de loginstellingen te overschrijven en een gedetailleerd logboek te maken.
--nowarn, --ignore-warnings Onderdrukt waarschuwingsuitvoer.
--disable-interactivity Schakel interactieve prompts uit.
--proxy Stel een proxy in die moet worden gebruikt voor deze uitvoering.
--no-proxy Schakel het gebruik van proxy uit voor deze uitvoering.

Voorbeelden

In het volgende voorbeeld ziet u alle huidige spelden.

winget pin list

In het volgende voorbeeld wordt een specifiek pakket pinweergegeven.

winget pin list --id Microsoft.PowerToys

terugstellen

Met de subopdracht Opnieuw instellen worden alle pinnen opnieuw ingesteld.

Als u deze subopdracht zonder het argument --force gebruikt, worden de spelden weergegeven die worden verwijderd.

Als u alle spelden opnieuw wilt instellen, neemt u het argument --force op.

Gebruik:

winget pin reset [<options>]

Opties

Met de opties kunt u de reset-pinnen aanpassen aan uw behoeften.

Optie Beschrijving
--force Voer de opdracht direct uit en ga door met niet-beveiligingsgerelateerde problemen.
-s, --source Hiermee wordt de zoekopdracht beperkt tot de opgegeven bronnaam. Moet worden gevolgd door de bronnaam.
-?, --help Meer hulp krijgen bij deze opdracht.
--wait Vraagt de gebruiker om, voordat het programma wordt afgesloten, op een willekeurige toets te drukken.
--logs, --open-logs Open de standaardlocatie van de logboeken.
--verbose, --verbose-logs Wordt gebruikt om de loginstellingen te overschrijven en een gedetailleerd logboek te maken.
--nowarn, --ignore-warnings Onderdrukt waarschuwingsuitvoer.
--disable-interactivity Schakel interactieve prompts uit.
--proxy Stel een proxy in die moet worden gebruikt voor deze uitvoering.
--no-proxy Schakel het gebruik van proxy uit voor deze uitvoering.

Voorbeelden

In het volgende voorbeeld ziet u alle pinnen die opnieuw worden ingesteld.

winget pin reset

In het volgende voorbeeld worden alle bestaande pinnen opnieuw ingesteld.

winget pin reset --force