pin Befehl (winget)

Mit wingetpin dem Befehl können Sie die Windows Paket-Manager daran hindern, ein Paket auf bestimmte Versionsbereiche zu aktualisieren, oder es kann verhindern, dass ein Paket vollständig aktualisiert wird. Ein angeheftetes Paket kann weiterhin upgrade eigenständig sein und von außerhalb des Windows Paket-Manager aktualisiert werden.

Pintypen

WinGet unterstützt drei Arten von Paketpins:

• Anheften: Das Paket wird von winget upgrade --all ausgeschlossen, lässt aber winget upgrade <package> zu. Sie können das Argument --include-pinned verwenden, damit winget upgrade --all angeheftete Pakete einschließen kann.

• Blockieren: Das Paket wird blockiert winget upgrade --all oder winget upgrade <package>, Sie müssen das Paket lösen, um WinGet ausführen upgradezu lassen. Die --force Option kann verwendet werden, um das Verhalten des pinSteuerelements außer Kraft zu setzen.

• Gating: Das Paket ist an eine bestimmte Version oder einen bestimmten Versionsbereich angeheftet. Sie können eine genaue Version angeben, an die ein Paket angeheftet werden soll, oder Sie können das Platzhalterzeichen * als letzten Versionsteil verwenden, um einen Versionsbereich anzugeben. Wenn z. B. ein Paket an die Version 1.2.* angeheftet wird, ist jede Version zwischen 1.2.0 und 1.2.x gültig. Die --force Option kann verwendet werden, um das Verhalten des pinSteuerelements außer Kraft zu setzen.

Verbrauch

winget pin <subcommand> <options>

Optionen

Die folgenden Optionen sind verfügbar.

Auswahlmöglichkeit	BESCHREIBUNG
-?, --help	Ruft zusätzliche Hilfe zu diesem Befehl ab.
--wait	Fordert den Benutzer auf, vor dem Beenden eine beliebige Taste zu drücken.
--logs,--open-logs	Öffnet den Standardspeicherort für Protokolle.
--verbose, --verbose-logs	Wird verwendet, um die Protokollierungseinstellung zu überschreiben und ein ausführliches Protokoll zu erstellen.
--nowarn,--ignore-warnings	Unterdrückt Warnungsausgaben.
--disable-interactivity	Deaktiviert interaktive Eingabeaufforderungen.
--proxy	Festlegen eines Proxys, der für diese Ausführung verwendet werden soll.
--no-proxy	Deaktivieren der Verwendung des Proxys für diese Ausführung.

Unterbefehle

Der pin Befehl unterstützt die folgenden Unterbefehle.

Unterbefehl	BESCHREIBUNG
hinzufügen	Hinzufügen eines neuen pin.
entfernen	Entfernen eines Pakets pin.
liste	Aktuelle Pins auflisten
zurücksetzen	Pins zurücksetzen

hinzufügen

Der Unterbefehl zum Hinzufügen fügt ein neues pinhinzu. Für diesen Unterbefehl müssen Sie das genaue Paket angeben.pin Wenn Mehrdeutigkeiten vorliegen, werden Sie aufgefordert, den Unterbefehl add auf eine exakte Anwendung zu filtern.

Syntax:

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

Argumente

Streitpunkt	BESCHREIBUNG
-Q--query	Die Abfrage, die für die Suche nach einer App verwendet wird.

Optionen

Mit den Optionen können Sie das Hinzufügen von Pins an Ihre jeweiligen Anforderungen anpassen.

Auswahlmöglichkeit	BESCHREIBUNG
--id	Schränkt die Suche auf die ID der Anwendung ein.
--name	Schränkt die Suche auf den Namen der Anwendung ein.
--moniker	Schränkt die Suche auf die für die Anwendung aufgelisteten Moniker ein.
--tag	Schränkt die Suche auf die für die Anwendung aufgelisteten Tags ein.
--cmd, --command	Schränkt die Suche auf den Befehl der Anwendung ein.
-E --exact	Verwendet die exakte Zeichenfolge in der Abfrage und berücksichtigt die Groß-/Kleinschreibung. Das Standardverhalten einer Teilzeichenfolge wird nicht verwendet.
-V --version	Ermöglicht Ihnen, eine genaue Version für pin anzugeben. Das Platzhalterzeichen * kann als letzter Versionsteil verwendet werden. Ändert pin das Verhalten, das sein soll gating.
-s, --source	Schränkt die Suche auf die Quelle mit dem angegebenen Namen ein. Hierauf muss der Name der Quelle folgen.
--header	Optionaler HTTP-Quellheader von Windows-Paket-Manager.
--authentication-mode	Angeben der Einstellung des Fensters „Authentifizierung“ (automatisch, vorzugsweise automatisch oder interaktiv).
--authentication-account	Angeben des Kontos, das für die Authentifizierung verwendet werden soll.
--accept-source-agreements	Wird verwendet, um den Quelllizenzvertrag zu akzeptieren und die Eingabeaufforderung zu vermeiden.
--force	Führt den Befehl direkt aus und fährt mit nicht sicherheitsrelevanten Problemen fort.
--blocking	Blockieren sie das Upgrade, bis die pin Aktualisierung entfernt wurde, und verhindern Sie die Außerkraftsetzung von Argumenten. Ändert pin das Verhalten, das sein soll blocking.
--installed	Anheften einer bestimmten installierten Version
-?, --help	Ruft zusätzliche Hilfe zu diesem Befehl ab.
--wait	Fordert den Benutzer auf, vor dem Beenden eine beliebige Taste zu drücken.
--logs, --open-logs	Öffnet den Standardspeicherort für Protokolle.
--verbose, --verbose-logs	Wird verwendet, um die Protokollierungseinstellung zu überschreiben und ein ausführliches Protokoll zu erstellen.
--nowarn,--ignore-warnings	Unterdrückt Warnungsausgaben.
--disable-interactivity	Deaktiviert interaktive Eingabeaufforderungen.
--proxy	Festlegen eines Proxys, der für diese Ausführung verwendet werden soll.
--no-proxy	Deaktivieren der Verwendung des Proxys für diese Ausführung.

Beispiele

Im folgenden Beispiel wird eine pin Anwendung hinzugefügt. Durch das Hinzufügen wird pin verhindert, dass dieses Paket beim Aufrufen winget upgrade --allaktualisiert wird. Verwenden Sie das Argument --include-pinned mit winget upgrade --all, um alle angehefteten Pakete einzuschließen.

winget pin add powertoys

Im folgenden Beispiel wird eine Blockierung pin für eine Anwendung mithilfe ihrer ID hinzugefügt. Durch das Hinzufügen einer Blockierung pin wird verhindert, dass dieses Paket beim Aufrufen oder winget upgrade <package>aufrufen aktualisiert winget upgrade --all wird. Sie müssen die Blockierung des Pakets aufheben, damit WinGet ein upgrade.

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

Im folgenden Beispiel wird eine Gating pin für eine Anwendung mithilfe ihrer ID hinzugefügt. Durch das Hinzufügen eines Gatings pin werden Upgrades verhindert, die upgrade die Paketversion außerhalb einer bestimmten Version oder des Gated-Wildcardbereichs enthält.

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

entfernen

Der Unterbefehl " Entfernen " entfernt ein pin. Für diesen Unterbefehl müssen Sie das zu entfernende Paket pin angeben. Wenn Mehrdeutigkeiten vorliegen, werden Sie aufgefordert, den Unterbefehl remove auf eine exakte Anwendung zu filtern.

Syntax:

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

Argumente

Streitpunkt	BESCHREIBUNG
-Q--query	Die Abfrage, die für die Suche nach einer App verwendet wird.

Optionen

Mit den Optionen können Sie das Entfernen von Pins an Ihre jeweiligen Anforderungen anpassen.

Auswahlmöglichkeit	BESCHREIBUNG
--id	Schränkt die Suche auf die ID der Anwendung ein.
--name	Schränkt die Suche auf den Namen der Anwendung ein.
--moniker	Schränkt die Suche auf die für die Anwendung aufgelisteten Moniker ein.
-s, --source	Schränkt die Suche auf die Quelle mit dem angegebenen Namen ein. Hierauf muss der Name der Quelle folgen.
--tag	Schränkt die Suche auf die für die Anwendung aufgelisteten Tags ein.
--cmd, --command	Schränkt die Suche auf den Befehl der Anwendung ein.
-E --exact	Verwendet die exakte Zeichenfolge in der Abfrage und berücksichtigt die Groß-/Kleinschreibung. Das Standardverhalten einer Teilzeichenfolge wird nicht verwendet.
--header	Optionaler HTTP-Quellheader von Windows-Paket-Manager.
--authentication-mode	Angeben der Einstellung des Fensters „Authentifizierung“ (automatisch, vorzugsweise automatisch oder interaktiv).
--authentication-account	Angeben des Kontos, das für die Authentifizierung verwendet werden soll.
--accept-source-agreements	Wird verwendet, um den Quelllizenzvertrag zu akzeptieren und die Eingabeaufforderung zu vermeiden.
--installed	Anheften einer bestimmten installierten Version.
-?, --help	Ruft zusätzliche Hilfe zu diesem Befehl ab.
--wait	Fordert den Benutzer auf, vor dem Beenden eine beliebige Taste zu drücken.
--logs, --open-logs	Öffnet den Standardspeicherort für Protokolle.
--verbose, --verbose-logs	Wird verwendet, um die Protokollierungseinstellung zu überschreiben und ein ausführliches Protokoll zu erstellen.
--nowarn,--ignore-warnings	Unterdrückt Warnungsausgaben.
--disable-interactivity	Deaktiviert interaktive Eingabeaufforderungen.
--proxy	Festlegen eines Proxys, der für diese Ausführung verwendet werden soll.
--no-proxy	Deaktivieren der Verwendung des Proxys für diese Ausführung.

Beispiele

Im folgenden Beispiel wird eine pin Anwendung entfernt.

winget pin remove powertoys

Im folgenden Beispiel wird eine pin Anwendung mit ihrer ID entfernt.

winget pin remove --id Microsoft.PowerToys

Liste

Der Unterbefehl list listet alle aktuellen Pins auf.

Syntax:

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

Argumente

Streitpunkt	BESCHREIBUNG
-Q--query	Die Abfrage, die für die Suche nach einer App verwendet wird.

Optionen

Mit den Optionen können Sie das Auflisten von Pins an Ihre jeweiligen Anforderungen anpassen.

Auswahlmöglichkeit	BESCHREIBUNG
--id	Schränkt die Suche auf die ID der Anwendung ein.
--name	Schränkt die Suche auf den Namen der Anwendung ein.
--moniker	Schränkt die Suche auf die für die Anwendung aufgelisteten Moniker ein.
-s, --source	Schränkt die Suche auf die Quelle mit dem angegebenen Namen ein. Hierauf muss der Name der Quelle folgen.
--tag	Schränkt die Suche auf die für die Anwendung aufgelisteten Tags ein.
--cmd, --command	Schränkt die Suche auf den Befehl der Anwendung ein.
-E --exact	Verwendet die exakte Zeichenfolge in der Abfrage und berücksichtigt die Groß-/Kleinschreibung. Das Standardverhalten einer Teilzeichenfolge wird nicht verwendet.
--header	Optionaler HTTP-Quellheader von Windows-Paket-Manager.
--authentication-mode	Angeben der Einstellung des Fensters „Authentifizierung“ (automatisch, vorzugsweise automatisch oder interaktiv).
--authentication-account	Angeben des Kontos, das für die Authentifizierung verwendet werden soll.
--accept-source-agreements	Wird verwendet, um den Quelllizenzvertrag zu akzeptieren und die Eingabeaufforderung zu vermeiden.
-?, --help	Ruft zusätzliche Hilfe zu diesem Befehl ab.
--wait	Fordert den Benutzer auf, vor dem Beenden eine beliebige Taste zu drücken.
--logs, --open-logs	Öffnet den Standardspeicherort für Protokolle.
--verbose, --verbose-logs	Wird verwendet, um die Protokollierungseinstellung zu überschreiben und ein ausführliches Protokoll zu erstellen.
--nowarn,--ignore-warnings	Unterdrückt Warnungsausgaben.
--disable-interactivity	Deaktiviert interaktive Eingabeaufforderungen.
--proxy	Festlegen eines Proxys, der für diese Ausführung verwendet werden soll.
--no-proxy	Deaktivieren der Verwendung des Proxys für diese Ausführung.

Beispiele

Im folgenden Beispiel werden alle aktuellen Pins aufgelistet:

winget pin list

Im folgenden Beispiel wird ein bestimmtes Paket pinaufgelistet.

winget pin list --id Microsoft.PowerToys

zurücksetzen

Mit dem Unterbefehl „reset“ werden alle Pins zurückgesetzt.

Wenn Sie diesen Unterbefehl ohne das Argument --force verwenden, werden die Pins angezeigt, die entfernt werden.

Um alle Pins zurückzusetzen, schließen Sie das Argument --force ein.

Syntax:

winget pin reset [<options>]

Optionen

Mit den Optionen können Sie die Pins zum Zurücksetzen an Ihre jeweiligen Anforderungen anpassen.

Auswahlmöglichkeit	BESCHREIBUNG
--force	Führt den Befehl direkt aus und fährt mit nicht sicherheitsrelevanten Problemen fort.
-s, --source	Schränkt die Suche auf die Quelle mit dem angegebenen Namen ein. Hierauf muss der Name der Quelle folgen.
-?, --help	Ruft zusätzliche Hilfe zu diesem Befehl ab.
--wait	Fordert den Benutzer auf, vor dem Beenden eine beliebige Taste zu drücken.
--logs, --open-logs	Öffnet den Standardspeicherort für Protokolle.
--verbose, --verbose-logs	Wird verwendet, um die Protokollierungseinstellung zu überschreiben und ein ausführliches Protokoll zu erstellen.
--nowarn,--ignore-warnings	Unterdrückt Warnungsausgaben.
--disable-interactivity	Deaktiviert interaktive Eingabeaufforderungen.
--proxy	Festlegen eines Proxys, der für diese Ausführung verwendet werden soll.
--no-proxy	Deaktivieren der Verwendung des Proxys für diese Ausführung.

Beispiele

Mit dem folgenden Beispiel werden alle Pins angezeigt, die zurückgesetzt werden:

winget pin reset

Im folgenden Beispiel werden alle vorhandenen Pins zurückgesetzt:

winget pin reset --force