Set-PackageUpdateRule

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

SYNOPSIS

Aktualisiert eine bestehende PackageUpdateInfo-Regel, die steuert, wie Modulversionsänderungen gemeldet werden.

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

Dieses Cmdlet ändert eine bestehende Aktualisierungsregel, die in der PackageUpdateInfo-Konfiguration gespeichert ist, sodass Aktualisierungsprüfungen für bestimmte Module eingeschränkt oder erweitert werden können.
Du kannst es verwenden, um Module von der Aktualisierungserkennung auszuschließen oder einzubeziehen, steuern, welche Versionsbestandteile eine Aktualisierungsbenachrichtigung auslösen, und diese Regeländerungen in der aktiven Einstellungsdatei speichern.
Der Befehl arbeitet mit einer Regel, die durch Id identifiziert wird, oder mit einem Regelobjekt, das über InputObject übergeben wird, und kann die aktualisierte Regel zurückgeben, wenn -PassThru angegeben ist.

BEISPIELE

BEISPIEL 1

PS C:\> Set-PackageUpdateRule -Id 3 -IncludeModuleForChecking 'MyModule' -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false -PassThru

Aktualisiert Regel 3 so, dass MyModule explizit ausgewertet wird und nur Änderungen an Major-, Minor- und Build-Versionen als Aktualisierungsbedarf gemeldet werden.

BEISPIEL 2

PS C:\> Get-PackageUpdateRule -Id 7 | Set-PackageUpdateRule -ExcludeModuleFromChecking 'AzureTools' -ReportChangeOnRevision $false

Nimmt die Regel mit Id 7 aus der Pipeline und unterdrückt die Aktualisierungsbenachrichtigung basierend auf Revisionen für AzureTools, während die Regel in den aktuellen Einstellungen gespeichert bleibt.

BEISPIEL 3

$rule = Get-PackageUpdateRule -Id 12
PS C:\> Set-PackageUpdateRule -InputObject $rule -IncludeModuleForChecking 'PowershellGet','PSReadLine' -ReportChangeOnMinor $false -ReportChangeOnBuild $false

Lädt ein bestehendes Regelobjekt, erweitert die eingeschlossenen Module und aktualisiert die Regel so, dass nur Major- und Revisionsänderungen als relevante Updates behandelt werden.

BEISPIEL 4

PS C:\> Set-PackageUpdateRule -Id 5 -ReportChangeOnMajor $false -ReportChangeOnMinor $false -ReportChangeOnBuild $false -ReportChangeOnRevision $true -WhatIf

Zeigt die Auswirkung der Änderung von Regel 5, sodass nur revisionsbasierte Updates gemeldet werden, ohne die Änderung tatsächlich zu speichern.

PARAMETER

-Confirm

Fordert eine Bestätigung an, bevor das Cmdlet die geänderten Regel-Daten zurück in die Einstellungsdatei schreibt.

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 den Aktualisierungsprüfungen für die zu ändernde Regel 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 numerische Kennung der zu ändernden 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

Ein oder mehrere Modulnamen, die in die Aktualisierungsprüfungen für die zu ändernde Regel einbezogen werden sollen.
Wenn ausgelassen, behält die Regel das Standardverhalten bei, alle Module auszuwerten.

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 aktualisierende Regelobjekt.
Dies ist nützlich, wenn du bereits eine Regel von Get-PackageUpdateRule hast und sie ändern möchtest, ohne ihre Id anzugeben.

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

-PassThru

Gibt das aktualisierte Regelobjekt an die Pipeline zurück, nachdem die Änderung in der Einstellungsdatei gespeichert wurde.

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

Steuert, ob eine Änderung im Build-Versionsbestandteil dazu führt, dass die Regel meldet, dass ein Update benötigt wird.

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

Das bedeutet, ‘Get-PackageUpdateSetting’ meldet einen Aktualisierungsbedarf,
nur 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

Steuert, ob eine Änderung im Major-Versionsbestandteil dazu führt, dass die Regel meldet, dass ein Update benötigt wird.

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

Das bedeutet, ‘Get-PackageUpdateSetting’ meldet einen Aktualisierungsbedarf,
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

Steuert, ob eine Änderung im Minor-Versionsbestandteil dazu führt, dass die Regel meldet, dass ein Update benötigt wird.

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

Das bedeutet, ‘Get-PackageUpdateSetting’ meldet einen Aktualisierungsbedarf,
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

Steuert, ob eine Änderung im Revisions-Versionsbestandteil dazu führt, dass die Regel meldet, dass ein Update benötigt wird.

Meldet, wenn sich der Revisionsbestandteil eines Moduls ändert

Das bedeutet, ‘Get-PackageUpdateSetting’ meldet einen Aktualisierungsbedarf,
nur wenn sich die Revisionsversion eines Moduls ändert.

Major Minor Build Revision

0 0 0 1

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

Das PackageUpdateInfo-Konfigurationsobjekt, das aktualisiert werden soll.
Wenn ausgelassen, verwendet das Cmdlet die aktuellen Moduleinstellungen von Get-PackageUpdateSetting.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  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 Änderungen anzuwenden.

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

HINWEISE

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

VERWANDTE LINKS

• packageupdateinfo.andibellstedt.com/docs/commands/set-packageupdaterule