Add-PackageUpdateRule

For AI agents: a documentation index is available at /llms.txt; a markdown version of this page is available at /de/docs/commands/add-packageupdaterule/index.md.

SYNOPSIS

Fügt eine benutzerdefinierte Regel hinzu, die steuert, wie Modul-Updates gemeldet werden.

SYNTAX

__AllParameterSets

Add-PackageUpdateRule [[-Id] <int>] [[-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

Dieser Befehl erstellt eine benutzerdefinierte Update-Regel für die aktuelle PackageUpdateInfo-Konfiguration. Jede Regel definiert, wann ein Update als relevant für die Meldung betrachtet wird, basierend auf Änderungen im Major-, Minor-, Build- oder Revision-Teil der Modulversion. Regeln können die Meldung auch auf bestimmte Module beschränken, indem Modulnamen ein- oder ausgeschlossen werden, was es ermöglicht, störende reine Revisions-Updates zu unterdrücken oder Prüfungen auf ausgewählte Module zu fokussieren. Wenn kein Einstellungsobjekt angegeben wird, verwendet der Befehl die aktuelle Modulkonfiguration und speichert die neue Regel dort.

BEISPIELE

BEISPIEL 1

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

Fügt eine Regel hinzu, die Major-, Minor- und Build-Updates für MyModule meldet, während reine Revisionsänderungen unterdrückt werden.

BEISPIEL 2

PS C:\> Add-PackageUpdateRule -ExcludeModuleFromChecking "PowerShellGet","PSScriptAnalyzer" -ReportChangeOnRevision $false

Fügt eine Regel hinzu, die zwei Module von der Update-Prüfung ausschließt und Revisions-Updates für die übrigen Module unterdrückt.

BEISPIEL 3

PS C:\> Add-PackageUpdateRule -Id 99 -IncludeModuleForChecking "MyModule" -PassThru

Fügt eine Regel mit einer spezifischen Kennung hinzu und gibt das erstellte Regelobjekt zurück.

BEISPIEL 4

PS C:\> $settings = Get-PackageUpdateSetting; Add-PackageUpdateRule -SettingObject $settings -ExcludeModuleFromChecking "MyModule"

Fügt einem bestehenden Einstellungsobjekt eine Regel hinzu, ohne die Standard-Modulkonfiguration zu verwenden.

PARAMETER

-Confirm

Fordert eine Bestätigung an, bevor die neue Regel gespeichert wird.

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

Ein oder mehrere Modulnamen, die von der Update-Prüfung durch diese Regel 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 eindeutige Kennung 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

Ein oder mehrere Modulnamen, die von dieser Regel in die Update-Prüfung einbezogen werden sollen. Wird dieser Parameter weggelassen, gilt die Regel für alle Module.

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

Gibt das erstellte Regelobjekt über die Pipeline zurück.

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

Gibt an, ob eine Änderung im Build-Versionsanteil eine Update-Meldung auslösen soll.

Das bedeutet, dass ‘Get-PackageUpdateSetting’ nur dann ein Update meldet, 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

Gibt an, ob eine Änderung im Major-Versionsanteil eine Update-Meldung auslösen soll.

Das bedeutet, dass ‘Get-PackageUpdateSetting’ nur dann ein Update meldet, 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

Gibt an, ob eine Änderung im Minor-Versionsanteil eine Update-Meldung auslösen soll.

Das bedeutet, dass ‘Get-PackageUpdateSetting’ nur dann ein Update meldet, 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

Gibt an, ob eine Änderung im Revisions-Versionsanteil eine Update-Meldung auslösen soll.

Das bedeutet, dass ‘Get-PackageUpdateSetting’ eine Update-Meldung ausgibt, wenn sich die Revisions-Version eines Moduls ändert.

Major Minor Build Revision

0 0 0 1

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

Ein Einstellungsobjekt von Get-PackageUpdateSetting, das die neue Regel erhalten soll. Wird dieser Parameter weggelassen, werden die aktuellen Moduleinstellungen 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

Zeigt an, was passieren würde, wenn der Befehl ausgeführt wird, ohne die Konfiguration zu ändern.

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.ModuleRule

HINWEISE

Version : 1.1.0.0 Autor : Andi Bellstedt Datum : 2026-06-21 Schlüsselwörter : PackageUpdateInfo, Update, Modul, Regel