Das ist eine für den Ausdruck optimierte Ansicht des gesamten Kapitels inkl. Unterseiten. Druckvorgang starten.

Zur Standardansicht zurückkehren.

Über diese Dokumentation

Dies ist die offizielle Dokumentationsseite für PackageUpdateInfo, ein PowerShell-Modul, das dir dabei hilft, den Überblick über deine installierten Module zu behalten, indem es alle lokal installierten PowerShell-Module überprüft und anzeigt, welche aktualisiert werden müssen.

Über das Modul

PackageUpdateInfo entstand aus einem echten Bedarf: Es ist mühsam und leicht, den Überblick über Updates von vielen installierten PowerShell-Modulen zu verlieren. Dieses Modul schließt diese Lücke, indem es automatisch alle installierten Module mit der PowerShell-Galerie vergleicht und eine klare Übersicht über verfügbare Updates bietet.

Wichtige Designprinzipien:

  • Plattformübergreifend — unterstützt Windows, Linux und macOS
  • Kompatibilität über Editionen hinweg — unterstützt PowerShell Desktop (5.1+) und Core (7.x)
  • Anpassbar — passe die Intervalle für die Update-Prüfung, Regeln für Versionssensitivität und Ausschlüsse an
  • Pipeline-freundlich — integriert sich nahtlos in die Pipeline-Architektur von PowerShell
  • Benachrichtigungsunterstützung — optional BurntToast-Desktop-Benachrichtigungen unter Windows

Ressourcen

Mitwirken

Beiträge sind willkommen. Wenn du Probleme, Fehler findest oder Verbesserungsvorschläge hast, öffne bitte ein Issue oder einen Pull-Request im GitHub-Repository.

1 - Übersicht

PackageUpdateInfo hilft dir, installierte PowerShell-Module auf dem neuesten Stand zu halten. Es vergleicht lokale Modulversionen mit Versionen aus konfigurierten Online-Repositorys (zum Beispiel PSGallery) und meldet, wenn neuere Versionen verfügbar sind.

Was macht PackageUpdateInfo?

Das Modul kann:

  • Lokale installierte Module abfragen.
  • Aktuelle Online-Versionen entdecken.
  • Versionen mit anpassbarer Empfindlichkeit vergleichen (major, minor, build, revision).
  • Umfangreiche Ausgaben anzeigen, inklusive Repository, Versionshinweisen, Autor und Projektlinks.
  • Ergebnisse für späteren Import und schnelle Start-Workflows exportieren.

Warum PackageUpdateInfo verwenden?

Komfort

  • Schnelles Erkennen veralteter Module ohne manuelles Überprüfen.
  • Update-Informationen für Offline- oder verzögerte Überprüfung exportieren und importieren.
  • Update-Checks im Hintergrund ausführen.
  • Optionale Toast-Benachrichtigungen unter Windows nutzen.

Automatisierung

  • Update-Checks mit deinem Profil, geplanten Tasks oder Startroutinen planen.
  • Ein Update-Check-Intervall festlegen, um unnötige Repository-Abfragen zu vermeiden.
  • Benutzerdefinierte Regeln pro Modulpattern für die Update-Empfindlichkeit festlegen.
  • Bereits exportierte Daten für eine niedrige Latenz beim Shell-Start wiederverwenden.

Flexibilität

  • Modulnamensmuster ein- oder ausschließen.
  • Regelbereich und Priorität mit Standard- und benutzerdefinierten Regeln definieren.
  • Funktioniert unter Windows, Linux und macOS.
  • Unterstützt Windows PowerShell 5.1 und PowerShell 7+.

Voraussetzungen

  • Windows PowerShell 5.1 oder PowerShell 7+.
  • PowerShellGet Zugriff auf dein Ziel-Repository (z.B. PSGallery).
  • Optional: BurntToast-Modul für Toast-Benachrichtigungen unter Windows.

Installation

Für alle Benutzer installieren (benötigt Administratorrechte):

Install-Module PackageUpdateInfo

Für den aktuellen Benutzer installieren:

Install-Module PackageUpdateInfo -Scope CurrentUser

Schneller Einstieg

Führe eine interaktive Überprüfung durch:

Get-PackageUpdateInfo

Zeige nur Module an, die ein Update benötigen:

Get-PackageUpdateInfo -ShowOnlyNeededUpdate

Erzwinge eine Überprüfung, auch wenn das konfigurierte Update-Intervall noch nicht abgelaufen ist:

Get-PackageUpdateInfo -Force

Verwende Toast-Benachrichtigungen (Windows mit BurntToast):

Get-PackageUpdateInfo -ShowToastNotification

Praktisches Automatisierungsmuster

Exportiere Update-Daten in einem Hintergrund-Job und importiere sie beim Shell-Start:

Start-Job -ScriptBlock { Get-PackageUpdateInfo -ShowOnlyNeededUpdate -ShowToastNotification | Export-PackageUpdateInfo } | Out-Null
Import-PackageUpdateInfo

Das hält den Start interaktiv, während aktuelle Update-Informationen angezeigt werden.

Nächste Schritte

  • Weiter mit Best Practices für Betrieb, Regelgestaltung und Automatisierung.
  • Weiter mit Troubleshooting für häufige Fehler und Wiederherstellungsprozesse.

2 - Betriebsempfehlungen

Diese Seite beschreibt empfohlene Betriebsabläufe für PackageUpdateInfo in interaktiven Shells, Profilen und Automatisierungen.

Beginne mit dem Standardverhalten

Setze die Einstellungen zurück, bevor du benutzerdefinierte Anpassungen vornimmst, insbesondere auf gemeinsam genutzten Systemen:

Set-PackageUpdateSetting -Reset

Prüfe die aktuelle Konfiguration und Regeln:

Get-PackageUpdateSetting
Get-PackageUpdateRule -IncludeDefaultRule

Nutze Update-Intervalle, um Rauschen zu reduzieren

Get-PackageUpdateInfo respektiert UpdateCheckInterval. Wenn die letzte effektive Überprüfung noch innerhalb des konfigurierten Intervalls liegt, gibt das Cmdlet frühzeitig zurück.

Lege ein Intervall fest, das zu deiner Umgebung passt:

Set-PackageUpdateSetting -UpdateCheckInterval (New-TimeSpan -Hours 6)

Verwende -Force nur für ad-hoc Überprüfungen:

Get-PackageUpdateInfo -Force

Bevorzuge nicht-blockierende Shell-Starts

Ein praktisches Profilmuster ist:

Start-Job -ScriptBlock {
    Get-PackageUpdateInfo -ShowOnlyNeededUpdate | Export-PackageUpdateInfo
} | Out-Null

Import-PackageUpdateInfo

Warum das gut funktioniert:

  • Der Start bleibt schnell, weil der Import zwischengespeicherte Daten liest.
  • Die aufwändige Online-Überprüfung läuft im Hintergrund.
  • Du erhältst in jeder Sitzung eine nützliche Übersicht über Updates.

Überprüfungen explizit bei Bedarf einschränken

Verwende Scope-Parameter, wenn Berechtigungen zwischen Benutzer- und Systemmodulen unterschiedlich sind:

Get-PackageUpdateInfo -CurrentUser
Get-PackageUpdateInfo -AllUsers

Nutze -Repository in Umgebungen mit mehreren konfigurierten Repositories:

Get-PackageUpdateInfo -Repository PSGallery

Regeln sorgfältig entwerfen

Verwende breite Ausschlüsse nur, wenn es beabsichtigt ist. Das Ausschließen großer Muster kann wichtige Updates verbergen.

Erstelle fokussierte, benutzerdefinierte Regeln für Module mit hoher Änderungsrate:

Add-PackageUpdateRule -IncludeModuleForChecking "Az.*" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $false -ReportChangeOnRevision $false

Überprüfe die Priorität der Regeln, indem du alle Regeln auflistest:

Get-PackageUpdateRule -IncludeDefaultRule | Sort-Object Id

Exportieren/Importieren gezielt einsetzen

Standardpfade für Export und Import sind plattformspezifisch und enthalten PowerShell-Edition sowie die Hauptversion im Dateinamen. Das hilft, Daten verschiedener Laufzeiten nicht zu vermischen.

Gängige Exportoptionen:

Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat XML
Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat JSON
Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat CSV

Empfohlene Vorgehensweise:

  • Verwende XML, wenn du typisierte Objekte für einen erneuten Import bewahren möchtest.
  • Nutze JSON oder CSV für externe Berichte und Integrationen.
  • Nutze -IncludeTimeStamp für eine historische Nachverfolgung.

Benachrichtigungen sinnvoll nutzen

Verwende Toast-Benachrichtigungen nur dort, wo sie Mehrwert bieten:

  • Auf Windows-Hosts mit installiertem BurntToast.
  • Bei Sitzungen, in denen interaktive Warnungen erwartet werden.

Für Server, CI und nicht-interaktive Shells bevorzugst du exportierte Berichte gegenüber Toast-Benachrichtigungen.

3 - Fehlerbehebung

Verwende diese Anleitung, wenn PackageUpdateInfo keine erwarteten Ergebnisse liefert, Prüfungen überspringt oder beim Import und Export von Daten fehlschlägt.

Erste Schritte: Aktionsfähige Diagnosen

Führe den Befehl mit ausführlicher Ausgabe aus:

Get-PackageUpdateInfo -Verbose

Einstellungen und Regeln prüfen:

Get-PackageUpdateSetting
Get-PackageUpdateRule -IncludeDefaultRule

Wird übersprungen unerwartet?

Symptom:

  • Du siehst eine Warnung, dass Update-Prüfungen übersprungen werden, weil das Prüfintervall noch nicht abgelaufen ist.

Ursache:

  • UpdateCheckInterval und das aktuelle LastCheck oder LastSuccessfulCheck verhindern eine neue Online-Prüfung.

Lösung:

Get-PackageUpdateInfo -Force

Oder das Intervall verkürzen:

Set-PackageUpdateSetting -UpdateCheckInterval (New-TimeSpan -Minutes 30)

Konfigurationsdatei fehlt oder ist beschädigt

Symptom:

  • Get-PackageUpdateSetting warnt, dass die Modulkonfigurationsdatei nicht gefunden wurde, und wirft dann einen Fehler.

Ursache:

  • Der Pfad zur Konfigurationsdatei existiert nicht oder enthält ungültiges JSON.

Lösung:

Set-PackageUpdateSetting -Reset
Get-PackageUpdateSetting

Keine Module werden zurückgegeben

Symptom:

  • Get-PackageUpdateInfo liefert nichts, obwohl Module installiert sind.

Häufige Ursachen:

  • Include- und Exclude-Regeln filtern alle Module heraus.
  • -CurrentUser oder -AllUsers filtern die erwarteten Module aus.
  • Repository-Filterung schließt relevante Module aus.

Schritte zur Lösung:

Get-PackageUpdateRule -IncludeDefaultRule
Get-PackageUpdateInfo -Force
Get-PackageUpdateInfo -CurrentUser -Force
Get-PackageUpdateInfo -AllUsers -Force

Export schlägt wegen Pfadfehlern fehl

Symptom:

  • Export meldet ungültigen Pfad oder Verzeichnisprobleme.

Ursache:

  • -Path zeigt auf ein Verzeichnis oder einen nicht existierenden Ort ohne -Force.

Lösung:

Get-PackageUpdateInfo | Export-PackageUpdateInfo -Path "$HOME\PackageUpdateInfo\updates.xml" -Force

Import liefert keine Daten

Symptom:

  • Import-PackageUpdateInfo liefert nichts.

Häufige Ursachen:

  • Die Datei ist leer oder zu klein, um Datensätze zu enthalten.
  • -InputFormat stimmt nicht mit dem exportierten Format überein.
  • Falscher Dateipfad für die aktuelle Laufzeit und Edition.

Lösung:

Import-PackageUpdateInfo -InputFormat XML -Verbose
Import-PackageUpdateInfo -Path "$HOME\PackageUpdateInfo\updates.json" -InputFormat JSON

Toast-Benachrichtigungen erscheinen nicht

Symptom:

  • -ShowToastNotification wird verwendet, aber kein Toast erscheint.

Häufige Ursachen:

  • BurntToast ist nicht installiert.
  • Die Host-Plattform unterstützt keine Windows-Toast-Benachrichtigungen.
  • Kein Modul im Ergebnis hat NeedUpdate = $true.

Lösung:

Install-Module BurntToast -Scope CurrentUser
Get-PackageUpdateInfo -ShowOnlyNeededUpdate -ShowToastNotification -Force

Regeln können nicht hinzugefügt oder geändert werden

Symptom:

  • Das Hinzufügen einer Regel schlägt mit doppelter Id, include oder exclude fehl.

Ursache:

  • Bereits vorhandene benutzerdefinierte Regeln enthalten die gleichen Identifikatoren oder Muster.

Lösung:

Get-PackageUpdateRule
Add-PackageUpdateRule -IncludeModuleForChecking "MyModule.*"
Set-PackageUpdateRule -Id 1 -ReportChangeOnRevision $false
Remove-PackageUpdateRule -Id 1

Repository- und Netzwerkprobleme

Symptom:

  • Online-Versionenabfrage schlägt fehl oder ist unvollständig.

Häufige Ursachen:

  • Repository ist nicht registriert oder nicht erreichbar.
  • Vorübergehende Netzwerkprobleme.

Lösung:

Get-PSRepository
Find-Module PackageUpdateInfo -Repository PSGallery
Get-PackageUpdateInfo -Repository PSGallery -Force

Wiederherstellungsablauf

Wenn das Verhalten weiterhin inkonsistent ist, nutze diese Reset-Sequenz:

Set-PackageUpdateSetting -Reset
Get-PackageUpdateInfo -Force | Export-PackageUpdateInfo
Import-PackageUpdateInfo

4 - Modulbefehle Referenz

Hier findest du eine Referenz für alle Befehle im Modul. Diese Referenz soll dir helfen, schnell den Befehl zu finden, den du brauchst, und zu verstehen, wie du ihn effektiv nutzt.

Wenn du auf einen Befehl klickst, gelangst du zu einer detaillierten Seite, die umfassende Informationen über den Befehl bietet, einschließlich seiner Syntax, Parameter, Beispiele und zusätzlicher Hinweise oder Tipps zur Verwendung.

4.1 - Add-PackageUpdateRule

SYNOPSIS

Fügt eine Regel zum Überprüfen und Berichten über installierte Module hinzu

SYNTAX

__AllParameterSets

Add-PackageUpdateRule [[-Id] <int>] [[-IncludeModuleForChecking] <string[]>]
 [[-ExcludeModuleFromChecking] <string[]>] [[-ReportChangeOnMajor] <bool>]
 [[-ReportChangeOnMinor] <bool>] [[-ReportChangeOnBuild] <bool>] [[-ReportChangeOnRevision] <bool>]
 [[-SettingObject] <Configuration>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASSE

Dieses Cmdlet hat die folgenden Aliase,

BESCHREIBUNG

Mit diesem Befehl kannst du festlegen, wie ein Modul in der Berichterstattung behandelt wird.

Zum Beispiel kannst du PackageUpdateInfo so konfigurieren, dass Revision-Updates bei häufig aktualisierten Modulen unterdrückt werden, sodass nur Build-, Minor- oder Major-Updates als „Update erforderlich“ gemeldet werden.

BEISPIELE

BEISPIEL 1

PS C:\> Add-PackageUpdateRule -IncludeModuleForChecking "MyModule" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false

Fügt eine neue benutzerdefinierte Regel für “MyModule” hinzu, um Benachrichtigungen bei Revision-Updates des Moduls zu unterdrücken

PARAMETER

-Confirm

Wenn dieser Schalter aktiviert ist, wirst du vor der Ausführung von Operationen, die den Zustand ändern, um Bestätigung gefragt.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position:: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ExcludeModuleFromChecking

Modulnamen, die von der Aktualitätsprüfung ausgeschlossen werden sollen

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: (All)
  Position: 2
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

Die ID als Bezeichner für die Regel

Type: Int32
DefaultValue: 0
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Modulnamen, die in die Aktualitätsprüfung einbezogen werden sollen Standardmäßig sind alle Module eingeschlossen.

Standardwert ist: “*”

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Das Regelobjekt wird an die Pipeline weitergegeben, um es weiter zu verarbeiten

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position:: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnBuild

Berichtet, wenn sich die Build-Version eines Moduls ändert

Das bedeutet, dass ‘Get-PackageUpdateSetting’ ein Update melden muss, wenn sich die Build-Version eines Moduls ändert.

Major Minor Build Revision

0 0 1 0

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 5
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMajor

Berichtet, wenn sich die Major-Version eines Moduls ändert

Das bedeutet, dass ‘Get-PackageUpdateSetting’ ein Update melden muss, nur wenn sich die Major-Version eines Moduls ändert.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 3
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMinor

Berichtet, wenn sich die Minor-Version eines Moduls ändert

Das bedeutet, dass ‘Get-PackageUpdateSetting’ ein Update melden muss, nur wenn sich die Minor-Version eines Moduls ändert.

Major Minor Build Revision

0 1 0 0

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 4
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Berichtet, wenn sich der Revisions-Teil eines Moduls ändert

Das bedeutet, dass ‘Get-PackageUpdateSetting’ ein Update melden muss, wenn sich die Revisions-Version eines Moduls ändert.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 6
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

Einstellungsobjekt, das beim Befehl Get-PackageUpdateSetting eingelesen wird Dies ist ein optionaler Parameter. Standardmäßig wird das Standard-Settings-Objekt des Moduls verwendet.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 7
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Wenn dieser Schalter aktiviert ist, werden keine Aktionen ausgeführt, aber Informationsmeldungen angezeigt, die erklären, was passieren würde, wenn der Befehl ausgeführt würde.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position:: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

Gemeinsame Parameter

Dieses Cmdlet unterstützt die gemeinsamen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Für weitere Informationen siehe about_CommonParameters.

EINGABEDATEN

PackageUpdate.Configuration

AUSGABEN

PackageUpdate.ModuleRule

4.2 - Export-PackageUpdateInfo

ZUSAMMENFASSUNG

Exportiere PackageUpdateInfo in eine Daten-Datei

SYNTAX

__AllParameterSets

Export-PackageUpdateInfo [[-Path] <string>] -InputObject <Info[]> [-OutputFormat <string>]
 [-Encoding <string>] [-Force] [-Append] [-IncludeTimeStamp] [-PassThru] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ALIASNAMES

Dieses Cmdlet hat die folgenden Aliase,

BESCHREIBUNG

Exportiere PackageUpdateInfo in eine Daten-Datei

BEISPIELE

BEISPIEL 1

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo

Beispiel für die Verwendung von Export-PackageUpdateInfo

PARAMETER

-Append

Die Ausgabedatei wird nicht überschrieben. Alle Informationen werden angehängt.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Confirm

Wenn dieser Schalter aktiviert ist, wirst du vor der Ausführung von Operationen, die den Zustand ändern, um Bestätigung gebeten.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Encoding

Datei-Codierung für die Datei

Type: String
DefaultValue: default
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Wenn das Verzeichnis für die Datei nicht vorhanden ist, aber ein anderes als das Standardverzeichnis angegeben wurde, versucht die Funktion, das Verzeichnis zu erstellen.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeTimeStamp

Ein Zeitstempel wird den Informationsaufzeichnungen hinzugefügt.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Das PackageUpdateInfo aus der Funktion Get-PackageUpdateInfo.

Type: Info[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-OutputFormat

Das Ausgabeformat für die Daten Verfügbare Formate sind “XML”,“JSON”,“CSV”

Type: String
DefaultValue: XML
SupportsWildcards: false
Aliases:
- Format
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Die exportierten Objekte werden an die Pipeline zur weiteren Verarbeitung weitergegeben.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

Der Pfad, an den die Infos exportiert werden sollen. Bitte gib eine Datei als Pfad an.

Standardpfad ist: Linux: “$HOME/.local/share/powershell/PackageUpdateInfo/PackageUpdateInfo.xml”) Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo.xml”)

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Wenn dieser Schalter aktiviert ist, werden keine Aktionen ausgeführt, aber Informationsmeldungen angezeigt, die erklären, was passieren würde, wenn der Befehl ausgeführt würde.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

Gemeinsame Parameter

Dieses Cmdlet unterstützt die gemeinsamen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Für weitere Informationen siehe about_CommonParameters.

EINGABEDATEN

PackageUpdate.Info[]

AUSGABEDATEN

PackageUpdate.Info

4.3 - Get-PackageUpdateInfo

SYNOPSIS

Infos zur Aktualität installierter Module abrufen

SYNTAX

DefaultSet1 (Standard)

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-Force] [<CommonParameters>]

CurrentUser

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-CurrentUser] [-Force] [<CommonParameters>]

AllUsers

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-AllUsers] [-Force] [<CommonParameters>]

ALIAS

Dieses Cmdlet hat die folgenden Aliases,

BESCHREIBUNG

Get-PackageUpdateInfo fragt lokal installierte Module ab und vergleicht sie mit den Online-Versionen auf Aktualität.

BEISPIELE

BEISPIEL 1

PS C:\> Get-PackageUpdateInfo

Gibt Update-Informationen für alle Module aus (currentUser und AllUsers).
Die Ausgabe kann beispielsweise so aussehen:

Name Repository VersionInstalled VersionOnline NeedUpdate Path

PSReadline PSGallery 1.2 1.2 False C:\Program Files\WindowsPowerShell\Modules\PSReadline Pester PSGallery 4.4.0 4.4.2 True C:\Program Files\WindowsPowerShell\Modules\Pester

BEISPIEL 2

PS C:\> Get-PackageUpdateInfo -ShowOnlyNeededUpdate

Dies filtert die Ausgabe, sodass nur Module angezeigt werden, bei denen NeedUpdate auf True gesetzt ist.
Die Ausgabe könnte so aussehen:

Name Repository VersionInstalled VersionOnline NeedUpdate Path

Pester PSGallery 4.4.0 4.4.2 True C:\Program Files\WindowsPowerShell\Modules\Pester

BEISPIEL 3

PS C:\> "Pester", "PSReadline" | Get-PackageUpdateInfo

Pipeline wird unterstützt. Dies gibt die Infos nur für die beiden Module “Pester” und “PSReadline” zurück.

Das kann auch mit dem Get-Module Cmdlet gemacht werden:
Get-Module “Pester”, “PSReadline” | Get-PackageUpdateInfo

PARAMETER

-AllUsers

Nur nach Modulen in den AllUsers/System-Verzeichnissen suchen.
Beachte, dass Administratorrechte erforderlich sind, um diese Module zu aktualisieren.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: AllUsers
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-CurrentUser

Nur nach Modulen im aktuellen Benutzerprofil suchen.
Das ist hilfreich, wenn du ohne Administratorrechte arbeitest, was du standardmäßig tun solltest.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: CurrentUser
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Erzwingt die Abfrage der Aktualitätsinformationen, auch wenn das UpdateCheckInterval vom letzten Check noch nicht abgelaufen ist.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Name

Der Name des zu überprüfenden Moduls

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Repository

Das Repository, das überprüft werden soll

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowOnlyNeededUpdate

Dieses Switch unterdrückt die Anzeige von Modulen, die auf dem neuesten Stand sind.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowToastNotification

Dieses Switch löst schöne Windows-Toast-Benachrichtigungen mit Versionshinweisen für Module aus, bei denen ein Update erforderlich ist.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- ToastNotification
- Notify
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Dieses Cmdlet unterstützt die gängigen Parameter: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter
about_CommonParameters.

INPUTS

System.String[]

OUTPUTS

PackageUpdate.Info

4.4 - Get-PackageUpdateRule

SYNOPSIS

Hole Regel(n) zum Überprüfen und Berichten über installierte Module

SYNTAX

ShowAll (Standard)

Get-PackageUpdateRule [-IncludeModuleForChecking <string>] [-ExcludeModuleFromChecking <string>]
 [-IncludeDefaultRule] [-SettingObject <Configuration>] [<CommonParameters>]

ById

Get-PackageUpdateRule -Id <int[]> [-SettingObject <Configuration>] [<CommonParameters>]

ALIASSE

Dieses Cmdlet hat die folgenden Aliase,

BESCHREIBUNG

Dieses Kommando holt die bestehenden benutzerdefinierten Regeln, wie Module im Bericht behandelt werden.

BEISPIELE

BEISPIEL 1

PS C:\> Get-PackageUpdateRule

Alle bestehenden benutzerdefinierten Regeln abrufen

BEISPIEL 2

PS C:\> Get-PackageUpdateRule -Id 1

Alle benutzerdefinierten Regeln mit der ID 1 abrufen

PARAMETER

-ExcludeModuleFromChecking

Module-Namen, die von der Aktualisierungsprüfung ausgeschlossen werden sollen

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

Die ID als Kennung für die Regel

Type: Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeDefaultRule

Gibt die DefaultRule aus dem Einstellungsobjekt zusammen mit den benutzerdefinierten Regeln aus

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Module-Namen, die in die Aktualisierungsprüfung eingeschlossen werden sollen Standardmäßig sind alle Module eingeschlossen.

Standardwert ist: “*”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

Einstellungsobjekt, das beim Befehl Get-PackageUpdateSetting geparst wird Dies ist ein optionaler Parameter. Standardmäßig wird das Standard-Einstellungsobjekt des Moduls verwendet.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (Alle)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Dieses Cmdlet unterstützt die gängigen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Für weitere Informationen siehe about_CommonParameters.

EINGABEDATEN

System.Int32[]

PackageUpdate.Configuration

AUSGABEN

PackageUpdate.ModuleRule

4.5 - Get-PackageUpdateSetting

ZUSAMMENFASSUNG

Einstellungen für das Verhalten des PackageUpdateInfo-Moduls festlegen

SYNTAX

__AllParameterSets

Get-PackageUpdateSetting [[-Path] <string>] [<CommonParameters>]

ALIASSE

Dieses Cmdlet hat die folgenden Aliasse,

BESCHREIBUNG

Abfrage der Grundeinstellungen für die Überprüfung und Berichterstattung über Aktualitätsinformationen zu installierten Modulen

BEISPIELE

BEISPIEL 1

PS C:\> Get-PackageUpdateSetting

Aktuelle Einstellungen zum Verhalten von PackageUpdateInfo abrufen.

PARAMETER

-Path

Der Dateipfad zur Einstellungsdatei

Dies ist optional, der Standardpfad ist: Linux: “$HOME/.local/share/powershell/PackageUpdateInfo/PackageUpdateInfo.xml”) Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo.xml”)

Type: String
DefaultValue: $script:ModuleSettingPath
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Dieses Cmdlet unterstützt die gängigen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Für weitere Informationen siehe about_CommonParameters.

AUSGABEN

PackageUpdate.Configuration

4.6 - Import-PackageUpdateInfo

SYNOPSIS

Importiere PackageUpdateInfo aus einer Datendatei

SYNTAX

__AllParameterSets

Import-PackageUpdateInfo [[-Path] <string>] [-ShowToastNotification] [-InputFormat <string>]
 [-Encoding <string>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Dieses Cmdlet hat folgende Aliase,

BESCHREIBUNG

Importiere PackageUpdateInfo aus einer zuvor mit der Funktion Export-PackageUpdateInfo exportierten Datendatei.

BEISPIELE

BEISPIEL 1

PS C:\> Import-PackageUpdateInfo

Versucht, die Standarddatei “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo.xml” zu importieren.

PARAMETER

-Confirm

Wenn dieser Schalter aktiviert ist, wirst du vor der Ausführung von Operationen, die den Zustand ändern, zur Bestätigung aufgefordert.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Encoding

Dateicodierung für die Datei

Type: String
DefaultValue: default
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputFormat

Das Ausgabeformat für die Daten Verfügbare Formate sind “XML”, “JSON”, “CSV”

Type: String
DefaultValue: XML
SupportsWildcards: false
Aliases:
- Format
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

Der Dateipfad, von dem die Informationen importiert werden. Bitte gib eine Datei als Pfad an.

Standardpfad ist: Linux: “$HOME/.local/share/powershell/PackageUpdateInfo/PackageUpdateInfo.xml”) Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo.xml”)

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowToastNotification

Dieser Schalter zeigt schöne Windows-Toast-Benachrichtigungen mit Versionshinweisen zu Modulen an, die ein Update benötigen.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- ToastNotification
- Notify
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Wenn dieser Schalter aktiviert ist, werden keine Aktionen ausgeführt, aber Informationsmeldungen angezeigt, die erklären, was passieren würde, wenn der Befehl ausgeführt würde.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

EINGABEN

System.String

AUSGABEN

PackageUpdate.Info

4.7 - Remove-PackageUpdateRule

SYNOPSIS

Regel(n) zum Überprüfen und Melden installierter Module entfernen

SYNTAX

ById (Standard)

Remove-PackageUpdateRule -Id <int[]> [-Force] [-PassThru] [-SettingObject <Configuration>] [-WhatIf]
 [-Confirm] [<CommonParameters>]

ByInputObject

Remove-PackageUpdateRule -InputObject <ModuleRule[]> [-Force] [-PassThru]
 [-SettingObject <Configuration>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Dieses Cmdlet hat folgende Aliase,

BESCHREIBUNG

Dieser Befehl entfernt bestehende benutzerdefinierte Regel(n), wie ein Modul bei der Berichterstattung behandelt wird.

BEISPIELE

BEISPIEL 1

PS C:\> Get-PackageUpdateRule | Remove-PackageUpdateRule

Alle benutzerdefinierten Regeln für die Modul-Update-Verwaltung entfernen.

PARAMETER

-Confirm

Wenn dieser Schalter aktiviert ist, wirst du vor der Ausführung von Operationen, die den Zustand ändern, um eine Bestätigung gebeten.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Wenn angegeben, wird der Benutzer nicht um eine Bestätigung gebeten.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

Die Id der zu entfernenden Regel

Type: Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Einstellungen-Objekt, übergeben vom Befehl Get-PackageUpdateSetting
Dies ist ein optionaler Parameter

Type: ModuleRule[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ByInputObject
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Das Regel-Objekt wird zur weiteren Verarbeitung an die Pipeline weitergegeben

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

Einstellungen-Objekt vom Befehl Get-PackageUpdateSetting
Dies ist ein optionaler Parameter.
Standardmäßig wird das Standard-Einstellungen-Objekt aus dem Modul verwendet.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Wenn dieser Schalter aktiviert ist, werden keine Aktionen ausgeführt, aber Informationsmeldungen angezeigt, die erklären, was passieren würde, wenn der Befehl ausgeführt würde.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter
about_CommonParameters.

EINGABEN

System.Int32[]

PackageUpdate.ModuleRule[]

PackageUpdate.Configuration

AUSGABEN

PackageUpdate.ModuleRule

4.8 - Set-PackageUpdateRule

SYNOPSIS

Legt eine Regel zum Überprüfen und Melden installierter Module fest

SYNTAX

ById (Standard)

Set-PackageUpdateRule -Id <int> [-IncludeModuleForChecking <string[]>]
 [-ExcludeModuleFromChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
 [-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-SettingObject <Configuration>]
 [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ByInputObject

Set-PackageUpdateRule -InputObject <ModuleRule[]> [-IncludeModuleForChecking <string[]>]
 [-ExcludeModuleFromChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
 [-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-SettingObject <Configuration>]
 [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Dieses Cmdlet hat folgende Aliase,

BESCHREIBUNG

Mit diesem Befehl können bestehende Regeln bearbeitet werden, wie ein Modul im Berichtswesen behandelt wird.

Zum Beispiel kannst du PackageUpdateInfo so konfigurieren, dass Revision-Updates bei häufig aktualisierten Modulen unterdrückt werden, sodass nur Build-, Minor- oder Major-Updates als „Update benötigt“ gemeldet werden.

BEISPIELE

BEISPIEL 1

PS C:\> Add-PackageUpdateRule -IncludeModuleForChecking "MyModule" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false

Fügt eine neue benutzerdefinierte Regel für „MyModule“ hinzu, um Benachrichtigungen bei Revision-Updates des Moduls zu unterdrücken

PARAMETER

-Confirm

Wenn dieser Schalter aktiviert ist, wirst du vor der Ausführung von Operationen, die den Zustand ändern, zur Bestätigung aufgefordert.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ExcludeModuleFromChecking

Modulnamen, die von der Update-Prüfung ausgeschlossen werden sollen

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

Die Id als Bezeichner für die Regel

Type: Int32
DefaultValue: 0
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Modulnamen, die in die Update-Prüfung einbezogen werden sollen Standardmäßig sind alle Module eingeschlossen.

Standardwert ist: “*”

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Das zu ändernde Regelobjekt

Type: ModuleRule[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ByInputObject
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Das Regelobjekt wird zur weiteren Verarbeitung an die Pipeline weitergegeben

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnBuild

Meldet, wenn sich die Build-Version eines Moduls ändert

Das bedeutet, dass ‘Get-PackageUpdateSetting’ ein Update benötigt meldet, wenn sich die Build-Version eines Moduls ändert.

Major Minor Build Revision

0 0 1 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMajor

Meldet, wenn sich die Major-Version eines Moduls ändert

Das bedeutet, dass ‘Get-PackageUpdateSetting’ ein Update benötigt meldet, nur wenn sich die Major-Version eines Moduls ändert.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMinor

Meldet, wenn sich die Minor-Version eines Moduls ändert

Das bedeutet, dass ‘Get-PackageUpdateSetting’ ein Update benötigt meldet, nur wenn sich die Minor-Version eines Moduls ändert.

Major Minor Build Revision

0 1 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Meldet, wenn sich der Revisionsanteil eines Moduls ändert

Das bedeutet, dass ‘Get-PackageUpdateSetting’ ein Update benötigt meldet, wenn sich die Revisionsversion eines Moduls ändert.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

Einstellungen-Objekt, das vom Befehl Get-PackageUpdateSetting übergeben wird Dies ist ein optionaler Parameter. Standardmäßig wird das Standard- Einstellungsobjekt aus dem Modul verwendet.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Wenn dieser Schalter aktiviert ist, werden keine Aktionen ausgeführt, aber Informationsmeldungen angezeigt, die erklären, was passieren würde, wenn der Befehl ausgeführt würde.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Dieses Cmdlet unterstützt die gemeinsamen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Für weitere Informationen siehe about_CommonParameters.

EINGABEN

System.Int32

PackageUpdate.ModuleRule[]

PackageUpdate.Configuration

AUSGABEN

PackageUpdate.ModuleRule

4.9 - Set-PackageUpdateSetting

SYNOPSIS

Verhaltenseinstellungen für das PackageUpdateInfo-Modul festlegen

SYNTAX

SetBehaviour

Set-PackageUpdateSetting [-ExcludeModuleFromChecking <string[]>]
 [-IncludeModuleForChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
 [-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-UpdateCheckInterval <timespan>]
 [-LastCheck <datetime>] [-LastSuccessfulCheck <datetime>] [-InputObject <Configuration>]
 [-Path <string>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ResetBehaviour

Set-PackageUpdateSetting [-Reset] [-Path <string>] [-PassThru] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ALIASES

Dieses Cmdlet hat folgende Aliase,

BESCHREIBUNG

Set-PackageUpdateInfo konfiguriert grundlegende Einstellungen für die Prüfung und Meldung von Aktualitätsinformationen installierter Module

BEISPIELE

BEISPIEL 1

PS C:\> Set-PackageUpdateSetting -ExcludeModuleFromChecking @("") -IncludeModuleForChecking "*" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $true -UpdateCheckInterval "01:00:00"

Modul auf das Standardverhalten zurücksetzen

BEISPIEL 2

PS C:\> Set-PackageUpdateSetting -Reset

Modul auf das Standardverhalten zurücksetzen

PARAMETER

-Confirm

Wenn dieser Schalter aktiviert ist, wirst du vor der Ausführung von Operationen, die den Zustand ändern, um eine Bestätigung gebeten.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ExcludeModuleFromChecking

Modulnamen, die von der Update-Prüfung in der Standardregel ausgeschlossen werden sollen

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Modulnamen, die in der Standardregel für die Update-Prüfung eingeschlossen werden sollen Standardmäßig sind alle Module eingeschlossen.

Standardwert ist: “*”

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Einstellungen-Objekt, das vom Befehl Get-PackageUpdateSetting übergeben wird

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-LastCheck

Zeitstempel, wann die letzte Prüfung auf Updatebedarf bei Modulen gestartet wurde

Type: DateTime
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-LastSuccessfulCheck

Zeitstempel, wann die letzte Prüfung auf Updatebedarf erfolgreich abgeschlossen wurde

Type: DateTime
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Das Einstellungsobjekt wird zur weiteren Verarbeitung an die Pipeline weitergegeben

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

Der Dateipfad, an dem die Einstellungsdatei gespeichert ist

Dies ist optional, der Standardpfad ist: Linux: “$HOME/.local/share/powershell/PackageUpdateInfo/PackageUpdateSetting.xml”) Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateSetting.xml”)

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnBuild

Melde, wenn sich die Build-Version eines Moduls in der Standardregel ändert

Das bedeutet, ‘Get-PackageUpdateSetting’ meldet einen Updatebedarf, wenn sich die Build-Version eines Moduls ändert.

Major Minor Build Revision

0 0 1 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMajor

Melde, wenn sich die Major-Version eines Moduls in der Standardregel ändert

Das bedeutet, ‘Get-PackageUpdateSetting’ meldet einen Updatebedarf, nur wenn sich die Major-Version eines Moduls ändert.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMinor

Melde, wenn sich die Minor-Version eines Moduls in der Standardregel ändert

Das bedeutet, ‘Get-PackageUpdateSetting’ meldet einen Updatebedarf, nur wenn sich die Minor-Version eines Moduls ändert.

Major Minor Build Revision

0 1 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Melde, wenn sich der Revisionsanteil eines Moduls in der Standardregel ändert

Das bedeutet, ‘Get-PackageUpdateSetting’ meldet einen Updatebedarf, wenn sich die Revisionsnummer eines Moduls ändert.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Reset

Modul auf das Standardverhalten zurücksetzen

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ResetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-UpdateCheckInterval

Das minimale Intervall/Zeitspanne, die vergehen muss, bevor eine neue Modul-Updateprüfung durchgeführt wird

Standardwert ist: “01:00:00”

Type: TimeSpan
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Wenn dieser Schalter aktiviert ist, werden keine Aktionen ausgeführt, aber Informationsmeldungen angezeigt, die erklären, was passieren würde, wenn der Befehl ausgeführt würde.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

EINGABEN

PackageUpdate.Configuration

AUSGABEN

PackageUpdate.Configuration

4.10 - Show-PackageUpdateReleaseNote

SYNOPSIS

Zeigt Versionshinweise eines Moduls an

SYNTAX

ByPackageUpdeInfoObject

Show-PackageUpdateReleaseNote [[-InputObject] <Info[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

ByModuleObject

Show-PackageUpdateReleaseNote [[-Module] <psmoduleinfo[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Dieses Cmdlet hat folgende Aliase,

BESCHREIBUNG

Zeigt Versionshinweise eines Moduls an.

BEISPIELE

BEISPIEL 1

PS C:\> Get-PackageUpdateInfo | Show-PackageUpdateReleaseNote

Versionshinweise aus PackageUpdateInfo-Objekten abrufen

BEISPIEL 2

PS C:\> Get-Module PackageUpdateInfo | Show-PackageUpdateReleaseNote

Versionshinweise aus einem Modul abrufen

PARAMETER

-Confirm

Wenn dieser Schalter aktiviert ist, wirst du vor der Ausführung von Operationen, die den Zustand ändern, um eine Bestätigung gebeten.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Eingabeobjekt(e) von Get-PackageUpdateInfo oder Import-PackageUpdateInfo, um Versionshinweise anzuzeigen

Type: Info[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Input
ParameterSets:
- Name: ByPackageUpdeInfoObject
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Module

Eingabeobjekt(e) von Get-Module, um Versionshinweise anzuzeigen

Type: PSModuleInfo[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- ModuleName
ParameterSets:
- Name: ByModuleObject
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Wenn dieser Schalter aktiviert ist, werden keine Aktionen ausgeführt, aber Informationsmeldungen angezeigt, die erklären, was passieren würde, wenn der Befehl ausgeführt würde.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

EINGABEN

PackageUpdate.Info[]

System.Management.Automation.PSModuleInfo[]

AUSGABEN

PackageUpdate.ReleaseNote