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]

ByInputObject

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

ALIASES

Dieses Cmdlet hat folgende Aliase,

BESCHREIBUNG

Dieses Cmdlet ändert eine bestehende Aktualisierungsregel, die in der PackageUpdateInfo-Konfiguration gespeichert ist, sodass Update-Prüfungen für bestimmte Module eingegrenzt oder erweitert werden können. Du kannst es verwenden, um Module von der Update-Erkennung auszuschließen oder einzuschließen, steuern, welche Versionsbestandteile eine Update-Meldung 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 als Update-Bedarf 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 revisionsbasierte Update-Meldung 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 auf die Festplatte zu schreiben.

PARAMETER

-Confirm

Fordert zur Bestätigung auf, bevor das Cmdlet geänderte 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 Update-Prü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 Update-Prüfung für die zu ändernde Regel einbezogen werden sollen. Wenn ausgelassen, behält die Regel das Standardverhalten bei, alle Module zu bewerten.

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 erforderlich ist.

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

Das bedeutet, dass ‘Get-PackageUpdateSetting’ einen Update-Bedarf meldet, 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 erforderlich ist.

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

Das bedeutet, dass ‘Get-PackageUpdateSetting’ einen Update-Bedarf 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

Steuert, ob eine Änderung im Minor-Versionsbestandteil dazu führt, dass die Regel meldet, dass ein Update erforderlich ist.

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

Das bedeutet, dass ‘Get-PackageUpdateSetting’ einen Update-Bedarf 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

Steuert, ob eine Änderung im Revisions-Versionsbestandteil dazu führt, dass die Regel meldet, dass ein Update erforderlich ist.

Meldet, wenn sich der Revisionsbestandteil eines Moduls ändert

Das bedeutet, dass ‘Get-PackageUpdateSetting’ einen Update-Bedarf meldet, nur wenn sich die Revisions-Version 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, Modul, Regel